JkMain (Apache Tomcat 6.0.24 API Documentation)

Main class used to startup and configure jk. It manages the conf/jk2.properties file and is the target of JMX proxy. It implements a policy of save-on-change - whenever a property is changed at runtime the jk2.properties file will be overriden. You can edit the config file when tomcat is stoped ( or if you don't use JMX or other admin tools ). The format of jk2.properties:

TYPE[.LOCALNAME].PROPERTY_NAME=VALUE: Set a property on the associated component. TYPE will be used to find the class name and instantiate the component. LOCALNAME allows multiple instances. In JMX mode, TYPE and LOCALNAME will form the JMX name ( eventually combined with a 'jk2' component )
NAME=VALUE: Define global properties to be used in ${} substitutions
class.COMPONENT_TYPE=JAVA_CLASS_NAME: Adds a new 'type' of component. We predefine all known types.

Instances are created the first time a component name is found. In addition, 'handler.list' property will override the list of 'default' components that are loaded automatically. Note that the properties file is just one (simplistic) way to configure jk. We hope to see configs based on registry, LDAP, db, etc. ( XML is not necesarily better )

Author: Costin Manolache

Set the base dir of jk2. ( including WEB-INF if in a webapp ). We'll try to guess it from classpath if none is set ( for example on command line ), but if in a servlet environment you need to use Context.getRealPath or a system property or set it expliciltey.

Field Summary
protected String	domain
protected MBeanServer	mserver
protected ObjectName	oname

Method Summary
String	getChannelClassName()
String	getDomain()
String	getErr()
long	getInitTime() The time it took to initialize jk ( ms)
String	getJkHome()
static JkMain	getJkMain()
ObjectName	getObjectName()
String	getOut()
String	getPropertiesFile()
Object	getProperty(String name) Retrieve a property.
long	getStartTime() The time it took to start jk ( ms )
String	getWorkerClassName()
WorkerEnv	getWorkerEnv()
void	init()
static void	main(String[] args)
void	pause()
void	postDeregister()
void	postRegister(Boolean registrationDone)
void	preDeregister()
ObjectName	preRegister(MBeanServer server, ObjectName name)
void	resume()
void	saveProperties()
void	setBeanProperty(Object target, String name, String val)
void	setChannelClassName(String name) Set the `channelClassName` that will used to connect to httpd.
void	setErr(String s)
void	setJkHome(String s) Set the base dir of jk2.
void	setOut(String s)
void	setPropertiesFile(String p) Load a .properties file into and set the values into jk2 configuration.
void	setProperty(String n, String v) Set a name/value as a jk2 property
void	setPropertyString(String handlerN, String name, String val)
void	setSaveProperties(boolean b)
void	setWorkerClassName(String name) Set the `workerClassName` that will handle the request.
void	setWorkerEnv(WorkerEnv wEnv)
void	start()
void	stop()

Class JkMain