public interface SystemProperties
See the
ScriptEnvironment
interface for general background information about this API.
Modifier and Type | Method and Description |
---|---|
java.lang.Object |
getPropertyValue(java.lang.String pathType,
java.lang.String propertyPath)
Returns the value of the specified System Property.
|
void |
setPropertyValue(java.lang.String pathType,
java.lang.String propertyPath,
java.lang.Object newValue)
Sets a new value into the specified System Property.
|
void setPropertyValue(java.lang.String pathType, java.lang.String propertyPath, java.lang.Object newValue) throws ScriptEnvironmentException
Setting and getting of property values is not thread-safe when two or more threads might be accessing the same property value and at least one of the threads is setting the value.
pathType
- Specifies the "starting point" of the path to the
System Property, relative to the context in which the current
Script is playing, as specified for property paths within
"In Situ Substitution Specifications" (ISSEs).
Refer to the separate documentation on ISSEs on
CloudLink.
propertyPath
- The path to the item and System Property that is to be set,
as specified for property paths within "In Situ
Substitution Specifications" (ISSEs).
Refer to the separate documentation on ISSEs on
CloudLink.
newValue
- The new value for the System Property. May be null, or
any of the following objects:
String
Long
Double
Boolean
Date
ArrayList<Object>
, when the System Property accepts
array values. The Object
values can be any of
the objects listed here, including a nested array.LinkedHashMap<String, Object>
, when the System Property
accepts structs. The String
key is the member name.
The Object
values can be any of the objects listed here,
including a nested struct.
Integer
objects are also accepted and will be converted to Long
.
Float
objects are also accepted and will be converted to Double
.
Any other objects will be converted to String
by calling the
toString()
method of the object.
The particular types and ranges of values that are acceptable vary depending upon which System Property is being set.
ScriptEnvironmentException
java.lang.Object getPropertyValue(java.lang.String pathType, java.lang.String propertyPath) throws ScriptEnvironmentException
Setting and getting of property values is not thread-safe when two or more threads might be accessing the same property value and at least one of the threads is setting the value.
pathType
- Specifies the "starting point" of the path to the
System Property, relative to the context in which the current
Script is playing, as specified for property paths within
"In Situ Substitution Specifications" (ISSEs).
Refer to the separate documentation on ISSEs on
CloudLink.
propertyPath
- The path to the item and System Property that is to be accessed,
as specified for property paths within "In Situ
Substitution Specifications" (ISSEs).
Refer to the separate documentation on ISSEs on
CloudLink.
String
Long
Double
Boolean
Date
ArrayList<Object>
, when the System Property
value is an array. The Object
values can be any of
the objects listed here, including a nested array.LinkedHashMap<String, Object>
, when the System Property
value is a struct. The String
key is the member name.
The Object
values can be any of the objects listed here,
including a nested struct.ScriptEnvironmentException