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:

com.sun.star.bridge.XBridge, com.sun.star.lang.XComponent, IReceiver, com.sun.star.lib.util.DisposeNotifier, com.sun.star.uno.IBridge, com.sun.star.uno.XInterface

public class java_remote_bridge
extends Object
implements com.sun.star.uno.IBridge, IReceiver, com.sun.star.bridge.XBridge, com.sun.star.lang.XComponent, com.sun.star.lib.util.DisposeNotifier

This class implements a remote bridge.

Therefore 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 com.sun.star.uno.IEnvironment	_java_environment
protected AtomicInteger	_life_count
protected com.sun.star.lib.uno.bridges.java_remote.java_remote_bridge.MessageDispatcher	_messageDispatcher
protected String	_name
protected com.sun.star.connection.XConnection	_xConnection
protected com.sun.star.bridge.XInstanceProvider	_xInstanceProvider

Fields inherited from interface com.sun.star.bridge.XBridge

UNOTYPEINFO

Fields inherited from interface com.sun.star.lang.XComponent

UNOTYPEINFO

Constructor Summary

Constructors

Constructor and Description
java_remote_bridge(com.sun.star.uno.IEnvironment java_environment, com.sun.star.uno.IEnvironment remote_environment, Object[] args)
java_remote_bridge(Object[] args) Deprecated. as of UDK 1.0

Method Summary

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

Methods inherited from class java.lang.Object

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

Field Detail

_xConnection

protected com.sun.star.connection.XConnection _xConnection

_xInstanceProvider

protected com.sun.star.bridge.XInstanceProvider _xInstanceProvider

_name

protected String _name

_iProtocol

protected IProtocol _iProtocol

_java_environment

protected com.sun.star.uno.IEnvironment _java_environment

_messageDispatcher

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

_life_count

protected final AtomicInteger _life_count

_iThreadPool

protected IThreadPool _iThreadPool

Constructor Detail

java_remote_bridge

public java_remote_bridge(com.sun.star.uno.IEnvironment java_environment,
                          com.sun.star.uno.IEnvironment remote_environment,
                          Object[] args)
                   throws Exception

Throws:

Exception

java_remote_bridge

public java_remote_bridge(Object[] args)
                   throws 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:

Exception

Method Detail

mapInterfaceTo

public Object mapInterfaceTo(Object object,
                             com.sun.star.uno.Type type)

Specified by:

mapInterfaceTo in interface com.sun.star.uno.IBridge

See Also:

IBridge.mapInterfaceTo(java.lang.Object, com.sun.star.uno.Type)

mapInterfaceFrom

public Object mapInterfaceFrom(Object oId,
                               com.sun.star.uno.Type type)

Maps an object from destination environment to the source environment.

Specified by:

mapInterfaceFrom in interface com.sun.star.uno.IBridge

Parameters:

oId - the object to map.

type - the interface under which is to be mapped.

Returns:

the object in the source environment.

See Also:

IBridge.mapInterfaceFrom(java.lang.Object, com.sun.star.uno.Type)

getSourceEnvironment

public com.sun.star.uno.IEnvironment getSourceEnvironment()

Gives the source environment.

Specified by:

getSourceEnvironment in interface com.sun.star.uno.IBridge

Returns:

the source environment of this bridge.

See Also:

IBridge.getSourceEnvironment()

getTargetEnvironment

public com.sun.star.uno.IEnvironment getTargetEnvironment()

Gives the destination environment.

Specified by:

getTargetEnvironment in interface com.sun.star.uno.IBridge

Returns:

the destination environment of this bridge.

See Also:

IBridge.getTargetEnvironment()

acquire

public void acquire()

Increases the life count.

Specified by:

acquire in interface com.sun.star.uno.IBridge

See Also:

IBridge.acquire()

release

public void release()

Decreases the life count.

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

Specified by:

release in interface com.sun.star.uno.IBridge

See Also:

IBridge.release()

dispose

public void dispose()

Specified by:

dispose in interface com.sun.star.lang.XComponent

Specified by:

dispose in interface com.sun.star.uno.IBridge

getInstance

public Object getInstance(String instanceName)

Specified by:

getInstance in interface com.sun.star.bridge.XBridge

See Also:

XBridge.getInstance(java.lang.String)

getName

public String getName()

Gives the name of this bridge.

Specified by:

getName in interface com.sun.star.bridge.XBridge

Returns:

the name of this bridge.

See Also:

XBridge.getName()

getDescription

public String getDescription()

Gives a description of the connection type and protocol used.

Specified by:

getDescription in interface com.sun.star.bridge.XBridge

Returns:

connection type and protocol.

See Also:

XBridge.getDescription()

sendReply

public void sendReply(boolean exception,
                      ThreadId threadId,
                      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 Object sendRequest(String oid,
                          com.sun.star.uno.Type type,
                          String operation,
                          Object[] params)
                   throws Throwable

Throws:

Throwable

addEventListener

public void addEventListener(com.sun.star.lang.XEventListener xEventListener)

Methods XComponent.

Specified by:

addEventListener in interface com.sun.star.lang.XComponent

removeEventListener

public void removeEventListener(com.sun.star.lang.XEventListener xEventListener)

Specified by:

removeEventListener in interface com.sun.star.lang.XComponent

addDisposeListener

public void addDisposeListener(com.sun.star.lib.util.DisposeListener listener)

Specified by:

addDisposeListener in interface com.sun.star.lib.util.DisposeNotifier

See Also:

DisposeNotifier.addDisposeListener(com.sun.star.lib.util.DisposeListener)