org.apache.xmlrpc.client

クラス XmlRpcClient

java.lang.Object

org.apache.xmlrpc.common.XmlRpcController

org.apache.xmlrpc.client.XmlRpcClient

public class XmlRpcClient
extends org.apache.xmlrpc.common.XmlRpcController

The main access point of an XML-RPC client. This object serves mainly as an object factory. It is designed with singletons in mind: Basically, an application should be able to hold a single instance of XmlRpcClient in a static variable, unless you would be working with different factories.

Until Apache XML-RPC 2.0, this object was used both as an object factory and as a place, where configuration details (server URL, suggested encoding, user credentials and the like) have been stored. In Apache XML-RPC 3.0, the configuration details has been moved to the XmlRpcClientConfig object. The configuration object is designed for being passed through the actual worker methods.

A configured XmlRpcClient object is thread safe: In other words, the suggested use is, that you configure the client using setTransportFactory(XmlRpcTransportFactory) and similar methods, store it in a field and never modify it again. Without modifications, the client may be used for an arbitrary number of concurrent requests.

導入されたバージョン:

3.0

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
XmlRpcClient()

メソッドのサマリー

修飾子とタイプ	メソッドと説明
java.lang.Object	execute(java.lang.String pMethodName, java.util.List pParams) Performs a request with the clients default configuration.
java.lang.Object	execute(java.lang.String pMethodName, java.lang.Object[] pParams) Performs a request with the clients default configuration.
java.lang.Object	execute(XmlRpcClientConfig pConfig, java.lang.String pMethodName, java.util.List pParams) Performs a request with the given configuration.
java.lang.Object	execute(XmlRpcClientConfig pConfig, java.lang.String pMethodName, java.lang.Object[] pParams) Performs a request with the given configuration.
java.lang.Object	execute(org.apache.xmlrpc.XmlRpcRequest pRequest) Performs a request with the clients default configuration.
void	executeAsync(java.lang.String pMethodName, java.util.List pParams, AsyncCallback pCallback) Performs an asynchronous request with the clients default configuration.
void	executeAsync(java.lang.String pMethodName, java.lang.Object[] pParams, AsyncCallback pCallback) Performs an asynchronous request with the clients default configuration.
void	executeAsync(XmlRpcClientConfig pConfig, java.lang.String pMethodName, java.util.List pParams, AsyncCallback pCallback) Performs an asynchronous request with the given configuration.
void	executeAsync(XmlRpcClientConfig pConfig, java.lang.String pMethodName, java.lang.Object[] pParams, AsyncCallback pCallback) Performs an asynchronous request with the given configuration.
void	executeAsync(org.apache.xmlrpc.XmlRpcRequest pRequest, AsyncCallback pCallback) Performs a request with the clients default configuration.
XmlRpcClientConfig	getClientConfig() Returns the clients default configuration.
org.apache.xmlrpc.XmlRpcConfig	getConfig() Returns the clients default configuration.
protected org.apache.xmlrpc.common.XmlRpcWorkerFactory	getDefaultXmlRpcWorkerFactory()
XmlRpcTransportFactory	getTransportFactory() Returns the clients transport factory.
org.apache.xmlrpc.serializer.XmlWriterFactory	getXmlWriterFactory() Returns the clients instance of XmlWriterFactory.
void	setConfig(XmlRpcClientConfig pConfig) Sets the clients default configuration.
void	setTransportFactory(XmlRpcTransportFactory pFactory) Sets the clients transport factory.
void	setXmlWriterFactory(org.apache.xmlrpc.serializer.XmlWriterFactory pFactory) Sets the clients instance of XmlWriterFactory.

クラスから継承されたメソッド org.apache.xmlrpc.common.XmlRpcController

getMaxThreads, getTypeFactory, getWorkerFactory, setMaxThreads, setTypeFactory, setWorkerFactory

クラスから継承されたメソッド java.lang.Object

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

コンストラクタの詳細

XmlRpcClient

public XmlRpcClient()

メソッドの詳細

getDefaultXmlRpcWorkerFactory

protected org.apache.xmlrpc.common.XmlRpcWorkerFactory getDefaultXmlRpcWorkerFactory()

定義:

getDefaultXmlRpcWorkerFactory クラス内 org.apache.xmlrpc.common.XmlRpcController

setConfig

public void setConfig(XmlRpcClientConfig pConfig)

Sets the clients default configuration. This configuration is used by the methods execute(String, List), execute(String, Object[]), and execute(XmlRpcRequest). You may overwrite this per request by using execute(XmlRpcClientConfig, String, List), or execute(XmlRpcClientConfig, String, Object[]).

パラメータ:

pConfig - The default request configuration.

getConfig

public org.apache.xmlrpc.XmlRpcConfig getConfig()

Returns the clients default configuration. This configuration is used by the methods execute(String, List), execute(String, Object[]). You may overwrite this per request by using execute(XmlRpcClientConfig, String, List), or execute(XmlRpcClientConfig, String, Object[]).

定義:

getConfig クラス内 org.apache.xmlrpc.common.XmlRpcController

戻り値:

The default request configuration.

getClientConfig

public XmlRpcClientConfig getClientConfig()

Returns the clients default configuration. Shortcut for (XmlRpcClientConfig) getConfig(). This configuration is used by the methods execute(String, List), execute(String, Object[]). You may overwrite this per request by using execute(XmlRpcClientConfig, String, List), or execute(XmlRpcClientConfig, String, Object[])

戻り値:

The default request configuration.

setTransportFactory

public void setTransportFactory(XmlRpcTransportFactory pFactory)

Sets the clients transport factory. The client will invoke the factory method XmlRpcTransportFactory.getTransport() for any request.

パラメータ:

pFactory - The clients transport factory.

getTransportFactory

public XmlRpcTransportFactory getTransportFactory()

Returns the clients transport factory. The client will use this factory for invocation of XmlRpcTransportFactory.getTransport() for any request.

戻り値:

The clients transport factory.

execute

public java.lang.Object execute(java.lang.String pMethodName,
                                java.lang.Object[] pParams)
                         throws org.apache.xmlrpc.XmlRpcException

Performs a request with the clients default configuration.

パラメータ:

pMethodName - The method being performed.

pParams - The parameters.

戻り値:

The result object.

例外:

org.apache.xmlrpc.XmlRpcException - Performing the request failed.

execute

public java.lang.Object execute(XmlRpcClientConfig pConfig,
                                java.lang.String pMethodName,
                                java.lang.Object[] pParams)
                         throws org.apache.xmlrpc.XmlRpcException

Performs a request with the given configuration.

パラメータ:

pConfig - The request configuration.

pMethodName - The method being performed.

pParams - The parameters.

戻り値:

The result object.

例外:

org.apache.xmlrpc.XmlRpcException - Performing the request failed.

execute

public java.lang.Object execute(java.lang.String pMethodName,
                                java.util.List pParams)
                         throws org.apache.xmlrpc.XmlRpcException

Performs a request with the clients default configuration.

パラメータ:

pMethodName - The method being performed.

pParams - The parameters.

戻り値:

The result object.

例外:

org.apache.xmlrpc.XmlRpcException - Performing the request failed.

execute

public java.lang.Object execute(XmlRpcClientConfig pConfig,
                                java.lang.String pMethodName,
                                java.util.List pParams)
                         throws org.apache.xmlrpc.XmlRpcException

Performs a request with the given configuration.

パラメータ:

pConfig - The request configuration.

pMethodName - The method being performed.

pParams - The parameters.

戻り値:

The result object.

例外:

org.apache.xmlrpc.XmlRpcException - Performing the request failed.

execute

public java.lang.Object execute(org.apache.xmlrpc.XmlRpcRequest pRequest)
                         throws org.apache.xmlrpc.XmlRpcException

Performs a request with the clients default configuration.

パラメータ:

pRequest - The request being performed.

戻り値:

The result object.

例外:

org.apache.xmlrpc.XmlRpcException - Performing the request failed.

executeAsync

public void executeAsync(java.lang.String pMethodName,
                         java.lang.Object[] pParams,
                         AsyncCallback pCallback)
                  throws org.apache.xmlrpc.XmlRpcException

Performs an asynchronous request with the clients default configuration.

パラメータ:

pMethodName - The method being performed.

pParams - The parameters.

pCallback - The callback being notified when the request is finished.

例外:

org.apache.xmlrpc.XmlRpcException - Performing the request failed.

executeAsync

public void executeAsync(XmlRpcClientConfig pConfig,
                         java.lang.String pMethodName,
                         java.lang.Object[] pParams,
                         AsyncCallback pCallback)
                  throws org.apache.xmlrpc.XmlRpcException

Performs an asynchronous request with the given configuration.

パラメータ:

pConfig - The request configuration.

pMethodName - The method being performed.

pParams - The parameters.

pCallback - The callback being notified when the request is finished.

例外:

org.apache.xmlrpc.XmlRpcException - Performing the request failed.

executeAsync

public void executeAsync(java.lang.String pMethodName,
                         java.util.List pParams,
                         AsyncCallback pCallback)
                  throws org.apache.xmlrpc.XmlRpcException

Performs an asynchronous request with the clients default configuration.

パラメータ:

pMethodName - The method being performed.

pParams - The parameters.

pCallback - The callback being notified when the request is finished.

例外:

org.apache.xmlrpc.XmlRpcException - Performing the request failed.

executeAsync

public void executeAsync(XmlRpcClientConfig pConfig,
                         java.lang.String pMethodName,
                         java.util.List pParams,
                         AsyncCallback pCallback)
                  throws org.apache.xmlrpc.XmlRpcException

Performs an asynchronous request with the given configuration.

パラメータ:

pConfig - The request configuration.

pMethodName - The method being performed.

pParams - The parameters.

pCallback - The callback being notified when the request is finished.

例外:

org.apache.xmlrpc.XmlRpcException - Performing the request failed.

executeAsync

public void executeAsync(org.apache.xmlrpc.XmlRpcRequest pRequest,
                         AsyncCallback pCallback)
                  throws org.apache.xmlrpc.XmlRpcException

Performs a request with the clients default configuration.

パラメータ:

pRequest - The request being performed.

pCallback - The callback being notified when the request is finished.

例外:

org.apache.xmlrpc.XmlRpcException - Performing the request failed.

getXmlWriterFactory

public org.apache.xmlrpc.serializer.XmlWriterFactory getXmlWriterFactory()

Returns the clients instance of XmlWriterFactory.

戻り値:

A factory for creating instances of org.apache.ws.commons.serialize.XMLWriter.

setXmlWriterFactory

public void setXmlWriterFactory(org.apache.xmlrpc.serializer.XmlWriterFactory pFactory)

Sets the clients instance of XmlWriterFactory.

パラメータ:

pFactory - A factory for creating instances of org.apache.ws.commons.serialize.XMLWriter.