Language

The Free and Open Productivity Suite
Released: Apache OpenOffice 4.1.15

API

SDK

Tips ‘n’ Tricks

Miscellaneous


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

interface XBridgeFactory
Description
factory to create interprocess bridges.
Developers Guide
ProUNO - Opening a Connection

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 named and unnamed UNO interprocess bridges that are instantiated at the time the call is made.  
Methods' Details
createBridge
XBridge
createBridge( [in] string  sName,
[in] string  sProtocol,
[in] ::com::sun::star::connection::XConnection  aConnection,
[in] XInstanceProvider  anInstanceProvider )
raises( 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
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< XBridge >
getExistingBridges();

Description
returns the sequence of all named and unnamed UNO interprocess bridges that are instantiated at the time the call is made.
Top of Page

Apache Software Foundation

Copyright & License | Privacy | Contact Us | Donate | Thanks

Apache, OpenOffice, OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. The Apache feather logo is a trademark of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.