The Spring Framework

## org.springframework.remoting.rmi
Class JndiRmiServiceExporter

    java.lang.Object
      org.springframework.remoting.support.RemotingSupport
          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

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.RemotingSupport
`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, setRegisterTraceInterceptor, setService, setServiceInterface`

Methods inherited from class org.springframework.remoting.support.RemotingSupport
`getBeanClassLoader, overrideThreadContextClassLoader, resetThreadContextClassLoader, setBeanClassLoader`

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`

The Spring Framework

Copyright © 2002-2008 The Spring Framework.