|
|||||||||
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
The m-let Service allows you to instantiate and register in the MBeanServer one or several MBeans 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. 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.
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 MBeanServer. |
void |
postRegister(java.lang.Boolean registrationDone)
Allows the m-let to perform any operations needed after having been registered in the MBeanServer or after the registration has failed. |
void |
preDeregister()
Allows the m-let to perform any operations it needs before being de-registered by the MBeanServer. |
ObjectName |
preRegister(MBeanServer server,
ObjectName name)
Allows the m-let to perform any operations it needs before being registered in the MBeanServer. |
void |
readExternal(java.io.ObjectInput in)
This method reads the objects 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 objects 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 resourcespublic MLet(java.net.URL[] urls, java.lang.ClassLoader parent)
urls
- the URLs from which to load classes and resourcesparent
- the parent class loader for delegationpublic MLet(java.net.URL[] urls, java.lang.ClassLoader parent, java.net.URLStreamHandlerFactory factory)
urls
- the URLs from which to load classes and resourcesparent
- the parent class loader for delegationfactory
- the URLStreamHandlerFactory to use when creating URLsMethod 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 MBeanServer 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 MBeanServer. 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 |