org.wildfly.core.embedded

Class EmbeddedServerFactory

java.lang.Object

org.wildfly.core.embedded.EmbeddedServerFactory

public class EmbeddedServerFactory
extends Object

Factory that sets up an embedded standalone server using modular classloading.

To use this class the jboss.home.dir system property must be set to the application server home directory. By default it will use the directories {$jboss.home.dir}/standalone/config as the configuration directory and {$jboss.home.dir}/standalone/data as the data directory. This can be overridden with the ${jboss.server.base.dir}, ${jboss.server.config.dir} or ${jboss.server.config.dir} system properties as for normal server startup.

If a clean run is wanted, you can specify ${jboss.embedded.root} to an existing directory which will copy the contents of the data and configuration directories under a temporary folder. This has the effect of this run not polluting later runs of the embedded server.

Author:

Kabir Khan, Thomas.Diesler@jboss.com

Method Summary

Modifier and Type	Method and Description
static StandaloneServer	create(org.jboss.modules.ModuleLoader moduleLoader, File jbossHomeDir) Create an embedded standalone server with an already established module loader.
static StandaloneServer	create(org.jboss.modules.ModuleLoader moduleLoader, File jbossHomeDir, String[] cmdargs) Create an embedded standalone server with an already established module loader.
static StandaloneServer	create(String jbossHomePath, String modulePath, String... systemPackages) Create an embedded standalone server.
static StandaloneServer	create(String jbossHomePath, String modulePath, String[] systemPackages, String[] cmdargs) Create an embedded standalone server.
static EmbeddedServerReference	createHostController(org.jboss.modules.ModuleLoader moduleLoader, File jbossHomeDir, String[] cmdargs) Create an embedded host controller with an already established module loader.
static EmbeddedServerReference	createHostController(String jbossHomePath, String modulePath, String[] systemPackages, String[] cmdargs)
static EmbeddedServerReference	createStandalone(org.jboss.modules.ModuleLoader moduleLoader, File jbossHomeDir, String[] cmdargs)
static EmbeddedServerReference	createStandalone(String jbossHomePath, String modulePath, String[] systemPackages, String[] cmdargs)

Methods inherited from class java.lang.Object

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

Method Detail

create

public static StandaloneServer create(String jbossHomePath,
                                      String modulePath,
                                      String... systemPackages)

Create an embedded standalone server.

Parameters:

jbossHomePath - the location of the root of server installation. Cannot be null or empty.

modulePath - the location of the root of the module repository. May be null if the standard location under jbossHomePath should be used

systemPackages - names of any packages that must be treated as system packages, with the same classes visible to the caller's classloader visible to server-side classes loaded from the server's modular classlaoder

Returns:

the server. Will not be null

create

public static StandaloneServer create(String jbossHomePath,
                                      String modulePath,
                                      String[] systemPackages,
                                      String[] cmdargs)

Create an embedded standalone server.

Parameters:

jbossHomePath - the location of the root of server installation. Cannot be null or empty.

modulePath - the location of the root of the module repository. May be null if the standard location under jbossHomePath should be used

systemPackages - names of any packages that must be treated as system packages, with the same classes visible to the caller's classloader visible to server-side classes loaded from the server's modular classlaoder

cmdargs - any additional arguments to pass to the embedded server (e.g. -b=192.168.100.10)

Returns:

the server. Will not be null

createStandalone

public static EmbeddedServerReference createStandalone(String jbossHomePath,
                                                       String modulePath,
                                                       String[] systemPackages,
                                                       String[] cmdargs)

create

public static StandaloneServer create(org.jboss.modules.ModuleLoader moduleLoader,
                                      File jbossHomeDir)

Create an embedded standalone server with an already established module loader.

Parameters:

moduleLoader - the module loader. Cannot be null

jbossHomeDir - the location of the root of server installation. Cannot be null or empty.

Returns:

the server. Will not be null

create

public static StandaloneServer create(org.jboss.modules.ModuleLoader moduleLoader,
                                      File jbossHomeDir,
                                      String[] cmdargs)

Create an embedded standalone server with an already established module loader.

Parameters:

moduleLoader - the module loader. Cannot be null

jbossHomeDir - the location of the root of server installation. Cannot be null or empty.

cmdargs - any additional arguments to pass to the embedded server (e.g. -b=192.168.100.10)

Returns:

the server. Will not be null

createStandalone

public static EmbeddedServerReference createStandalone(org.jboss.modules.ModuleLoader moduleLoader,
                                                       File jbossHomeDir,
                                                       String[] cmdargs)

createHostController

public static EmbeddedServerReference createHostController(String jbossHomePath,
                                                           String modulePath,
                                                           String[] systemPackages,
                                                           String[] cmdargs)

createHostController

public static EmbeddedServerReference createHostController(org.jboss.modules.ModuleLoader moduleLoader,
                                                           File jbossHomeDir,
                                                           String[] cmdargs)

Create an embedded host controller with an already established module loader.

Parameters:

moduleLoader - the module loader. Cannot be null

jbossHomeDir - the location of the root of server installation. Cannot be null or empty.

cmdargs - any additional arguments to pass to the embedded server (e.g. -b=192.168.100.10)

Returns:

the running host controller Will not be null