Class Bootstrap

java.lang.Object
com.sun.star.comp.helper.Bootstrap

public class Bootstrap extends Object
Bootstrap offers functionality to obtain a context or simply a service manager. The service manager can create a few basic services, whose implementations are:
  • com.sun.star.comp.loader.JavaLoader
  • com.sun.star.comp.urlresolver.UrlResolver
  • com.sun.star.comp.bridgefactory.BridgeFactory
  • com.sun.star.comp.connections.Connector
  • com.sun.star.comp.connections.Acceptor
  • com.sun.star.comp.servicemanager.ServiceManager
Other services can be inserted into the service manager by using its XSet interface:
        XSet xSet = UnoRuntime.queryInterface( XSet.class, aMultiComponentFactory );
        // insert the service manager
        xSet.insert( aSingleComponentFactory );
    
  • Constructor Details

    • Bootstrap

      public Bootstrap()
  • Method Details

    • getDefaultOptions

      public static final String[] getDefaultOptions()
      Returns an array of default commandline options to start bootstrapped instance of soffice with. You may use it in connection with bootstrap method for example like this:
           List list = Arrays.asList( Bootstrap.getDefaultOptions() );
           list.remove("--nologo");
           list.remove("--nodefault");
           list.add("--invisible");
      
           Bootstrap.bootstrap( list.toArray( new String[list.size()] );
       
      Returns:
      an array of default commandline options
      Since:
      LibreOffice 5.1
      See Also:
    • createInitialComponentContext

      public static XComponentContext createInitialComponentContext(Hashtable<String,Object> context_entries) throws Exception
      backwards compatibility stub.
      Parameters:
      context_entries - the hash table contains mappings of entry names (type string) to context entries (type class ComponentContextEntry).
      Returns:
      a new context.
      Throws:
      Exception - if things go awry.
    • createInitialComponentContext

      public static XComponentContext createInitialComponentContext(Map<String,Object> context_entries) throws Exception
      Bootstraps an initial component context with service manager and basic jurt components inserted.
      Parameters:
      context_entries - the hash table contains mappings of entry names (type string) to context entries (type class ComponentContextEntry).
      Returns:
      a new context.
      Throws:
      Exception - if things go awry.
    • createSimpleServiceManager

      public static XMultiServiceFactory createSimpleServiceManager() throws Exception
      Bootstraps a servicemanager with the jurt base components registered. See also UNOIDL com.sun.star.lang.ServiceManager.
      Returns:
      a freshly bootstrapped service manager
      Throws:
      Exception - if things go awry.
    • defaultBootstrap_InitialComponentContext

      public static final XComponentContext defaultBootstrap_InitialComponentContext() throws Exception
      Bootstraps the initial component context from a native UNO installation.
      Returns:
      a freshly bootstrapped component context. See also cppuhelper/defaultBootstrap_InitialComponentContext().
      Throws:
      Exception - if things go awry.
    • defaultBootstrap_InitialComponentContext

      public static final XComponentContext defaultBootstrap_InitialComponentContext(String ini_file, Hashtable<String,String> bootstrap_parameters) throws Exception
      Backwards compatibility stub.
      Parameters:
      ini_file - ini_file (may be null: uno.rc besides cppuhelper lib)
      bootstrap_parameters - bootstrap parameters (maybe null)
      Returns:
      a freshly bootstrapped component context.
      Throws:
      Exception - if things go awry.
    • defaultBootstrap_InitialComponentContext

      public static final XComponentContext defaultBootstrap_InitialComponentContext(String ini_file, Map<String,String> bootstrap_parameters) throws Exception
      Bootstraps the initial component context from a native UNO installation. See also cppuhelper/defaultBootstrap_InitialComponentContext().
      Parameters:
      ini_file - ini_file (may be null: uno.rc besides cppuhelper lib)
      bootstrap_parameters - bootstrap parameters (maybe null)
      Returns:
      a freshly bootstrapped component context.
      Throws:
      Exception - if things go awry.
    • bootstrap

      public static final XComponentContext bootstrap() throws BootstrapException
      Bootstraps the component context from a UNO installation.
      Returns:
      a bootstrapped component context.
      Throws:
      BootstrapException - if things go awry.
      Since:
      UDK 3.1.0
    • bootstrap

      public static final XComponentContext bootstrap(String[] argArray) throws BootstrapException
      Bootstraps the component context from a UNO installation.
      Parameters:
      argArray - an array of strings - commandline options to start instance of soffice with
      Returns:
      a bootstrapped component context.
      Throws:
      BootstrapException - if things go awry.
      Since:
      LibreOffice 5.1
      See Also:
    • bootstrapWebsocketConnection

      public static final XComponentContext bootstrapWebsocketConnection(String url) throws BootstrapException
      Bootstraps the component context from a websocket location.
      Parameters:
      url - the ws:// or wss:// url of the websocket server
      Returns:
      a bootstrapped component context.
      Throws:
      BootstrapException - if things go awry.
      Since:
      LibreOffice 24.2