interface XBridgeFactory in module com::sun::star::bridge::

(Global Index)

Syntax

interface XBridgeFactory : com::sun::star::uno::XInterface ;

Description

factory to create interprocess bridges.

Method Summary

createBridge tries to create a UNO interprocess bridge.

getBridge tries to get a bridge by this name.

getExistingBridges returns the sequence of all existing (including unnamed)bridges.

Known Services Which Export this Interface

com::sun::star::bridge::BridgeFactory

com::sun::star::bridge::BridgeFactory

Method Details



createBridge

Syntax

com::sun::star::bridge::XBridge createBridge (
string sName,
string sProtocol,
com::sun::star::connection::XConnection aConnection,
com::sun::star::bridge::XInstanceProvider anInstanceProvider )
raises ( com::sun::star::bridge::BridgeExistsException , com::sun::star::lang::IllegalArgumentException );

Description

tries to create a UNO interprocess bridge.

Parameter sName

The name of the bridge. This allows other components to reuse an already created bridge (using getBridge).

If empty, an anonymous bridge is created, which cannot be retrieved with getBridge(). No BridgeExistsException can be thrown in this case.

Parameter sProtocol

The protocol, that will be used on the connection (e.g., urp) plus additional comma separated name=value protocol properties.

Parameter aConnection

The connection, which is used to transfer the calls. The bridge expects to own the connection, thus it will close the connection, in case it does not need it anymore.

Parameter anInstanceProvider

gets called, when a request from remote comes in. You can pass a null reference in case you don't want to export any objects.

Throws

BridgeExistsException There is already a bridge registered with this name. Use getBridge instead.

Throws

IllegalArgumentException The protocol is unknown or the connection is null.

getBridge

Syntax

com::sun::star::bridge::XBridge getBridge (
string sName );

Description

tries to get a bridge by this name.

Cannot be retrieved, when the bridge got disposed before.

Returns

An existing remote bridge or a null reference.

getExistingBridges

Syntax

sequence< com::sun::star::bridge::XBridge > getExistingBridges ();

Description

returns the sequence of all existing (including unnamed)bridges.

Top of Page