J2SE1.3  Overview   Package   Class  Text Changes  Statistics  Help 
Generated by
JDiff
PREV PACKAGE    NEXT PACKAGE          FRAMES    NO FRAMES  

org.omg.CORBA.portable Documentation Differences

This file contains all the changes in documentation in the package org.omg.CORBA.portable as colored differences. Deletions are shown like this, and additions are shown like this.
If no deletions or additions are shown in an entry, the HTML tags will be what has changed. The new HTML tags are shown in the differences. If no documentation existed, and then some was added in a later version, this change is noted in the appropriate class pages of differences, but the change is not shown on this page. Only changes in existing text are shown here. Similarly, documentation which was inherited from another class or interface is not shown here.
Note that an HTML error in the new documentation may cause the display of other documentation changes to be presented incorrectly. For instance, failure to close a <code> tag will cause all subsequent paragraphs to be displayed differently.
Class Delegate

TheSpecifies Delegate abstract class specifies a portable API for ORB-vendor-specific implementation of the org.omg.CORBA.Object methods. Each stub (proxy) contains a delegate object to which all org.omg.CORBA.Object methods are forwarded. This allows a stub generated by one vendor's ORB to work with the delegate from another vendor's ORB. @see org.omg.CORBA.Object @author OMG @version 1.30 02/02/00
Class Delegate, Request create_request(Object, Context, String, NVList, NamedValue, ExceptionList, ContextList)

CreateCreates a Request instance for use in the Dynamic Invocation Interface. @param obj The object reference which delegated to this delegate. @param ctx The context to be used. @param operation The name of the operation to be invoked. @param arg_list The arguments to the operation in the form of an NVList. @param result A container for the result as a NamedValue. @param exclist A list of possible exceptions the operation can throw. @param ctxlist A list of context strings that need to be resolved and sent with the Request. @return The created Request object.
Class Delegate, Object get_interface_def(Object)

Return an InterfaceDef for the object reference provided. @param objself The object reference whose InterfaceDef needs to be returned @return the InterfaceDef
Class Delegate, int hash(Object, int)

Returns an ORB-internal identifier (hashcode) for this object reference. @param obj The object reference which delegated to this delegate. @param maximummax specifies an upper bound on the hash value returned by the ORB. @return ORB-internal hash identifier for object reference
Class Delegate, InputStream invoke(Object, OutputStream)

invoke is called by a stub to invoke an operation. The stub provides an OutputStream that was previously returned by a request() call. invoke returns an InputStream which contains the marshaled reply. If an exception occurs invoke may throw an ApplicationException object which contains an InputStream from which the user exception state may be unmarshaled. @param self The object reference which delegated to this delegate. @param output the OutputStream which contains marshaled arguments @return input the InputStream from which reply parameters can be unmarshaled. @throws ApplicationException thrown when implementation throws (upon invocation) an exception defined as part of its remote method definition. @throws RemarshalException thrown when remarshalling fails. @see portable package comments for unimplemented features
Class Delegate, boolean is_a(Object, String)

CheckChecks if the object reference is an instance of the given interface. @param obj The object reference to be checked. @param repository_id The repository identifier of the interface to check against. @return true if the object reference supports the interface
Class Delegate, boolean is_equivalent(Object, Object)

Determines if the two object references are equivalent. @param obj The object reference which delegated to this delegate. @param other The object reference to check equivalence against. @return true if the objects are CORBA-equivalent.
Class Delegate, boolean non_existent(Object)

Determines whether the server object for the object reference has been destroyed. @param obj The object reference which delegated to this delegate. @resultreturn true if the ORB knows authoritatively that the server object does not exist false otherwise
Class Delegate, ORB orb(Object)

ReturnProvides a reference to the orb associated with its parameter. @param obj the ORBobject reference that createdwhich delegated to this delegate. @return the associated orb. @see portable package comments for unimplemented features
Class Delegate, ServantObject servant_preinvoke(Object, String, Class)

Returns a Java reference to the servant which should be used for this request. servant_preinvoke() is invoked by a local stub. If a ServantObject object is returned then its servant field has been set to an object of the expected type (Note: the object may or may not be the actual servant instance). The local stub may cast the servant field to the expected type and then invoke the operation directly. The ServantRequest object is valid for only one invocation and cannot be used for more than one invocation. @param self The object reference which delegated to this delegate. @param operation a string containing the operation name. The operation name corresponds to the operation name as it would be encoded in a GIOP request. @param expectedType a Class object representing the expected type of the servant. The expected type is the Class object associated with the operations class of the stub's interface (e.g. A stub for an interface Foo would pass the Class object for the FooOperations interface). @return a ServantObject object. The method may return a null value if it does not wish to support this optimization (e.g. due to security transactions etc). The method must return null if the servant is not of the expected type.
Class Delegate, Object set_policy_override(Object, Policy[], SetOverrideType)

Associates the policies passed in with a newly created object reference that it returns. Only certain policies that pertain to the invocation of an operation at the client end can be overridden using this operation. Attempts to override any other policy will result in the raising of the CORBA::NO_PERMISSION exception. @param self The object reference which delegated to this delegate. @param policies A sequence of references to Policy objects. @param set_add Indicates whether these policies should be added onto any otheroverrides that already exist (ADD_OVERRIDE) in the object reference or they should be added to a clean override free object reference (SET_OVERRIDE). @return A new object reference with the new policies associated with it. @see portable package comments for unimplemented features
Class InputStream, ORB orb()

ReturnReturns the ORB that created this InputStream. @return an ORB object. @see portable package comments for unimplemented features
Class InputStream, Context read_Context()

Reads a CORBA context from the stream. @return a CORBA context. @see portable package comments for unimplemented features
Class InputStream, Object read_Object(Class)

read_Object unmarshals an object and returns a CORBA Object which is an instance of the class passed as its argument. This class is the stub class of the expected type. @param clz a Class object one of whose instances this method will read and return from the stream. @return an Object instance of clz read from this stream. @see portable package comments for unimplemented features
Class InputStream, Principal read_Principal()

Returns principle for invocation. @return Principle for invocation. @deprecated Deprecated by CORBA 2.2.
Class InputStream, BigDecimal read_fixed()

Reads a BigDecimal number. @return a java.math.BigDecimal number. @see portable package comments for unimplemented features
Class InvokeHandler, OutputStream _invoke(String, InputStream, ResponseHandler)

Invoked by the ORB to dispatch a request to the servant. ORB passes the method name an InputStream containing the marshalled arguments and a ResponseHandler which the servant uses to construct a proper reply. Only CORBA SystemException may be thrown by this method. The method must return an OutputStream created by the ResponseHandler which contains the marshalled reply. A servant must not retain a reference to the ResponseHandler beyond the lifetime of a method invocation. Servant behaviour is defined as follows:

1. Determine correct method and unmarshal parameters from InputStream.

2. Invoke method implementation.

3. If no user exception create a normal reply using ResponseHandler.

4. If user exception occurred create exception reply using ResponseHandler.

5. Marshal reply into OutputStream returned by ResponseHandler.

6. Return OutputStream to ORB.

@param method The method name. @param input The InputStream containing the marshalled arguments. @param handler The ResponseHandler which the servant uses to construct a proper reply @return The OutputStream created by the ResponseHandler which contains the marshalled reply @throws SystemException is thrown when invocation fails due to a CORBA system exception.

Class ObjectImpl, Delegate _get_delegate()

Provides a reference to the vendor-specific Delegate for this ObjectImpl. @return the Delegate contained in this ObjectImpl instance.
Class ObjectImpl, String[] _ids()

Provides a string array containing the repository ids for this object. @return the array of all repository identifiers supported by this ObjectImpl instance (e.g. For a stub _ids() will return information about all interfaces supported by the stub).
Class ObjectImpl, InputStream _invoke(OutputStream)

_invoke is called to invoke an operation. The stub provides an OutputStream that was previously returned by a _request() call. _invoke returns an InputStream which contains the marshaled reply. If an exception occurs _invoke may throw an ApplicationException object which contains an InputStream from which the user exception state may be unmarshaled. @param output an OutputStream object for dispatching the request. @return an InputStream object for reading the response. @throws ApplicationException an exception -- thrown if the invocation meets application-defined exception. @throws RemarshalException an exception -- thrown if the invocation leads to a remarshalling error.
Class ObjectImpl, ORB _orb()

Provides reference to the ORB associated with this object and its delegate. @return the ORB instance which created the Delegate contained in this ObjectImpl.
Class ObjectImpl, void _releaseReply(InputStream)

_releaseReply may optionally be called by a stub to release a reply stream back to the ORB when the unmarshaling has completed. The stub passes the InputStream returned by _invoke() or ApplicationException.getInputStream(). A null value may also be passed to _releaseReply in which case the method is a noop. @param input an InputStream object that represents handle to the reply.
Class ObjectImpl, OutputStream _request(String, boolean)

_request is called by a stub to obtain an OutputStream for marshaling arguments. The stub must supply the operation name and indicate if a response is expected (i.e is this a oneway call). @param operation a String giving the name of the object. @param responseExpected a boolean -- true if request is not one way. @return an OutputStream object for dispatching the request.
Class ObjectImpl, void _set_delegate(Delegate)

setSets the Delegate contained in this ObjectImpl instance. @delegate implementation delegate used for an instance of this object.
Class OutputStream, ORB orb()

ReturnReturns the ORB that created this OutputStream. @return the ORB that created this OutputStream. @see portable package comments for unimplemented features
Class OutputStream, void write(int)

Writes an integer (length of arrays) onto this stream. @param b the value to be written. @see portable package comments for unimplemented features
Class OutputStream, void write_Context(Context, ContextList)

Writes a CORBA context on this stream. The Context is marshaled as a sequence of strings. Only those Context values specified in the contexts parameter are actually written. @param a CORBA context. @see portable package comments for unimplemented features
Class OutputStream, void write_Principal(Principal)

Writes a Principle on this output stream. @param value the value to be written. @deprecated Deprecated by CORBA 2.2.
Class OutputStream, void write_fixed(BigDecimal)

Writes a BigDecimal number. @param value a BidDecimal--value to be written. @see portable package comments for unimplemented features