JaxRpcPortClientInterceptor (Spring Framework) - Spring Framework 1.2.9 API 文档英文版

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.springframework.remoting.jaxrpc
Class JaxRpcPortClientInterceptor

java.lang.Object
  org.springframework.remoting.jaxrpc.LocalJaxRpcServiceFactory
      org.springframework.remoting.jaxrpc.JaxRpcPortClientInterceptor

All Implemented Interfaces:: Advice, Interceptor, MethodInterceptor, InitializingBean

Direct Known Subclasses:: JaxRpcPortProxyFactoryBean

public class JaxRpcPortClientInterceptor
extends LocalJaxRpcServiceFactory
implements MethodInterceptor, InitializingBean
extends LocalJaxRpcServiceFactory
implements MethodInterceptor, InitializingBean

Interceptor for accessing a specific port of a JAX-RPC service. Uses either LocalJaxRpcServiceFactory's facilities underneath, or takes an explicit reference to an existing JAX-RPC Service instance (for example looked up via JndiObjectFactoryBean).

Allows to set JAX-RPC's standard stub properties directly, via the "username", "password", "endpointAddress" and "maintainSession" properties. For typical usage, it is not necessary to specify those.

In standard JAX-RPC style, this invoker is used with an RMI service interface. Alternatively, this invoker can also proxy a JAX-RPC service with a matching non-RMI business interface, that is, an interface that declares the service methods without RemoteExceptions. In the latter case, RemoteExceptions thrown by JAX-RPC will automatically get converted to Spring's unchecked RemoteAccessException.

Setting "serviceInterface" is usually sufficient: The invoker will automatically use JAX-RPC "dynamic invocations" via the Call API in this case, no matter whether the specified interface is an RMI or non-RMI interface. Alternatively, a corresponding JAX-RPC port interface can be specified as "portInterface", which will turn this invoker into "static invocation" mode - operating on a standard JAX-RPC port stub.

Since:: 15.12.2003
Author:: Juergen Hoeller
See Also:: setPortName(java.lang.String), setServiceInterface(java.lang.Class), setPortInterface(java.lang.Class), Service.createCall(javax.xml.namespace.QName), Service.getPort(javax.xml.namespace.QName, java.lang.Class), RemoteAccessException, JndiObjectFactoryBean

Field Summary

Fields inherited from class org.springframework.remoting.jaxrpc.LocalJaxRpcServiceFactory

logger

Constructor Summary

JaxRpcPortClientInterceptor()


Method Summary

void afterPropertiesSet()
          Prepares the JAX-RPC service and port if the "lookupServiceOnStartup" is turned on (which it is by default).

protected boolean alwaysUseJaxRpcCall()
          Return whether to always use JAX-RPC dynamic calls.

Properties getCustomProperties()
          Return custom properties to be set on the stub or call.

String getEndpointAddress()
          Return the endpoint address to specify on the stub or call.

Service getJaxRpcService()
          Return a reference to an existing JAX-RPC Service instance, if any.

String getPassword()
          Return the password to specify on the stub or call.

Class getPortInterface()
          Return the JAX-RPC port interface to use.

String getPortName()
          Return the name of the port.

protected QName getPortQName()
          Return the prepared QName for the port.

protected Remote getPortStub()
          Return the underlying JAX-RPC port stub that this interceptor delegates to for each method invocation on the proxy.

Class getServiceInterface()
          Return the interface of the service that this factory should create a proxy for.

String getUsername()
          Return the username to specify on the stub or call.

Object invoke(MethodInvocation invocation)
          Translates the method invocation into a JAX-RPC service invocation.

boolean isMaintainSession()
          Return the maintain session flag to specify on the stub or call.

protected boolean isPrepared()
          Return whether this client interceptor has already been prepared, i.e. has already looked up the JAX-RPC service and port.

protected Object performJaxRpcCall(MethodInvocation invocation)
          Perform a JAX-RPC dynamic call for the given AOP method invocation.

protected void postProcessJaxRpcCall(Call call, MethodInvocation invocation)
          Post-process the given JAX-RPC call.

protected void postProcessPortStub(Stub stub)
          Post-process the given JAX-RPC port stub.

void prepare()
          Create and initialize the JAX-RPC service for the specified port.

protected void prepareJaxRpcCall(Call call)
          Prepare the given JAX-RPC call, applying properties to it.

protected void preparePortStub(Stub stub)
          Prepare the given JAX-RPC port stub, applying properties to it.

void setCustomProperties(Properties customProperties)
          Set custom properties to be set on the stub or call.

void setEndpointAddress(String endpointAddress)
          Set the endpoint address to specify on the stub or call.

void setJaxRpcService(Service jaxRpcService)
          Set a reference to an existing JAX-RPC Service instance, for example looked up via JndiObjectFactoryBean.

void setLookupServiceOnStartup(boolean lookupServiceOnStartup)
          Set whether to look up the JAX-RPC service on startup.

void setMaintainSession(boolean maintainSession)
          Set the maintain session flag to specify on the stub or call.

void setPassword(String password)
          Set the password to specify on the stub or call.

void setPortInterface(Class portInterface)
          Set the JAX-RPC port interface to use.

void setPortName(String portName)
          Set the name of the port.

void setServiceInterface(Class serviceInterface)
          Set the interface of the service that this factory should create a proxy for.

void setUsername(String username)
          Set the username to specify on the stub or call.

Methods inherited from class org.springframework.remoting.jaxrpc.LocalJaxRpcServiceFactory

createJaxRpcService, createService, createServiceFactory, getJaxRpcServiceInterface, getJaxRpcServiceProperties, getNamespaceUri, getQName, getServiceFactoryClass, getServiceName, getServicePostProcessors, getWsdlDocumentUrl, postProcessJaxRpcService, setJaxRpcServiceInterface, setJaxRpcServiceProperties, setNamespaceUri, setServiceFactoryClass, setServiceName, setServicePostProcessors, setWsdlDocumentUrl

Methods inherited from class java.lang.Object

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

Fields inherited from class org.springframework.remoting.jaxrpc.LocalJaxRpcServiceFactory
`logger`

Constructor Summary
`JaxRpcPortClientInterceptor()`

Method Summary
`void`	`afterPropertiesSet()` Prepares the JAX-RPC service and port if the "lookupServiceOnStartup" is turned on (which it is by default).
`protected boolean`	`alwaysUseJaxRpcCall()` Return whether to always use JAX-RPC dynamic calls.
`Properties`	`getCustomProperties()` Return custom properties to be set on the stub or call.
`String`	`getEndpointAddress()` Return the endpoint address to specify on the stub or call.
`Service`	`getJaxRpcService()` Return a reference to an existing JAX-RPC Service instance, if any.
`String`	`getPassword()` Return the password to specify on the stub or call.
`Class`	`getPortInterface()` Return the JAX-RPC port interface to use.
`String`	`getPortName()` Return the name of the port.
`protected QName`	`getPortQName()` Return the prepared QName for the port.
`protected Remote`	`getPortStub()` Return the underlying JAX-RPC port stub that this interceptor delegates to for each method invocation on the proxy.
`Class`	`getServiceInterface()` Return the interface of the service that this factory should create a proxy for.
`String`	`getUsername()` Return the username to specify on the stub or call.
`Object`	`invoke(MethodInvocation invocation)` Translates the method invocation into a JAX-RPC service invocation.
`boolean`	`isMaintainSession()` Return the maintain session flag to specify on the stub or call.
`protected boolean`	`isPrepared()` Return whether this client interceptor has already been prepared, i.e. has already looked up the JAX-RPC service and port.
`protected Object`	`performJaxRpcCall(MethodInvocation invocation)` Perform a JAX-RPC dynamic call for the given AOP method invocation.
`protected void`	`postProcessJaxRpcCall(Call call, MethodInvocation invocation)` Post-process the given JAX-RPC call.
`protected void`	`postProcessPortStub(Stub stub)` Post-process the given JAX-RPC port stub.
`void`	`prepare()` Create and initialize the JAX-RPC service for the specified port.
`protected void`	`prepareJaxRpcCall(Call call)` Prepare the given JAX-RPC call, applying properties to it.
`protected void`	`preparePortStub(Stub stub)` Prepare the given JAX-RPC port stub, applying properties to it.
`void`	`setCustomProperties(Properties customProperties)` Set custom properties to be set on the stub or call.
`void`	`setEndpointAddress(String endpointAddress)` Set the endpoint address to specify on the stub or call.
`void`	`setJaxRpcService(Service jaxRpcService)` Set a reference to an existing JAX-RPC Service instance, for example looked up via JndiObjectFactoryBean.
`void`	`setLookupServiceOnStartup(boolean lookupServiceOnStartup)` Set whether to look up the JAX-RPC service on startup.
`void`	`setMaintainSession(boolean maintainSession)` Set the maintain session flag to specify on the stub or call.
`void`	`setPassword(String password)` Set the password to specify on the stub or call.
`void`	`setPortInterface(Class portInterface)` Set the JAX-RPC port interface to use.
`void`	`setPortName(String portName)` Set the name of the port.
`void`	`setServiceInterface(Class serviceInterface)` Set the interface of the service that this factory should create a proxy for.
`void`	`setUsername(String username)` Set the username to specify on the stub or call.

Methods inherited from class org.springframework.remoting.jaxrpc.LocalJaxRpcServiceFactory
`createJaxRpcService, createService, createServiceFactory, getJaxRpcServiceInterface, getJaxRpcServiceProperties, getNamespaceUri, getQName, getServiceFactoryClass, getServiceName, getServicePostProcessors, getWsdlDocumentUrl, postProcessJaxRpcService, setJaxRpcServiceInterface, setJaxRpcServiceProperties, setNamespaceUri, setServiceFactoryClass, setServiceName, setServicePostProcessors, setWsdlDocumentUrl`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

JaxRpcPortClientInterceptor

public JaxRpcPortClientInterceptor()

Method Detail

setJaxRpcService

public void setJaxRpcService(Service jaxRpcService)

Set a reference to an existing JAX-RPC Service instance, for example looked up via JndiObjectFactoryBean. If not set, LocalJaxRpcServiceFactory's properties have to be specified.

See Also:: LocalJaxRpcServiceFactory.setServiceFactoryClass(java.lang.Class), LocalJaxRpcServiceFactory.setWsdlDocumentUrl(java.net.URL), LocalJaxRpcServiceFactory.setNamespaceUri(java.lang.String), LocalJaxRpcServiceFactory.setServiceName(java.lang.String), JndiObjectFactoryBean

getJaxRpcService

public Service getJaxRpcService()

Return a reference to an existing JAX-RPC Service instance, if any.

setPortName

public void setPortName(String portName)

Set the name of the port. Corresponds to the "wsdl:port" name.

getPortName

public String getPortName()

Return the name of the port.

setUsername

public void setUsername(String username)

Set the username to specify on the stub or call.

See Also:: Stub.USERNAME_PROPERTY, Call.USERNAME_PROPERTY

getUsername

public String getUsername()

Return the username to specify on the stub or call.

setPassword

public void setPassword(String password)

Set the password to specify on the stub or call.

See Also:: Stub.PASSWORD_PROPERTY, Call.PASSWORD_PROPERTY

getPassword

public String getPassword()

Return the password to specify on the stub or call.

setEndpointAddress

public void setEndpointAddress(String endpointAddress)

Set the endpoint address to specify on the stub or call.

See Also:: Stub.ENDPOINT_ADDRESS_PROPERTY, Call.setTargetEndpointAddress(java.lang.String)

getEndpointAddress

public String getEndpointAddress()

Return the endpoint address to specify on the stub or call.

setMaintainSession

public void setMaintainSession(boolean maintainSession)

Set the maintain session flag to specify on the stub or call.

See Also:: Stub.SESSION_MAINTAIN_PROPERTY, Call.SESSION_MAINTAIN_PROPERTY

isMaintainSession

public boolean isMaintainSession()

Return the maintain session flag to specify on the stub or call.

setCustomProperties

public void setCustomProperties(Properties customProperties)

Set custom properties to be set on the stub or call.

Can be populated with a String "value" (parsed via PropertiesEditor) or a "props" element in XML bean definitions.

See Also:: Stub._setProperty(java.lang.String, java.lang.Object), Call.setProperty(java.lang.String, java.lang.Object)

getCustomProperties

public Properties getCustomProperties()

Return custom properties to be set on the stub or call.

setServiceInterface

public void setServiceInterface(Class serviceInterface)

Set the interface of the service that this factory should create a proxy for. This will typically be a non-RMI business interface, although you can also use an RMI port interface as recommended by JAX-RPC here.

Calls on the specified service interface will either be translated to the underlying RMI port interface (in case of a "portInterface" being specified) or to dynamic calls (using the JAX-RPC Dynamic Invocation Interface).

The dynamic call mechanism has the advantage that you don't need to maintain an RMI port interface in addition to an existing non-RMI business interface. In terms of configuration, specifying the business interface as "serviceInterface" will be enough; this interceptor will automatically use dynamic calls in such a scenario.

See Also:: Service.createCall(javax.xml.namespace.QName), setPortInterface(java.lang.Class)

getServiceInterface

public Class getServiceInterface()

Return the interface of the service that this factory should create a proxy for.

setPortInterface

public void setPortInterface(Class portInterface)

Set the JAX-RPC port interface to use. Only needs to be set if a JAX-RPC port stub should be used instead of the dynamic call mechanism. See the javadoc of the "serviceInterface" property for more details.

The interface must be suitable for a JAX-RPC port, that is, it must be an RMI service interface (that extends java.rmi.Remote).

NOTE: Check whether your JAX-RPC provider returns thread-safe port stubs. If not, use the dynamic call mechanism instead, which will always be thread-safe. In particular, do not use JAX-RPC port stubs with Apache Axis, whose port stubs are known to be non-thread-safe.

See Also:: Service.getPort(javax.xml.namespace.QName, java.lang.Class), Remote, setServiceInterface(java.lang.Class)

getPortInterface

public Class getPortInterface()

Return the JAX-RPC port interface to use.

setLookupServiceOnStartup

public void setLookupServiceOnStartup(boolean lookupServiceOnStartup)

Set whether to look up the JAX-RPC service on startup. Default is "true".

Can be turned off to allow for late start of the target server. In this case, the JAX-RPC service will be fetched on first access.

afterPropertiesSet

public void afterPropertiesSet()
                        throws ServiceException

Prepares the JAX-RPC service and port if the "lookupServiceOnStartup" is turned on (which it is by default).

Specified by:: afterPropertiesSet in interface InitializingBean

Throws:: ServiceException

prepare

public void prepare()
             throws ServiceException

Create and initialize the JAX-RPC service for the specified port.

Prepares a JAX-RPC stub if possible (if an RMI interface is available); falls back to JAX-RPC dynamic calls else. Using dynamic calls can be enforced through overriding alwaysUseJaxRpcCall to return true.

postProcessJaxRpcService and postProcessPortStub hooks are available for customization in subclasses. When using dynamic calls, each can be post-processed via postProcessJaxRpcCall.

Throws:: ServiceException
See Also:: alwaysUseJaxRpcCall(), LocalJaxRpcServiceFactory.postProcessJaxRpcService(javax.xml.rpc.Service), postProcessPortStub(javax.xml.rpc.Stub), postProcessJaxRpcCall(javax.xml.rpc.Call, org.aopalliance.intercept.MethodInvocation)

isPrepared

protected boolean isPrepared()

Return whether this client interceptor has already been prepared, i.e. has already looked up the JAX-RPC service and port.

getPortQName

protected QName getPortQName()

Return the prepared QName for the port.

See Also:: setPortName(java.lang.String), LocalJaxRpcServiceFactory.getQName(java.lang.String)

alwaysUseJaxRpcCall

protected boolean alwaysUseJaxRpcCall()

Return whether to always use JAX-RPC dynamic calls. Called by afterPropertiesSet.

Default is "false"; if an RMI interface is specified as "portInterface" or "serviceInterface", it will be used to create a JAX-RPC port stub.

Can be overridden to enforce the use of the JAX-RPC Call API, for example if there is a need to customize at the Call level. This just necessary if you you want to use an RMI interface as "serviceInterface", though; in case of only a non-RMI interface being available, this interceptor will fall back to the Call API anyway.

See Also:: postProcessJaxRpcCall(javax.xml.rpc.Call, org.aopalliance.intercept.MethodInvocation)

preparePortStub

protected void preparePortStub(Stub stub)

Prepare the given JAX-RPC port stub, applying properties to it. Called by afterPropertiesSet.

Just applied when actually creating a JAX-RPC port stub, in case of a specified JAX-RPC-compliant port interface. Else, JAX-RPC dynamic calls will be used.

Parameters:: stub - the current JAX-RPC port stub
See Also:: afterPropertiesSet(), setUsername(java.lang.String), setPassword(java.lang.String), setEndpointAddress(java.lang.String), setMaintainSession(boolean), setCustomProperties(java.util.Properties), setPortInterface(java.lang.Class), prepareJaxRpcCall(javax.xml.rpc.Call)

postProcessPortStub

protected void postProcessPortStub(Stub stub)

Post-process the given JAX-RPC port stub. Default implementation is empty. Called by prepare.

Just applied when actually creating a JAX-RPC port stub, in case of a specified JAX-RPC-compliant port interface. Else, JAX-RPC dynamic calls will be used.

Parameters:: stub - the current JAX-RPC port stub (can be cast to an implementation-specific class if necessary)
See Also:: prepare(), setPortInterface(java.lang.Class), postProcessJaxRpcCall(javax.xml.rpc.Call, org.aopalliance.intercept.MethodInvocation)

getPortStub

protected Remote getPortStub()

Return the underlying JAX-RPC port stub that this interceptor delegates to for each method invocation on the proxy.

invoke

public Object invoke(MethodInvocation invocation)
              throws Throwable

Translates the method invocation into a JAX-RPC service invocation. Uses traditional RMI stub invocation if a JAX-RPC port stub is available; falls back to JAX-RPC dynamic calls else.

Specified by:: invoke in interface MethodInterceptor

Throws:: Throwable
See Also:: getPortStub(), RmiClientInterceptorUtils, performJaxRpcCall(org.aopalliance.intercept.MethodInvocation)

performJaxRpcCall

protected Object performJaxRpcCall(MethodInvocation invocation)
                            throws Throwable

Perform a JAX-RPC dynamic call for the given AOP method invocation. Delegates to prepareJaxRpcCall and postProcessJaxRpcCall for setting up the call object.

Default implementation uses method name as JAX-RPC operation name and method arguments as arguments for the JAX-RPC call. Can be overridden in subclasses for custom operation names and/or arguments.

Parameters:: invocation - the current AOP MethodInvocation that should be converted to a JAX-RPC call
Returns:: the return value of the invocation, if any
Throws:: Throwable - the exception thrown by the invocation, if any
See Also:: getJaxRpcService(), getPortQName(), prepareJaxRpcCall(javax.xml.rpc.Call), postProcessJaxRpcCall(javax.xml.rpc.Call, org.aopalliance.intercept.MethodInvocation)

prepareJaxRpcCall

protected void prepareJaxRpcCall(Call call)

Prepare the given JAX-RPC call, applying properties to it. Called by invoke.

Just applied when actually using JAX-RPC dynamic calls, i.e. if no JAX-RPC-compliant port interface was specified. Else, a JAX-RPC port stub will be used.

Parameters:: call - the current JAX-RPC call object
See Also:: invoke(org.aopalliance.intercept.MethodInvocation), setUsername(java.lang.String), setPassword(java.lang.String), setEndpointAddress(java.lang.String), setMaintainSession(boolean), setCustomProperties(java.util.Properties), setPortInterface(java.lang.Class), preparePortStub(javax.xml.rpc.Stub)

postProcessJaxRpcCall

protected void postProcessJaxRpcCall(Call call,
                                     MethodInvocation invocation)

Post-process the given JAX-RPC call. Default implementation is empty. Called by invoke.

Just applied when actually using JAX-RPC dynamic calls, i.e. if no JAX-RPC-compliant port interface was specified. Else, a JAX-RPC port stub will be used.

Parameters:: call - the current JAX-RPC call object (can be cast to an implementation-specific class if necessary); invocation - the current AOP MethodInvocation that the call was created for (can be used to check method name, method parameters and/or passed-in arguments)
See Also:: invoke(org.aopalliance.intercept.MethodInvocation), setPortInterface(java.lang.Class), postProcessPortStub(javax.xml.rpc.Stub)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

JaxRpcPortClientInterceptor (Spring Framework) - Spring Framework 1.2.9 API 文档英文版

org.springframework.remoting.jaxrpc Class JaxRpcPortClientInterceptor

JaxRpcPortClientInterceptor

setJaxRpcService

getJaxRpcService

setPortName

getPortName

setUsername

getUsername

setPassword

getPassword

setEndpointAddress

getEndpointAddress

setMaintainSession

isMaintainSession

setCustomProperties

getCustomProperties

setServiceInterface

getServiceInterface

setPortInterface

getPortInterface

setLookupServiceOnStartup

afterPropertiesSet

prepare

isPrepared

getPortQName

alwaysUseJaxRpcCall

preparePortStub

postProcessPortStub

getPortStub

invoke

performJaxRpcCall

prepareJaxRpcCall

postProcessJaxRpcCall

org.springframework.remoting.jaxrpc
Class JaxRpcPortClientInterceptor