com.sun.corba.se.impl.corba

Class ServerRequestImpl

java.lang.Object

org.omg.CORBA.ServerRequest

com.sun.corba.se.impl.corba.ServerRequestImpl

public class ServerRequestImpl
extends ServerRequest

Constructor Summary

Constructors

Constructor and Description
ServerRequestImpl(CorbaMessageMediator req, ORB orb)

Method Summary

Modifier and Type	Method and Description
void	arguments(NVList args) Specifies method parameter types and retrieves "in" and "inout" argument values.
Any	checkResultCalled() This is called from the ORB after the DynamicImplementation.invoke returns.
Context	ctx() Returns the context information specified in IDL for the operation when the operation is not an attribute access and the operation's IDL definition contains a context expression; otherwise it returns a nil Context reference.
void	marshalReplyParams(OutputStream os) This is called from the ORB after the DynamicImplementation.invoke returns.
String	operation() Throws an org.omg.CORBA.NO_IMPLEMENT exception.
void	set_exception(Any exc) Throws an org.omg.CORBA.NO_IMPLEMENT exception.
void	set_result(Any res) Throws an org.omg.CORBA.NO_IMPLEMENT exception.

Methods inherited from class org.omg.CORBA.ServerRequest

except, op_name, params, result

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ServerRequestImpl

public ServerRequestImpl(CorbaMessageMediator req,
                         ORB orb)

Method Detail

operation

public String operation()

Description copied from class: ServerRequest

Throws an org.omg.CORBA.NO_IMPLEMENT exception.

Retrieves the name of the operation being invoked. According to OMG IDL's rules, these names must be unique among all operations supported by this object's "most-derived" interface. Note that the operation names for getting and setting attributes are _get_<attribute_name> and _set_<attribute_name>, respectively.

Overrides:

operation in class ServerRequest

Returns:

the name of the operation to be invoked

See Also:

CORBA package comments for unimplemented features

arguments

public void arguments(NVList args)

Description copied from class: ServerRequest

Specifies method parameter types and retrieves "in" and "inout" argument values. Unless it calls the method set_exception, the DIR must call this method exactly once, even if the method signature contains no parameters. Once the method arguments or set_exception has been called, calling arguments on the same ServerRequest object will result in a BAD_INV_ORDER system exception. The DIR must pass in to the method arguments an NVList initialized with TypeCodes and Flags describing the parameter types for the operation, in the order in which they appear in the IDL specification (left to right). A potentially-different NVList will be returned from arguments, with the "in" and "inout" argument values supplied. If it does not call the method set_exception, the DIR must supply the returned NVList with return values for any "out" arguments before returning, and it may also change the return values for any "inout" arguments.

Overrides:

arguments in class ServerRequest

Parameters:

args - the arguments of the method, in the form of an NVList

See Also:

CORBA package comments for unimplemented features

set_result

public void set_result(Any res)

Description copied from class: ServerRequest

Throws an org.omg.CORBA.NO_IMPLEMENT exception.

Specifies any return value for the call. Unless the method set_exception is called, if the invoked method has a non-void result type, the method set_result must be called exactly once before the DIR returns. If the operation has a void result type, the method set_result may optionally be called once with an Any object whose type is tk_void. Calling the method set_result before the method arguments has been called or after the method set_result or set_exception has been called will result in a BAD_INV_ORDER exception. Calling the method set_result without having previously called the method ctx when the IDL operation contains a context expression, or when the NVList passed to arguments did not describe all parameters passed by the client, may result in a MARSHAL system exception.

Overrides:

set_result in class ServerRequest

Parameters:

res - an Any object containing the return value to be set

See Also:

CORBA package comments for unimplemented features

set_exception

public void set_exception(Any exc)

Description copied from class: ServerRequest

Throws an org.omg.CORBA.NO_IMPLEMENT exception.

Returns the given exception to the client. This method is invoked by the DIR, which may call it at any time. The Any object passed to this method must contain either a system exception or one of the user exceptions specified in the invoked operation's IDL definition. Passing in an Any object that does not contain an exception will cause a BAD_PARAM system exception to be thrown. Passing in an unlisted user exception will result in either the DIR receiving a BAD_PARAM system exception or in the client receiving an UNKNOWN_EXCEPTION system exception.

Overrides:

set_exception in class ServerRequest

Parameters:

exc - the Any object containing the exception

See Also:

CORBA package comments for unimplemented features

checkResultCalled

public Any checkResultCalled()

This is called from the ORB after the DynamicImplementation.invoke returns. Here we set the result if result() has not already been called.

Returns:

the exception if there is one (then ORB will not call marshalReplyParams()) otherwise return null.

marshalReplyParams

public void marshalReplyParams(OutputStream os)

This is called from the ORB after the DynamicImplementation.invoke returns. Here we marshal the return value and inout/out params.

ctx

public Context ctx()

Description copied from class: ServerRequest

Returns the context information specified in IDL for the operation when the operation is not an attribute access and the operation's IDL definition contains a context expression; otherwise it returns a nil Context reference. Calling the method ctx before the method arguments has been called or after the method ctx, set_result, or set_exception has been called will result in a BAD_INV_ORDER system exception.

Specified by:

ctx in class ServerRequest

Returns:

the context object that is to be used to resolve any context strings whose values need to be sent with the invocation.