com.sun.star.lib.uno.protocols.urp

Class urp

java.lang.Object

com.sun.star.lib.uno.protocols.urp.urp

All Implemented Interfaces:

IProtocol

public final class urp
extends java.lang.Object
implements IProtocol

Constructor Summary

Constructors

Constructor and Description
urp(IBridge bridge, java.lang.String attributes, java.io.InputStream input, java.io.OutputStream output)

Method Summary

Modifier and Type	Method and Description
void	init() Initializes the connection.
Message	readMessage() Reads a request or reply message.
void	terminate()
void	writeReply(boolean exception, ThreadId tid, java.lang.Object result) Writes a reply message.
boolean	writeRequest(java.lang.String oid, TypeDescription type, java.lang.String function, ThreadId tid, java.lang.Object[] arguments) Writes a request message.

Methods inherited from class java.lang.Object

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

Constructor Detail

urp

public urp(IBridge bridge,
           java.lang.String attributes,
           java.io.InputStream input,
           java.io.OutputStream output)

Method Detail

init

public void init()
          throws java.io.IOException

Description copied from interface: IProtocol

Initializes the connection.

This method must be called exactly once, after the readMessage loop has already been established.

Specified by:

init in interface IProtocol

Throws:

java.io.IOException

terminate

public void terminate()

Specified by:

terminate in interface IProtocol

readMessage

public Message readMessage()
                    throws java.io.IOException

Description copied from interface: IProtocol

Reads a request or reply message.

Access to this method from multiple threads must be properly synchronized.

Specified by:

readMessage in interface IProtocol

Returns:

a non-null message; if the input stream is exhausted, a java.io.IOException is thrown instead

Throws:

java.io.IOException

writeRequest

public boolean writeRequest(java.lang.String oid,
                            TypeDescription type,
                            java.lang.String function,
                            ThreadId tid,
                            java.lang.Object[] arguments)
                     throws java.io.IOException

Description copied from interface: IProtocol

Writes a request message.

Specified by:

writeRequest in interface IProtocol

Parameters:

oid - a non-null OID

type - a non-null UNO type

function - a non-null function (the name of a UNO interface method or attribute compatible with the given type, or either "queryInterface" or "release")

arguments - a list of UNO arguments compatible with the given type and function; may be null to represent an empty list

Returns:

true if the request message is sent as a synchronous request

Throws:

java.io.IOException

writeReply

public void writeReply(boolean exception,
                       ThreadId tid,
                       java.lang.Object result)
                throws java.io.IOException

Description copied from interface: IProtocol

Writes a reply message.

Specified by:

writeReply in interface IProtocol

Parameters:

exception - true if the reply corresponds to a raised exception

tid - a non-null TID

result - if exception is true, a non-null UNO exception; otherwise, a UNO return value, which may be null to represent a VOID return value

Throws:

java.io.IOException