Difference between revisions of "Documentation/DevGuide/UCB/Instantiating the UCB"
From Apache OpenOffice Wiki
< Documentation | DevGuide
OOoWikiBot (Talk | contribs) m (FINAL VERSION FOR L10N) |
|||
Line 14: | Line 14: | ||
There are several predefined UCB configurations. Each configuration contains data that describes a set of UCPs. All UCPs contained in a configuration are registered at the UCB that is created using this configuration. A UCB configuration is identified by two keys that are strings. The standard configuration is "<code>Local</code>" and "<code>Office</code>", which generally allows access to all UCPs available in a local installation. | There are several predefined UCB configurations. Each configuration contains data that describes a set of UCPs. All UCPs contained in a configuration are registered at the UCB that is created using this configuration. A UCB configuration is identified by two keys that are strings. The standard configuration is "<code>Local</code>" and "<code>Office</code>", which generally allows access to all UCPs available in a local installation. | ||
− | + | <syntaxhighlight lang="java"> | |
import com.sun.star.lang.XMultiServiceFactory; | import com.sun.star.lang.XMultiServiceFactory; | ||
import com.sun.star.uno.Exception; | import com.sun.star.uno.Exception; | ||
Line 49: | Line 49: | ||
return true; | return true; | ||
} | } | ||
− | + | </syntaxhighlight> | |
For information about other configurations, refer to [[Documentation/DevGuide/UCB/Configuration|Configuration]]. | For information about other configurations, refer to [[Documentation/DevGuide/UCB/Configuration|Configuration]]. | ||
Latest revision as of 16:08, 21 December 2020
The following steps have to be performed before a process can use the UCB:
- Create and set the UNO service manager.
- Create an instance of the UNO service com.sun.star.ucb.UniversalContentBroker, passing the keys identifying a predefined UCB configuration to
createInstanceWithArguments()
.
There are several predefined UCB configurations. Each configuration contains data that describes a set of UCPs. All UCPs contained in a configuration are registered at the UCB that is created using this configuration. A UCB configuration is identified by two keys that are strings. The standard configuration is "Local
" and "Office
", which generally allows access to all UCPs available in a local installation.
import com.sun.star.lang.XMultiServiceFactory; import com.sun.star.uno.Exception; import com.sun.star.uno.XInterface; boolean initUCB() { ///////////////////////////////////////////////////////////////////// // Obtain Process Service Manager. ///////////////////////////////////////////////////////////////////// XMultiServiceFactory xServiceFactory = ... ///////////////////////////////////////////////////////////////////// // Create UCB. This needs to be done only once per process. ///////////////////////////////////////////////////////////////////// XInterface xUCB; try { // Supply configuration to use for this UCB instance... String[] keys = new String[2]; keys[ 0 ] = "Local"; keys[ 1 ] = "Office"; xUCB = xServiceFactory.createInstanceWithArguments( "com.sun.star.ucb.UniversalContentBroker", keys ); } catch (com.sun.star.uno.Exception e) { } if (xUCB == null) return false; return true; }
For information about other configurations, refer to Configuration.
Content on this page is licensed under the Public Documentation License (PDL). |