Class JMXAccessorCreateTask
java.lang.Object
org.apache.tools.ant.ProjectComponent
org.apache.tools.ant.Task
org.apache.catalina.ant.BaseRedirectorHelperTask
org.apache.catalina.ant.jmx.JMXAccessorTask
org.apache.catalina.ant.jmx.JMXAccessorCreateTask
- All Implemented Interfaces:
Cloneable
Create new MBean at JMX JSR 160 MBeans Server.
- Create Mbeans
- Create Mbeans with parameter
- Create remote Mbeans with different classloader
Examples:
create a new Mbean at jmx.server connection
<jmx:create
ref="jmx.server"
name="Catalina:type=MBeanFactory"
className="org.apache.catalina.mbeans.MBeanFactory"
classLoader="Catalina:type=ServerClassLoader,name=server">
<Arg value="org.apache.catalina.mbeans.MBeanFactory" />
</jmxCreate/>
WARNINGNot all Tomcat MBeans can create remotely and autoregister by its parents! Please, use the MBeanFactory operation to generate valves and realms.
First call to a remote MBeanserver save the JMXConnection a reference jmx.server
These tasks require Ant 1.6 or later interface.- Since:
- 5.5.12
- Author:
- Peter Rossbach
-
Field Summary
Fields inherited from class org.apache.catalina.ant.jmx.JMXAccessorTask
JMX_SERVICE_PREFIX, JMX_SERVICE_SUFFIXFields inherited from class org.apache.catalina.ant.BaseRedirectorHelperTask
alwaysLog, failOnError, redirectErrStream, redirector, redirectorConfigured, redirectorElement, redirectOutput, redirectOutStreamFields inherited from class org.apache.tools.ant.Task
target, taskName, taskType, wrapperFields inherited from class org.apache.tools.ant.ProjectComponent
description, location, project -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidgetArgs()protected voidjmxCreate(MBeanServerConnection jmxServerConnection, String name) Create new MBean from ClassLoader identified by an ObjectName.jmxExecute(MBeanServerConnection jmxServerConnection) Execute the specified command, based on the configured properties.voidvoidsetClassLoader(String classLoaderName) voidsetClassName(String className) Methods inherited from class org.apache.catalina.ant.jmx.JMXAccessorTask
accessJMXConnection, convertStringToType, createJMXConnection, createProperty, createProperty, echoResult, execute, getDelimiter, getHost, getIf, getJMXConnection, getName, getPassword, getPort, getProperty, getRef, getResultproperty, getUnless, getUrl, getUsername, isEcho, isSeparatearrayresults, isUseRef, setDelimiter, setEcho, setHost, setIf, setName, setPassword, setPort, setProperty, setRef, setResultproperty, setSeparatearrayresults, setUnless, setUrl, setUsername, testIfCondition, testUnlessConditionMethods inherited from class org.apache.catalina.ant.BaseRedirectorHelperTask
addConfiguredRedirector, closeRedirector, handleErrorFlush, handleErrorOutput, handleFlush, handleOutput, handleOutput, isFailOnError, openRedirector, setAlwaysLog, setAppend, setCreateEmptyFiles, setError, setErrorProperty, setFailonerror, setLogError, setOutput, setOutputpropertyMethods inherited from class org.apache.tools.ant.Task
bindToOwner, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleInput, init, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskTypeMethods inherited from class org.apache.tools.ant.ProjectComponent
clone, getDescription, getLocation, getProject, setDescription, setLocation, setProject
-
Constructor Details
-
JMXAccessorCreateTask
public JMXAccessorCreateTask()
-
-
Method Details
-
getClassLoader
- Returns:
- Returns the classLoader.
-
setClassLoader
- Parameters:
classLoaderName- The classLoader to set.
-
getClassName
- Returns:
- Returns the className.
-
setClassName
- Parameters:
className- The className to set.
-
addArg
-
getArgs
-
setArgs
-
jmxExecute
Description copied from class:JMXAccessorTaskExecute the specified command, based on the configured properties. The input stream will be closed upon completion of this task, whether it was executed successfully or not.- Overrides:
jmxExecutein classJMXAccessorTask- Parameters:
jmxServerConnection- The JMX connection that should be used- Returns:
- An error message string in some situations
- Throws:
Exception- if an error occurs
-
jmxCreate
Create new MBean from ClassLoader identified by an ObjectName.- Parameters:
jmxServerConnection- Connection to the JMX servername- MBean name- Throws:
Exception- Error creating MBean
-