Package com.sun.star.comp.helper

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 Summary

Constructors

Constructor	Description
Bootstrap()

Method Summary

Modifier and Type	Method	Description
static XComponentContext	bootstrap()	Bootstraps the component context from a UNO installation.
static XComponentContext	bootstrap(String[] argArray)	Bootstraps the component context from a UNO installation.
static XComponentContext	createInitialComponentContext(Hashtable<String,Object> context_entries)	backwards compatibility stub.
static XComponentContext	createInitialComponentContext(Map<String,Object> context_entries)	Bootstraps an initial component context with service manager and basic jurt components inserted.
static XMultiServiceFactory	createSimpleServiceManager()	Bootstraps a servicemanager with the jurt base components registered.
static XComponentContext	defaultBootstrap_InitialComponentContext()	Bootstraps the initial component context from a native UNO installation.
static XComponentContext	defaultBootstrap_InitialComponentContext(String ini_file, Hashtable<String,String> bootstrap_parameters)	Backwards compatibility stub.
static XComponentContext	defaultBootstrap_InitialComponentContext(String ini_file, Map<String,String> bootstrap_parameters)	Bootstraps the initial component context from a native UNO installation.
static String[]	getDefaultOptions()	Returns an array of default commandline options to start bootstrapped instance of soffice with.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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 boostrapped 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:

getDefaultOptions()