• root
• java
• j2se
• 1.6
• javax.management.remote.rmi
• RMIServerImpl

Methods

• RMIServerImpltop

  public RMIServerImpl(Map<?> env)

  Constructs a new RMIServerImpl.

  Parameters:

  @param env the environment containing attributes for the new RMIServerImpl. Can be null, which is equivalent to an empty Map.

  Related Links:

  Google Code Search

  Stack Overflow

• clientClosedtop

  protected void clientClosed(RMIConnection client) throws IOException

  Method called when a client connection created by makeClient is closed. A subclass that defines makeClient must arrange for this method to be called when the resultant object's close method is called. This enables it to be removed from the RMIServerImpl's list of connections. It is not an error for client not to be in that list.

  After removing client from the list of connections, this method calls closeClient(client).

  Parameters:

  @param client the client connection that has been closed.

  Exceptions:

  @exception IOException if javax.management.remote.rmi.RMIServerImpl.closeClient(javax.management.remote.rmi.RMIConnection) throws this exception.

  @exception NullPointerException if client is null.

  Related Links:

  Google Code Search

  Stack Overflow

• closetop

  public synchronized void close() throws IOException

  Closes this connection server. This method first calls the javax.management.remote.rmi.RMIServerImpl.closeServer() method so that no new client connections will be accepted. Then, for each remaining javax.management.remote.rmi.RMIConnection object returned by makeClient, its close method is called.

  The behavior when this method is called more than once is unspecified.

  If javax.management.remote.rmi.RMIServerImpl.closeServer() throws an IOException, the individual connections are nevertheless closed, and then the IOException is thrown from this method.

  If javax.management.remote.rmi.RMIServerImpl.closeServer() returns normally but one or more of the individual connections throws an IOException, then, after closing all the connections, one of those IOExceptions is thrown from this method. If more than one connection throws an IOException, it is unspecified which one is thrown from this method.

  Exceptions:

  @exception IOException if javax.management.remote.rmi.RMIServerImpl.closeServer() or one of the javax.management.remote.rmi.RMIConnection.close() calls threw IOException.

  Specified by:

  close from Closeable

  Related Links:

  Google Code Search

  Stack Overflow

• closeClienttop

  abstract protected void closeClient(RMIConnection client) throws IOException

  Closes a client connection made by makeClient.

  Parameters:

  @param client a connection previously returned by makeClient on which the closeClient method has not previously been called. The behavior is unspecified if these conditions are violated, including the case where client is null.

  Exceptions:

  @exception IOException if the client connection cannot be closed.

  Related Links:

  Google Code Search

  Stack Overflow

• closeServertop

  abstract protected void closeServer() throws IOException

  Called by javax.management.remote.rmi.RMIServerImpl.close() to close the connector server. After returning from this method, the connector server must not accept any new connections.

  Exceptions:

  @exception IOException if the attempt to close the connector server failed.

  Related Links:

  Google Code Search

  Stack Overflow

• exporttop

  abstract protected void export() throws IOException

  Exports this RMI object.

  Exceptions:

  @exception IOException if this RMI object cannot be exported.

  Related Links:

  Google Code Search

  Stack Overflow

• getDefaultClassLoadertop

  public synchronized ClassLoader getDefaultClassLoader()

  Gets the default ClassLoader used by this connector server.

  Return:

  @return the default ClassLoader used by this connector server.

  See:

  @see javax.management.remote.rmi.RMIServerImpl.setDefaultClassLoader(java.lang.ClassLoader)

  Related Links:

  Google Code Search

  Stack Overflow

• getMBeanServertop

  public synchronized MBeanServer getMBeanServer()

  The MBeanServer to which this connector server is attached. This is the last value passed to javax.management.remote.rmi.RMIServerImpl.setMBeanServer(javax.management.MBeanServer) on this object, or null if that method has never been called.

  Return:

  @return the MBeanServer to which this connector is attached.

  See:

  @see javax.management.remote.rmi.RMIServerImpl.setMBeanServer(javax.management.MBeanServer)

  Related Links:

  Google Code Search

  Stack Overflow

• getProtocoltop

  abstract protected String getProtocol()

  Returns the protocol string for this object. The string is rmi for RMI/JRMP and iiop for RMI/IIOP.

  Return:

  @return the protocol string for this object.

  Related Links:

  Google Code Search

  Stack Overflow

• getVersiontop

  public String getVersion()

  The version of the RMI Connector Protocol understood by this connector server. This is a string with the following format:

   protocol-version implementation-name
   

  The protocol-version is a series of two or more non-negative integers separated by periods (.). An implementation of the version described by this documentation must use the string 1.0 here.

  After the protocol version there must be a space, followed by the implementation name. The format of the implementation name is unspecified. It is recommended that it include an implementation version number. An implementation can use an empty string as its implementation name, for example for security reasons.

  Return:

  @return a string with the format described here.

  Specified by:

  getVersion from RMIServer

  Related Links:

  Google Code Search

  Stack Overflow

• makeClienttop

  abstract protected RMIConnection makeClient(String connectionId, Subject subject) throws IOException

  Creates a new client connection. This method is called by the public method javax.management.remote.rmi.RMIServerImpl.newClient(java.lang.Object).

  Parameters:

  @param connectionId the ID of the new connection. Every connection opened by this connector server will have a different ID. The behavior is unspecified if this parameter is null.

  @param subject the authenticated subject. Can be null.

  Return:

  @return the newly-created RMIConnection.

  Exceptions:

  @exception IOException if the new client object cannot be created or exported.

  Related Links:

  Google Code Search

  Stack Overflow

• newClienttop

  public RMIConnection newClient(Object credentials) throws IOException

  Creates a new client connection. This method calls makeClient and adds the returned client connection object to an internal list. When this RMIServerImpl is shut down via its javax.management.remote.rmi.RMIServerImpl.close() method, the close() method of each object remaining in the list is called.

  The fact that a client connection object is in this internal list does not prevent it from being garbage collected.

  Parameters:

  @param credentials this object specifies the user-defined credentials to be passed in to the server in order to authenticate the caller before creating the RMIConnection. Can be null.

  Return:

  @return the newly-created RMIConnection. This is usually the object created by makeClient, though an implementation may choose to wrap that object in another object implementing RMIConnection.

  Exceptions:

  @exception IOException if the new client object cannot be created or exported.

  @exception SecurityException if the given credentials do not allow the server to authenticate the user successfully.

  @exception IllegalStateException if javax.management.remote.rmi.RMIServerImpl.getMBeanServer() is null.

  Specified by:

  newClient from RMIServer

  Related Links:

  Google Code Search

  Stack Overflow

• setDefaultClassLoadertop

  public synchronized void setDefaultClassLoader(ClassLoader cl)

  Sets the default ClassLoader for this connector server. New client connections will use this classloader. Existing client connections are unaffected.

  Parameters:

  @param cl the new ClassLoader to be used by this connector server.

  See:

  @see javax.management.remote.rmi.RMIServerImpl.getDefaultClassLoader()

  Related Links:

  Google Code Search

  Stack Overflow

• setMBeanServertop

  public synchronized void setMBeanServer(MBeanServer mbs)

  Sets the MBeanServer to which this connector server is attached. New client connections will interact with this MBeanServer. Existing client connections are unaffected.

  Parameters:

  @param mbs the new MBeanServer. Can be null, but new client connections will be refused as long as it is.

  See:

  @see javax.management.remote.rmi.RMIServerImpl.getMBeanServer()

  Related Links:

  Google Code Search

  Stack Overflow

• toStubtop

  public abstract Remote toStub() throws IOException
  Returns a remotable stub for this server object.

  Return:

  @return a remotable stub.

  Exceptions:

  @exception IOException if the stub cannot be obtained - e.g the RMIServerImpl has not been exported yet.

  Related Links:

  Google Code Search

  Stack Overflow