Package | Description |
---|---|
com.thetransactioncompany.jsonrpc2 |
Classes to represent, parse and serialise JSON-RPC 2.0 requests,
notifications and responses.
|
com.thetransactioncompany.jsonrpc2.util |
Utility classes for typed retrieval of JSON-RPC 2.0 request parameters on the
server side.
|
Modifier and Type | Field and Description |
---|---|
static JSONRPC2Error |
JSONRPC2Error.INTERNAL_ERROR
Internal JSON-RPC 2.0 error (-32603).
|
static JSONRPC2Error |
JSONRPC2Error.INVALID_PARAMS
Invalid parameters error (-32602).
|
static JSONRPC2Error |
JSONRPC2Error.INVALID_REQUEST
Invalid JSON-RPC 2.0 request error (-32600).
|
static JSONRPC2Error |
JSONRPC2Error.METHOD_NOT_FOUND
Method not found error (-32601).
|
static JSONRPC2Error |
JSONRPC2Error.PARSE_ERROR
JSON parse error (-32700).
|
Modifier and Type | Method and Description |
---|---|
static JSONRPC2Error |
JSONRPC2Error.appendMessage(JSONRPC2Error err,
java.lang.String apx)
Deprecated.
|
JSONRPC2Error |
JSONRPC2Error.appendMessage(java.lang.String apx)
Appends the specified string to the message of this JSON-RPC 2.0
error.
|
JSONRPC2Error |
JSONRPC2Response.getError()
Gets the error object indicating the cause of the request failure.
|
static JSONRPC2Error |
JSONRPC2Error.setData(JSONRPC2Error err,
java.lang.Object data)
Deprecated.
|
JSONRPC2Error |
JSONRPC2Error.setData(java.lang.Object data)
Sets the specified data to a JSON-RPC 2.0 error.
|
Modifier and Type | Method and Description |
---|---|
static JSONRPC2Error |
JSONRPC2Error.appendMessage(JSONRPC2Error err,
java.lang.String apx)
Deprecated.
|
static JSONRPC2Error |
JSONRPC2Error.setData(JSONRPC2Error err,
java.lang.Object data)
Deprecated.
|
void |
JSONRPC2Response.setError(JSONRPC2Error error)
Indicates a failed JSON-RPC 2.0 request and sets the error details.
|
Constructor and Description |
---|
JSONRPC2Response(JSONRPC2Error error,
java.lang.Object id)
Creates a new JSON-RPC 2.0 response to a failed request.
|
Modifier and Type | Method and Description |
---|---|
void |
PositionalParamsRetriever.ensureParam(int position)
Throws a
JSONRPC2Error.INVALID_PARAMS exception if there is
no parameter at the specified position. |
<T> void |
PositionalParamsRetriever.ensureParam(int position,
java.lang.Class<T> clazz)
Throws a
JSONRPC2Error.INVALID_PARAMS exception if there is
no parameter at the specified position, its value is null ,
or its type doesn't map to the specified. |
<T> void |
PositionalParamsRetriever.ensureParam(int position,
java.lang.Class<T> clazz,
boolean allowNull)
Throws a
JSONRPC2Error.INVALID_PARAMS exception if there is
no parameter at the specified position or its type doesn't map to
the specified. |
void |
NamedParamsRetriever.ensureParam(java.lang.String name)
Throws a
JSONRPC2Error.INVALID_PARAMS exception if there is
no parameter by the specified name. |
<T> void |
NamedParamsRetriever.ensureParam(java.lang.String name,
java.lang.Class<T> clazz)
Throws a
JSONRPC2Error.INVALID_PARAMS exception if there is
no parameter by the specified name, its value is null , or
its type doesn't map to the specified. |
<T> void |
NamedParamsRetriever.ensureParam(java.lang.String name,
java.lang.Class<T> clazz,
boolean allowNull)
Throws a
JSONRPC2Error.INVALID_PARAMS exception if there is
no parameter by the specified name or its type doesn't map to the
specified. |
void |
PositionalParamsRetriever.ensureParameter(int position)
Deprecated.
|
<T> void |
PositionalParamsRetriever.ensureParameter(int position,
java.lang.Class<T> clazz)
Deprecated.
|
<T> void |
PositionalParamsRetriever.ensureParameter(int position,
java.lang.Class<T> clazz,
boolean allowNull)
Deprecated.
|
void |
NamedParamsRetriever.ensureParameter(java.lang.String name)
Deprecated.
|
<T> void |
NamedParamsRetriever.ensureParameter(java.lang.String name,
java.lang.Class<T> clazz)
Deprecated.
|
<T> void |
NamedParamsRetriever.ensureParameter(java.lang.String name,
java.lang.Class<T> clazz,
boolean allowNull)
Deprecated.
|
void |
NamedParamsRetriever.ensureParameters(java.lang.String[] mandatoryNames)
Deprecated.
|
void |
NamedParamsRetriever.ensureParameters(java.lang.String[] mandatoryNames,
java.lang.String[] optionalNames)
Deprecated.
|
void |
NamedParamsRetriever.ensureParams(java.lang.String[] mandatoryNames)
Throws a
JSONRPC2Error.INVALID_PARAMS if the specified
names aren't present in the parameters, or names outside the
specified are contained. |
void |
NamedParamsRetriever.ensureParams(java.lang.String[] mandatoryNames,
java.lang.String[] optionalNames)
Throws a
JSONRPC2Error.INVALID_PARAMS if the specified
mandatory names aren't contained in the parameters, or names outside
the specified mandatory and optional are present. |
java.lang.Object |
PositionalParamsRetriever.get(int position)
Retrieves the specified parameter which can be of any type.
|
<T> T |
PositionalParamsRetriever.get(int position,
java.lang.Class<T> clazz)
Retrieves the specified parameter which must map to the provided
class (use the appropriate wrapper class for primitive types).
|
<T> T |
PositionalParamsRetriever.get(int position,
java.lang.Class<T> clazz,
boolean allowNull)
Retrieves the specified parameter which must map to the provided
class (use the appropriate wrapper class for primitive types).
|
java.lang.Object |
NamedParamsRetriever.get(java.lang.String name)
Retrieves the specified parameter which can be of any type.
|
<T> T |
NamedParamsRetriever.get(java.lang.String name,
java.lang.Class<T> clazz)
Retrieves the specified parameter which must map to the provided
class (use the appropriate wrapper class for primitive types).
|
<T> T |
NamedParamsRetriever.get(java.lang.String name,
java.lang.Class<T> clazz,
boolean allowNull)
Retrieves the specified parameter which must map to the provided
class (use the appropriate wrapper class for primitive types).
|
boolean |
PositionalParamsRetriever.getBoolean(int position)
Retrieves the specified boolean (maps from JSON true/false)
parameter.
|
boolean |
NamedParamsRetriever.getBoolean(java.lang.String name)
Retrieves the specified boolean (maps from JSON true/false)
parameter.
|
double |
PositionalParamsRetriever.getDouble(int position)
Retrieves the specified numeric parameter as a
double . |
double |
NamedParamsRetriever.getDouble(java.lang.String name)
Retrieves the specified numeric parameter as a
double . |
<T extends java.lang.Enum<T>> |
PositionalParamsRetriever.getEnum(int position,
java.lang.Class<T> enumClass)
Retrieves the specified enumerated parameter (from a JSON string
that has a predefined set of possible values).
|
<T extends java.lang.Enum<T>> |
PositionalParamsRetriever.getEnum(int position,
java.lang.Class<T> enumClass,
boolean ignoreCase)
Retrieves the specified enumerated parameter (from a JSON string
that has a predefined set of possible values), allowing for a case
insensitive match.
|
<T extends java.lang.Enum<T>> |
NamedParamsRetriever.getEnum(java.lang.String name,
java.lang.Class<T> enumClass)
Retrieves the specified enumerated parameter (from a JSON string
that has a predefined set of possible values).
|
<T extends java.lang.Enum<T>> |
NamedParamsRetriever.getEnum(java.lang.String name,
java.lang.Class<T> enumClass,
boolean ignoreCase)
Retrieves the specified enumerated parameter (from a JSON string
that has a predefined set of possible values), allowing for a case
insensitive match.
|
java.lang.String |
PositionalParamsRetriever.getEnumString(int position,
java.lang.String[] enumStrings)
Retrieves the specified enumerated string parameter.
|
java.lang.String |
PositionalParamsRetriever.getEnumString(int position,
java.lang.String[] enumStrings,
boolean ignoreCase)
Retrieves the specified enumerated string parameter, allowing for a
case insenstive match.
|
java.lang.String |
NamedParamsRetriever.getEnumString(java.lang.String name,
java.lang.String[] enumStrings)
Retrieves the specified enumerated string parameter.
|
java.lang.String |
NamedParamsRetriever.getEnumString(java.lang.String name,
java.lang.String[] enumStrings,
boolean ignoreCase)
Retrieves the specified enumerated string parameter, allowing for a
case insenstive match.
|
float |
PositionalParamsRetriever.getFloat(int position)
Retrieves the specified numeric parameter as a
float . |
float |
NamedParamsRetriever.getFloat(java.lang.String name)
Retrieves the specified numeric parameter as a
float . |
int |
PositionalParamsRetriever.getInt(int position)
Retrieves the specified numeric parameter as an
int . |
int |
NamedParamsRetriever.getInt(java.lang.String name)
Retrieves the specified numeric parameter as an
int . |
java.util.List<java.lang.Object> |
PositionalParamsRetriever.getList(int position)
Retrieves the specified list (maps from JSON array) parameter.
|
java.util.List<java.lang.Object> |
PositionalParamsRetriever.getList(int position,
boolean allowNull)
Retrieves the specified list (maps from JSON array) parameter.
|
java.util.List<java.lang.Object> |
NamedParamsRetriever.getList(java.lang.String name)
Retrieves the specified list (maps from JSON array) parameter.
|
java.util.List<java.lang.Object> |
NamedParamsRetriever.getList(java.lang.String name,
boolean allowNull)
Retrieves the specified list (maps from JSON array) parameter.
|
long |
PositionalParamsRetriever.getLong(int position)
Retrieves the specified numeric parameter as a
long . |
long |
NamedParamsRetriever.getLong(java.lang.String name)
Retrieves the specified numeric parameter as a
long . |
java.util.Map<java.lang.String,java.lang.Object> |
PositionalParamsRetriever.getMap(int position)
Retrieves the specified map (maps from JSON object) parameter.
|
java.util.Map<java.lang.String,java.lang.Object> |
PositionalParamsRetriever.getMap(int position,
boolean allowNull)
Retrieves the specified map (maps from JSON object) parameter.
|
java.util.Map<java.lang.String,java.lang.Object> |
NamedParamsRetriever.getMap(java.lang.String name)
Retrieves the specified map (maps from JSON object) parameter.
|
java.util.Map<java.lang.String,java.lang.Object> |
NamedParamsRetriever.getMap(java.lang.String name,
boolean allowNull)
Retrieves the specified map (maps from JSON object) parameter.
|
<T> T |
PositionalParamsRetriever.getOpt(int position,
java.lang.Class<T> clazz,
boolean allowNull,
T defaultValue)
Retrieves the specified optional parameter which must map to the
provided class (use the appropriate wrapper class for primitive
types).
|
<T> T |
PositionalParamsRetriever.getOpt(int position,
java.lang.Class<T> clazz,
T defaultValue)
Retrieves the specified optional parameter which must map to the
provided class (use the appropriate wrapper class for primitive
types).
|
<T> T |
NamedParamsRetriever.getOpt(java.lang.String name,
java.lang.Class<T> clazz,
boolean allowNull,
T defaultValue)
Retrieves the specified optional parameter which must map to the
provided class (use the appropriate wrapper class for primitive
types).
|
<T> T |
NamedParamsRetriever.getOpt(java.lang.String name,
java.lang.Class<T> clazz,
T defaultValue)
Retrieves the specified optional parameter which must map to the
provided class (use the appropriate wrapper class for primitive
types).
|
boolean |
PositionalParamsRetriever.getOptBoolean(int position,
boolean defaultValue)
Retrieves the specified optional boolean (maps from JSON true/false)
parameter.
|
boolean |
NamedParamsRetriever.getOptBoolean(java.lang.String name,
boolean defaultValue)
Retrieves the specified optional boolean (maps from JSON true/false)
parameter.
|
double |
PositionalParamsRetriever.getOptDouble(int position,
double defaultValue)
Retrieves the specified optional numeric parameter as a
double . |
double |
NamedParamsRetriever.getOptDouble(java.lang.String name,
double defaultValue)
Retrieves the specified optional numeric parameter as a
double . |
<T extends java.lang.Enum<T>> |
PositionalParamsRetriever.getOptEnum(int position,
java.lang.Class<T> enumClass,
java.lang.String defaultValue)
Retrieves the specified optional enumerated parameter (from a JSON
string that has a predefined set of possible values).
|
<T extends java.lang.Enum<T>> |
PositionalParamsRetriever.getOptEnum(int position,
java.lang.Class<T> enumClass,
java.lang.String defaultValue,
boolean ignoreCase)
Retrieves the specified optional enumerated parameter (from a JSON
string that has a predefined set of possible values), allowing for a
case insenstive match.
|
<T extends java.lang.Enum<T>> |
NamedParamsRetriever.getOptEnum(java.lang.String name,
java.lang.Class<T> enumClass,
T defaultValue)
Retrieves the specified optional enumerated parameter (from a JSON
string that has a predefined set of possible values).
|
<T extends java.lang.Enum<T>> |
NamedParamsRetriever.getOptEnum(java.lang.String name,
java.lang.Class<T> enumClass,
T defaultValue,
boolean ignoreCase)
Retrieves the specified optional enumerated parameter (from a JSON
string that has a predefined set of possible values), allowing for
a case insenstive match.
|
java.lang.String |
PositionalParamsRetriever.getOptEnumString(int position,
java.lang.String[] enumStrings,
java.lang.String defaultValue)
Retrieves the specified optional enumerated string parameter.
|
java.lang.String |
PositionalParamsRetriever.getOptEnumString(int position,
java.lang.String[] enumStrings,
java.lang.String defaultValue,
boolean ignoreCase)
Retrieves the specified optional enumerated string parameter,
allowing for a case insenstive match.
|
java.lang.String |
NamedParamsRetriever.getOptEnumString(java.lang.String name,
java.lang.String[] enumStrings,
java.lang.String defaultValue)
Retrieves the specified optional enumerated string parameter.
|
java.lang.String |
NamedParamsRetriever.getOptEnumString(java.lang.String name,
java.lang.String[] enumStrings,
java.lang.String defaultValue,
boolean ignoreCase)
Retrieves the specified optional enumerated string parameter,
allowing for a case insenstive match.
|
float |
PositionalParamsRetriever.getOptFloat(int position,
float defaultValue)
Retrieves the specified optional numeric parameter as a
float . |
float |
NamedParamsRetriever.getOptFloat(java.lang.String name,
float defaultValue)
Retrieves the specified optional numeric parameter as a
float . |
int |
PositionalParamsRetriever.getOptInt(int position,
int defaultValue)
Retrieves the specified optional numeric parameter as an
int . |
int |
NamedParamsRetriever.getOptInt(java.lang.String name,
int defaultValue)
Retrieves the specified optional numeric parameter as an
int . |
java.util.List<java.lang.Object> |
PositionalParamsRetriever.getOptList(int position,
boolean allowNull,
java.util.List<java.lang.Object> defaultValue)
Retrieves the specified optional list (maps from JSON array)
parameter.
|
java.util.List<java.lang.Object> |
PositionalParamsRetriever.getOptList(int position,
java.util.List<java.lang.Object> defaultValue)
Retrieves the specified optional list (maps from JSON array)
parameter.
|
java.util.List<java.lang.Object> |
NamedParamsRetriever.getOptList(java.lang.String name,
boolean allowNull,
java.util.List<java.lang.Object> defaultValue)
Retrieves the specified optional list (maps from JSON array)
parameter.
|
java.util.List<java.lang.Object> |
NamedParamsRetriever.getOptList(java.lang.String name,
java.util.List<java.lang.Object> defaultValue)
Retrieves the specified optional list (maps from JSON array)
parameter.
|
long |
PositionalParamsRetriever.getOptLong(int position,
long defaultValue)
Retrieves the specified optional numeric parameter as a
long . |
long |
NamedParamsRetriever.getOptLong(java.lang.String name,
long defaultValue)
Retrieves the specified optional numeric parameter as a
long . |
java.util.Map<java.lang.String,java.lang.Object> |
PositionalParamsRetriever.getOptMap(int position,
boolean allowNull,
java.util.Map<java.lang.String,java.lang.Object> defaultValue)
Retrieves the specified optional map (maps from JSON object)
parameter.
|
java.util.Map<java.lang.String,java.lang.Object> |
PositionalParamsRetriever.getOptMap(int position,
java.util.Map<java.lang.String,java.lang.Object> defaultValue)
Retrieves the specified optional map (maps from JSON object)
parameter.
|
java.util.Map<java.lang.String,java.lang.Object> |
NamedParamsRetriever.getOptMap(java.lang.String name,
boolean allowNull,
java.util.Map<java.lang.String,java.lang.Object> defaultValue)
Retrieves the specified optional map (maps from JSON object)
parameter.
|
java.util.Map<java.lang.String,java.lang.Object> |
NamedParamsRetriever.getOptMap(java.lang.String name,
java.util.Map<java.lang.String,java.lang.Object> defaultValue)
Retrieves the specified optional map (maps from JSON object)
parameter.
|
java.lang.String |
PositionalParamsRetriever.getOptString(int position,
boolean allowNull,
java.lang.String defaultValue)
Retrieves the specified optional string parameter.
|
java.lang.String |
PositionalParamsRetriever.getOptString(int position,
java.lang.String defaultValue)
Retrieves the specified optional string parameter.
|
java.lang.String |
NamedParamsRetriever.getOptString(java.lang.String name,
boolean allowNull,
java.lang.String defaultValue)
Retrieves the specified optional string parameter.
|
java.lang.String |
NamedParamsRetriever.getOptString(java.lang.String name,
java.lang.String defaultValue)
Retrieves the specified optional string parameter.
|
java.lang.String[] |
PositionalParamsRetriever.getOptStringArray(int position,
boolean allowNull,
java.lang.String[] defaultValue)
Retrieves the specified optional string array (maps from JSON array
of strings) parameter.
|
java.lang.String[] |
PositionalParamsRetriever.getOptStringArray(int position,
java.lang.String[] defaultValue)
Retrieves the specified optional string array (maps from JSON array
of strings) parameter.
|
java.lang.String[] |
NamedParamsRetriever.getOptStringArray(java.lang.String name,
boolean allowNull,
java.lang.String[] defaultValue)
Retrieves the specified optional string array (maps from JSON array
of strings) parameter.
|
java.lang.String[] |
NamedParamsRetriever.getOptStringArray(java.lang.String name,
java.lang.String[] defaultValue)
Retrieves the specified optional string array (maps from JSON array
of strings) parameter.
|
java.lang.String |
PositionalParamsRetriever.getString(int position)
Retrieves the specified string parameter.
|
java.lang.String |
PositionalParamsRetriever.getString(int position,
boolean allowNull)
Retrieves the specified string parameter.
|
java.lang.String |
NamedParamsRetriever.getString(java.lang.String name)
Retrieves the specified string parameter.
|
java.lang.String |
NamedParamsRetriever.getString(java.lang.String name,
boolean allowNull)
Retrieves the specified string parameter.
|
java.lang.String[] |
PositionalParamsRetriever.getStringArray(int position)
Retrieves the specified string array (maps from JSON array of
strings) parameter.
|
java.lang.String[] |
PositionalParamsRetriever.getStringArray(int position,
boolean allowNull)
Retrieves the specified string array (maps from JSON array of
strings) parameter.
|
java.lang.String[] |
NamedParamsRetriever.getStringArray(java.lang.String name)
Retrieves the specified string array (maps from JSON array of
strings) parameter.
|
java.lang.String[] |
NamedParamsRetriever.getStringArray(java.lang.String name,
boolean allowNull)
Retrieves the specified string array (maps from JSON array of
strings) parameter.
|
Copyright © 2017 The Transaction Company. All Rights Reserved.