cn.hserver.plugin.loader

类 PropertiesLauncher

java.lang.Object

cn.hserver.plugin.loader.Launcher

cn.hserver.plugin.loader.PropertiesLauncher

public class PropertiesLauncher
extends Launcher

Launcher for archives with user-configured classpath and main class via a properties file. This model is often more flexible and more amenable to creating well-behaved OS-level services than a model based on executable jars.

Looks in various places for a properties file to extract loader settings, defaulting to application.properties either on the current classpath or in the current working directory. The name of the properties file can be changed by setting a System property loader.config.name (e.g. -Dloader.config.name=foo will look for foo.properties. If that file doesn't exist then tries loader.config.location (with allowed prefixes classpath: and file: or any valid URL). Once that file is located turns it into Properties and extracts optional values (which can also be provided overridden as System properties in case the file doesn't exist):

• loader.path: a comma-separated list of directories to append to the classpath (containing file resources and/or nested archives in *.jar or *.zip). Defaults to lib in your application archive
• loader.main: the main method to delegate execution to once the class loader is set up. No default, but will fall back to looking for a Start-Class in a MANIFEST.MF, if there is one in ${loader.home}/META-INF.

作者:

Dave Syer, Janne Valkealahti

字段概要

字段

限定符和类型	字段和说明
static String	ARGS Properties key for default command line arguments.
static String	CONFIG_LOCATION Properties key for config file location (including optional classpath:, file: or URL prefix).
static String	CONFIG_NAME Properties key for name of external configuration file (excluding suffix).
static String	HOME Properties key for home directory.
static String	MAIN Properties key for main class.
static String	PATH Properties key for classpath entries (directories possibly containing jars).
static String	SET_SYSTEM_PROPERTIES Properties key for boolean flag (default false) which if set will cause the external configuration properties to be copied to System properties (assuming that is allowed by Java security).

构造器概要

构造器

构造器和说明
PropertiesLauncher()

方法概要

限定符和类型	方法和说明
protected ClassLoader	createClassLoader(List<Archive> archives) Create a classloader for the specified archives.
protected String[]	getArgs(String... args)
protected List<Archive>	getClassPathArchives() Returns the archives that will be used to construct the class path.
protected File	getHomeDirectory()
protected String	getMainClass() Returns the main class that should be launched.
static void	main(String[] args)
static String	toCamelCase(CharSequence string)

从类继承的方法 cn.hserver.plugin.loader.Launcher

createArchive, createClassLoader, createMainMethodRunner, launch, launch

从类继承的方法 java.lang.Object

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

字段详细资料

MAIN

public static final String MAIN

Properties key for main class. As a manifest entry can also be specified as Start-Class.

另请参阅:

常量字段值

PATH

public static final String PATH

Properties key for classpath entries (directories possibly containing jars). Defaults to "lib/" (relative to loader home directory). Multiple entries can be specified using a comma-separated list.

另请参阅:

常量字段值

HOME

public static final String HOME

Properties key for home directory. This is the location of external configuration if not on classpath, and also the base path for any relative paths in the loader path. Defaults to current working directory ( ${user.dir}).

另请参阅:

常量字段值

ARGS

public static final String ARGS

Properties key for default command line arguments. These arguments (if present) are prepended to the main method arguments before launching.

另请参阅:

常量字段值

CONFIG_NAME

public static final String CONFIG_NAME

Properties key for name of external configuration file (excluding suffix). Defaults to "application". Ignored if loader config location is provided instead.

另请参阅:

常量字段值

CONFIG_LOCATION

public static final String CONFIG_LOCATION

Properties key for config file location (including optional classpath:, file: or URL prefix).

另请参阅:

常量字段值

SET_SYSTEM_PROPERTIES

public static final String SET_SYSTEM_PROPERTIES

Properties key for boolean flag (default false) which if set will cause the external configuration properties to be copied to System properties (assuming that is allowed by Java security).

另请参阅:

常量字段值

构造器详细资料

PropertiesLauncher

public PropertiesLauncher()

方法详细资料

getHomeDirectory

protected File getHomeDirectory()

getArgs

protected String[] getArgs(String... args)
                    throws Exception

抛出:

Exception

getMainClass

protected String getMainClass()
                       throws Exception

从类复制的说明: Launcher

Returns the main class that should be launched.

指定者:

getMainClass 在类中 Launcher

返回:

the name of the main class

抛出:

Exception - if the main class cannot be obtained

createClassLoader

protected ClassLoader createClassLoader(List<Archive> archives)
                                 throws Exception

从类复制的说明: Launcher

Create a classloader for the specified archives.

覆盖:

createClassLoader 在类中 Launcher

参数:

archives - the archives

返回:

the classloader

抛出:

Exception - if the classloader cannot be created

getClassPathArchives

protected List<Archive> getClassPathArchives()
                                      throws Exception

从类复制的说明: Launcher

Returns the archives that will be used to construct the class path.

指定者:

getClassPathArchives 在类中 Launcher

返回:

the class path archives

抛出:

Exception - if the class path archives cannot be obtained

main

public static void main(String[] args)
                 throws Exception

抛出:

Exception

toCamelCase

public static String toCamelCase(CharSequence string)