com.sun.star.lib.uno.environments.remote

Class Message

java.lang.Object

com.sun.star.lib.uno.environments.remote.Message

public class Message
extends Object

A remote request or reply message.

Constructor Summary

Constructors

Constructor and Description
Message(ThreadId threadId, boolean request, String objectId, com.sun.star.lib.uno.typedesc.TypeDescription type, com.sun.star.lib.uno.typedesc.MethodDescription method, boolean synchronous, com.sun.star.uno.XCurrentContext currentContext, boolean abnormalTermination, Object result, Object[] arguments)

Method Summary

Modifier and Type	Method and Description
Object[]	getArguments() Returns the arguments of a message.
com.sun.star.uno.XCurrentContext	getCurrentContext() Returns the current context of a request message.
com.sun.star.lib.uno.typedesc.MethodDescription	getMethod() Returns the method description of a request message.
String	getObjectId() Returns the object ID of a request message.
Object	getResult() Returns the result of a reply message.
ThreadId	getThreadId() Returns the thread ID of the message.
com.sun.star.lib.uno.typedesc.TypeDescription	getType() Returns the type of a request message.
boolean	isAbnormalTermination() Returns whether the reply message represents abnormal termination.
boolean	isRequest() Returns whether the message is a request or a reply.
boolean	isSynchronous() Returns whether the request message is synchronous.

Methods inherited from class java.lang.Object

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

Constructor Detail

Message

public Message(ThreadId threadId,
               boolean request,
               String objectId,
               com.sun.star.lib.uno.typedesc.TypeDescription type,
               com.sun.star.lib.uno.typedesc.MethodDescription method,
               boolean synchronous,
               com.sun.star.uno.XCurrentContext currentContext,
               boolean abnormalTermination,
               Object result,
               Object[] arguments)

Method Detail

getThreadId

public final ThreadId getThreadId()

Returns the thread ID of the message.

Valid for all kinds of messages.

Returns:

the (non-null) thread ID.

isRequest

public final boolean isRequest()

Returns whether the message is a request or a reply.

Valid for all kinds of messages.

Returns:

true for a request, false for a reply.

getObjectId

public final String getObjectId()

Returns the object ID of a request message.

Valid only for request messages.

Returns:

the (non-null) object ID for a request, null for a reply.

getType

public final com.sun.star.lib.uno.typedesc.TypeDescription getType()

Returns the type of a request message.

Valid only for request messages.

Returns:

the (non-null) type for a request, null for a reply.

getMethod

public final com.sun.star.lib.uno.typedesc.MethodDescription getMethod()

Returns the method description of a request message.

Valid only for request messages. The returned MethodDescription is consistent with the type of the message.

Returns:

the (non-null) method description for a request, null for a reply.

isSynchronous

public final boolean isSynchronous()

Returns whether the request message is synchronous.

Valid only for request messages.

Returns:

true for a synchronous request, false for an asynchronous request or a reply.

getCurrentContext

public com.sun.star.uno.XCurrentContext getCurrentContext()

Returns the current context of a request message.

Valid only for request messages.

Returns:

the current context (which may be null) for a request, null for a reply.

isAbnormalTermination

public final boolean isAbnormalTermination()

Returns whether the reply message represents abnormal termination.

Valid only for reply messages.

Returns:

true for a reply that represents abnormal termination, false for a reply that represents normal termination or a request.

getResult

public final Object getResult()

Returns the result of a reply message.

Valid only for reply messages.

Returns:

any (possibly null) return value for a reply that represents normal termination, the (non-null) exception for a reply that represents abnormal termination, null for a request.

getArguments

public final Object[] getArguments()

Returns the arguments of a message.

Valid only for request messages and reply messages that represent normal termination. Any returned array must not be modified.

Returns:

the in and in– { }out arguments for a request (possibly null for a parameterless function), the out and in– { }out arguments for a reply that represents normal termination (possibly null for a parameterless function), null for a reply that represents abnormal termination.