Class gnuRequest

public static Version MAX_SUPPORTED

The maximal supported GIOP version.

public static int PAUSE_INITIAL

The initial pause that the Request makes when the required port is not available.

public static int PAUSE_MAX

The maximal pausing interval between two repetetive attempts. The interval doubles after each unsuccessful attempt, but will not exceed this value.

public static int PAUSE_STEPS

The number of repretetive attempts to get a required port, if it is not immediately available.

protected boolean complete

The flag, indicating that the request has been sent and the result is already received.

protected gnuNVList m_args

The request arguments.

protected Context m_context

The context holder for methods ctx(Context) and ctx().

protected ContextList m_context_list

The context list for method contexts().

protected Environment m_environment

The request environment for holding the exception the has possibly been thrown by the method being invoked.

protected String m_exception_id

The exception id, received from the server, null if none.

protected ExceptionList m_exceptions

The list of all exceptions that can be thrown by the method being invoked.

public IOR m_forward_ior

This field temporary remembers the value of the forwarded ior reference. If it is not null, the request was forwarded and the effective target is not the same as the default target.

public Object m_forwarding_target

Is set when object, and not IOR is directly available.

protected String m_operation

The name of the method being invoked.

protected StreamBasedRequest m_parameter_buffer

The request arguments in the case when they are directly written into the parameter buffer.

protected NamedValue m_result

The result, returned by the invoked method (function).

protected ReplyHeader m_rph

The reply header currently in use.

protected RequestHeader m_rqh

The request header currently in use.

protected Any[] m_slots

The array of slots.

protected SystemException m_sys_ex

The thrown system exception.

protected Object m_target

The invocation target.

protected boolean oneWay

The flag, indicating that the response to this request must be ignored (used with send_oneway()).

protected boolean running

The flag, indicating that the request has been sent and no result is yet received.

public gnuRequest Clone()

Creates a shallow copy of this request.

public Any add_in_arg()

Overrides:

add_in_arg in interface Request

public Any add_inout_arg()

Overrides:

add_inout_arg in interface Request

public Any add_named_in_arg(String name)

Overrides:

add_named_in_arg in interface Request

public Any add_named_inout_arg(String name)

Overrides:

add_named_inout_arg in interface Request

public Any add_named_out_arg(String name)

Overrides:

add_named_out_arg in interface Request

public Any add_out_arg()

Overrides:

add_out_arg in interface Request

public void add_request_service_context(ServiceContext service_context,
                                        boolean replace)

Add context to request.

public NVList arguments()

Overrides:

arguments in interface Request

public void checkDii()

Check if the call is done via DII.

public ContextList contexts()

Overrides:

contexts in interface Request

public Context ctx()

Overrides:

ctx in interface Request

public void ctx(Context a_context)

Overrides:

ctx in interface Request

public TaggedProfile effective_profile()

Get the Internet profile as an effective profile.

public Object effective_target()

Return either target or forwarded targed.

public Environment env()

Overrides:

env in interface Request

public ExceptionList exceptions()

Overrides:

exceptions in interface Request

public Object forward_reference()

Return the forwarded reference, null if none.

public IOR getIor()

Get the IOR data, sufficient to find the invocation target.

Returns:

the IOR data.

public StreamBasedRequest getParameterStream()

Get the parameter stream, where the invocation arguments should be written if they are written into the stream directly.

public TaggedComponent get_effective_component(int id)
            throws BAD_PARAM

Get effective component with the give id from the Internet profile.

public TaggedComponent[] get_effective_components(int id)
            throws BAD_PARAM

Get all components with the given id from the internet profile.

public ServiceContext get_reply_service_context(int ctx_name)
            throws BAD_PARAM

public Policy get_request_policy(int type)
            throws INV_POLICY

This should be not implemented up till jdk 1.5 inclusive.

public ServiceContext get_request_service_context(int ctx_name)
            throws BAD_PARAM

public void get_response()
            throws WrongTransaction

Overrides:

get_response in interface Request

public Any get_slot(int id)
            throws InvalidSlot

Get the slot from the slot array inside this request.

public String[] ice_contexts()

Get contexts as required by interceptor.

public void invoke()
            throws BAD_INV_ORDER

Submit the request, suspending the current thread until the answer is received. This implementation requires to set the IOR property (setIOR(IOR) before calling this method.

Overrides:

invoke in interface Request

Throws:

SystemException - if this exception has been thrown on remote side. The exact exception type and the minor code are the same as they have been for the exception, thrown on remoted side.

public String operation()

Overrides:

operation in interface Request

public String[] operation_context()

public ORB orb()

Get the orb, related to the invocation target.

public boolean poll_response()

Overrides:

poll_response in interface Request

public Any received_exception()

public String received_exception_id()

public short reply_status()

Get the reply status.

public int request_id()

Get the request id.

public boolean response_expected()

Return true if the response is expected.

public NamedValue result()

Overrides:

result in interface Request

public Any return_value()

Overrides:

return_value in interface Request

public void send_deferred()

Overrides:

send_deferred in interface Request

public void send_oneway()

Send a request and forget about it, not waiting for a response. This can be done also for methods that normally are expected to return some values. TODO It is generally recommended to reuse the threads. Reuse?

Overrides:

send_oneway in interface Request

public void setBigEndian(boolean use_big_endian)

Set the encoding that will be used to send the message. The default encoding is inherited from the set IOR (that string reference can be encoded in either Big or Little endian). If the IOR encoding is not known (for example, by obtaining the reference from the naming service), the Big Endian is used.

Parameters:

use_big_endian - true to use the Big Endian, false to use the Little Endian encoding.

public void setIor(IOR an_ior)

Set the IOR data, sufficient to find the invocation target. This also sets default endian encoding for invocations.

See Also:

IOR.parse(String)

public void setORB(ORB an_orb)

Set the ORB, related to the invocation target.

public void setOperation(String operation)

The the method name to invoke.

Parameters:

operation - the method name.

public void set_args(NVList a_args)

Set the argument list. This field is initialised as empty non null instance by default, so the method is only used in cases when the direct replacement is desired.

Parameters:

a_args - the argument list.

public void set_context_list(ContextList a_context_list)

Set the context list that is later returned by the method contexts().

Parameters:

a_context_list - a new context list.

public void set_environment(Environment a_environment)

Set the exception container. This field is initialised as empty non null instance by default, so the method is only used in cases when the direct replacement is desired.

Parameters:

a_environment - the new exception container.

public void set_exceptions(ExceptionList a_exceptions)

Set the list of exceptions. This field is initialised as empty non null instance by default, so the method is only used in cases when the direct replacement is desired.

Parameters:

a_exceptions - a list of exceptions.

public void set_operation(String a_operation)

Set the operation name.

Parameters:

a_operation - the operation name.

public void set_result(NamedValue a_result)

Set the named value, returned as result. This field is initialised as empty non null instance by default, so the method is only used in cases when the direct replacement is desired.

Parameters:

a_result - the result keeper.

public void set_return_type(TypeCode returns)

Set the type of the named value, returned as a result. Instantiates a new instance of the result value.

Overrides:

set_return_type in interface Request

public void set_target(Object a_target)

Set the invocation target.

Parameters:

a_target - the CORBA object for that the method will be invoked.

public gnu.CORBA.RawReply submit()
            throws ForwardRequest

Do the actual invocation. This implementation requires to set the IOR property (setIOR(IOR) before calling this method.

Returns:

the server response in binary form.

public short sync_scope()

Determines how far the request shall progress before control is returned to the client. However up till JDK 1.5 inclusive this method always returns SYNC_WITH_TRANSPORT.

Returns:

(1), always.

public Object target()

Overrides:

target in interface Request

public Version useVersion(Version desired)

Get the used version. Normally, it is better to respond using the same version as it is specified in IOR, but not above the maximal supported version.

public void waitWhileBusy()

Wait while the response to request, submitted using send_deferred() or invoke() (from other thread) is returned. FIXME It is possible to rewrite this using Object.wait() and Object.notify(), but be sure to prepare the test as well.

protected void write_parameter_buffer(MessageHeader header,
                                      BufferedCdrOutput request_part)
            throws MARSHAL

Write the operation parameters.

Parameters:

header - the message header

request_part - the stream to write parameters into

Throws:

MARSHAL - if the attempt to write the parameters has failde.

protected void write_parameters(MessageHeader header,
                                BufferedCdrOutput request_part)
            throws MARSHAL

Write the operation parameters.

Parameters:

header - the message header

request_part - the stream to write parameters into

Throws:

MARSHAL - if the attempt to write the parameters has failde.