Converts OTX Value to String and vice versa. More...

Static Public Member Functions
static Object	String2Value (String stringLiteral, String targetDataType)
	Converts a `String` into a value of the given data type. More...

static String	Value2String (Object value)
	Converts a value from an element of the API to a `String` literal. More...

Detailed Description

Converts OTX Value to String and vice versa.

Member Function Documentation

◆ String2Value()

static Object OpenTestSystem.Otx.Runtime.Api.DataTypes.ValueConverter.String2Value	(	String	stringLiteral,
		String	targetDataType
	)

inlinestatic

Converts a String into a value of the given data type.

This method converts a String in OTL notation into a value of the given data type. The String for the data type is formatted in OTL notation and is therefore independent from the underlying software platform like C++, DotNet or Java. The data type String can be get via the related method or property of the related OTX element, e.g. ProcedureParameter.

Parameters

stringLiteral	String literal formatted in OTL notation
targetDataType	OTL notation of the data type which the string literal will be converted to. To get the data type the property DataType of the related element can be used, e.g. ProcedureParameter.

Returns: An OTX value object.

Exceptions

OpenTestSystem.Otx.Runtime.Api.Exceptions.InvalidLiteralException	Thrown when a literal string cannot be converted to OTX Object.
IllegalArgumentException	Thrown when either stringLiteral or targetDataType is null.

Example

String2Value("1", "Integer"); String2Value("\"Hello World!"", "String"); String2Value("true", "Boolean") String2Value("1.23", "Float"); String2Value("&123456789ABCDEF0", "ByteField"); String2Value("{"Value1", "Value2", "Value3"}", "List<String>"); String2Value("{"Key1":"Value1", "Key2":"Value2", "Key3":"Value3"}", "Map<String, String>"); String2Value("{StringElement="Hello", IntegerElement=123, FloatElement=457.0}", "StructurePackage1.Document1.StructureSignature1<String, Integer, Float>"); // structure defined in OTX String2Value("IntegerElement", "EnumerationElementPackage1.Document1.EnumerationSignature1"); // enumeration defined in OTX String2Value("{"Value1", "Value2", "Value3"}", parameter.DataType);

◆ Value2String()

static String OpenTestSystem.Otx.Runtime.Api.DataTypes.ValueConverter.Value2String ( Object value )

inlinestatic

Converts a value from an element of the API to a String literal.

This method converts a value from an element of the API like a ProcedureParameter to a String literal. The String literal is formatted in OTL notation and is therefore independent from the underlying software platform like C++, DotNet or Java.

Parameters

value An arbitrary value of an OTX object e.g. ProcedureParameter.

Returns: String literal in OTL notation.

Exceptions

IllegalArgumentException Thrown when value is null.

Example

// Pseudo-Code example to convert values to string and vice versa
// ==============================================================
// Please note that the exact syntax of C++, DotNet and Java is different!
 
void main()
{
    // ...
 
    // Set and Get datatype List
    // Assume the parameter[0] is a ProcedureInParameter of data type List of String (List<String>)
    String newlyAddedListStringLiteral = SetParameterValue(procedure.Parameters[0], "{\"Value1\", \"Value2\", \"Value3\"}");
 
    // ...
 
    // ...
 
    // Set and Get datatype Map
    // Assume the parameter[1] is a ProcedureInParameter of data type Map with key of type String and value of type String (Map<String, String>)
    String newlyAddedListStringLiteral = SetParameterValue(procedure.Parameters[1], "{\"Key1\":\"Value1\", \"Key2\":\"Value2\", \"Key3\":\"Value3\"}");
 
    // ...
 
    // ...
 
    // Set and Get datatype ByteField
    // Assume the parameter[2] is a ProcedureInParameter of data type ByteField
    String newlyAddedListStringLiteral = SetParameterValue(procedure.Parameters[2], "&121212");
 
    // ...
 
    // Set and Get datatype ResourceLocation
    // Assume the parameter[3] is a ProcedureInParameter of data type ResourceLocation
    String newlyAddedListStringLiteral = SetParameterValue(procedure.Parameters[3], "@ResourceLocation: \"ID_1\"/\"path/to/resource/file\"");
 
    // ...
}
 
// Set value to a parameter using string literal
// and Get the newly added value back as a string literal
String SetParameterValue(OpenTestSystem.Otx.Runtime.Api.Otx.IProcedureParameter parameter, String stringLiteral)
{
    if (parameter is null)
    {
        return String.Empty;
    }
 
    try
    {
        // The string literal will be converted to an OTX Data Types Supported at the API
        Object value = OpenTestSystem.Otx.Runtime.Api.DataTypes.ValueConverter.String2Value(stringLiteral, parameter.DataType);
        if (parameter is OpenTestSystem.Otx.Runtime.Api.Otx.IProcedureInParameter)
        {
            (parameter as OpenTestSystem.Otx.Runtime.Api.Otx.IProcedureInParameter).Value = value;
        }
        else if (parameter is OpenTestSystem.Otx.Runtime.Api.Otx.IProcedureInOutParameter)
        {
            (parameter as OpenTestSystem.Otx.Runtime.Api.Otx.IProcedureInOutParameter).Value = value;
        }
 
        // Get value from the parameter and convert it back to a string literal
        // This should be nearly the same as the new string literal set to the Parameter
        return OpenTestSystem.Otx.Runtime.Api.DataTypes.ValueConverter.Value2String(parameter.Value);
    }
    catch (OpenTestSystem.Otx.Runtime.Api.Exceptions.InvalidLiteralException e)
    {
        throw e;
    }
}
 
OpenTestSystem.Otx.Runtime.Api.DataTypes.Structure CreatePersonStructureWithValueConverter()
{
    // Structure: Person{Name, Age}
    // Name: String
    // Age: Integer
    // Structure Person is locate inside Document1 in Package1
 
    String structureDataType = "Package1.Document1.Person<String, Integer>";
    String structureLiteral = "{Name=\"Chris\",Age=25}";
 
    // Use ValueConverter.String2Value to convert the string literal
    // then cast the result from Object back to OpenTestSystem.Otx.Runtime.Api.DataTypes.Structure
    OpenTestSystem.Otx.Runtime.Api.DataTypes.Structure person1 = OpenTestSystem.Otx.Runtime.Api.DataTypes.ValueConverter.String2Value(structureLiteral, structureDataType) as OpenTestSystem.Otx.Runtime.Api.DataTypes.Structure;
 
    return person1;
}
 
void ChangePersonStructure(OpenTestSystem.Otx.Runtime.Api.Otx.IProcedureInParameter inParameter)
{
    // Structure: Person{Name, Age}
    // Name: String
    // Age: Integer
    // Structure Person is locate inside Document1 in Package1
 
    // Assume that the given inParameter datatype is Person Structure
    // and default value is Person{Name="Chris",Age=25}
    OpenTestSystem.Otx.Runtime.Api.DataTypes.Structure chris = inParameter.Value as OpenTestSystem.Otx.Runtime.Api.DataTypes.Structure;
 
    // Get StrutureElements from Structure chris
    // This Collection should contains only 2 values (Name and Age StructureElement)
    ReadOnlyCollection<OpenTestSystem.Otx.Runtime.Api.DataTypes.StructureElement> chrisInfoCollection = chris.Elements;
 
    List<OpenTestSystem.Otx.Runtime.Api.DataTypes.StructureElement> newChrisInfoCollection = new List<OpenTestSystem.Otx.Runtime.Api.DataTypes.StructureElement>();
    String newNameLiteral = "\"Christopher\"";
    String newAgeLiteral = "40";
 
    foreach (OpenTestSystem.Otx.Runtime.Api.DataTypes.StructureElement info in chrisInfoCollection)
    {
        // Create new StructureElement Name
        if (info.Name == "Name")
        {
            Object newNameValue = OpenTestSystem.Otx.Runtime.Api.DataTypes.ValueConverter.String2Value(newNameLiteral, info.Type);
            OpenTestSystem.Otx.Runtime.Api.DataTypes.StructureElement nameStructureElement = new OpenTestSystem.Otx.Runtime.Api.DataTypes.StructureElement(
                info.Name
                , newNameValue
                , info.Type
            );
            newChrisInfoCollection.Add(nameStructureElement);
        }
        // Create new StructureElement Age
        else if (info.Name == "Age")
        {
            Object newAgeValue = OpenTestSystem.Otx.Runtime.Api.DataTypes.ValueConverter.String2Value(newAgeLiteral, info.Type);
            OpenTestSystem.Otx.Runtime.Api.DataTypes.StructureElement ageStructureElement = new OpenTestSystem.Otx.Runtime.Api.DataTypes.StructureElement(
                info.Name
                , newAgeValue
                , info.Type
            );
            newChrisInfoCollection.Add(ageStructureElement);
        }
    }
 
    // Create new Chris Structure with the new Information
    OpenTestSystem.Otx.Runtime.Api.DataTypes.Structure updatedChrisStructure = new OpenTestSystem.Otx.Runtime.Api.DataTypes.Structure(
        chris.Signature
        , newChrisInfoCollection
    );
}
 
OpenTestSystem.Otx.Runtime.Api.DataTypes.EnumerationElement CreateColorEnumerationWithValueConverter()
{
    // EnumerationSignature name: Color
    // EnumerationElements in Color: Red, Green, Blue
    // EnumerationSignature Color is locate inside Document1 in Package1
 
    String enumerationDataType = "Package1.Document1.Color";
    String enumerationLiteral = "Blue";
 
    // Use ValueConverter.String2Value to convert the string literal
    // then cast the result from Object back to OpenTestSystem.Otx.Runtime.Api.DataTypes.EnumerationElement
    // This will only work after the Otx Runtime Api loaded a PTX contains EnumerationSignature Color like above
    OpenTestSystem.Otx.Runtime.Api.DataTypes.EnumerationElement color1 = OpenTestSystem.Otx.Runtime.Api.DataTypes.ValueConverter.String2Value(enumerationLiteral, enumerationDataType) as OpenTestSystem.Otx.Runtime.Api.DataTypes.EnumerationElement; // On success, this will return Color EnumerationElement Blue
 
    return color1;
}
 
void ChangeColorEnumerationElement(OpenTestSystem.Otx.Runtime.Api.Otx.IProcedureInParameter inParameter)
{
    // EnumerationSignature name: Color
    // EnumerationElements in Color: Red, Green, Blue
    // EnumerationSignature Color is locate inside Document1 in Package1
 
    // Assume that the given inParameter datatype is EnumerationElement from Color EnumerationSignature
    // and the default Color is Red
    OpenTestSystem.Otx.Runtime.Api.DataTypes.EnumerationElement redColor = inParameter.Value as OpenTestSystem.Otx.Runtime.Api.DataTypes.EnumerationElement;
 
    OpenTestSystem.Otx.Runtime.Api.Otx.Signatures.IEnumerationSignature colorEnumeration = redColor.Enumeration;
 
    // Get all Color EnumerationElements
    List<OpenTestSystem.Otx.Runtime.Api.DataTypes.EnumerationElement> colors = colorEnumeration.Elements;
 
    // Get Blue Color EnumerationElement
    OpenTestSystem.Otx.Runtime.Api.DataTypes.EnumerationElement blueColor = colors.First();
    foreach (OpenTestSystem.Otx.Runtime.Api.DataTypes.EnumerationElement color in colors)
    {
        if (color.Name == "Blue")
        {
            blueColor = color;
            break;
        }
    }
 
    // Set Blue Color into inParameter
    inParameter.Value = blueColor;
}
 
void ChangeLocationPropertyOfResourceLocation(OpenTestSystem.Otx.Runtime.Api.Otx.IProcedureInParameter inParameter)
{
    // Assume that the given inParameter datatype is ResourceLocation
    // and the default ID is "ID_1" and Location is "current/path/to/resource"
    OpenTestSystem.Otx.Runtime.Api.DataTypes.ResourceLocation resourceLocation = inParameter.Value as OpenTestSystem.Otx.Runtime.Api.DataTypes.ResourceLocation;
 
    // Update ResourceLocation
    // Since this is a reference to the ResourceLocaiton inside inParameter
    // , the ResourceLocation's Location should also be updated, inParameter.Value does not need to be set again
    resourceLocation.Location = "new/path/to/resource";
}
 
void CreateNewResourceLocationWithResourceLocationConstructor(OpenTestSystem.Otx.Runtime.Api.Otx.IProcedureInParameter inParameter)
{
    String id = "Logo";
    String location = "/home/chris/pictures/myLogo.ico";
 
    OpenTestSystem.Otx.Runtime.Api.DataTypes.ResourceLocation logoResource = new OpenTestSystem.Otx.Runtime.Api.DataTypes.ResourceLocation(id, location);
 
    // Assume that the given inParameter datatype is ResourceLocation
    inParameter.Value = logoResource;
}

The documentation for this class was generated from the following file:

ValueConverter.java

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ String2Value()

◆ Value2String()