SSO Constraints |
DEVELOPER |
SSOs are subject to the following constraints:
-
SSO nicknames and tag names are case sensitive.
-
SSO nicknames are limited to 32 characters in length.
-
SSO tag names are limited to 32 characters in length.
-
An SSO nickname and an ActiveX nickname can have identical names.
-
'char' and 'string' data types are subject to character-set conversion which is dependent on the JAVA_CHARSET setting in the pro4v[n].ini file.
PROIV Behaviour
-
'static' data is shared between all SSOs of the same type in a single Client session.
-
Parameters provided in an interface map for an SSO method call is always direction 'input'.
-
SSO parameters for PROIV function calls, can only be direction 'input' in interface maps. This is the same as current PROIV support for ActiveX controls.
-
Type checking is preserved for SSO method calls. For example, the following will not build successfully if the signature for getintValue() indicates that the method call returns a PROIV numeric:
$S = tagname.getintvalue()
Properties
-
SSO method and property names are case sensitive. This differs from ActiveX Controls for which event, method, and property names are case insensitive.
-
SSO method and property names are truncated to 32 characters in length.
-
Properties must be 'public' and of the Simple-Alpha-Numeric data type. Simple-Alpha-Numeric data type includes all the basic data types (boolean, byte, char, short, int, long, float, and double), as well as the java.lang.String.
-
Attempting to set a property declared as 'final' results in a java.lang.IllegalAccessException exception.
Methods
-
SSO methods return one of the following types:
-
Basic types: Boolean, byte, char, double, float, int, long and short.
-
Objects e.g. java.lang.String or java.lang.Integer
-
void
-
Methods must be 'public', not 'abstract' or 'overloaded', and the parameters must be of the Simple-Alpha-Numeric data type. The return type can be any non-array data type, but objects are converted to strings via the toString() method.
-
Some classes provide methods with the same method name, but differing parameter types. This is not supported.
-
Java does not support methods with the same method name, but differing return data type.
-
No support is provided for array handling with PROIV SSO methods. For example, arrays cannot be supplied as parameters to an SSO method. Also, SSO method calls cannot return arrays.
-
There is only support for numeric and alphanumeric parameters to SSO methods. This is the same as current PROIV support for ActiveX controls.
Topic ID: 500569