InvalidJsonType class

Json objects simulate JavaScript untyped variables. However, many Json functions only make sense for specific underlying Json data. For example, the Add function only makes sense if the underlying json object is an Array. If a function applied to a Json object is invalid for the underlying object, an InvalidJsonType exception is thrown.

To create an InvalidjsonType exception yourself, you typically use a SOUL Throw statement with an InvalidJsonType New constructor. This statement must be issued from within a method, and it can only be caught by the code that calls the method. For example, the following statement throws an InvalidJsonType exception:

throw %(invalidJsonType):new(type=array, method="MyJsonMethod")

Remember that you catch an exception with the Catch statement; if an exception condition occurs outside a Catch for it, the request is cancelled.

The InvalidJsonType class, like the Json class is available as of Model 204 7.6.

The InvalidJsonTypes methods

The following are the available InvalidJsonType class methods.

Method	Description
MethodName	Type of object for invalid method
New	Create a new InvalidJsonType object
Type	Type of object for invalid method

The methods in the class are described in the subsections that follow. In addition:

• "Notation conventions for methods" has information about the conventions followed.
• "InvalidJsonType methods syntax" is a single page that contains the syntax diagrams of all the methods in the class.

MethodName property

Type of object for invalid method (InvalidJsonType class)

This ReadOnly property returns a string that indicates the name of the failing method.

Syntax

%string = invalidJsonType:MethodName

Syntax terms

%string	The name of the failing method.
invalidJsonType	A reference to an instance of an InvalidJsonType object.

Type property

Type of object for invalid method (InvalidJsonType class)

This ReadOnly property returns a JsonType enumeration value that indicates the underlying Json object type for the object against which the failing method was applied.

Syntax

%jsonType = invalidJsonType:Type

Syntax terms

%jsonType	The underlying Json object type for the object against which the failing method was applied.
invalidJsonType	A reference to an instance of an InvalidJsonType object.

New constructor

Create a new InvalidJsonType object (InvalidJsonType class)

This Constructor generates an instance of an InvalidJsonType exception. The New method format follows:

Syntax

%invalidJsonType = [%(InvalidJsonType):]New( Type= jsonType, MethodName= string)

Syntax terms

%invalidJsonType	A reference to an instance of an InvalidJsonType object.
[%(InvalidJsonType):]	The class name in parentheses denotes a Constructor.
jsonType	A JsonType enumeration value that indicates the underlying JSON type of the object to which the invalid method was applied.
string	The name of the method that encountered the error.

Usage notes

• Json object tree can be created from data received from an outside data source that was generated via the Json Parse function. If the external data source is considered 100% in terms of sending JSON data with a known format, the data could be extracted without worries about InvalidJsonType exceptions. However, if there is a concern that the data will not be exactly what is expected, one should either test each object for the expected datatype via the Type function or wrap the data extraction inside a Try/Catch InvalidJsonType. Obviously, the latter requires less effort and is more efficient. For example, if an application expects an order to come in as an array of objects with a product name, code, quantity, and price but the source is not 100% trustworthy, one can do something like:

  try for %i from 1 to %order:count %name = %order(%i)("name"):stringValue %code = %order(%i)("code"):stringValue %quantity = %order(%i)("quantity"):numberValue %price = %order(%i)("price"):numberValue ... process the order item end for catch invalidJsonType ... deal with the error end try

  The Try/Catch adds no overhead to the processing but makes it easy to trap a malformed request.