Package org.apache.catalina.ant.jmx
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 SummaryFields inherited from class org.apache.catalina.ant.jmx.JMXAccessorTaskJMX_SERVICE_PREFIX, JMX_SERVICE_SUFFIXFields inherited from class org.apache.catalina.ant.BaseRedirectorHelperTaskalwaysLog, failOnError, redirectErrStream, redirector, redirectorConfigured, redirectorElement, redirectOutput, redirectOutStreamFields inherited from class org.apache.tools.ant.Tasktarget, taskName, taskType, wrapperFields inherited from class org.apache.tools.ant.ProjectComponentdescription, location, project
- 
Constructor SummaryConstructors
- 
Method SummaryModifier 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.JMXAccessorTaskaccessJMXConnection, 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.BaseRedirectorHelperTaskaddConfiguredRedirector, closeRedirector, handleErrorFlush, handleErrorOutput, handleFlush, handleOutput, handleOutput, isFailOnError, openRedirector, setAlwaysLog, setAppend, setCreateEmptyFiles, setError, setErrorProperty, setFailonerror, setLogError, setOutput, setOutputpropertyMethods inherited from class org.apache.tools.ant.TaskbindToOwner, 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.ProjectComponentclone, getDescription, getLocation, getProject, setDescription, setLocation, setProject
- 
Constructor Details- 
JMXAccessorCreateTaskpublic 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- Returns:
- Returns the args.
 
- 
setArgs- Parameters:
- args- The args to set.
 
- 
jmxExecuteDescription 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 class- JMXAccessorTask
- Parameters:
- jmxServerConnection- The JMX connection that should be used
- Returns:
- An error message string in some situations
- Throws:
- Exception- if an error occurs
 
- 
jmxCreateCreate new MBean from ClassLoader identified by an ObjectName.- Parameters:
- jmxServerConnection- Connection to the JMX server
- name- MBean name
- Throws:
- Exception- Error creating MBean
 
 
-