Overview | Module | Use | Devguide | Index

Methods' Summary | Methods' Details | Attributes' Summary | Attributes' Details

:: com :: sun :: star :: bridge ::
interface XBridgeFactory
  Base Hierarchy
      ::com::sun::star::uno::XInterface
       |
       +-XBridgeFactory
Description factory to create interprocess bridges. Developers Guide 3.3.1 Professional UNO - UNO Concepts - UNO Interprocess Connections - 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 existing (including unnamed)bridges.

Methods' Details
createBridge
XBridge createBridge( | [in] string [in] string [in] ::com::sun::star::connection::XConnection [in] XInstanceProvider raises( | sName, sProtocol, aConnection, anInstanceProvider ) 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 existing (including unnamed)bridges.

Top of Page

Copyright © 2003 Sun Microsystems, Inc.