javax.rmi
Class PortableRemoteObject
An utility class for RMI/IDL server side object implementations. Server side
implementation objects may inherit from this class, but this is not
mandatory, as the needed methds are static. Server side implementations may
choose to inherit from
ObjectImpl or
Servant instead.
The functionality of methods in this class is forwarded to the enclosed
PortableRemoteObjectDelegate. This delegate can be altered by setting the
system property "javax.rmi.CORBA.PortableRemoteObjectClass" to the name of
the alternative class that must implement
PortableRemoteObjectDelegate.
static void | connect(Remote target, Remote source)-
Makes the remote object
a_target ready for remote
communication using the same communications runtime as for the passed
a_source parameter.
|
static void | exportObject(Remote object)-
Makes a server object ready for remote calls.
|
static Object | narrow(Object object, Class<T> narrowToInstaceOf)- Narrows the passed object to conform to the given interface or IDL type.
|
static Remote | toStub(Remote targetImpl)-
Takes a server implementation object (name pattern *imp) and returns a stub
object that can be used to access that server object (target), name
(pattern _*_Stub).
|
static void | unexportObject(Remote object)- Deregister a currently exported server object from the ORB runtimes.
|
clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait |
connect
public static void connect(Remote target,
Remote source)
throws RemoteException
Makes the remote object
a_target ready for remote
communication using the same communications runtime as for the passed
a_source parameter. The a_target is connected to the same
ORB (and, if applicable, to the same
POA) as the a_source.
exportObject
public static void exportObject(Remote object)
throws RemoteException
Makes a server object ready for remote calls. The subclasses of
PortableRemoteObject do not need to call this method, as it is called by
the constructor.
This method only creates a tie object and caches it for future usage. The
created tie does not have a delegate or an ORB associated.
object - the object to export.
narrow
public static Object narrow(Object object,
Class<T> narrowToInstaceOf)
throws ClassCastException Narrows the passed object to conform to the given interface or IDL type. In
RMI-IIOP, this method replaces the narrow(org.omg.CORBA.Object) method that
was present in the CORBA Helpers. This method frequently returns different
instance and cannot be replaced by the direct cast. The typical narrowing
cases (all supported by GNU Classpath) are:
- A CORBA object (for instance, returned by the
ORB.string_to_object(String) or from the naming service) can be narrowed
into interface, derived from Remote. The method will try to locate an
appropriate Stub by the name pattern (_*_Stub). If the object being
narrowed is connected to an ORB, the returned instance will inherit that
connection, representing the same remote (or local) object, but now with
the possibility to invoke remote methods. - A CORBA object may be directly narrowed into the appropriate
Stub class, if it is and passed as a second parameter. This allows
to use non-standard stubs without parameterless constructors. - Any two classes, derived from the
ObjectImpl (may be Stub's)
can be narrowed one into another (a delegate is transferred). - An implementation of Remote can be narrowed into
Tie that can
later connected to an ORB, making the methods accessible remotely. The
Remote being narrowed normally provides a local implementation, but you can
also narrow remote Stub, creating "forwarding Tie". - null is narrowed into null regardless of the second parameter.
- A
Tie can be narrowed into Remote, representing the
implementation for this Tie (if one is set).
object - the object like CORBA Object, Stub or Remote that must be
narrowed to the given interface.narrowToInstaceOf - the class of the interface to that the object must
be narrowed.
- On success, an object of type narrowTo or null, if narrowFrom =
null.
toStub
public static Remote toStub(Remote targetImpl)
throws NoSuchObjectException
Takes a server implementation object (name pattern *imp) and returns a stub
object that can be used to access that server object (target), name
(pattern _*_Stub).
The returned stub is not connected to any ORB and must be explicitly
connected using
connect(Remote,Remote).
The method signature prevents it from returning stubs that does not
implement Remote (ClassCastException will be thrown).
- a stub object that can be used to access that server object.
NoSuchObjectException - if a stub class cannot be located by supposed
name pattern, or an instance of stub fails to be instantiated.ClassCastException - if the stub class can be located, but it does
not inherit from Remote.BAD_PARAM - if the name of the passed class does not match the
implementation name pattern (does not end by 'Impl').
PortableRemoteObject.java --
Copyright (C) 2004, 2004, 2005 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version.