|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface ParameterServerXmlRpcEndpoint
XML-RPC endpoint for a parameter server.
Method Summary | |
---|---|
java.util.List<java.lang.Object> |
deleteParam(java.lang.String callerId,
java.lang.String key)
Deletes a parameter. |
java.util.List<java.lang.Object> |
getParam(java.lang.String callerId,
java.lang.String key)
Retrieve parameter value from server. |
java.util.List<java.lang.Object> |
getParamNames(java.lang.String callerId)
Gets the list of all parameter names stored on this server. |
java.util.List<java.lang.Object> |
hasParam(java.lang.String callerId,
java.lang.String key)
Check if parameter is stored on server. |
java.util.List<java.lang.Object> |
searchParam(java.lang.String callerId,
java.lang.String key)
Searches for a parameter key on the ParameterServer . |
java.util.List<java.lang.Object> |
setParam(java.lang.String callerId,
java.lang.String key,
java.lang.Boolean value)
Sets a parameter. |
java.util.List<java.lang.Object> |
setParam(java.lang.String callerId,
java.lang.String key,
java.lang.Double value)
|
java.util.List<java.lang.Object> |
setParam(java.lang.String callerId,
java.lang.String key,
java.lang.Integer value)
|
java.util.List<java.lang.Object> |
setParam(java.lang.String callerId,
java.lang.String key,
java.util.List<?> value)
|
java.util.List<java.lang.Object> |
setParam(java.lang.String callerId,
java.lang.String key,
java.util.Map<?,?> value)
|
java.util.List<java.lang.Object> |
setParam(java.lang.String callerId,
java.lang.String key,
java.lang.String value)
|
java.util.List<java.lang.Object> |
subscribeParam(java.lang.String callerId,
java.lang.String callerApi,
java.lang.String key)
Retrieves the parameter value from server and subscribe to updates to that param. |
java.util.List<java.lang.Object> |
unsubscribeParam(java.lang.String callerId,
java.lang.String callerApi,
java.lang.String key)
Unsubscribes from updates to the specified param. |
Method Detail |
---|
java.util.List<java.lang.Object> deleteParam(java.lang.String callerId, java.lang.String key)
callerId
- ROS caller IDkey
- parameter name
java.util.List<java.lang.Object> setParam(java.lang.String callerId, java.lang.String key, java.lang.Boolean value)
NOTE: if value is a dictionary it will be treated as a parameter tree, where key is the parameter namespace. For example {'x':1,'y':2,'sub':{'z':3}} will set key/x=1, key/y=2, and key/sub/z=3. Furthermore, it will replace all existing parameters in the key parameter namespace with the parameters in value. You must set parameters individually if you wish to perform a union update.
callerId
- ROS caller IDkey
- Parameter name.value
- Parameter value.
java.util.List<java.lang.Object> setParam(java.lang.String callerId, java.lang.String key, java.lang.Integer value)
java.util.List<java.lang.Object> setParam(java.lang.String callerId, java.lang.String key, java.lang.Double value)
java.util.List<java.lang.Object> setParam(java.lang.String callerId, java.lang.String key, java.lang.String value)
java.util.List<java.lang.Object> setParam(java.lang.String callerId, java.lang.String key, java.util.List<?> value)
java.util.List<java.lang.Object> setParam(java.lang.String callerId, java.lang.String key, java.util.Map<?,?> value)
java.util.List<java.lang.Object> getParam(java.lang.String callerId, java.lang.String key)
If code is not 1, parameterValue should be ignored. If key is a namespace, the return value will be a dictionary, where each key is a parameter in that namespace. Sub-namespaces are also represented as dictionaries.
callerId
- ROS caller IDkey
- Parameter name. If key is a namespace, getParam() will return a
parameter tree.
java.util.List<java.lang.Object> searchParam(java.lang.String callerId, java.lang.String key)
ParameterServer
.
Search starts in caller's namespace and proceeds upwards through parent namespaces until Parameter Server finds a matching key. searchParam()'s behavior is to search for the first partial match. For example, imagine that there are two 'robot_description' parameters /robot_description /robot_description/arm /robot_description/base /pr2/robot_description /pr2/robot_description/base If I start in the namespace /pr2/foo and search for robot_description, searchParam() will match /pr2/robot_description. If I search for robot_description/arm it will return /pr2/robot_description/arm, even though that parameter does not exist (yet). If code is not 1, foundKey should be ignored.
callerId
- ROS caller IDkey
- Parameter name to search for.
java.util.List<java.lang.Object> subscribeParam(java.lang.String callerId, java.lang.String callerApi, java.lang.String key)
If code is not 1, parameterValue should be ignored. parameterValue is an empty dictionary if the parameter has not been set yet.
callerId
- ROS caller IDcallerApi
- Node API URI of subscriber for paramUpdate callbacks.key
-
java.util.List<java.lang.Object> unsubscribeParam(java.lang.String callerId, java.lang.String callerApi, java.lang.String key)
A return value of zero means that the caller was not subscribed to the parameter.
callerId
- ROS caller IDcallerApi
- Node API URI of subscriberkey
- Parameter name
java.util.List<java.lang.Object> hasParam(java.lang.String callerId, java.lang.String key)
callerId
- ROS caller ID.key
- Parameter name.
true
if the parameter existsjava.util.List<java.lang.Object> getParamNames(java.lang.String callerId)
callerId
- ROS caller ID.
Collection
of parameter names
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |