RemoteExporter (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.support
Class RemoteExporter

java.lang.Object
  org.springframework.remoting.support.RemoteExporter

Direct Known Subclasses:: BurlapServiceExporter, HessianServiceExporter, RemoteInvocationBasedExporter

public abstract class RemoteExporter
extends Object
extends Object

Abstract base class for classes that export a remote service. Provides "service" and "serviceInterface" bean properties.

Note that the service interface being used will show some signs of remotability, like the granularity of method calls that it offers. Furthermore, it has to have serializable arguments etc.

Since:: 26.12.2003
Author:: Juergen Hoeller

Field Summary

protected Log logger
          Logger, available to subclasses.

Constructor Summary

RemoteExporter()


Method Summary

protected void checkService()
          Check whether the service reference has been set.

protected void checkServiceInterface()
          Check whether a service reference has been set, and whether it matches the specified service.

protected String getExporterName()
          Return a short name for this exporter.

protected Object getProxyForService()
          Get a proxy for the given service object, implementing the specified service interface.

protected Object getService()
          Return the service to export.

protected Class getServiceInterface()
          Return the interface of the service to export.

protected boolean isRegisterTraceInterceptor()
          Return whether to register a RemoteInvocationTraceInterceptor for exported services.

void setRegisterTraceInterceptor(boolean registerTraceInterceptor)
          Set whether to register a RemoteInvocationTraceInterceptor for exported services.

void setService(Object service)
          Set the service to export.

void setServiceInterface(Class serviceInterface)
          Set the interface of the service to export.

Methods inherited from class java.lang.Object

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

Field Summary
`protected Log`	`logger` Logger, available to subclasses.

Constructor Summary
`RemoteExporter()`

Method Summary
`protected void`	`checkService()` Check whether the service reference has been set.
`protected void`	`checkServiceInterface()` Check whether a service reference has been set, and whether it matches the specified service.
`protected String`	`getExporterName()` Return a short name for this exporter.
`protected Object`	`getProxyForService()` Get a proxy for the given service object, implementing the specified service interface.
`protected Object`	`getService()` Return the service to export.
`protected Class`	`getServiceInterface()` Return the interface of the service to export.
`protected boolean`	`isRegisterTraceInterceptor()` Return whether to register a RemoteInvocationTraceInterceptor for exported services.
`void`	`setRegisterTraceInterceptor(boolean registerTraceInterceptor)` Set whether to register a RemoteInvocationTraceInterceptor for exported services.
`void`	`setService(Object service)` Set the service to export.
`void`	`setServiceInterface(Class serviceInterface)` Set the interface of the service to export.

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

Field Detail

logger

protected final Log logger

Logger, available to subclasses.

Constructor Detail

RemoteExporter

public RemoteExporter()

Method Detail

setService

public void setService(Object service)

Set the service to export. Typically populated via a bean reference.

getService

protected Object getService()

Return the service to export.

setServiceInterface

public void setServiceInterface(Class serviceInterface)

Set the interface of the service to export. The interface must be suitable for the particular service and remoting tool.

getServiceInterface

protected Class getServiceInterface()

Return the interface of the service to export.

setRegisterTraceInterceptor

public void setRegisterTraceInterceptor(boolean registerTraceInterceptor)

Set whether to register a RemoteInvocationTraceInterceptor for exported services. Only applied when a subclass uses getProxyForService for creating the proxy to expose.

Default is "true". RemoteInvocationTraceInterceptor's most important value is that it logs exception stacktraces on the server, before propagating an exception to the client.

See Also:: getProxyForService(), RemoteInvocationTraceInterceptor

isRegisterTraceInterceptor

protected boolean isRegisterTraceInterceptor()

Return whether to register a RemoteInvocationTraceInterceptor for exported services.

checkService

protected void checkService()
                     throws IllegalArgumentException

Check whether the service reference has been set.

Throws:: IllegalArgumentException
See Also:: setService(java.lang.Object)

checkServiceInterface

protected void checkServiceInterface()
                              throws IllegalArgumentException

Check whether a service reference has been set, and whether it matches the specified service.

Throws:: IllegalArgumentException
See Also:: setServiceInterface(java.lang.Class), setService(java.lang.Object)

getProxyForService

protected Object getProxyForService()

Get a proxy for the given service object, implementing the specified service interface.

Used to export a proxy that does not expose any internals but just a specific interface intended for remote access. Furthermore, a RemoteInvocationTraceInterceptor gets registered (by default).

Returns:: the proxy
See Also:: setServiceInterface(java.lang.Class), setRegisterTraceInterceptor(boolean), RemoteInvocationTraceInterceptor

getExporterName

protected String getExporterName()

Return a short name for this exporter. Used for tracing of remote invocations.

Default is the unqualified class name (without package). Can be overridden in subclasses.

See Also:: getProxyForService(), RemoteInvocationTraceInterceptor, ClassUtils.getShortName(java.lang.String)