public class CASActionOptions extends java.lang.Object implements java.io.Serializable, KeyedMap<java.lang.String,java.lang.Object>
Modifier and Type | Class and Description |
---|---|
static interface |
CASActionOptions.EnumValue |
static class |
CASActionOptions.FORMAT
Defines the various formats for the toString method.
|
Modifier and Type | Field and Description |
---|---|
static int |
FLAGS_EXPAND_ARRAYS
Causes CASTable array columns to be expanded.
|
static int |
FLAGS_IGNORE_DISPOSITION_ERROR
A disposition error causes an exception to be thrown.
|
static int |
FLAGS_RETURN_RESULTS_ON_EXCEPTION
Causes results to be queued and set on the CASException if an error returned
by the action.
|
static int |
FLAGS_SKIP_ACTION_EVENTS
Causes any action events for this action to be skipped
|
static int |
FLAGS_SKIP_RESULTS
Causes CASClient to skip the materialization of results.
|
static java.lang.String |
HIDDEN_PASSWORD |
static java.lang.String |
JSON_NULL |
static java.lang.String |
LUA_NIL |
static int |
PARAMETER_FLAG_ISPASSWORD |
static int |
PARAMETER_FLAG_ISPATH |
static int |
PARAMETER_FLAG_ISTABLENAME |
static int |
PARAMETER_FLAG_ISVAR |
static int |
PARAMETER_FLAG_REQUIRED |
static java.lang.String |
PYTHON_NULL |
static java.lang.String |
SERIALIZED_PREFIX |
Constructor and Description |
---|
CASActionOptions() |
CASActionOptions(CASActionOptions options) |
CASActionOptions(CASClientInterface client) |
CASActionOptions(java.lang.String actionSetName,
java.lang.String actionName) |
Modifier and Type | Method and Description |
---|---|
void |
addActionFlags(int flags) |
void |
addParameterFlag(java.lang.String key,
int flag)
Adds a flag to the given parameter key.
|
protected static void |
appendValue(CASActionOptions.FORMAT format,
java.lang.StringBuffer sb,
com.sas.cas.proto.CASClientProto.Value value) |
protected void |
checkForPasswords(java.util.Map<java.lang.String,java.lang.Object> p) |
void |
clear() |
boolean |
containsKey(java.lang.Object key) |
boolean |
containsValue(java.lang.Object value) |
protected void |
convertToEnumArray(java.lang.String[] a,
java.lang.Object values) |
void |
copy(CASActionOptions options)
Copies the event listeners and handlers from the given options.
|
static CASActionOptions |
deserialize(java.lang.String code)
Attempts to deserialize the given code.
|
java.util.Set<java.util.Map.Entry<java.lang.String,java.lang.Object>> |
entrySet() |
boolean |
equals(java.lang.Object o) |
protected static java.lang.Class<?> |
findOptionsClass(CASActionOptions options) |
protected static java.lang.reflect.Method |
findSetter(java.lang.Class<?> cls,
java.lang.String key) |
java.lang.Object |
get(java.lang.Object key) |
int |
getActionFlags() |
java.lang.String |
getActionName() |
CASActionResponseEventListener |
getActionResponseEventListener() |
CASActionResultEventListener |
getActionResultEventListener() |
java.lang.String |
getActionSetName() |
CASClientInterface |
getCASClient()
Gets the client interface used to invoke this action.
|
protected static java.lang.String |
getClassName(java.lang.Class<?> cls) |
CASDebugOptions |
getDebugOptions() |
CASDispositionEventListener |
getDispositionEventListener() |
java.lang.String |
getFullyQualifiedActionName()
Returns the fully qualified action name, such as "builtins.reflect".
|
CASLogEventListener |
getLogEventListener() |
java.lang.String |
getLogMessage() |
java.io.OutputStream |
getMessageOutputStream() |
CASMessageTagHandler |
getMessageTagHandler(int tag)
Gets a registered message tag handler for the given tag.
|
java.lang.Object |
getParameter(java.lang.String key)
Get the parameter value for the given key.
|
java.lang.Boolean |
getParameterAsBoolean(java.lang.String key)
Gets the parameter value for the given key as a Boolean.
|
byte[] |
getParameterAsByteArray(java.lang.String key) |
java.lang.Double |
getParameterAsDouble(java.lang.String key)
Gets the parameter value for the given key as a Double.
|
java.lang.Double[] |
getParameterAsDoubleArray(java.lang.String key)
Gets the parameter value for the given key as a Double array.
|
java.lang.Integer |
getParameterAsInteger(java.lang.String key)
Gets the parameter value for the given key as an Integer.
|
java.lang.Integer[] |
getParameterAsIntegerArray(java.lang.String key)
Gets the parameter value for the given key as an Integer array.
|
java.lang.Long |
getParameterAsLong(java.lang.String key)
Gets the parameter value for the given key as a Long.
|
java.lang.Long[] |
getParameterAsLongArray(java.lang.String key)
Gets the parameter value for the given key as a Long array.
|
java.lang.String |
getParameterAsString(java.lang.String key)
Gets the parameter value for the given key as a String.
|
java.lang.String[] |
getParameterAsStringArray(java.lang.String key)
Gets the parameter value for the given key as a String array.
|
java.lang.Integer |
getParameterFlags(java.lang.String key)
Returns the parameter flags for the given key.
|
static java.lang.Object |
getParameterIgnoreCase(java.util.Map<java.lang.String,java.lang.Object> map,
java.lang.String key)
Gets the parameter value for the given key.
|
java.lang.Object |
getParameterIgnoreCase(java.lang.String key)
Gets the parameter value for the given key.
|
java.util.Iterator<java.lang.String> |
getParameterKeys()
Returns all of the parameter keys.
|
CASPerformanceEventListener |
getPerformanceEventListener() |
java.lang.String |
getPropertyKey()
Gets the key value for this set of properties.
|
java.lang.Object |
getServerDefaultValue(java.lang.String key)
Gets the server default value, if known.
|
java.lang.String |
getSessionID() |
java.lang.Object |
getUserProperty(java.lang.String key)
Returns the user property associated with the given key.
|
java.util.Iterator<java.lang.String> |
getUserPropertyKeys()
Returns an iterator of user property keys.
|
int |
hashCode() |
CASActionResults<CASValue> |
invoke()
Invokes the CAS action represented by this options object.
|
boolean |
isEmpty() |
boolean |
isFlagSet(int flag) |
protected static boolean |
isMap(java.lang.Class<?> cls) |
protected boolean |
isParameterFlagSet(java.lang.String key,
int flag) |
boolean |
isPassword(java.lang.String key)
Returns true if the given parameter represents a password.
|
boolean |
isPath(java.lang.String key)
Returns true if the given parameter represents a file path.
|
boolean |
isRequired(java.lang.String key)
Returns true if the given parameter is required.
|
boolean |
isTable(java.lang.String key)
Returns true if the given parameter represents a table.
|
boolean |
isVariable(java.lang.String key)
Returns true if the given parameter represents a variable or a variable list.
|
java.util.Set<java.lang.String> |
keySet() |
java.lang.Object |
put(java.lang.String key,
java.lang.Object value) |
void |
putAll(java.util.Map<? extends java.lang.String,? extends java.lang.Object> m) |
void |
putAllDeep(java.util.Map<? extends java.lang.String,? extends java.lang.Object> m)
Performs a deep copy.
|
protected void |
putDeep(java.util.Map<java.lang.String,java.lang.Object> target,
java.util.Map<? extends java.lang.String,? extends java.lang.Object> m) |
protected void |
putDeep(java.util.Map<java.lang.String,java.lang.Object> target,
java.lang.String key,
java.lang.Object value) |
protected java.lang.String |
quoteIfNotNull(java.lang.String s) |
java.lang.Object |
remove(java.lang.Object key) |
java.lang.Object |
removeParameter(java.lang.String key)
Removes an action parameter.
|
static boolean |
set(com.sas.cas.proto.CASClientProto.Value.Builder valueBuilder,
java.lang.String key,
java.lang.Object value)
Sets the appropriate type data on the given ValueBuilder.
|
CASActionOptions |
setActionFlags(int flags)
Sets any flags on the options.
|
CASActionOptions |
setActionName(java.lang.String actionName)
Sets the action name.
|
CASActionOptions |
setActionResponseEventListener(CASActionResponseEventListener responseEventListener)
Sets the response event listener for this action request.
|
CASActionOptions |
setActionResultEventListener(CASActionResultEventListener resultEventListener)
Sets the result event listener for this action request.
|
CASActionOptions |
setActionSetName(java.lang.String actionSetName)
Sets the action set name.
|
CASActionOptions |
setCASClient(CASClientInterface client) |
CASActionOptions |
setDebugOptions(CASDebugOptions debugOptions)
Sets debug options for the given action.
|
CASActionOptions |
setDispositionEventListener(CASDispositionEventListener dispositionEventListener)
Sets the disposition event listener for this action request.
|
CASActionOptions |
setFullyQualifiedActionName(java.lang.String name)
Sets the fully qualified action name, such as "builtins_reflect" or "builtins.reflect".
|
CASActionOptions |
setLogEventListener(CASLogEventListener logEventListener)
Sets the log event listener for this action request.
|
CASActionOptions |
setLogMessage(java.lang.String logMessage)
Sets a message which will be added to the log of the first response.
|
CASActionOptions |
setMessageOutputStream(java.io.OutputStream messageOutputStream)
Sets an output stream that will receive each response message from the action.
|
CASActionOptions |
setMessageTagHandler(int tag,
CASMessageTagHandler handler)
Sets a message tag handler for the given tag.
|
CASActionOptions |
setParameter(java.lang.String key,
java.lang.Object value)
Sets an action parameter.
|
CASActionOptions |
setPerformanceEventListener(CASPerformanceEventListener performanceEventListener)
Sets the performance event listener for this action request.
|
void |
setPropertyKey(java.lang.String key)
Sets the key value for this set of properties.
|
CASActionOptions |
setSessionID(java.lang.String sessionID)
Sets the session ID for this action.
|
CASActionOptions |
setUserProperty(java.lang.String key,
java.lang.Object value)
Sets a user property.
|
int |
size() |
java.lang.String |
toCASLString()
Returns the representation of this action object in CASL format.
|
java.lang.String |
toLuaString()
Returns the representation of this action object in lua format.
|
static java.lang.String |
toLuaString(com.sas.cas.proto.CASClientProto.Request request)
Returns the representation of the given request in lua format.
|
CASActionOptions |
toOptionsWithGeneratedClasses()
This method makes an attempt to convert any maps of key/value pairs into their
corresponding generated classes.
|
protected java.lang.String |
toSerialized(CASActionOptions options)
Serializes the given options to a string representation.
|
java.lang.String |
toString() |
java.lang.String |
toString(CASActionOptions.FORMAT format)
Returns the representation of this action object in the given
format.
|
static java.lang.String |
toString(com.sas.cas.proto.CASClientProto.Request request)
Returns the representation of the given request in string format.
|
protected static java.lang.String |
upcaseFirstChar(java.lang.String s) |
java.util.Collection<java.lang.Object> |
values() |
public static final int FLAGS_SKIP_RESULTS
public static final int FLAGS_EXPAND_ARRAYS
public static final int FLAGS_SKIP_ACTION_EVENTS
public static final int FLAGS_RETURN_RESULTS_ON_EXCEPTION
public static final int FLAGS_IGNORE_DISPOSITION_ERROR
public static final java.lang.String LUA_NIL
public static final java.lang.String JSON_NULL
public static final java.lang.String PYTHON_NULL
public static final java.lang.String HIDDEN_PASSWORD
public static final java.lang.String SERIALIZED_PREFIX
public static final int PARAMETER_FLAG_REQUIRED
public static final int PARAMETER_FLAG_ISTABLENAME
public static final int PARAMETER_FLAG_ISPATH
public static final int PARAMETER_FLAG_ISVAR
public static final int PARAMETER_FLAG_ISPASSWORD
public CASActionOptions()
public CASActionOptions(CASClientInterface client)
public CASActionOptions(java.lang.String actionSetName, java.lang.String actionName)
public CASActionOptions(CASActionOptions options)
public void copy(CASActionOptions options)
options
- The options to copy frompublic java.lang.String getActionSetName()
public CASActionOptions setActionSetName(java.lang.String actionSetName)
actionSetName
- The action set namepublic java.lang.String getActionName()
public CASActionOptions setActionName(java.lang.String actionName)
actionName
- The action namepublic java.lang.String getSessionID()
public CASActionOptions setSessionID(java.lang.String sessionID)
sessionID
- The session IDpublic CASClientInterface getCASClient()
public CASActionOptions setCASClient(CASClientInterface client)
public int getActionFlags()
public CASActionOptions setActionFlags(int flags)
flags
- The flagspublic void addActionFlags(int flags)
public boolean isFlagSet(int flag)
public void addParameterFlag(java.lang.String key, int flag)
key
- The keyflag
- The parameter flagpublic java.lang.Integer getParameterFlags(java.lang.String key)
key
- The keyprotected boolean isParameterFlagSet(java.lang.String key, int flag)
public boolean isRequired(java.lang.String key)
key
- The parameter keypublic boolean isTable(java.lang.String key)
key
- The parameter keypublic boolean isPath(java.lang.String key)
key
- The parameter keypublic boolean isVariable(java.lang.String key)
key
- The parameter keypublic boolean isPassword(java.lang.String key)
key
- The parameter keypublic java.lang.Object getServerDefaultValue(java.lang.String key)
key
- The parameter keypublic CASActionOptions setParameter(java.lang.String key, java.lang.Object value)
key
- The key namevalue
- The valuepublic java.lang.Object removeParameter(java.lang.String key)
key
- The key namepublic java.lang.Object getParameter(java.lang.String key)
key
- The key namepublic java.lang.Object getParameterIgnoreCase(java.lang.String key)
key
- The key namepublic static java.lang.Object getParameterIgnoreCase(java.util.Map<java.lang.String,java.lang.Object> map, java.lang.String key)
map
- The map of keys/valueskey
- The key namepublic java.lang.String getParameterAsString(java.lang.String key)
key
- The key namepublic java.lang.Double getParameterAsDouble(java.lang.String key)
key
- The key namepublic java.lang.Boolean getParameterAsBoolean(java.lang.String key)
key
- The key namepublic java.lang.Integer getParameterAsInteger(java.lang.String key)
key
- The key namepublic java.lang.Long getParameterAsLong(java.lang.String key)
key
- The key namepublic java.lang.String[] getParameterAsStringArray(java.lang.String key)
key
- The key namepublic java.lang.Double[] getParameterAsDoubleArray(java.lang.String key)
key
- The key namepublic java.lang.Integer[] getParameterAsIntegerArray(java.lang.String key)
key
- The key namepublic java.lang.Long[] getParameterAsLongArray(java.lang.String key)
key
- The key namepublic byte[] getParameterAsByteArray(java.lang.String key)
protected void convertToEnumArray(java.lang.String[] a, java.lang.Object values)
public java.util.Iterator<java.lang.String> getParameterKeys()
public CASActionOptions setUserProperty(java.lang.String key, java.lang.Object value)
key
- The property keyvalue
- The property value, or null to remove the keypublic java.lang.Object getUserProperty(java.lang.String key)
key
- The property keypublic java.util.Iterator<java.lang.String> getUserPropertyKeys()
public java.lang.String getFullyQualifiedActionName()
public CASActionOptions setFullyQualifiedActionName(java.lang.String name)
name
- The action namepublic CASDebugOptions getDebugOptions()
public CASActionOptions setDebugOptions(CASDebugOptions debugOptions)
debugOptions
- The debug optionspublic CASLogEventListener getLogEventListener()
public CASActionOptions setLogEventListener(CASLogEventListener logEventListener)
logEventListener
- The log event listener.public CASDispositionEventListener getDispositionEventListener()
public CASActionOptions setDispositionEventListener(CASDispositionEventListener dispositionEventListener)
dispositionEventListener
- The disposition event listenerpublic CASPerformanceEventListener getPerformanceEventListener()
public CASActionOptions setPerformanceEventListener(CASPerformanceEventListener performanceEventListener)
performanceEventListener
- The performance event listenerpublic CASActionResultEventListener getActionResultEventListener()
public CASActionOptions setActionResultEventListener(CASActionResultEventListener resultEventListener)
resultEventListener
- The result event listenerpublic CASActionResponseEventListener getActionResponseEventListener()
public CASActionOptions setActionResponseEventListener(CASActionResponseEventListener responseEventListener)
responseEventListener
- The response event listenerpublic CASActionOptions setMessageTagHandler(int tag, CASMessageTagHandler handler)
tag
- The taghandler
- The handler, or null to removepublic CASMessageTagHandler getMessageTagHandler(int tag)
tag
- The tagpublic java.io.OutputStream getMessageOutputStream()
public CASActionOptions setMessageOutputStream(java.io.OutputStream messageOutputStream)
messageOutputStream
- The output streampublic java.lang.String getLogMessage()
public CASActionOptions setLogMessage(java.lang.String logMessage)
logMessage
- The message, or null for nonepublic CASActionResults<CASValue> invoke() throws CASException, java.io.IOException
The currently active client is either the last client instantiated, the last client to have invoked an action, or the last client to be set as the active client context (setAsActiveClientContext)
CASException
java.io.IOException
public java.lang.String toString()
toString
in class java.lang.Object
public void setPropertyKey(java.lang.String key)
KeyedMap
setPropertyKey
in interface KeyedMap<java.lang.String,java.lang.Object>
key
- The keypublic java.lang.String getPropertyKey()
KeyedMap
getPropertyKey
in interface KeyedMap<java.lang.String,java.lang.Object>
public void clear()
clear
in interface java.util.Map<java.lang.String,java.lang.Object>
public boolean containsKey(java.lang.Object key)
containsKey
in interface java.util.Map<java.lang.String,java.lang.Object>
public boolean containsValue(java.lang.Object value)
containsValue
in interface java.util.Map<java.lang.String,java.lang.Object>
public java.util.Set<java.util.Map.Entry<java.lang.String,java.lang.Object>> entrySet()
entrySet
in interface java.util.Map<java.lang.String,java.lang.Object>
public boolean equals(java.lang.Object o)
equals
in interface java.util.Map<java.lang.String,java.lang.Object>
equals
in class java.lang.Object
public int hashCode()
hashCode
in interface java.util.Map<java.lang.String,java.lang.Object>
hashCode
in class java.lang.Object
public java.lang.Object get(java.lang.Object key)
get
in interface java.util.Map<java.lang.String,java.lang.Object>
public boolean isEmpty()
isEmpty
in interface java.util.Map<java.lang.String,java.lang.Object>
public java.util.Set<java.lang.String> keySet()
keySet
in interface java.util.Map<java.lang.String,java.lang.Object>
public java.lang.Object put(java.lang.String key, java.lang.Object value)
put
in interface java.util.Map<java.lang.String,java.lang.Object>
public void putAll(java.util.Map<? extends java.lang.String,? extends java.lang.Object> m)
putAll
in interface java.util.Map<java.lang.String,java.lang.Object>
public void putAllDeep(java.util.Map<? extends java.lang.String,? extends java.lang.Object> m)
m
- Mappings to be stored in this mapprotected void putDeep(java.util.Map<java.lang.String,java.lang.Object> target, java.util.Map<? extends java.lang.String,? extends java.lang.Object> m)
protected void putDeep(java.util.Map<java.lang.String,java.lang.Object> target, java.lang.String key, java.lang.Object value)
public java.lang.Object remove(java.lang.Object key)
remove
in interface java.util.Map<java.lang.String,java.lang.Object>
public int size()
size
in interface java.util.Map<java.lang.String,java.lang.Object>
public java.util.Collection<java.lang.Object> values()
values
in interface java.util.Map<java.lang.String,java.lang.Object>
public java.lang.String toLuaString()
public java.lang.String toCASLString()
public static java.lang.String toLuaString(com.sas.cas.proto.CASClientProto.Request request)
request
- The requestpublic static java.lang.String toString(com.sas.cas.proto.CASClientProto.Request request)
request
- The requestprotected static void appendValue(CASActionOptions.FORMAT format, java.lang.StringBuffer sb, com.sas.cas.proto.CASClientProto.Value value)
public java.lang.String toString(CASActionOptions.FORMAT format)
format
- The formatprotected java.lang.String toSerialized(CASActionOptions options)
options
- The optionspublic static CASActionOptions deserialize(java.lang.String code)
code
- The codeprotected void checkForPasswords(java.util.Map<java.lang.String,java.lang.Object> p)
protected java.lang.String quoteIfNotNull(java.lang.String s)
protected static java.lang.Class<?> findOptionsClass(CASActionOptions options)
protected static java.lang.String upcaseFirstChar(java.lang.String s)
protected static java.lang.String getClassName(java.lang.Class<?> cls)
protected static java.lang.reflect.Method findSetter(java.lang.Class<?> cls, java.lang.String key)
protected static boolean isMap(java.lang.Class<?> cls)
public static boolean set(com.sas.cas.proto.CASClientProto.Value.Builder valueBuilder, java.lang.String key, java.lang.Object value)
valueBuilder
- The value builderkey
- The value keyvalue
- The raw valuepublic CASActionOptions toOptionsWithGeneratedClasses()