File	Doc	Category	Size	Date	Package
MLet.java	API Doc	Java SE 6 API	47067	Tue Jun 10 00:26:14 BST 2008	javax.management.loading

MLet

• java.lang.Object
  • java.lang.ClassLoader
    • java.security.SecureClassLoader
      • java.net.URLClassLoader

Fields Summary
private static final long	serialVersionUID
private MBeanServer	server The reference to the MBean server.
private List	mletList The list of instances of the MLetContent class found at the specified URL.
private String	libraryDirectory The directory used for storing libraries locally before they are loaded.
private ObjectName	mletObjectName The object name of the MLet Service.
private URL[]	myUrls The URLs of the MLet Service.
private static final String	dbgTag The name of this class to be used for trace messages
private transient ClassLoaderRepository	currentClr What ClassLoaderRepository, if any, to use if this MLet doesn't find an asked-for class.
private transient boolean	delegateToCLR True if we should consult the {@link ClassLoaderRepository} when we do not find a class ourselves.
private Map	primitiveClasses objects maps from primitive classes to primitive object classes.

Constructors Summary
public MLet() Constructs a new MLet using the default delegation parent ClassLoader. primitiveClasses.put(Boolean.TYPE.toString(), Boolean.class); primitiveClasses.put(Character.TYPE.toString(), Character.class); primitiveClasses.put(Byte.TYPE.toString(), Byte.class); primitiveClasses.put(Short.TYPE.toString(), Short.class); primitiveClasses.put(Integer.TYPE.toString(), Integer.class); primitiveClasses.put(Long.TYPE.toString(), Long.class); primitiveClasses.put(Float.TYPE.toString(), Float.class); primitiveClasses.put(Double.TYPE.toString(), Double.class); this(new URL[0]);
public MLet(URL[] urls) Constructs a new MLet for the specified URLs using the default delegation parent ClassLoader. The URLs will be searched in the order specified for classes and resources after first searching in the parent class loader. param urls The URLs from which to load classes and resources. this(urls, true);
public MLet(URL[] urls, ClassLoader parent) Constructs a new MLet for the given URLs. The URLs will be searched in the order specified for classes and resources after first searching in the specified parent class loader. The parent argument will be used as the parent class loader for delegation. param urls The URLs from which to load classes and resources. param parent The parent class loader for delegation. this(urls, parent, true);
public MLet(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory) Constructs a new MLet for the specified URLs, parent class loader, and URLStreamHandlerFactory. The parent argument will be used as the parent class loader for delegation. The factory argument will be used as the stream handler factory to obtain protocol handlers when creating new URLs. param urls The URLs from which to load classes and resources. param parent The parent class loader for delegation. param factory The URLStreamHandlerFactory to use when creating URLs. this(urls, parent, factory, true);
public MLet(URL[] urls, boolean delegateToCLR) Constructs a new MLet for the specified URLs using the default delegation parent ClassLoader. The URLs will be searched in the order specified for classes and resources after first searching in the parent class loader. param urls The URLs from which to load classes and resources. param delegateToCLR True if, when a class is not found in either the parent ClassLoader or the URLs, the MLet should delegate to its containing MBeanServer's {@link ClassLoaderRepository}. since.unbundled JMX 1.2 super(urls); init(delegateToCLR);
public MLet(URL[] urls, ClassLoader parent, boolean delegateToCLR) Constructs a new MLet for the given URLs. The URLs will be searched in the order specified for classes and resources after first searching in the specified parent class loader. The parent argument will be used as the parent class loader for delegation. param urls The URLs from which to load classes and resources. param parent The parent class loader for delegation. param delegateToCLR True if, when a class is not found in either the parent ClassLoader or the URLs, the MLet should delegate to its containing MBeanServer's {@link ClassLoaderRepository}. since.unbundled JMX 1.2 super(urls, parent); init(delegateToCLR);
public MLet(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory, boolean delegateToCLR) Constructs a new MLet for the specified URLs, parent class loader, and URLStreamHandlerFactory. The parent argument will be used as the parent class loader for delegation. The factory argument will be used as the stream handler factory to obtain protocol handlers when creating new URLs. param urls The URLs from which to load classes and resources. param parent The parent class loader for delegation. param factory The URLStreamHandlerFactory to use when creating URLs. param delegateToCLR True if, when a class is not found in either the parent ClassLoader or the URLs, the MLet should delegate to its containing MBeanServer's {@link ClassLoaderRepository}. since.unbundled JMX 1.2 super(urls, parent, factory); init(delegateToCLR);

Methods Summary
public void	addURL(java.lang.String url) Appends the specified URL to the list of URLs to search for classes and resources. exception ServiceNotFoundException The specified URL is malformed. try { URL ur = new URL(url); if (!Arrays.asList(getURLs()).contains(ur)) super.addURL(ur); } catch (MalformedURLException e) { debug("addURL", url + ": Malformed URL. " + e); throw new ServiceNotFoundException("The specified URL is malformed"); }
public void	addURL(java.net.URL url) Appends the specified URL to the list of URLs to search for classes and resources. if (!Arrays.asList(getURLs()).contains(url)) super.addURL(url);
protected java.net.URL	check(java.lang.String version, java.net.URL codebase, java.lang.String jarfile, javax.management.loading.MLetContent mlet) This method is to be overridden when extending this service to support caching and versioning. It is called from {@link #getMBeansFromURL getMBeansFromURL} when the version, codebase, and jarfile have been extracted from the MLet file, and can be used to verify that it is all right to load the given MBean, or to replace the given URL with a different one. The default implementation of this method returns codebase unchanged. param version The version number of the .jar file stored locally. param codebase The base URL of the remote .jar file. param jarfile The name of the .jar file to be loaded. param mlet The MLetContent instance that represents the MLET tag. return the codebase to use for the loaded MBean. The returned value should not be null. exception Exception if the MBean is not to be loaded for some reason. The exception will be added to the set returned by {@link #getMBeansFromURL getMBeansFromURL}. since.unbundled JMX 1.2 return codebase;
private java.lang.Object	constructParameter(java.lang.String param, java.lang.String type) Converts the String value of the constructor's parameter to a basic Java object with the type of the parameter. // check if it is a primitive type Class<?> c = primitiveClasses.get(type); if (c != null) { try { Constructor<?> cons = c.getConstructor(new Class[] {String.class}); Object[] oo = new Object[1]; oo[0]=param; return(cons.newInstance(oo)); } catch (Exception e) { if (isDebugOn()) { debug(dbgTag, "constructParameter", "Unexpected Exception" + e.getClass().getName() + " occurred"); } } } if (type.compareTo("java.lang.Boolean") == 0) return new Boolean(param); if (type.compareTo("java.lang.Byte") == 0) return new Byte(param); if (type.compareTo("java.lang.Short") == 0) return new Short(param); if (type.compareTo("java.lang.Long") == 0) return new Long(param); if (type.compareTo("java.lang.Integer") == 0) return new Integer(param); if (type.compareTo("java.lang.Float") == 0) return new Float(param); if (type.compareTo("java.lang.Double") == 0) return new Double(param); if (type.compareTo("java.lang.String") == 0) return param; return param;
private void	debug(java.lang.String clz, java.lang.String func, java.lang.String info) Trace.send(Trace.LEVEL_DEBUG, Trace.INFO_MLET, clz, func, info);
private void	debug(java.lang.String func, java.lang.String info) debug(dbgTag, func, info);
protected java.lang.Class	findClass(java.lang.String name) This is the main method for class loaders that is being redefined. param name The name of the class. return The resulting Class object. exception ClassNotFoundException The specified class could not be found. /* currentClr is context sensitive - used to avoid recursion in the class loader repository. (This is no longer necessary with the new CLR semantics but is kept for compatibility with code that might have called the two-parameter loadClass explicitly.) */ return findClass(name, currentClr);
java.lang.Class	findClass(java.lang.String name, javax.management.loading.ClassLoaderRepository clr) Called by {@link MLet#findClass(java.lang.String)}. param name The name of the class that we want to load/find. param clr The ClassLoaderRepository that can be used to search for the given class. This parameter is null when called from within the {@link javax.management.MBeanServerFactory#getClassLoaderRepository(javax.management.MBeanServer) Class Loader Repository}. exception ClassNotFoundException The specified class could not be found. Class<?> c = null; if (isTraceOn()) { trace("findClass", name); } // Try looking in the JAR: try { c = super.findClass(name); if (isTraceOn()) { trace("findClass", "Class "+name+ " loaded through mlet classloader"); } } catch (ClassNotFoundException e) { // Drop through debug("findClass", "Class "+name+ " not found locally."); } // if we are not called from the ClassLoaderRepository if (c == null && delegateToCLR && clr != null) { // Try the classloader repository: // try { debug("findClass", "Class "+name+": looking in CLR"); c = clr.loadClassBefore(this, name); // The loadClassBefore method never returns null. // If the class is not found we get an exception. if (isTraceOn()) { trace("findClass", "Class "+name+ " loaded through the default classloader repository"); } } catch (ClassNotFoundException e) { debug("findClass", "Class "+name+ " not found in CLR."); // Drop through } } if (c == null) { debug("findClass","Failed to load class " + name); throw new ClassNotFoundException(name); } return c;
protected java.lang.String	findLibrary(java.lang.String libname) Returns the absolute path name of a native library. The VM invokes this method to locate the native libraries that belong to classes loaded with this class loader. Libraries are searched in the JAR files using first just the native library name and if not found the native library name together with the architecture-specific path name (OSName/OSArch/OSVersion/lib/nativelibname), i.e. the library stat on Solaris SPARC 5.7 will be searched in the JAR file as: libstat.so SunOS/sparc/5.7/lib/libstat.so the library stat on Windows NT 4.0 will be searched in the JAR file as: stat.dll WindowsNT/x86/4.0/lib/stat.dll More specifically, let {@code nativelibname} be the result of {@link System#mapLibraryName(java.lang.String) System.mapLibraryName}{@code (libname)}. Then the following names are searched in the JAR files, in order: {@code nativelibname} {@code ///lib/}{@code nativelibname} where {@code } means {@code System.getProperty(X)} with any spaces in the result removed, and {@code /} stands for the file separator character ({@link File#separator}). If this method returns null, i.e. the libraries were not found in any of the JAR files loaded with this class loader, the VM searches the library along the path specified as the java.library.path property. param libname The library name. return The absolute path of the native library. String abs_path; String mth = "findLibrary"; // Get the platform-specific string representing a native library. // String nativelibname = System.mapLibraryName(libname); // // See if the native library is accessible as a resource through the JAR file. // if (isTraceOn()) { trace(mth, "Search " + libname + " in all JAR files."); } // First try to locate the library in the JAR file using only // the native library name. e.g. if user requested a load // for "foo" on Solaris SPARC 5.7 we try to load "libfoo.so" // from the JAR file. // if (isTraceOn()) { trace(mth, "loadLibraryAsResource(" + nativelibname + ")"); } abs_path = loadLibraryAsResource(nativelibname); if (abs_path != null) { if (isTraceOn()) { trace(mth, nativelibname + " loaded " + "absolute path = " + abs_path); } return abs_path; } // Next try to locate it using the native library name and // the architecture-specific path name. e.g. if user // requested a load for "foo" on Solaris SPARC 5.7 we try to // load "SunOS/sparc/5.7/lib/libfoo.so" from the JAR file. // nativelibname = removeSpace(System.getProperty("os.name")) + File.separator + removeSpace(System.getProperty("os.arch")) + File.separator + removeSpace(System.getProperty("os.version")) + File.separator + "lib" + File.separator + nativelibname; if (isTraceOn()) { trace(mth, "loadLibraryAsResource(" + nativelibname + ")"); } abs_path = loadLibraryAsResource(nativelibname); if (abs_path != null) { if (isTraceOn()) { trace(mth, nativelibname + " loaded " + "absolute path = " + abs_path); } return abs_path; } // // All paths exhausted, library not found in JAR file. // if (isTraceOn()) { trace(mth, libname + " not found in any JAR file."); trace(mth, "Search " + libname + " along the path specified as the java.library.path property."); } // Let the VM search the library along the path // specified as the java.library.path property. // return null;
public synchronized java.lang.String	getLibraryDirectory() Gets the current directory used by the library loader for storing native libraries before they are loaded into memory. return The current directory used by the library loader. see #setLibraryDirectory throws UnsupportedOperationException if this implementation does not support storing native libraries in this way. return libraryDirectory;
public java.util.Set	getMBeansFromURL(java.net.URL url) Loads a text file containing MLET tags that define the MBeans to be added to the MBean server. The location of the text file is specified by a URL. The MBeans specified in the MLET file will be instantiated and registered in the MBean server. param url The URL of the text file to be loaded as URL object. return A set containing one entry per MLET tag in the m-let text file loaded. Each entry specifies either the ObjectInstance for the created MBean, or a throwable object (that is, an error or an exception) if the MBean could not be created. exception ServiceNotFoundException One of the following errors has occurred: The m-let text file does not contain an MLET tag, the m-let text file is not found, a mandatory attribute of the MLET tag is not specified, the value of url is null. exception IllegalStateException MLet MBean is not registered with an MBeanServer. if (url == null) { throw new ServiceNotFoundException("The specified URL is null"); } return getMBeansFromURL(url.toString());
public java.util.Set	getMBeansFromURL(java.lang.String url) Loads a text file containing MLET tags that define the MBeans to be added to the MBean server. The location of the text file is specified by a URL. The MBeans specified in the MLET file will be instantiated and registered in the MBean server. param url The URL of the text file to be loaded as String object. return A set containing one entry per MLET tag in the m-let text file loaded. Each entry specifies either the ObjectInstance for the created MBean, or a throwable object (that is, an error or an exception) if the MBean could not be created. exception ServiceNotFoundException One of the following errors has occurred: The m-let text file does not contain an MLET tag, the m-let text file is not found, a mandatory attribute of the MLET tag is not specified, the url is malformed. exception IllegalStateException MLet MBean is not registered with an MBeanServer. String mth = "getMBeansFromURL"; if (server == null) { throw new IllegalStateException("This MLet MBean is not " + "registered with an MBeanServer."); } // Parse arguments if (url == null) { if (isTraceOn()) { trace(mth, "URL is null"); } throw new ServiceNotFoundException("The specified URL is null"); } else { url = url.replace(File.separatorChar,'/"); } if (isTraceOn()) { trace(mth, "<URL = " + url + ">"); } // Parse URL try { MLetParser parser = new MLetParser(); mletList = parser.parseURL(url); } catch (Exception e) { final String msg = "Problems while parsing URL [" + url + "], got exception [" + e.toString() + "]"; if (isTraceOn()) { trace(mth, msg); } throw EnvHelp.initCause(new ServiceNotFoundException(msg), e); } // Check that the list of MLets is not empty if (mletList.size() == 0) { final String msg = "File " + url + " not found or MLET tag not defined in file"; if (isTraceOn()) { trace(mth, msg); } throw new ServiceNotFoundException(msg); } // Walk through the list of MLets Set<Object> mbeans = new HashSet<Object>(); for (MLetContent elmt : mletList) { // Initialize local variables String code = elmt.getCode(); if (code != null) { if (code.endsWith(".class")) { code = code.substring(0, code.length() - 6); } } String name = elmt.getName(); URL codebase = elmt.getCodeBase(); String version = elmt.getVersion(); String serName = elmt.getSerializedObject(); String jarFiles = elmt.getJarFiles(); URL documentBase = elmt.getDocumentBase(); // Display debug information if (isTraceOn()) { trace(mth, "MLET TAG = " + elmt.getAttributes()); trace(mth, "CODEBASE = " + codebase); trace(mth, "ARCHIVE = " + jarFiles); trace(mth, "CODE = " + code); trace(mth, "OBJECT = " + serName); trace(mth, "NAME = " + name); trace(mth, "VERSION = " + version); trace(mth, "DOCUMENT URL = " + documentBase); } // Load classes from JAR files StringTokenizer st = new StringTokenizer(jarFiles, ",", false); while (st.hasMoreTokens()) { String tok = st.nextToken().trim(); if (isTraceOn()) { trace(mth, "Load archive for codebase <" + codebase + ">, file <" + tok + ">"); } // Check which is the codebase to be used for loading the jar file. // If we are using the base MLet implementation then it will be // always the remote server but if the service has been extended in // order to support caching and versioning then this method will // return the appropriate one. // try { codebase = check(version, codebase, tok, elmt); } catch (Exception ex) { if (isDebugOn()) { debug(mth, "check returned exception: " + ex); } mbeans.add(ex); continue; } // Appends the specified JAR file URL to the list of // URLs to search for classes and resources. try { if (!Arrays.asList(getURLs()) .contains(new URL(codebase.toString() + tok))) { addURL(codebase + tok); } } catch (MalformedURLException me) { // OK : Ignore jar file if its name provokes the // URL to be an invalid one. } } // Instantiate the class specified in the // CODE or OBJECT section of the MLet tag // Object o = null; ObjectInstance objInst = null; if (code != null && serName != null) { final String msg = "CODE and OBJECT parameters cannot be specified at the " + "same time in tag MLET"; if (isTraceOn()) { trace(mth, msg); } mbeans.add(new Error(msg)); continue; } if (code == null && serName == null) { final String msg = "Either CODE or OBJECT parameter must be specified in " + "tag MLET"; if (isTraceOn()) { trace(mth, msg); } mbeans.add(new Error(msg)); continue; } try { if (code != null) { List<String> signat = elmt.getParameterTypes(); List<String> stringPars = elmt.getParameterValues(); List<Object> objectPars = new ArrayList<Object>(); for (int i = 0; i < signat.size(); i++) { objectPars.add(constructParameter(stringPars.get(i), signat.get(i))); } if (signat.isEmpty()) { if (name == null) { objInst = server.createMBean(code, null, mletObjectName); } else { objInst = server.createMBean(code, new ObjectName(name), mletObjectName); } } else { Object[] parms = objectPars.toArray(); String[] signature = new String[signat.size()]; signat.toArray(signature); if (isDebugOn()) { for (int i=0;i<signature.length;i++) { debug(mth, "Signature = " + signature[i]); debug(mth, "Params = " + parms[i]); } } if (name == null) { objInst = server.createMBean(code, null, mletObjectName, parms, signature); } else { objInst = server.createMBean(code, new ObjectName(name), mletObjectName, parms, signature); } } } else { o = loadSerializedObject(codebase,serName); if (name == null) { server.registerMBean(o, null); } else { server.registerMBean(o, new ObjectName(name)); } objInst = new ObjectInstance(name, o.getClass().getName()); } } catch (ReflectionException ex) { if (isTraceOn()) { trace(mth, "ReflectionException: " + ex.getMessage()); } mbeans.add(ex); continue; } catch (InstanceAlreadyExistsException ex) { if (isTraceOn()) { trace(mth, "InstanceAlreadyExistsException: " + ex.getMessage()); } mbeans.add(ex); continue; } catch (MBeanRegistrationException ex) { if (isTraceOn()) { trace(mth, "MBeanRegistrationException: " + ex.getMessage()); } mbeans.add(ex); continue; } catch (MBeanException ex) { if (isTraceOn()) { trace(mth, "MBeanException: " + ex.getMessage()); } mbeans.add(ex); continue; } catch (NotCompliantMBeanException ex) { if (isTraceOn()) { trace(mth, "NotCompliantMBeanException: " + ex.getMessage()); } mbeans.add(ex); continue; } catch (InstanceNotFoundException ex) { if (isTraceOn()) { trace(mth, "InstanceNotFoundException: " + ex.getMessage()); } mbeans.add(ex); continue; } catch (IOException ex) { if (isTraceOn()) { trace(mth, "IOException: " + ex.getMessage()); } mbeans.add(ex); continue; } catch (SecurityException ex) { if (isTraceOn()) { trace(mth, "SecurityException: " + ex.getMessage()); } mbeans.add(ex); continue; } catch (Exception ex) { if (isTraceOn()) { trace(mth, "Exception: " + ex.getClass().getName() + ex.getMessage()); } mbeans.add(ex); continue; } catch (Error ex) { if (isTraceOn()) { trace(mth, "Error: " + ex.getMessage()); } mbeans.add(ex); continue; } mbeans.add(objInst); } return mbeans;
private java.lang.String	getTmpDir() // JDK 1.4 String tmpDir = System.getProperty("java.io.tmpdir"); if (tmpDir != null) return tmpDir; // JDK < 1.4 File tmpFile = null; try { // Try to guess the system temporary dir... tmpFile = File.createTempFile("tmp","jmx"); if (tmpFile == null) return null; final File tmpDirFile = tmpFile.getParentFile(); if (tmpDirFile == null) return null; return tmpDirFile.getAbsolutePath(); } catch (Exception x) { debug("getTmpDir","Failed to determine system temporary dir."); return null; } finally { // Cleanup ... if (tmpFile!=null) try { tmpFile.delete(); } catch (Exception x) { debug("getTmpDir","Failed to delete temporary file: " + x.getMessage()); } }
public java.net.URL[]	getURLs() Returns the search path of URLs for loading classes and resources. This includes the original list of URLs specified to the constructor, along with any URLs subsequently appended by the addURL() method. return super.getURLs();
private void	init(boolean delegateToCLR) this.delegateToCLR = delegateToCLR; try { libraryDirectory = System.getProperty(JmxProperties.MLET_LIB_DIR); if (libraryDirectory == null) libraryDirectory = getTmpDir(); } catch (SecurityException e) { // OK : We don't do AccessController.doPrivileged, but we don't // stop the user from creating an MLet just because they // can't read the MLET_LIB_DIR or java.io.tmpdir properties // either. }
private boolean	isDebugOn() return Trace.isSelected(Trace.LEVEL_DEBUG, Trace.INFO_MLET);
private boolean	isTraceOn() return Trace.isSelected(Trace.LEVEL_TRACE, Trace.INFO_MLET);
public synchronized java.lang.Class	loadClass(java.lang.String name, javax.management.loading.ClassLoaderRepository clr) Load a class, using the given {@link ClassLoaderRepository} if the class is not found in this MLet's URLs. The given ClassLoaderRepository can be null, in which case a {@link ClassNotFoundException} occurs immediately if the class is not found in this MLet's URLs. param name The name of the class we want to load. param clr The ClassLoaderRepository that will be used to search for the given class, if it is not found in this ClassLoader. May be null. return The resulting Class object. exception ClassNotFoundException The specified class could not be found in this ClassLoader nor in the given ClassLoaderRepository. since.unbundled JMX 1.1 final ClassLoaderRepository before=currentClr; try { currentClr = clr; return loadClass(name); } finally { currentClr = before; }
private synchronized java.lang.String	loadLibraryAsResource(java.lang.String libname) Search the specified native library in any of the JAR files loaded by this classloader. If the library is found copy it into the library directory and return the absolute path. If the library is not found then return null. try { InputStream is = getResourceAsStream(libname.replace(File.separatorChar,'/")); if (is != null) { File directory = new File(libraryDirectory); directory.mkdirs(); File file = File.createTempFile(libname + ".", null, directory); file.deleteOnExit(); FileOutputStream fileOutput = new FileOutputStream(file); int c; while ((c = is.read()) != -1) { fileOutput.write(c); } is.close(); fileOutput.close(); if (file.exists()) { return file.getAbsolutePath(); } } } catch (Exception e) { debug("loadLibraryAsResource",libname+ ": Failed to load library. " + e); return null; } return null;
private java.lang.Object	loadSerializedObject(java.net.URL codebase, java.lang.String filename) Loads the serialized object specified by the OBJECT attribute of the MLET tag. param codebase The codebase. param filename The name of the file containing the serialized object. return The serialized object. exception ClassNotFoundException The specified serialized object could not be found. exception IOException An I/O error occurred while loading serialized object. if (filename != null) { filename = filename.replace(File.separatorChar,'/"); } if (isTraceOn()) { trace("loadSerializedObject", codebase.toString() + filename); } InputStream is = getResourceAsStream(filename); if (is != null) { try { ObjectInputStream ois = new MLetObjectInputStream(is, this); Object serObject = ois.readObject(); ois.close(); return serObject; } catch (IOException e) { if (isDebugOn()) { debug("loadSerializedObject", "Exception while deserializing " + filename + ", " + e.getMessage()); } throw e; } catch (ClassNotFoundException e) { if (isDebugOn()) { debug("loadSerializedObject", "Exception while deserializing " + filename + ", " + e.getMessage()); } throw e; } } else { if (isDebugOn()) { debug("loadSerializedObject", "Error: File " + filename + " containing serialized object not found"); } throw new Error("File " + filename + " containing serialized object not found"); }
public void	postDeregister() Allows the m-let to perform any operations needed after having been unregistered in the MBean server.
public void	postRegister(java.lang.Boolean registrationDone) Allows the m-let to perform any operations needed after having been registered in the MBean server or after the registration has failed. param registrationDone Indicates whether or not the m-let has been successfully registered in the MBean server. The value false means that either the registration phase has failed.
public void	preDeregister() Allows the m-let to perform any operations it needs before being unregistered by the MBean server. exception java.langException This exception should be caught by the MBean server and re-thrown as an MBeanRegistrationException.
public javax.management.ObjectName	preRegister(javax.management.MBeanServer server, javax.management.ObjectName name) Allows the m-let to perform any operations it needs before being registered in the MBean server. If the ObjectName is null, the m-let provides a default name for its registration <defaultDomain>:type=MLet param server The MBean server in which the m-let will be registered. param name The object name of the m-let. return The name of the m-let registered. exception java.lang.Exception This exception should be caught by the MBean server and re-thrown as an MBeanRegistrationException. // Initialize local pointer to the MBean server setMBeanServer(server); // If no name is specified return a default name for the MLet if (name == null) { name = new ObjectName(server.getDefaultDomain() + ":" + ServiceName.MLET); } this.mletObjectName = name; return this.mletObjectName;
public void	readExternal(java.io.ObjectInput in) Restore this MLet's contents from the given {@link ObjectInput}. Not all implementations support this method. Those that do not throw {@link UnsupportedOperationException}. A subclass may override this method to support it or to change the format of the read data. The format of the read data is not specified, but if an implementation supports {@link #readExternal} it must also support {@link #writeExternal} in such a way that what is written by the latter can be read by the former. param in The object input stream to read from. exception IOException if a problem occurred while reading. exception ClassNotFoundException if the class for the object being restored cannot be found. exception UnsupportedOperationException if this implementation does not support this operation. throw new UnsupportedOperationException("MLet.readExternal");
private java.lang.String	removeSpace(java.lang.String s) Removes any white space from a string. This is used to convert strings such as "Windows NT" to "WindowsNT". s = s.trim(); int j = s.indexOf(' "); if (j == -1) { return s; } String temp = ""; int k = 0; while (j != -1) { s = s.substring(k); j = s.indexOf(' "); if (j != -1) { temp = temp + s.substring(0, j); } else { temp = temp + s.substring(0); } k = j + 1; } return temp;
public synchronized void	setLibraryDirectory(java.lang.String libdir) Sets the directory used by the library loader for storing native libraries before they are loaded into memory. param libdir The directory used by the library loader. see #getLibraryDirectory throws UnsupportedOperationException if this implementation does not support storing native libraries in this way. libraryDirectory = libdir;
private synchronized void	setMBeanServer(javax.management.MBeanServer server) this.server = server; PrivilegedAction<ClassLoaderRepository> act = new PrivilegedAction<ClassLoaderRepository>() { public ClassLoaderRepository run() { return server.getClassLoaderRepository(); } }; currentClr = AccessController.doPrivileged(act);
private void	trace(java.lang.String clz, java.lang.String func, java.lang.String info) Trace.send(Trace.LEVEL_TRACE, Trace.INFO_MLET, clz, func, info);
private void	trace(java.lang.String func, java.lang.String info) trace(dbgTag, func, info);
public void	writeExternal(java.io.ObjectOutput out) Save this MLet's contents to the given {@link ObjectOutput}. Not all implementations support this method. Those that do not throw {@link UnsupportedOperationException}. A subclass may override this method to support it or to change the format of the written data. The format of the written data is not specified, but if an implementation supports {@link #writeExternal} it must also support {@link #readExternal} in such a way that what is written by the former can be read by the latter. param out The object output stream to write to. exception IOException If a problem occurred while writing. exception UnsupportedOperationException If this implementation does not support this operation. throw new UnsupportedOperationException("MLet.writeExternal");