Top   Module   Use   Manual   Index 
 EXPORTING SERVICES | METHODS' SUMMARY | METHODS' DETAILS 

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

interface XBridgeFactory

Base Interface
com::sun::star::uno::XInterface

Description
factory to create interprocess bridges.


Known Services which Export this Interface

com::sun::star::bridge::BridgeFactory allows to create new or access existing interprocess bridges.
com::sun::star::bridge::BridgeFactory allows to create new or access existing interprocess bridges.

Methods' 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.

Methods' Details

createBridge
 
com::sun::star::bridge::XBridge
createBridge(
[ in ] string sName,
[ in ] string sProtocol,
[ in ] com::sun::star::connection::XConnection aConnection,
[ in ] 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
 
com::sun::star::bridge::XBridge
getBridge(
[ in ] 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
 
sequence< com::sun::star::bridge::XBridge >
getExistingBridges();
Description
returns the sequence of all existing (including unnamed)bridges.

Top of Page