javax.management.loading
Class MLet

java.lang.Object
  java.lang.ClassLoader
      java.security.SecureClassLoader
          java.net.URLClassLoader
              javax.management.loading.MLet

All Implemented Interfaces:

Externalizable, MBeanRegistration, MLetMBean, Serializable

Direct Known Subclasses:

PrivateMLet

public class MLet

extends URLClassLoader

implements MLetMBean, MBeanRegistration, Externalizable

URL classloader capable of parsing an MLet text file adhering to the file format defined in the JMX specification (v1.0).

Version:

$Revision: 1.10.4.8 $

Author:

Juha Lindfors.

See Also:

MLetMBean, Serialized Form

Constructor Summary

MLet()

MLet(URL[] urls)

MLet(URL[] urls, boolean delegateToCLR)

MLet(URL[] urls, ClassLoader parent)

MLet(URL[] urls, ClassLoader parent, boolean delegateToCLR)

MLet(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory)

MLet(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory, boolean delegateToCLR)

Method Summary

void	addURL(String url) Adds the given URL to the MLet's classpath.
void	addURL(URL url) Adds the given URL to the MLet's classpath.
String	getLibraryDirectory()
Set	getMBeansFromURL(String url) Loads an MLET text file from a given url.
Set	getMBeansFromURL(URL url) Loads an MLET text file from a given url.
Class	loadClass(String name, boolean resolve)
void	postDeregister() This method is called by the MBeanServer after deregistration takes place.
void	postRegister(Boolean registrationDone) This method is called by the MBeanServer after registration takes place or when registration fails.
void	preDeregister() This method is called by the MBeanServer before deregistration takes place.
ObjectName	preRegister(MBeanServer server, ObjectName name) This method is called by the MBeanServer before registration takes place.
void	readExternal(ObjectInput in) This implementation does not support externalizing an MLet.
void	setLibraryDirectory(String libdir)
void	writeExternal(ObjectOutput out) This implementation does not support externalizing an MLet.

Methods inherited from class java.net.URLClassLoader

definePackage, findClass, findResource, findResources, getPermissions, getURLs, newInstance, newInstance

Methods inherited from class java.security.SecureClassLoader

defineClass

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, definePackage, findLibrary, findLoadedClass, findSystemClass, getPackage, getPackages, getParent, getResource, getResourceAsStream, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.management.loading.MLetMBean

getResource, getResourceAsStream, getResources, getURLs

Constructor Detail

MLet

public MLet()

MLet

public MLet(URL[] urls)

MLet

public MLet(URL[] urls,
            ClassLoader parent)

MLet

public MLet(URL[] urls,
            ClassLoader parent,
            URLStreamHandlerFactory factory)

MLet

public MLet(URL[] urls,
            boolean delegateToCLR)

MLet

public MLet(URL[] urls,
            ClassLoader parent,
            boolean delegateToCLR)

MLet

public MLet(URL[] urls,
            ClassLoader parent,
            URLStreamHandlerFactory factory,
            boolean delegateToCLR)

Method Detail

preRegister

public ObjectName preRegister(MBeanServer server,
                              ObjectName name)
                       throws Exception

Description copied from interface: MBeanRegistration

This method is called by the MBeanServer before registration takes place. The MBean is passed a reference of the MBeanServer it is about to be registered with. The MBean must return the ObjectName it will be registered with. The MBeanServer can pass a suggested object depending upon how the MBean is registered.

The MBean can stop the registration by throwing an exception.The exception is forwarded to the invoker wrapped in an MBeanRegistrationException.

Specified by:

preRegister in interface MBeanRegistration

Returns:

the actual ObjectName to register this MBean with.

Throws:

Exception - for any error, the MBean is not registered.

postRegister

public void postRegister(Boolean registrationDone)

Description copied from interface: MBeanRegistration

This method is called by the MBeanServer after registration takes place or when registration fails.

Specified by:

postRegister in interface MBeanRegistration

Parameters:

registrationDone - the MBeanServer passes true when the MBean was registered, false otherwise.

preDeregister

public void preDeregister()
                   throws Exception

Description copied from interface: MBeanRegistration

This method is called by the MBeanServer before deregistration takes place.

The MBean can throw an exception, this will stop the deregistration. The exception is forwarded to the invoker wrapped in an MBeanRegistrationException.

Specified by:

preDeregister in interface MBeanRegistration

Throws:

Exception

postDeregister

public void postDeregister()

Description copied from interface: MBeanRegistration

This method is called by the MBeanServer after deregistration takes place.

Specified by:

postDeregister in interface MBeanRegistration

getMBeansFromURL

public Set getMBeansFromURL(String url)
                     throws ServiceNotFoundException

Description copied from interface: MLetMBean

Loads an MLET text file from a given url. The MLET text file is parsed and the declared MBeans will be registered to the MBean server.

Specified by:

getMBeansFromURL in interface MLetMBean

Parameters:

url - url to load the MLET text file from

Returns:

A set of ObjectInstance instances for each registered MBean. If there was an error registering the MBean, a Throwable instance is added to the returned collection.

Throws:

ServiceNotFoundException - if the given URL is malformed, or the given MLET text file cannot be found, or the given text file does not contain an <MLET> tag or one of the specified mandatory attributes (see the JMX specification for a list of mandatory attributes in an MLET text file).

getMBeansFromURL

public Set getMBeansFromURL(URL url)
                     throws ServiceNotFoundException

Description copied from interface: MLetMBean

Loads an MLET text file from a given url. The MLET text file is parsed and the declared MBeans will be registered to the MBean server.

Specified by:

getMBeansFromURL in interface MLetMBean

Parameters:

url - url to load the MLET text file from

Returns:

A set of ObjectInstance instances for each registered MBean. If there was an error registering the MBean, a Throwable instance is added to the returned collection.

Throws:

ServiceNotFoundException - if the given MLET text file cannot be found, or the given text file does not contain an <MLET> tag or one of the specified mandatory attributes (see the JMX specification for a list of mandatory attributes in an MLET text file).

addURL

public void addURL(URL url)

Description copied from interface: MLetMBean

Adds the given URL to the MLet's classpath.

Specified by:

addURL in interface MLetMBean

addURL

public void addURL(String url)
            throws ServiceNotFoundException

Description copied from interface: MLetMBean

Adds the given URL to the MLet's classpath.

Specified by:

addURL in interface MLetMBean

Parameters:

url - url

Throws:

ServiceNotFoundException - if the given URL is malformed

getLibraryDirectory

public String getLibraryDirectory()

Specified by:

getLibraryDirectory in interface MLetMBean

setLibraryDirectory

public void setLibraryDirectory(String libdir)

Specified by:

setLibraryDirectory in interface MLetMBean

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException,
                         UnsupportedOperationException

This implementation does not support externalizing an MLet.

Specified by:

readExternal in interface Externalizable

Throws:

UnsupportedOperationException

IOException

ClassNotFoundException

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException,
                          UnsupportedOperationException

This implementation does not support externalizing an MLet.

Specified by:

writeExternal in interface Externalizable

Throws:

UnsupportedOperationException

IOException

loadClass

public Class loadClass(String name,
                       boolean resolve)
                throws ClassNotFoundException

Throws:

ClassNotFoundException