|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.lang.ClassLoader | +--java.security.SecureClassLoader | +--java.net.URLClassLoader | +--javax.management.loading.MLet
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:
<MLET
CODE =
class | OBJECT =
serfile
ARCHIVE = "
archiveList"
[CODEBASE =
codebaseURL]
[NAME =
mbeanname]
[VERSION =
version]
>
[
arglist]
</MLET
>
where:
CODE =
class.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.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"
.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:
.jar
files in archivelist must be stored in the directory specified by the code base URL.
CODEBASE =
codebaseURL.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 =
mbeannamegetDomain()
method of the Framework class to
obtain this information.
VERSION =
version.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.
ARG TYPE=
argumentType VALUE=
value>
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
).
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 DefaultLoaderRepository
to load classes that could not be found in the loaded jar files.
Constructor Summary | |
MLet()
Constructs a new MLet using the default delegation parent ClassLoader. |
|
MLet(java.net.URL[] urls)
Constructs a new MLet for the specified URLs using the default delegation parent ClassLoader. |
|
MLet(java.net.URL[] urls,
java.lang.ClassLoader parent)
Constructs a new MLet for the given URLs. |
|
MLet(java.net.URL[] urls,
java.lang.ClassLoader parent,
java.net.URLStreamHandlerFactory factory)
Constructs a new MLet for the specified URLs, parent class loader, and URLStreamHandlerFactory. |
Method Summary | |
void |
addURL(java.lang.String url)
Appends the specified URL to the list of URLs to search for classes and resources. |
void |
addURL(java.net.URL url)
Appends the specified URL to the list of URLs to search for classes and resources. |
protected java.lang.Class |
findClass(java.lang.String name)
This is the main method for class loaders that is being redefined. |
protected java.lang.String |
findLibrary(java.lang.String libname)
Returns the absolute path name of a native library. |
java.lang.String |
getLibraryDirectory()
Gets the current directory used by the library loader for storing native libraries before they are loaded into memory. |
java.util.Set |
getMBeansFromURL(java.lang.String url)
Loads a text file containing MLET tags that define the MBeans to be added to the agent. |
java.util.Set |
getMBeansFromURL(java.net.URL url)
Loads a text file containing MLET tags that define the MBeans to be added to the agent. |
java.net.URL[] |
getURLs()
Returns the search path of URLs for loading classes and resources. |
void |
postDeregister()
Allows the m-let to perform any operations needed after having been de-registered in the MBean server. |
void |
postRegister(java.lang.Boolean registrationDone)
Allows the m-let to perform any operations needed after having been registered in the MBean server or after the registration has failed. |
void |
preDeregister()
Allows the m-let to perform any operations it needs before being de-registered by the MBean server. |
ObjectName |
preRegister(MBeanServer server,
ObjectName name)
Allows the m-let to perform any operations it needs before being registered in the MBean server. |
void |
readExternal(java.io.ObjectInput in)
This method reads the object's contents during Object Serialization. |
void |
setLibraryDirectory(java.lang.String libdir)
Sets the directory used by the library loader for storing native libraries before they are loaded into memory. |
void |
writeExternal(java.io.ObjectOutput out)
This method saves the object's contents during Object Serialization. |
Methods inherited from class java.net.URLClassLoader |
definePackage,
findResource,
findResources,
getPermissions,
newInstance,
newInstance |
Methods inherited from class java.security.SecureClassLoader |
defineClass |
Methods inherited from class java.lang.ClassLoader |
defineClass,
defineClass,
defineClass,
definePackage,
findLoadedClass,
findSystemClass,
getPackage,
getPackages,
getParent,
getResource,
getResourceAsStream,
getResources,
getSystemClassLoader,
getSystemResource,
getSystemResourceAsStream,
getSystemResources,
loadClass,
loadClass,
resolveClass,
setSigners |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
Constructor Detail |
public MLet()
public MLet(java.net.URL[] urls)
urls
- The URLs from which to load classes and resources.public MLet(java.net.URL[] urls, java.lang.ClassLoader parent)
urls
- The URLs from which to load classes and resources.parent
- The parent class loader for delegation.public MLet(java.net.URL[] urls, java.lang.ClassLoader parent, java.net.URLStreamHandlerFactory factory)
urls
- The URLs from which to load classes and resources.parent
- The parent class loader for delegation.factory
- The URLStreamHandlerFactory to use when creating URLs.Method Detail |
public void addURL(java.net.URL url)
public void addURL(java.lang.String url) throws ServiceNotFoundException
public java.net.URL[] getURLs()
public java.util.Set getMBeansFromURL(java.net.URL url) throws ServiceNotFoundException
url
- The URL of the text file to be loaded as URL object.public java.util.Set getMBeansFromURL(java.lang.String url) throws ServiceNotFoundException
url
- The URL of the text file to be loaded as String object.public java.lang.String getLibraryDirectory()
public void setLibraryDirectory(java.lang.String libdir)
libdir
- The directory used by the library loader.public ObjectName preRegister(MBeanServer server, ObjectName name) throws java.lang.Exception
server
- The MBean server in which the m-let will be registered.name
- The object name of the m-let.public void postRegister(java.lang.Boolean registrationDone)
registrationDone
- Indicates whether or not the m-let has been successfully registered in
the MBean server. The value false means that either the registration phase
has failed.public void preDeregister() throws java.lang.Exception
public void postDeregister()
public void writeExternal(java.io.ObjectOutput out) throws java.io.IOException
out
- The serialization output stream.public void readExternal(java.io.ObjectInput in) throws java.io.IOException, java.lang.ClassNotFoundException
in
- The serialization input stream.protected java.lang.Class findClass(java.lang.String name) throws java.lang.ClassNotFoundException
name
- The name of the class.protected java.lang.String findLibrary(java.lang.String libname)
OSName/OSArch/OSVersion/lib/nativelibname
), i.e.
the library stat on Solaris SPARC 5.7 will be searched in the JAR file as:
If this method returns null
, i.e. the libraries were not found in any of the JAR
files loaded with this class loader, the VM searches the library along the path specified as
the java.library.path
property.
libname
- The library name.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |