This documents the type conversion in java.lang.management.ManagementFactory.
Changelog:
2006-08-20 Andrew John Hughes <[EMAIL PROTECTED]>
* java/lang/management/ManagementFactory.java:
Updated documentation.
--
Andrew :-)
Escape the Java Trap with GNU Classpath!
http://www.gnu.org/philosophy/java-trap.html
public class gcj extends Freedom implements Java { ... }
Index: java/lang/management/ManagementFactory.java
===================================================================
RCS file:
/cvsroot/classpath/classpath/java/lang/management/ManagementFactory.java,v
retrieving revision 1.12
diff -u -3 -p -u -r1.12 ManagementFactory.java
--- java/lang/management/ManagementFactory.java 29 Jul 2006 14:05:59 -0000
1.12
+++ java/lang/management/ManagementFactory.java 20 Aug 2006 21:07:49 -0000
@@ -67,6 +67,49 @@ import javax.management.NotCompliantMBea
* <li>Calling the appropriate static method of this factory.
* </li>
* </ol>
+ * <h2>Open Data Types</h2>
+ * <p>
+ * The data types used by the management beans are restricted
+ * to <emph>open</emph> data types to aid interoperability. This
+ * allows the beans to be accessed remotely, including from non-Java
+ * clients. Below is a table which lists the types used by the beans
+ * on the left, and the types they are converted to when returned via
+ * a bean server on the right. Type information is provided for each
+ * bean by obtaining its instance of [EMAIL PROTECTED]
javax.management.MBeanInfo}.
+ * </p>
+ * <table>
+ * <th><td>Data Type Used</td><td>Data Type Returned</td></th>
+ * <tr>
+ * <td>Primitive types (<code>int</code>, <code>char</code>, etc.)</td>
+ * <td>Same</td>
+ * </tr><tr>
+ * <td>Wrapper classes ([EMAIL PROTECTED],
+ * @link{java.lang.Character}, etc.)</td>
+ * <td>Same</td>
+ * </tr><tr>
+ * <td>An [EMAIL PROTECTED] java.lang.Enum}</td>
+ * <td>The <code>name</code> of the enumeration constant</td>
+ * </tr><tr>
+ * <td>An array of type <code>E</code></td>
+ * <td>An array of the same dimensions with this mapping applied
+ * to <code>E</code>.</td>
+ * </tr><tr>
+ * <td>A class with `getter' methods and a
+ * <code>from([EMAIL PROTECTED]
javax.management.openmbean.CompositeData})</code>
+ * method.</td>
+ * <td>The equivalent [EMAIL PROTECTED]
javax.management.openmbean.CompositeData}
+ * instance, specified by the <code>from</code> method.</td>
+ * </tr><tr>
+ * <td>A map with keys of type <code>K</code> and values of
+ * type <code>V</code>.</td>
+ * <td>A [EMAIL PROTECTED] javax.management.openmbean.TabularData} instance,
+ * with the row type containing two items, <code>"key"</code> and
+ * <code>"value"</code> with the types <code>K</code> and <code>V</code>
+ * respectively (with translation applied).</td>
+ * </tr><tr>
+ * <td>A list of type <code>E</code>.</td>
+ * <td>An array with this mapping applied to <code>E</code>.</td>
+ * </tr></table>
*
* @author Andrew John Hughes ([EMAIL PROTECTED])
* @since 1.5
signature.asc
Description: Digital signature
