| java.net.URLClassLoader javax.management.loading.MLet
MLet | public class MLet extends URLClassLoader implements MLetMBean,MBeanRegistration(Code) | | Allows you to instantiate and register one or several MBeans in the MBean server
coming from a remote URL. M-let is a shortcut for management applet.
The m-let service does this by loading an m-let text file,
which specifies information on the MBeans to be obtained.
The information on each MBean is specified in a single instance of a tag,
called the MLET tag. The location of the m-let text file is specified by a URL.
The MLET tag has the following syntax:
[arglist]
where:
CODE = class
This attribute specifies the full Java class name, including package name,
of the MBean to be obtained. The compiled .class file of the MBean must be
contained in one of the .jar files specified by the ARCHIVE attribute.
Either CODE or OBJECT must be present.
OBJECT = serfile
This attribute specifies the .ser file that contains a serialized representation
of the MBean to be obtained. This file must be contained in one of the .jar files
specified by the ARCHIVE attribute. If the .jar file contains a directory hierarchy,
specify the path of the file within this hierarchy. Otherwise a match will not be
found. Either CODE or OBJECT must be present.
ARCHIVE = "archiveList"
This mandatory attribute specifies one or more .jar files containing MBeans or
other resources used by the MBean to be obtained. One of the .jar files must
contain the file specified by the CODE or OBJECT attribute. If archivelist contains
more than one file:
Each file must be separated from the one that follows it by a comma (,).
archivelist must be enclosed in double quote marks.
All .jar files in archivelist must be stored in the directory specified by the code base URL.
CODEBASE = codebaseURL
This optional attribute specifies the code base URL of the MBean to be obtained.
It identifies the directory that contains the .jar files specified by the ARCHIVE
attribute. Specify this attribute only if the .jar files are not in the same directory
as the m-let text file. If this attribute is not specified, the base URL of the m-let text file is used.
NAME = mbeanname
This optional attribute specifies the object name to be assigned to the MBean instance
when the m-let service registers it. If mbeanname starts with the colon character (:),
the domain part of the object name is the domain of the agent. The m-let service
invokes the getDomain() method of the Framework class to obtain this information.
VERSION = version
This optional attribute specifies the version number of the MBean and associated .jar
files to be obtained. This version number can be used to specify that the .jar files
are loaded from the server to update those stored locally in the cache the next time
the m-let text file is loaded. version must be a series of non-negative decimal
integers each separated by a period from the one that precedes it.
arglist
This optional attribute specifies a list of one or more parameters for the MBean to
be instantiated. This list describes the parameters to be passed the MBean's
constructor. Use the following syntax to specify each item in arglist:
where:
argumentType is the type of the argument that will be passed as parameter to the
MBean's constructor.
The arguments' type in the argument list should be a Java primitive type or a Java
basic type (java.lang.Boolean, java.lang.Byte, java.lang.Short, java.lang.Long,
java.lang.Integer, java.lang.Float, java.lang.Double, java.lang.String).
When an m-let text file is loaded, an instance of each MBean specified in the file is
created and registered.
The m-let Service extends the java.net.URLClassLoader and can be used to load remote
classes and jar files in the VM of the agent.
Note - The MLet class loader uses the
MBeanServerFactory.getClassLoaderRepository(javax.management.MBeanServer) to load
classes that could not be found in the loaded jar files.
author: Young Yang |
createMBean | protected ObjectInstance createMBean(MLetObject mlet)(Code) | | doCreate a MBean by the offered mlet
Parameters: mlet - ObjectInstance of the created MBean |
getLibraryDirectory | public String getLibraryDirectory()(Code) | | |
getMLetURLs | protected URL[] getMLetURLs(MLetObject mlet, String defaultCodeBase)(Code) | | get the jar urls, so can add it the the classloader path
|
postDeregister | public void postDeregister()(Code) | | |
setLibraryDirectory | public void setLibraryDirectory(String ld)(Code) | | |
|
|