Package com.sun.star.comp.helper

Class 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 Detail

      • Bootstrap

        public Bootstrap()

    • Method Detail

      • 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:
        bootstrap( String[] )

      • 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​(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:
        getDefaultOptions()