All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class com.sun.jaw.impl.agent.services.mlet.MLetSrv

java.lang.Object
   |
   +----com.sun.jaw.impl.agent.services.mlet.MLetSrv

public class MLetSrv
extends Object
implements Serializable

This class provides an implementation of the management applet or m-let service. The m-let service enables an agent to obtain m-beans remotely. The agent does this by loading a text file stored remotely that specifies information on the m-beans to be obtained. The location of the text file is specified by a URL. The information on each m-bean to be obtained is specified in a single instance of a tag, called the MLET tag. When a text file is loaded, each m-bean specified in the file is instantiated.

An m-bean instantiated by the m-let service is registered in one of the following ways:

If an initCmf method is defined for the m-bean, the m-let service invokes it to register the m-bean. The value of the NAME attribute in the MLET tag is passed to this method as the ObjectName argument.
If an initCmf method is not defined for the m-bean, but the NAME attribute of the MLET tag is specified, the m-let service invokes the addObject or addDBObject method of the framework class to register the m-bean depending on the value of the PERSISTENT attribute in the MLET tag.
If an initCmf method is not defined for the m-bean, and the NAME attribute of the MLET tag is not specified, the m-let service does not invoke a method for registering the m-bean. In this case, it is still possible to register the m-bean. To do this, invoke the addObject or addDBObject method of the framework class for each entry in the vector returned by the performLocalLoadURL method. This is possible only within the code of an agent, not within the code of a manager.

The security mode of the MLet Service is specified at instantiation time through a property named secure in the object name.

secure=true : Only signed JAR files coming from trusted sources will be loaded.
secure=false : Any JAR file signed/not-signed by a trusted/not-trusted signer will be loaded.

If no secure property is specified then the service assumes unsecure mode to be enabled.

See Also:: MLet

MLetSrv(): Instantiates the m-let service.

deleteCmf(): Deletes the m-let service.
flushMLetClassLoader(URL): For Java DMK internal use only.
getClassVersion(): Returns the version of this class.
getLibraryDirectory(): Returns the current directory used by the library loader for storing native libraries before they are loaded into memory.
getMLetClassLoader(URL): For Java DMK internal use only.
initCmf(Framework, ObjectName, boolean, ModificationList): Initializes the m-let service and registers it with the core management framework.
newMLetClassLoader(URL, Framework): For Java DMK internal use only.
performGetResource(String, String): Returns the URL of a resource.
performGetResource(URL, String): Returns the URL of a resource.
performGetResourceAsStream(String, String): Gets an input stream for a resource.
performGetResourceAsStream(URL, String): Gets an input stream for a resource.
performLoadURL(String): Loads a text file containing MLET tags that define the m-beans to be added to the agent.
performLoadURL(URL): Loads a text file containing MLET tags that define the m-beans to be added to the agent.
performLocalLoadURL(String): Loads a text file containing MLET tags that define the m-beans to be added to the agent.
performLocalLoadURL(URL): Loads a text file containing MLET tags that define the m-beans to be added to the agent.
performRemoteLoadURL(String): Loads a text file containing MLET tags that define the m-beans to be added to the agent.
performRemoteLoadURL(URL): Loads a text file containing MLET tags that define the m-beans to be added to the agent.
setLibraryDirectory(String): Sets the current directory used by the library loader for storing native libraries before they are loaded into memory.

MLetSrv

 public MLetSrv()

Instantiates the m-let service.

initCmf

 public void initCmf(Framework cmf,
                     ObjectName name,
                     boolean db,
                     ModificationList list) throws InstanceAlreadyExistException

Initializes the m-let service and registers it with the core management framework.
For internal use only.

Parameters:: agent - The core management framework to register the service with.; name - Object name.; db - Indicates if persistent storage is required.; list - The modification list to use for setting up parameters.
Throws: InstanceAlreadyExistException: The m-bean is already registered in the repository.

deleteCmf

 public void deleteCmf()

Deletes the m-let service.

performLoadURL

 public void performLoadURL(URL url) throws ServiceNotFoundException

Loads a text file containing MLET tags that define the m-beans to be added to the agent. The location of the text file is specified by a URL.

This method is allowed in the code of an agent or a manager. It is similar to performLocalLoadURL (allowed only in agent code) or performRemoteLoadURL (allowed only in manager code) except that it does not return.

Parameters:

url - The URL of the text file to be loaded.

Throws: 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.

performLoadURL

 public void performLoadURL(String url) throws ServiceNotFoundException

Loads a text file containing MLET tags that define the m-beans to be added to the agent. The location of the text file is specified by a string representation of its URL.

Parameters:

url - A string representation of the URL of the text file to be loaded.

Throws: 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.

performLocalLoadURL

 public Vector performLocalLoadURL(URL url) throws ServiceNotFoundException

Loads a text file containing MLET tags that define the m-beans to be added to the agent. The location of the text file is specified by a URL.

This method is allowed only in the code of an agent.

Parameters:

url - The URL of the text file to be loaded.

Returns:

A vector containing one entry per MLET tag in the m-let text file loaded. Each entry specifies either the reference of the m-bean instantiated, or a throwable object (that is, an error or an exception) if the m-bean could not be instantiated.

Throws: 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.

performLocalLoadURL

 public Vector performLocalLoadURL(String url) throws ServiceNotFoundException

Loads a text file containing MLET tags that define the m-beans to be added to the agent. The location of the text file is specified by a string representation of its URL.

This method is allowed only in the code of an agent.

Parameters:

url - A string representation of the URL of the text file to be loaded.

Returns:

Throws: 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.

performRemoteLoadURL

 public Vector performRemoteLoadURL(URL url) throws ServiceNotFoundException

Loads a text file containing MLET tags that define the m-beans to be added to the agent. The location of the text file is specified by a URL.

This method is allowed only in the code of a manager.

Parameters:

url - The URL of the text file to be loaded.

Returns:

A vector containing one entry per MLET tag in the m-let text file loaded. Each entry specifies either an instance of class MLet representing the parameters of the MLET tag for the m-bean instantiated, or a throwable object (that is, an error or an exception) if the m-bean could not be instantiated.

Throws: 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.

performRemoteLoadURL

 public Vector performRemoteLoadURL(String url) throws ServiceNotFoundException

Loads a text file containing MLET tags that define the m-beans to be added to the agent. The location of the text file is specified by a string representation of its URL.

This method is allowed only in the code of a manager.

Parameters:

url - A string representation of the URL of the text file to be loaded.

Returns:

Throws: 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.

performGetResource

 public URL performGetResource(URL codebase,
                               String resource)

Returns the URL of a resource.

Parameters:: codebase - A URL that identifies the code base of the m-let class loader to be used.; resource - The name of the resource.
Returns:: The URL of the resource or null if the resource could not be found.

performGetResource

 public URL performGetResource(String codebase,
                               String resource)

Returns the URL of a resource.

Parameters:: codebase - A string that identifies the code base of the m-let class loader to be used.; resource - The name of the resource.
Returns:: The URL of the resource or null if the resource could not be found.

performGetResourceAsStream

 public InputStream performGetResourceAsStream(URL codebase,
                                               String resource)

Gets an input stream for a resource.

Parameters:: codebase - A URL that identifies the code base of the m-let class loader to be used.; resource - The name of the resource.
Returns:: An input stream for the resource or null if the resource could not be found.

performGetResourceAsStream

 public InputStream performGetResourceAsStream(String codebase,
                                               String resource)

Gets an input stream for a resource.

Parameters:: codebase - A string that identifies the code base of the m-let class loader to be used.; resource - The name of the resource.
Returns:: An input stream for the resource or null if the resource could not be found.

newMLetClassLoader

 public static synchronized MLetClassLoader newMLetClassLoader(URL codebase,
                                                               Framework cmf)

For Java DMK internal use only.

Creates a new class loader to be used for loading the classes specified by an MLET tag. If an instance of MLetClassLoader for the specified code base already exists, it is used. Otherwise, a new instance is created and registered with the repository.

Parameters:: codebase - A URL that identifies the code base of the m-let class loader to be created.; cmf - The core management framework that the class loader is to be registered with. If you do not want the class loader to be registered, set this parameter to null.
Returns:: A reference to the m-let class loader or null if it could not be created.

getMLetClassLoader

 public static synchronized MLetClassLoader getMLetClassLoader(URL codebase)

For Java DMK internal use only.

Gets the m-let class loader instantiated for a given code base.

Parameters:: codebase - A URL that identifies the code base.
Returns:: A reference to the m-let class loader or null if it could not be found.

flushMLetClassLoader

 public static synchronized void flushMLetClassLoader(URL codebase)

For Java DMK internal use only.

Flushes the m-let class loader instantiated for a given code base.

Parameters:: codebase - A URL that identifies the code base.

getLibraryDirectory

 public String getLibraryDirectory()

Returns the current directory used by the library loader for storing native libraries before they are loaded into memory.

The value of the directory defaults to /tmp (Solaris) or <installDir>\SUNWconn\jaw\tmp (Windows NT).

setLibraryDirectory

 public void setLibraryDirectory(String libdir)

Sets the current directory used by the library loader for storing native libraries before they are loaded into memory.

The value of the directory defaults to /tmp (Solaris) or <installDir>\SUNWconn\jaw\tmp (Windows NT).

getClassVersion

 public static String getClassVersion()

Returns the version of this class.

All Packages  Class Hierarchy  This Package  Previous  Next  Index