JndiRmiServiceExporter (Spring Framework API 2.1) - Spring Framework 2.1.0 API 文档英文版

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

The Spring Framework

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.springframework.remoting.rmi
Class JndiRmiServiceExporter

java.lang.Object
  org.springframework.remoting.support.RemoteExporter
      org.springframework.remoting.support.RemoteInvocationBasedExporter
          org.springframework.remoting.rmi.RmiBasedExporter
              org.springframework.remoting.rmi.JndiRmiServiceExporter

All Implemented Interfaces:: BeanClassLoaderAware, DisposableBean, InitializingBean

public class JndiRmiServiceExporter
extends RmiBasedExporter
implements InitializingBean, DisposableBean
extends RmiBasedExporter
implements InitializingBean, DisposableBean

Service exporter which binds RMI services to JNDI. Typically used for RMI-IIOP (CORBA).

Exports services via the PortableRemoteObject class. You need to run "rmic" with the "-iiop" option to generate corresponding stubs and skeletons for each exported service.

Also supports exposing any non-RMI service via RMI invokers, to be accessed via JndiRmiClientInterceptor / JndiRmiProxyFactoryBean's automatic detection of such invokers.

With an RMI invoker, RMI communication works on the RmiInvocationHandler level, needing only one stub for any service. Service interfaces do not have to extend java.rmi.Remote or throw java.rmi.RemoteException on all methods, but in and out parameters have to be serializable.

The JNDI environment can be specified as "jndiEnvironment" bean property, or be configured in a jndi.properties file or as system properties. For example:

<property name="jndiEnvironment">
         <props>
                 <prop key="java.naming.factory.initial">com.sun.jndi.cosnaming.CNCtxFactory</prop>
                 <prop key="java.naming.provider.url">iiop://localhost:1050</prop>
         </props>
 </property>

Since:: 1.1
Author:: Juergen Hoeller
See Also:: RemoteExporter.setService(java.lang.Object), setJndiTemplate(org.springframework.jndi.JndiTemplate), setJndiEnvironment(java.util.Properties), setJndiName(java.lang.String), JndiRmiClientInterceptor, JndiRmiProxyFactoryBean, PortableRemoteObject.exportObject(java.rmi.Remote)

Field Summary

Fields inherited from class org.springframework.remoting.support.RemoteExporter

logger

Constructor Summary

JndiRmiServiceExporter()


Method Summary

void afterPropertiesSet()
          Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware).

void destroy()
          Unbind the RMI service from JNDI on bean factory shutdown.

void prepare()
          Initialize this service exporter, binding the specified service to JNDI.

void rebind()
          Rebind the specified service to JNDI, for recovering in case of the target registry having been restarted.

void setJndiEnvironment(Properties jndiEnvironment)
          Set the JNDI environment to use for JNDI lookups.

void setJndiName(String jndiName)
          Set the JNDI name of the exported RMI service.

void setJndiTemplate(JndiTemplate jndiTemplate)
          Set the JNDI template to use for JNDI lookups.

Methods inherited from class org.springframework.remoting.rmi.RmiBasedExporter

getObjectToExport, invoke

Methods inherited from class org.springframework.remoting.support.RemoteInvocationBasedExporter

getRemoteInvocationExecutor, invokeAndCreateResult, setRemoteInvocationExecutor

Methods inherited from class org.springframework.remoting.support.RemoteExporter

checkService, checkServiceInterface, getExporterName, getProxyForService, getService, getServiceInterface, isRegisterTraceInterceptor, setBeanClassLoader, setRegisterTraceInterceptor, setService, setServiceInterface

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.support.RemoteExporter
`logger`

Constructor Summary
`JndiRmiServiceExporter()`

Method Summary
`void`	`afterPropertiesSet()` Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware).
`void`	`destroy()` Unbind the RMI service from JNDI on bean factory shutdown.
`void`	`prepare()` Initialize this service exporter, binding the specified service to JNDI.
`void`	`rebind()` Rebind the specified service to JNDI, for recovering in case of the target registry having been restarted.
`void`	`setJndiEnvironment(Properties jndiEnvironment)` Set the JNDI environment to use for JNDI lookups.
`void`	`setJndiName(String jndiName)` Set the JNDI name of the exported RMI service.
`void`	`setJndiTemplate(JndiTemplate jndiTemplate)` Set the JNDI template to use for JNDI lookups.

Methods inherited from class org.springframework.remoting.rmi.RmiBasedExporter
`getObjectToExport, invoke`

Methods inherited from class org.springframework.remoting.support.RemoteInvocationBasedExporter
`getRemoteInvocationExecutor, invokeAndCreateResult, setRemoteInvocationExecutor`

Methods inherited from class org.springframework.remoting.support.RemoteExporter
`checkService, checkServiceInterface, getExporterName, getProxyForService, getService, getServiceInterface, isRegisterTraceInterceptor, setBeanClassLoader, setRegisterTraceInterceptor, setService, setServiceInterface`

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

Constructor Detail

JndiRmiServiceExporter

public JndiRmiServiceExporter()

Method Detail

setJndiTemplate

public void setJndiTemplate(JndiTemplate jndiTemplate)

Set the JNDI template to use for JNDI lookups. You can also specify JNDI environment settings via "jndiEnvironment".

See Also:: setJndiEnvironment(java.util.Properties)

setJndiEnvironment

public void setJndiEnvironment(Properties jndiEnvironment)

Set the JNDI environment to use for JNDI lookups. Creates a JndiTemplate with the given environment settings.

See Also:: setJndiTemplate(org.springframework.jndi.JndiTemplate)

setJndiName

public void setJndiName(String jndiName)

Set the JNDI name of the exported RMI service.

afterPropertiesSet

public void afterPropertiesSet()
                        throws NamingException,
                               RemoteException

Description copied from interface: InitializingBean

Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware).

This method allows the bean instance to perform initialization only possible when all bean properties have been set and to throw an exception in the event of misconfiguration.

Specified by:: afterPropertiesSet in interface InitializingBean

Throws:: NamingException; RemoteException

prepare

public void prepare()
             throws NamingException,
                    RemoteException

Initialize this service exporter, binding the specified service to JNDI.

Throws:: NamingException - if service binding failed; RemoteException - if service export failed

rebind

public void rebind()
            throws NamingException

Rebind the specified service to JNDI, for recovering in case of the target registry having been restarted.

Throws:: NamingException - if service binding failed

destroy

public void destroy()
             throws NamingException,
                    NoSuchObjectException

Unbind the RMI service from JNDI on bean factory shutdown.

Specified by:: destroy in interface DisposableBean

Throws:: NamingException; NoSuchObjectException