public class

LocalJaxRpcServiceFactory

extends Object
java.lang.Object
   ↳ org.springframework.remoting.jaxrpc.LocalJaxRpcServiceFactory
Known Direct Subclasses
Known Indirect Subclasses

This class is deprecated.
in favor of JAX-WS support in org.springframework.remoting.jaxws

Class Overview

Factory for locally defined JAX-RPC javax.xml.rpc.Service references. Uses a JAX-RPC javax.xml.rpc.ServiceFactory underneath.

Serves as base class for LocalJaxRpcServiceFactoryBean as well as JaxRpcPortClientInterceptor and JaxRpcPortProxyFactoryBean.

See Also

Summary

Fields
protected final Log logger Logger available to subclasses
Public Constructors
LocalJaxRpcServiceFactory()
Public Methods
Service createJaxRpcService()
Create a JAX-RPC Service according to the parameters of this factory.
Class getJaxRpcServiceInterface()
Return the JAX-RPC service interface to use for looking up the service.
Properties getJaxRpcServiceProperties()
Return JAX-RPC service properties to be passed to the ServiceFactory, if any.
String getNamespaceUri()
Return the namespace URI of the service.
ServiceFactory getServiceFactory()
Return the specified ServiceFactory instance, if any.
Class getServiceFactoryClass()
Return the ServiceFactory class to use, or null if default.
String getServiceName()
Return the name of the service.
JaxRpcServicePostProcessor[] getServicePostProcessors()
Return the JaxRpcServicePostProcessors to be applied to JAX-RPC Service instances created by this factory.
URL getWsdlDocumentUrl()
Return the URL of the WSDL document that describes the service.
void setJaxRpcServiceInterface(Class jaxRpcServiceInterface)
Set the JAX-RPC service interface to use for looking up the service.
void setJaxRpcServiceProperties(Properties jaxRpcServiceProperties)
Set JAX-RPC service properties to be passed to the ServiceFactory, if any.
void setNamespaceUri(String namespaceUri)
Set the namespace URI of the service.
void setServiceFactory(ServiceFactory serviceFactory)
Set the ServiceFactory instance to use.
void setServiceFactoryClass(Class serviceFactoryClass)
Set the ServiceFactory class to use, for example "org.apache.axis.client.ServiceFactory".
void setServiceName(String serviceName)
Set the name of the service to look up.
void setServicePostProcessors(JaxRpcServicePostProcessor[] servicePostProcessors)
Set the JaxRpcServicePostProcessors to be applied to JAX-RPC Service instances created by this factory.
void setWsdlDocumentUrl(URL wsdlDocumentUrl)
Set the URL of the WSDL document that describes the service.
Protected Methods
Service createService(ServiceFactory serviceFactory)
Actually create the JAX-RPC Service instance, based on this factory's settings.
ServiceFactory createServiceFactory()
Create a JAX-RPC ServiceFactory, either of the specified class or the default.
QName getQName(String name)
Return a QName for the given name, relative to the namespace URI of this factory, if given.
void postProcessJaxRpcService(Service service)
Post-process the given JAX-RPC Service.
[Expand]
Inherited Methods
From class java.lang.Object

Fields

protected final Log logger

Logger available to subclasses

Public Constructors

public LocalJaxRpcServiceFactory ()

Public Methods

public Service createJaxRpcService ()

Create a JAX-RPC Service according to the parameters of this factory.

Throws
ServiceException
See Also

public Class getJaxRpcServiceInterface ()

Return the JAX-RPC service interface to use for looking up the service.

public Properties getJaxRpcServiceProperties ()

Return JAX-RPC service properties to be passed to the ServiceFactory, if any.

public String getNamespaceUri ()

Return the namespace URI of the service.

public ServiceFactory getServiceFactory ()

Return the specified ServiceFactory instance, if any.

public Class getServiceFactoryClass ()

Return the ServiceFactory class to use, or null if default.

public String getServiceName ()

Return the name of the service.

public JaxRpcServicePostProcessor[] getServicePostProcessors ()

Return the JaxRpcServicePostProcessors to be applied to JAX-RPC Service instances created by this factory.

public URL getWsdlDocumentUrl ()

Return the URL of the WSDL document that describes the service.

public void setJaxRpcServiceInterface (Class jaxRpcServiceInterface)

Set the JAX-RPC service interface to use for looking up the service. If specified, this will override a "serviceName" setting.

The specified interface will usually be a generated JAX-RPC service interface that directly corresponds to the WSDL service declaration. Note that this is not a port interface or the application-level service interface to be exposed by a port proxy!

Only supported by JAX-RPC 1.1 providers.

See Also

public void setJaxRpcServiceProperties (Properties jaxRpcServiceProperties)

Set JAX-RPC service properties to be passed to the ServiceFactory, if any.

Only supported by JAX-RPC 1.1 providers.

See Also

public void setNamespaceUri (String namespaceUri)

Set the namespace URI of the service. Corresponds to the WSDL "targetNamespace".

public void setServiceFactory (ServiceFactory serviceFactory)

Set the ServiceFactory instance to use.

This is an alternative to the common "serviceFactoryClass" property, allowing for a pre-initialized ServiceFactory instance to be specified.

See Also

public void setServiceFactoryClass (Class serviceFactoryClass)

Set the ServiceFactory class to use, for example "org.apache.axis.client.ServiceFactory".

Does not need to be set if the JAX-RPC implementation has registered itself with the JAX-RPC system property "SERVICEFACTORY_PROPERTY".

See Also
  • javax.xml.rpc.ServiceFactory

public void setServiceName (String serviceName)

Set the name of the service to look up. Corresponds to the "wsdl:service" name.

See Also

public void setServicePostProcessors (JaxRpcServicePostProcessor[] servicePostProcessors)

Set the JaxRpcServicePostProcessors to be applied to JAX-RPC Service instances created by this factory.

Such post-processors can, for example, register custom type mappings. They are reusable across all pre-built subclasses of this factory: LocalJaxRpcServiceFactoryBean, JaxRpcPortClientInterceptor, JaxRpcPortProxyFactoryBean.

See Also

public void setWsdlDocumentUrl (URL wsdlDocumentUrl)

Set the URL of the WSDL document that describes the service.

Protected Methods

protected Service createService (ServiceFactory serviceFactory)

Actually create the JAX-RPC Service instance, based on this factory's settings.

Parameters
serviceFactory the JAX-RPC ServiceFactory to use
Returns
  • the newly created JAX-RPC Service
Throws
ServiceException if thrown by JAX-RPC methods
See Also

protected ServiceFactory createServiceFactory ()

Create a JAX-RPC ServiceFactory, either of the specified class or the default.

Throws
ServiceException if thrown by JAX-RPC methods
See Also

protected QName getQName (String name)

Return a QName for the given name, relative to the namespace URI of this factory, if given.

See Also

protected void postProcessJaxRpcService (Service service)

Post-process the given JAX-RPC Service. Called by createJaxRpcService(). Useful, for example, to register custom type mappings.

The default implementation delegates to all registered JaxRpcServicePostProcessors. It is usually preferable to implement custom type mappings etc there rather than in a subclass of this factory, to allow for reuse of the post-processors.

Parameters
service the current JAX-RPC Service (can be cast to an implementation-specific class if necessary)
See Also