C
Java Packages Supplied With the Java
Dynamic Management Kit
The Java classes supplied with the Java Dynamic Management Kit are contained in reference packages, implementation packages, SNMP packages, and tools packages. Detailed information is provided in:
Reference Packages
The reference packages supplied with the Java Dynamic Management Kit contain generic definitions and implementations. They are contained in the packages under the com.sun.jaw.reference package. The structure of the reference packages is illustrated in FIGURE C-1. The packages are described in the following subsections.
Java Dynamic Management Kit Reference Packages
com.sun.jaw.reference.common
The com.sun.jaw.reference.common package provides common definitions and implementations used by both management and agent applications. For example, the Java class for representing an object name is part of this package.
com.sun.jaw.reference.agent.cmf
The com.sun.jaw.reference.agent.cmf package provides the implementation of the framework. The name of the Java class of this implementation is Framework. A Java Dynamic Management agent must contain an instance of the Framework class.
com.sun.jaw.reference.agent.services
The com.sun.jaw.reference.agent.services package provides interface definitions of the services available to a Java Dynamic Management agent. An implementation of these services is provided with the implementation packages.
com.sun.jaw.reference.query
The com.sun.jaw.reference.query package provides the definition and implementation of a query. A query is a set of filtering and querying criteria. For example, using the query object, it is possible to select all the m-beans for which the color property is set to red.
com.sun.jaw.reference.client.adaptor
The com.sun.jaw.reference.client.adaptor package provides the interface definition of an adaptor client (adaptorMO) class. A Java manager uses the interface defined in this package to communicate with an agent through an adaptor.
com.sun.jaw.reference.client.mo
The com.sun.jaw.reference.client.mo package provides the generic definition of a managed object. Any c-bean must implement the interface defined in this package.
com.sun.jaw.reference.mapper
The com.sun.jaw.reference.mapper package provides the interface definition of a mapping service. A mapping service defines the rules for obtaining the Java class name of an m-bean or a c-bean from its object name.
Implementation Packages
The implementation packages supplied with the Java Dynamic Management Kit contain: implementations of the services specified in the reference packages. The implementation packages are contained in the packages under the com.sun.jaw.impl package. The structure of the implementation packages is illustrated in FIGURE C-2. The packages are described in the following subsections.
Java Dynamic Management Kit Implementation Packages
com.sun.jaw.impl.common
The com.sun.jaw.impl.common package contains implementations used by both management and agent applications.
com.sun.jaw.impl.agent.services
The com.sun.jaw.impl.agent.services package contains implementations of the core management services required by the framework. The framework is implemented by the class com.sun.jaw.reference.agent.cmf.Framework. The com.sun.jaw.impl.agent.services package contains:
com.sun.jaw.impl.agent.services.light
The com.sun.jaw.impl.agent.services.light package contains lightweight implementations of these services:
com.sun.jaw.impl.agent.services.persistent
The com.sun.jaw.impl.agent.services.persistent package contains implementations of a persistent repository and a mixed repository.
com.sun.jaw.impl.agent.services.loader
The com.sun.jaw.impl.agent.services.loader package contains an implementation of a class and library loader. The loader works in conjunction with a class and library server. An implementation of a class and library server is provided in the com.sun.jaw.impl.server package.
com.sun.jaw.impl.agent.services.mlet
The com.sun.jaw.impl.agent.services.mlet package contains an implementation of the management applet or m-let service. The m-let service enables an agent to obtain m-beans from a remote .jar file.
com.sun.jaw.impl.agent.services.bootstrap
The com.sun.jaw.impl.agent.services.bootstrap package contains an implementation of the bootstrap service. The bootstrap service is a stand-alone application that simplifies the distribution of applications from a central server.
com.sun.jaw.impl.agent.services.monitor
The com.sun.jaw.impl.agent.services.monitor contains an implementation of a service for monitoring how the properties of m-beans vary with time.
com.sun.jaw.impl.agent.services.alarm
The com.sun.jaw.impl.agent.services.alarm package contains an implementation of an alarm-clock service. An alarm-clock service is used for activating (or "waking up") event listeners.
com.sun.jaw.impl.agent.services.scheduler
The com.sun.jaw.impl.agent.services.scheduler package contains an implementation of a scheduler service. A scheduler service is used for creating alarms for specific dates and times.
com.sun.jaw.impl.agent.services.jawdiscovery
The com.sun.jaw.impl.agent.services.jawdiscovery package contains an implementation of a discovery service. A discovery service enables agents to be discovered by clients by using multicasting.
com.sun.jaw.impl.agent.services.security
The com.sun.jaw.impl.agent.services.security package contains an implementation of a security manager for a Java Dynamic Management agent that allows native libraries to be loaded across a network.
com.sun.jaw.impl.base
The com.sun.jaw.impl.base package contains the implementation of the base agent supplied with the Java Dynamic Management Kit.
com.sun.jaw.impl.mapper
The com.sun.jaw.impl.mapper package provides the implementation of the default mapping service. A mapping service defines the rules for obtaining the Java class name of an m-bean or a c-bean from its object name.
com.sun.jaw.impl.server
The com.sun.jaw.impl.server package contains an implementation of a network class and native library server. The server works in conjunction with the network class and native library loader provided in the com.sun.jaw.impl.agent.services.loader package.
com.sun.jaw.impl.client.tools
The com.sun.jaw.impl.client.tools package contains applications that are used for remotely invoking services of the Java Dynamic Management Kit.
com.sun.jaw.impl.adaptor
The com.sun.jaw.impl.adaptor package contains the packages that implement the adaptors supplied with the Java Dynamic Management Kit.
SNMP Packages
The SNMP packages contain classes that enable applications developed with the Java Dynamic Management Kit to interoperate with SNMP managers and agents. They are contained in the packages under the com.sun.jaw.snmp package. The structure of the SNMP packages is illustrated in FIGURE C-3. The packages are described in the following subsections.
Java Dynamic Management Kit SNMP Packages
com.sun.jaw.snmp.agent
The com.sun.jaw.snmp.agent package contains interface definitions and implementations of objects required by SNMP agents. For example, the implementation of an SNMP MIB object is contained in this package.
com.sun.jaw.snmp.common
The com.sun.jaw.snmp.agent package contains interface definitions and implementations of objects common to both SNMP agent and managers. The implementations of common SNMP data types are contained in this package, for example, the implementation of an SNMP Var-Bind object.
com.sun.jaw.snmp.manager
The com.sun.jaw.snmp.manager package contains interface definitions and implementations of objects required by SNMP managers. For example, the implementation of an SNMP poll request is contained in this package.
Tools Packages
The tools packages contain the classes that implement the tools supplied with the Java Dynamic Management Kit. They are contained in the packages under the com.sun.jaw.tools package. There is no API to the classes contained in the tools packages.
Copyright 1998 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California 94303 U.S.A.
Copyright in French