User: juhalindfors
Date: 02/04/10 16:18:09
Modified: src/main/javax/management MBeanServer.java
Log:
and javadoc
Revision Changes Path
1.4 +85 -11 jmx/src/main/javax/management/MBeanServer.java
Index: MBeanServer.java
===================================================================
RCS file: /cvsroot/jboss/jmx/src/main/javax/management/MBeanServer.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- MBeanServer.java 8 Apr 2002 21:25:01 -0000 1.3
+++ MBeanServer.java 10 Apr 2002 23:18:09 -0000 1.4
@@ -16,7 +16,7 @@
* @see javax.management.loading.DefaultLoaderRepository
*
* @author <a href="mailto:[EMAIL PROTECTED]";>Juha Lindfors</a>.
- * @version $Revision: 1.3 $
+ * @version $Revision: 1.4 $
*/
public interface MBeanServer
{
@@ -27,38 +27,112 @@
*
* @see javax.management.loading.DefaultLoaderRepository
*
- * @param className Class to instantiate. Must have a public no-args
constructor.
+ * @param className Class to instantiate. Must have a public no-args
+ * constructor. Cannot contain a <tt>null</tt> reference.
+ *
* @return instantiated object
*
- * @throws ReflectionException if there was an error while trying to invoke the
class's constructor
- * @throws MBeanException if the class constructor threw a checked exception
- * @throws RuntimeMBeanException if the class constructor threw a runtime
exception
- * @throws RuntimeErrorException if the class constructor threw an error
+ * @throws ReflectionException If there was an error while trying to invoke
+ * the class's constructor or the given class was not found. This
+ * exception wraps the actual exception thrown.
+ * @throws MBeanException If the object constructor threw a checked exception
+ * during the initialization. This exception wraps the actual
+ * exception thrown.
+ * @throws RuntimeMBeanException If the class constructor threw a runtime
+ * exception. This exception wraps the actual exception thrown.
+ * @throws RuntimeErrorException If the class constructor threw an error.
+ * This exception wraps the actual error thrown.
+ * @throws RuntimeOperationsException If the <tt>className</tt> is <tt>null</tt>.
+ * Wraps an <tt>IllegalArgumentException</tt> instance.
*/
public Object instantiate(String className)
throws ReflectionException, MBeanException;
/**
* Instantiates an object using the given class loader. If the loader name
contains
- * a <tt>null</tt> reference, the class loader of the server implementation class
+ * a <tt>null</tt> reference, the class loader of the MBean server implementation
* will be used. The object must have a default, no-args constructor.
*
* @param className Class to instantiate. Must have a public no args
constructor.
+ * Cannot contain a <tt>null</tt> reference.
* @param loaderName Object name of a class loader that has been registered
to the server.
+ * If <tt>null</tt>, the class loader of the MBean server
is used.
* @return instantiated object
*
- * @throws ReflectionException if there was an error while trying to invoke the
class's constructor
- * @throws MBeanException if the class constructor threw a checked exception
- * @throws InstanceNotFoundException if the specified class loader was not found
in the server
- * @throws RuntimeMBeanException if the class constructor raised a runtime
exception
- * @throws RuntimeErrorException if the class constructor raised an error
+ * @throws ReflectionException If there was an error while trying to invoke
+ * the class's constructor or the given class was not found. This
+ * exception wraps the actual exception thrown.
+ * @throws MBeanException If the object constructor threw a checked exception
+ * during the initialization. This exception wraps the actual exception
+ * thrown.
+ * @throws InstanceNotFoundException if the specified class loader was not
+ * registered to the agent
+ * @throws RuntimeMBeanException If the class constructor raised a runtime
+ * exception. This exception wraps the actual exception thrown.
+ * @throws RuntimeErrorException If the class constructor raised an error.
+ * This exception wraps the actual error thrown.
+ * @throws RuntimeOperationsException if the <tt>className</tt> is <tt>null</tt>.
+ * Wraps an <tt>IllegalArgumentException</tt> instance.
*/
public Object instantiate(String className, ObjectName loaderName)
throws ReflectionException, MBeanException, InstanceNotFoundException;
+ /**
+ * Instantiates an object using the default loader repository and a given
constructor.
+ * The class being instantiated must contain a constructor that matches the
+ * signature given as an argument to this method call.
+ *
+ * @see javax.management.loading.DefaultLoaderRepository
+ *
+ * @param className class to instantiate
+ * @param params argument values for the constructor call
+ * @param signature signature of the constructor as fully qualified class names
+ *
+ * @return instantiated object
+ *
+ * @throws ReflectionException If there was an error while trying to invoke
+ * the class's constructor or the given class was not found. This
+ * exception wraps the actual exception thrown.
+ * @throws MBeanException If the object constructor raised a checked exception
+ * during the initialization. This exception wraps the actual exception
+ * thrown.
+ * @throws RuntimeMBeanException If the class constructor raised a runtime
+ * exception. This exception wraps the actual exception thrown.
+ * @throws RuntimeErrorException If the class constructor raised an error.
+ * This exception wraps the actual error thrown.
+ * @throws RuntimeOperationsException if the <tt>className</tt> is <tt>null</tt>.
+ * Wraps an <tt>IllegalArgumentException</tt> instance.
+ */
public Object instantiate(String className, Object[] params, String[] signature)
throws ReflectionException, MBeanException;
+ /**
+ * Instantiates an object using the given class loader. If the loader name
contains
+ * a <tt>null</tt> reference, the class loader of the MBean server implementation
+ * will be used. The object must contain a constructor with a matching signature
+ * given as a parameter to this call.
+ *
+ * @param className class to instantiate
+ * @param loaderName object name of a registered class loader in the agent.
+ * @param params argument values for the constructor call
+ * @param signature signature of the constructor as fully qualified class
name strings
+ *
+ * @return instantiated object
+ *
+ * @throws ReflectionException If there was an error while trying to invoke the
+ * class's constructor or the given class was not found. this exception
+ * wraps the actual exception thrown.
+ * @throws MBeanException If the object constructor raised a checked exception
+ * during the initialization. This exception wraps the actual exception
thrown.
+ * @throws InstanceNotFoundException if the specified class loader was not
+ * registered to the agent.
+ * @throws RuntimeMBeanException If the class constructor raised a runtime
+ * exception. This exception wraps the actual exception thrown.
+ * @throws RuntimeErrorException If the class constructor raised an error.
+ * This exception wraps the actual error thrown.
+ * @throws RuntimeOperationsException if the <tt>className</tt> argument is
<tt>null</tt>.
+ * Wraps an <tt>IllegalArgumentException</tt> instance.
+ */
public Object instantiate(String className, ObjectName loaderName, Object[]
params, String[] signature)
throws ReflectionException, MBeanException, InstanceNotFoundException;
_______________________________________________
Jboss-development mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/jboss-development
