management/loading/package.html

0N/A<html>
0N/A<head>
0N/A<title>javax.management.loading package</title>
0N/A<!--
4230N/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
2362N/Apublished by the Free Software Foundation.  Oracle designates this
0N/Aparticular file as subject to the "Classpath" exception as provided
2362N/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
0N/A2 along with this work; if not, write to the Free Software Foundation,
0N/AInc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
0N/A
2365N/APlease contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
2365N/Aor visit www.oracle.com if you need additional information or have any
2365N/Aquestions.
0N/A-->
0N/A</head>
0N/A<body bgcolor="white">
0N/A
0N/A      <p>Provides the classes which implement advanced dynamic
0N/A    loading.  See the chapter <em>Advanced Dynamic Loading</em> in
0N/A    the <a href="#spec">JMX Specification</a>.</p>
0N/A
0N/A      <p>An MBean that is of a subclass of {@link
0N/A    java.lang.ClassLoader} can be used as a class loader to create
0N/A    other MBeans via the method {@link
0N/A    javax.management.MBeanServer#createMBean(String, ObjectName,
0N/A    ObjectName, Object[], String[])}, and to instantiate arbitrary
0N/A    objects via the method {@link
0N/A    javax.management.MBeanServer#instantiate(String, ObjectName,
0N/A    Object[], String[])}.  The {@link
0N/A    javax.management.loading.MLet MLet} class is an example of
0N/A    such an MBean.  It is a {@link java.net.URLClassLoader
0N/A    URLClassLoader}, so the list of URLs to load classes from can
0N/A    be configured.</p>
0N/A
0N/A      <p>Additionally, an <code>MLet</code> can read a configuration
0N/A    file that specifies a set of MBeans to be registered in the same
0N/A    MBean Server as the <code>MLet</code>.</p>
0N/A
0N/A      <p>Every MBean Server has a <em>class loader repository</em>
0N/A    containing all MBeans registered in that MBean Server that
0N/A    are of a subclass of {@link java.lang.ClassLoader}.  The class
0N/A    loader repository is used by the forms of the
0N/A    <code>createMBean</code> and <code>instantiate</code> methods
0N/A    in the {@link javax.management.MBeanServer MBeanServer}
0N/A    interface that do not have an explicit loader parameter.  It
0N/A    is also used by the <code>MLet</code> class when it does not
0N/A    find a class in its own set of URLs.</p>
0N/A
0N/A      <p>If an MBean implements the interface {@link
0N/A    javax.management.loading.PrivateClassLoader PrivateClassLoader},
0N/A    then it is not added to the class loader repository.  The class
0N/A    {@link javax.management.loading.PrivateMLet PrivateMLet} is a
0N/A    subclass of <code>MLet</code> that implements
0N/A    <code>PrivateClassLoader</code>.</p>
0N/A
0N/A    <p id="spec">
0N/A    @see <a href="{@docRoot}/technotes/guides/jmx/">
4230N/A      Java Platform documentation on JMX technology</a>,
0N/A    in particular the
0N/A    <a href="{@docRoot}/technotes/guides/jmx/JMX_1_4_specification.pdf">
0N/A      JMX Specification, version 1.4(pdf).</a>
0N/A
0N/A      @since 1.5
0N/A</BODY>
0N/A</HTML>