<html> <head> <title>Interface XBridgeFactory</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <link rel="stylesheet" type="text/css" href="../../../../idl.css"> </head> <body> <div id="adc-idlref"> <a name="_top_"> </a><table class="navimain" border="0" cellpadding="3"> <tr> <td class="navimain"><a href="../module-ix.html" class="navimain">Overview</a></td> <td class="navimain"><a href="module-ix.html" class="navimain">Module</a></td> <td class="navimain"><a href="XBridgeFactory-xref.html" class="navimain">Use</a></td> <td class="navimain"><a href="http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/ProUNO/Opening_a_Connection" class="navimain">Devguide</a></td> <td class="navimain"><a href="../../../../index-files/index-1.html" class="navimain">Index</a></td> </tr> </table> <table class="navisub" border="0" cellpadding="0"> <tr> <td class="navisub"><a href="#MethodsSummary" class="navisub">Methods' Summary</a></td> <td class="navisub">Attributes' Summary</td> <td class="navisub"><a href="#MethodsDetails" class="navisub">Methods' Details</a></td> <td class="navisub">Attributes' Details</td> </tr> </table> <hr> <table border="0" width="100%" cellpadding="5" cellspacing="3" class="title-table" style="margin-bottom:6pt;"> <tr> <td><p class="namechain"><a href="../../../../module-ix.html" class="namechain">::</a> <a href="../../../module-ix.html" class="namechain">com</a> :: <a href="../../module-ix.html" class="namechain">sun</a> :: <a href="../module-ix.html" class="namechain">star</a> :: <a href="module-ix.html" class="namechain">bridge</a> :: </p> </td> </tr> <tr> <td class="title">interface XBridgeFactory</td> </tr> <tr> <td/></tr> <tr> <td><dl> <dt><b>Description</b></dt> <dd>factory to create interprocess bridges. </dd> </dl> <a name="devmanual"> </a><dl> <dt><b>Developers Guide</b></dt> <dd><a href="http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/ProUNO/Opening_a_Connection">ProUNO - Opening a Connection</a></dd> </dl> </td> </tr> </table> <hr> <a name="MethodsSummary"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle" colspan="2">Methods' Summary</td> </tr> <tr> <td class="imsum_left"><a href="#createBridge">createBridge</a></td> <td class="imsum_right">tries to create a UNO interprocess bridge. </td> </tr> <tr> <td class="imsum_left"><a href="#getBridge">getBridge</a></td> <td class="imsum_right">tries to get a bridge by this name. </td> </tr> <tr> <td class="imsum_left"><a href="#getExistingBridges">getExistingBridges</a></td> <td class="imsum_right">returns the sequence of all named and unnamed UNO interprocess bridges that are instantiated at the time the call is made. </td> </tr> </table> <a name="MethodsDetails"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle">Methods' Details</td> </tr> <tr> <td class="imdetail"><a name="createBridge" class="membertitle">createBridge</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center"> <tr> <td><table class="table-in-method" border="0"> <tr> <td valign="top" colspan="3"><a href="XBridge.html">XBridge</a></td> </tr> <tr> <td valign="top"><b>createBridge</b>(</td> <td valign="top">[in] string</td> <td valign="bottom"> sName,</td> </tr> <tr> <td/><td valign="top">[in] string</td> <td valign="bottom"> sProtocol,</td> </tr> <tr> <td/><td valign="top">[in] ::com::sun::star::<a href="../connection/module-ix.html">connection</a>::<a href="../connection/XConnection.html">XConnection</a></td> <td valign="bottom"> aConnection,</td> </tr> <tr> <td/><td valign="top">[in] <a href="XInstanceProvider.html">XInstanceProvider</a></td> <td valign="bottom"> anInstanceProvider )</td> </tr> <tr> <td valign="top" align="right">raises( </td> <td valign="top" colspan="2"><a href="BridgeExistsException.html">BridgeExistsException</a>,<br> ::com::sun::star::<a href="../lang/module-ix.html">lang</a>::<a href="../lang/IllegalArgumentException.html">IllegalArgumentException</a> );</td> </tr> </table> <hr> <dl> <dt><b>Description</b></dt> <dd>tries to create a UNO interprocess bridge. </dd> <dt><b>Parameter sName</b></dt> <dd>The name of the bridge. This allows other components to reuse an already created bridge (using getBridge). <p> If empty, an anonymous bridge is created, which cannot be retrieved with getBridge(). No BridgeExistsException can be thrown in this case. </dd> <dt><b>Parameter sProtocol</b></dt> <dd>The protocol, that will be used on the connection (e.g., urp) plus additional comma separated name=value protocol properties. </dd> <dt><b>Parameter aConnection</b></dt> <dd>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. </dd> <dt><b>Parameter anInstanceProvider</b></dt> <dd>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. </dd> <dt><b>Throws</b></dt> <dd>BridgeExistsException There is already a bridge registered with this name. Use getBridge instead. </dd> <dt><b>Throws</b></dt> <dd>IllegalArgumentException The protocol is unknown or the connection is null. </dd> </dl> </td> </tr> </table> </td> </tr> <tr> <td class="imdetail"><a name="getBridge" class="membertitle">getBridge</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center"> <tr> <td><table class="table-in-method" border="0"> <tr> <td valign="top" colspan="3"><a href="XBridge.html">XBridge</a></td> </tr> <tr> <td valign="top"><b>getBridge</b>(</td> <td valign="top">[in] string</td> <td valign="bottom"> sName );</td> </tr> </table> <hr> <dl> <dt><b>Description</b></dt> <dd>tries to get a bridge by this name. </dd> <dd><p> Cannot be retrieved, when the bridge got disposed before. </dd> <dt><b>Returns</b></dt> <dd>An existing remote bridge or a null reference. </dd> </dl> </td> </tr> </table> </td> </tr> <tr> <td class="imdetail"><a name="getExistingBridges" class="membertitle">getExistingBridges</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center"> <tr> <td><table class="table-in-method" border="0"> <tr> <td valign="top" colspan="3">sequence< <a href="XBridge.html">XBridge</a> ></td> </tr> <tr> <td valign="top"><b>getExistingBridges</b>();</td> </tr> </table> <hr> <dl> <dt><b>Description</b></dt> <dd>returns the sequence of all named and unnamed UNO interprocess bridges that are instantiated at the time the call is made. </dd> </dl> </td> </tr> </table> </td> </tr> </table> <a href="#_top_">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright © 2011, Oracle and/or its affiliates. All rights reserved. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.</p> </div> <!-- id="adc-idlref" --> </body> </html>