management/loading/package.html

0N/A<html>
0N/A<head>
0N/A<title>javax.management.loading package</title>
0N/A<!--
0N/ACopyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved.
0N/ADO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A
0N/AThis code is free software; you can redistribute it and/or modify it
0N/Aunder the terms of the GNU General Public License version 2 only, as
0N/Apublished by the Free Software Foundation.  Oracle designates this
0N/Aparticular file as subject to the "Classpath" exception as provided
0N/Aby Oracle in the LICENSE file that accompanied this code.
0N/A
0N/AThis code is distributed in the hope that it will be useful, but WITHOUT
0N/AANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/AFITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
0N/Aversion 2 for more details (a copy is included in the LICENSE file that
0N/Aaccompanied this code).
0N/A
0N/AYou should have received a copy of the GNU General Public License version
3516N/A2 along with this work; if not, write to the Free Software Foundation,
3516N/AInc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
3516N/A
3516N/APlease contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
3516N/Aor visit www.oracle.com if you need additional information or have any
3516N/Aquestions.
3516N/A-->
3516N/A</head>
3516N/A<body bgcolor="white">
3516N/A
3516N/A      <p>Provides the classes which implement advanced dynamic
3516N/A    loading.  See the chapter <em>Advanced Dynamic Loading</em> in
3516N/A    the <a href="#spec">JMX Specification</a>.</p>
3516N/A
3516N/A      <p>An MBean that is of a subclass of {@link
3516N/A    java.lang.ClassLoader} can be used as a class loader to create
3516N/A    other MBeans via the method {@link
3516N/A    javax.management.MBeanServer#createMBean(String, ObjectName,
3516N/A    ObjectName, Object[], String[])}, and to instantiate arbitrary
3516N/A    objects via the method {@link
3516N/A    javax.management.MBeanServer#instantiate(String, ObjectName,
3516N/A    Object[], String[])}.  The {@link
3516N/A    javax.management.loading.MLet MLet} class is an example of
3516N/A    such an MBean.  It is a {@link java.net.URLClassLoader
3516N/A    URLClassLoader}, so the list of URLs to load classes from can
3516N/A    be configured.</p>
3516N/A
      <p>Additionally, an <code>MLet</code> can read a configuration
    file that specifies a set of MBeans to be registered in the same
    MBean Server as the <code>MLet</code>.</p>

      <p>Every MBean Server has a <em>class loader repository</em>
    containing all MBeans registered in that MBean Server that
    are of a subclass of {@link java.lang.ClassLoader}.  The class
    loader repository is used by the forms of the
    <code>createMBean</code> and <code>instantiate</code> methods
    in the {@link javax.management.MBeanServer MBeanServer}
    interface that do not have an explicit loader parameter.  It
    is also used by the <code>MLet</code> class when it does not
    find a class in its own set of URLs.</p>

      <p>If an MBean implements the interface {@link
    javax.management.loading.PrivateClassLoader PrivateClassLoader},
    then it is not added to the class loader repository.  The class
    {@link javax.management.loading.PrivateMLet PrivateMLet} is a
    subclass of <code>MLet</code> that implements
    <code>PrivateClassLoader</code>.</p>

    <p id="spec">
    @see <a href="{@docRoot}/technotes/guides/jmx/">
      Java Platform documentation on JMX technology</a>,
    in particular the
    <a href="{@docRoot}/technotes/guides/jmx/JMX_1_4_specification.pdf">
      JMX Specification, version 1.4(pdf).</a>

      @since 1.5
</BODY>
</HTML>