rocks.xmpp.extensions.rpc

Class RpcManager

java.lang.Object

rocks.xmpp.core.session.Manager

rocks.xmpp.core.session.ExtensionManager

rocks.xmpp.extensions.rpc.RpcManager

public final class RpcManager
extends ExtensionManager

This manager allows you to call remote procedures and handle incoming calls, if enabled.

By default this manager is disabled. If you want to support RPC (i.e. handle incoming calls), enable it and set a RPC handler, which allows you to handle incoming calls.

Author:

Christian Schudt

See Also:

XEP-0009: Jabber-RPC

Field Summary

Fields inherited from class rocks.xmpp.core.session.ExtensionManager

features, xmppSession

Method Summary

Modifier and Type	Method and Description
Value	call(rocks.xmpp.core.Jid jid, String methodName, Value... parameters) Calls a remote procedure.
void	setRpcHandler(RpcHandler rpcHandler) Sets the RPC handler, which will handle RPCs.

Methods inherited from class rocks.xmpp.core.session.ExtensionManager

setEnabled

Methods inherited from class rocks.xmpp.core.session.Manager

isEnabled

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

call

public Value call(rocks.xmpp.core.Jid jid,
                  String methodName,
                  Value... parameters)
           throws rocks.xmpp.core.XmppException,
                  RpcException

Calls a remote procedure.

Parameters:

jid - The JID, which will receive the RPC.

methodName - The method name.

parameters - The parameters.

Returns:

The result.

Throws:

NoResponseException - If the entity did not respond.

rocks.xmpp.core.stanza.model.StanzaException - If the RPC returned with an XMPP stanza error.

RpcException - If the RPC returned with an application-level error (<fault/> element).

rocks.xmpp.core.XmppException

setRpcHandler

public void setRpcHandler(RpcHandler rpcHandler)

Sets the RPC handler, which will handle RPCs.

Parameters:

rpcHandler - The RPC handler.