public abstract class XmlRpcKit
extends java.lang.Object
Modifier and Type | Class and Description |
---|---|
private static class |
XmlRpcKit.AvailableKit
XmlRpcKit implementation which is available.
|
private static class |
XmlRpcKit.UnavailableKit
XmlRpcKit implementation which always returns false from isAvailable
and throws exceptions from getServer/Client factory methods.
|
Modifier and Type | Field and Description |
---|---|
static XmlRpcKit |
APACHE
Implementation based on Apache XML-RPC.
|
private static XmlRpcKit |
defaultInstance_ |
static java.lang.String |
IMPL_PROP
Property which is examined to determine which implementation to use
by default.
|
static XmlRpcKit |
INTERNAL
Implementation which requires no external libraries.
|
static XmlRpcKit[] |
KNOWN_IMPLS
Array of available known implementations of this class.
|
private static java.util.logging.Logger |
logger_ |
static XmlRpcKit |
RPC_LOGGING
Internal implementation variant with verbose logging of RPC calls.
|
static XmlRpcKit |
XML_LOGGING
Internal implementation variant with verbose logging of XML I/O.
|
Constructor and Description |
---|
XmlRpcKit() |
Modifier and Type | Method and Description |
---|---|
private static XmlRpcKit |
createApacheKit(java.lang.String name)
Returns an available or unavailable XmlRpcKit based on Apache XML-RPC
version 1.2.
|
private static XmlRpcKit |
createDefaultInstance()
Constructs the default instance of this class based on system property
and class availability.
|
static XmlRpcKit |
createReflectionKit(java.lang.String name,
java.lang.String clientFactoryClassName,
java.lang.String serverFactoryClassName)
Returns a new XmlRpcKit given classnames for the client and server
factory classes.
|
abstract SampXmlRpcClientFactory |
getClientFactory()
Returns an XML-RPC client factory.
|
static XmlRpcKit |
getInstance()
Returns the default instance of this class.
|
static XmlRpcKit |
getInstanceByName(java.lang.String name)
Returns an XmlRpcKit instance given its name.
|
abstract java.lang.String |
getName()
Returns the name of this kit.
|
abstract SampXmlRpcServerFactory |
getServerFactory()
Returns an XML-RPC server factory.
|
abstract boolean |
isAvailable()
Indicates whether this object is ready for use.
|
public static final XmlRpcKit APACHE
public static final XmlRpcKit INTERNAL
public static final XmlRpcKit XML_LOGGING
public static final XmlRpcKit RPC_LOGGING
public static XmlRpcKit[] KNOWN_IMPLS
public static final java.lang.String IMPL_PROP
KNOWN_IMPLS
, currently:
XmlRpcKit
and has a no-arg constructor.
The property name is "jsamp.xmlrpc.impl".private static XmlRpcKit defaultInstance_
private static java.util.logging.Logger logger_
public abstract SampXmlRpcClientFactory getClientFactory()
public abstract SampXmlRpcServerFactory getServerFactory()
public abstract boolean isAvailable()
getClientFactory()
and getServerFactory()
may throw exceptions rather than behaving as documented.public abstract java.lang.String getName()
public static XmlRpcKit getInstance()
IMPL_PROP
is set this
will determine the implementation used. It may be one of:
apache
: implementation based on the
Apache XML-RPC libraryinternal
: implementation which requires no libraries
beyond JSAMP itselfpublic static XmlRpcKit getInstanceByName(java.lang.String name)
name
- name of one of the known implementations, or classname
of an XmlRpcKit implementatation with a no-arg
constructorjava.lang.IllegalArgumentException
- if none by that name can be foundprivate static XmlRpcKit createDefaultInstance()
getInstance()
public static XmlRpcKit createReflectionKit(java.lang.String name, java.lang.String clientFactoryClassName, java.lang.String serverFactoryClassName)
isAvailable()
()=false will be returned.name
- kit nameclientFactoryClassName
- name of class implementing
SampXmlRpcClientFactory which has a no-arg constructorserverFactoryClassName
- name of class implementing
SampXmlRpcServerFactory which has a no-arg constructorprivate static XmlRpcKit createApacheKit(java.lang.String name)
name
- kit name