com.sun.star.lib.uno.bridges.java_remote

Class java_remote_bridge

java.lang.Object

com.sun.star.lib.uno.bridges.java_remote.java_remote_bridge

All Implemented Interfaces:

IReceiver

public class java_remote_bridge
extends java.lang.Object
implements IReceiver

This class implements a remote bridge. Therefor various interfaces are implemented.

The protocol to used is passed by name, the bridge then looks for it under com.sun.star.lib.uno.protocols.

Since:

UDK1.0

Field Summary

Fields

Modifier and Type	Field and Description
protected IProtocol	_iProtocol
protected IThreadPool	_iThreadPool
protected IEnvironment	_java_environment
protected int	_life_count
protected com.sun.star.lib.uno.bridges.java_remote.java_remote_bridge.MessageDispatcher	_messageDispatcher
protected java.lang.String	_name
protected XConnection	_xConnection
protected XInstanceProvider	_xInstanceProvider

Constructor Summary

Constructors

Constructor and Description
java_remote_bridge(IEnvironment java_environment, IEnvironment remote_environment, java.lang.Object[] args)
java_remote_bridge(java.lang.Object[] args) Deprecated. as of UDK 1.0

Method Summary

Modifier and Type	Method and Description
void	acquire() Increases the life count.
void	addDisposeListener(DisposeListener listener)
void	addEventListener(XEventListener xEventListener)
void	dispose()
java.lang.String	getDescription() Gives a description of the connection type and protocol used
java.lang.Object	getInstance(java.lang.String instanceName)
java.lang.String	getName() Gives the name of this bridge
IEnvironment	getSourceEnvironment() Gives the source environment.
IEnvironment	getTargetEnvironment() Gives the destination environment.
java.lang.Object	mapInterfaceFrom(java.lang.Object oId, Type type) Maps an object from destination environment to the source environment.
java.lang.Object	mapInterfaceTo(java.lang.Object object, Type type)
void	release() Decreases the life count.
void	removeEventListener(XEventListener xEventListener)
void	sendReply(boolean exception, ThreadId threadId, java.lang.Object result) Send back a reply for a request.
java.lang.Object	sendRequest(java.lang.String oid, Type type, java.lang.String operation, java.lang.Object[] params)

Methods inherited from class java.lang.Object

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

Field Detail

_xConnection

protected XConnection _xConnection

_xInstanceProvider

protected XInstanceProvider _xInstanceProvider

_name

protected java.lang.String _name

_iProtocol

protected IProtocol _iProtocol

_java_environment

protected IEnvironment _java_environment

_messageDispatcher

protected com.sun.star.lib.uno.bridges.java_remote.java_remote_bridge.MessageDispatcher _messageDispatcher

_life_count

protected int _life_count

_iThreadPool

protected IThreadPool _iThreadPool

Constructor Detail

java_remote_bridge

public java_remote_bridge(IEnvironment java_environment,
                          IEnvironment remote_environment,
                          java.lang.Object[] args)
                   throws java.lang.Exception

Throws:

java.lang.Exception

java_remote_bridge

public java_remote_bridge(java.lang.Object[] args)
                   throws java.lang.Exception

Deprecated. as of UDK 1.0

Constructs a new bridge.

This method is not part of the provided api and should only be used by the UNO runtime.

Parameters:

args - the custom parameters: arg[0] == protocol_name, arg[1] == xConnection, arg[2] == xInstanceProvider

Throws:

java.lang.Exception

Method Detail

mapInterfaceTo

public java.lang.Object mapInterfaceTo(java.lang.Object object,
                                       Type type)

mapInterfaceFrom

public java.lang.Object mapInterfaceFrom(java.lang.Object oId,
                                         Type type)

Maps an object from destination environment to the source environment.

Parameters:

object - the object to map

type - the interface under which is to be mapped

Returns:

the object in the source environment

See Also:

com.sun.star.uno.IBridge#mapInterfaceFrom

getSourceEnvironment

public IEnvironment getSourceEnvironment()

Gives the source environment.

Returns:

the source environment of this bridge

See Also:

com.sun.star.uno.IBridge#getSourceEnvironment

getTargetEnvironment

public IEnvironment getTargetEnvironment()

Gives the destination environment.

Returns:

the destination environment of this bridge

See Also:

com.sun.star.uno.IBridge#getTargetEnvironment

acquire

public void acquire()

Increases the life count.

See Also:

com.sun.star.uno.IBridge#acquire

release

public void release()

Decreases the life count. If the life count drops to zero, the bridge disposes itself.

See Also:

com.sun.star.uno.IBridge#release

dispose

public void dispose()

getInstance

public java.lang.Object getInstance(java.lang.String instanceName)

getName

public java.lang.String getName()

Gives the name of this bridge

Returns:

the name of this bridge

See Also:

com.sun.star.bridge.XBridge#getName

getDescription

public java.lang.String getDescription()

Gives a description of the connection type and protocol used

Returns:

connection type and protocol

See Also:

com.sun.star.bridge.XBridge#getDescription

sendReply

public void sendReply(boolean exception,
                      ThreadId threadId,
                      java.lang.Object result)

Description copied from interface: IReceiver

Send back a reply for a request.

Specified by:

sendReply in interface IReceiver

Parameters:

exception - true if an exception (instead of a normal result) is sent back.

threadId - the thread ID of the request.

result - the result of executing the request, or an exception thrown while executing the request.

sendRequest

public java.lang.Object sendRequest(java.lang.String oid,
                                    Type type,
                                    java.lang.String operation,
                                    java.lang.Object[] params)
                             throws java.lang.Throwable

Throws:

java.lang.Throwable

addEventListener

public void addEventListener(XEventListener xEventListener)

removeEventListener

public void removeEventListener(XEventListener xEventListener)

addDisposeListener

public void addDisposeListener(DisposeListener listener)