User: starksm Date: 01/04/02 14:33:24 Modified: src/docs basicconfiguration.xml howtombeans.xml Log: It is the ServiceControl MBean that manages service depdencies, not the ConfigurationSerivce MBean. Revision Changes Path 1.7 +8 -9 manual/src/docs/basicconfiguration.xml Index: basicconfiguration.xml =================================================================== RCS file: /cvsroot/jboss/manual/src/docs/basicconfiguration.xml,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- basicconfiguration.xml 2001/04/02 03:25:40 1.6 +++ basicconfiguration.xml 2001/04/02 21:33:24 1.7 @@ -138,7 +138,7 @@ <para> Configuration file jboss.conf typically contains only those core service MBeans that are necessary to achieve the initial "bootstrap" of JBoss . These services include the classpath extension inclusion mechanism shown in - <xref linkend = "jboss.conf-excerpt"/> , logging ,configuration service, etc.</para> + <xref linkend = "jboss.conf-excerpt"/> , logging ,configuration service, service control, etc.</para> <figure id = "jboss.conf-excerpt"> <title>Excerpt from jboss.conf</title> @@ -215,19 +215,18 @@ </para> - <para>The jboss.jcml file is loaded by the org.jboss.configuration.ConfigurationService MBean. This service acts much like the standard JMX MLet class in that it loads and configures MBeans, but it also manages dependencies between MBeans as long as the MBean interface conforms to a certain pattern described by the org.jboss.util.ServiceMBean interface. This interface allows for the ordered initialization, starting, stopping and destorying of MBeans. The ordering is based on the order in which MBeans are specified in the jboss.jcml file. See <xref linkend = "howto.mbeans"/> for the details of creating an MBean with depedencies on other MBeans.</para> - </listitem> - - <listitem> - <para id = "jboss.dependencies-file">jboss.dependencies</para> + <para>The jboss.jcml file is loaded by the org.jboss.configuration.ConfigurationService MBean. This service acts much like the standard JMX MLet class in that it loads and configures MBeans. The dependencies between MBeans are managed by the org.jboss.util.ServiceControl MBean. The ServiceControl MBean listens for REGISTRATION_NOTIFICATION and UNREGISTRATION_NOTIFICATION JMX events to determine which MBeans are available. The order of rgistration determines the order of initialization and startup. The ServiceControl expects that MBeans which require depdendency management to conform to the org.jboss.util.Service interface. This interface allows for the ordered initialization, starting, stopping and destorying of MBeans. The ordering is based on the order in which MBeans are specified in the jboss.jcml file. See <xref linkend = "howto.mbeans"/> for the details of creating an MBean with depedencies on other MBeans.</para> + </listitem> + <listitem> + <para id = "jboss.dependencies-file">jboss.dependencies</para> <para> For the reason of simplicity and ease of configuration JBoss's DependancyManager - was deprecated in 2.1 release, so this file is no longer used.</para> + was deprecated in 2.1 release, so this file is no longer used.</para> <para> Now all MBeans listed in jboss.jcml have "vertical" dependency on each other. For example, JNDI provider is required for DataSource wrappers since DataSource wrapper has to store reference to itself in JNDI, thus JNDI provider - MBean has to be listed before DataSource wrapper. See <xref linkend = "howto.mbeans"/> for the details of the depedency mechanism.</para> - + MBean has to be listed before DataSource wrapper. See <xref linkend = "howto.mbeans"/> for the details of the depedency mechanism.</para> + </listitem> 1.2 +30 -5 manual/src/docs/howtombeans.xml Index: howtombeans.xml =================================================================== RCS file: /cvsroot/jboss/manual/src/docs/howtombeans.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- howtombeans.xml 2001/04/02 03:25:40 1.1 +++ howtombeans.xml 2001/04/02 21:33:24 1.2 @@ -1,17 +1,42 @@ <?xml version = "1.0" encoding = "UTF-8"?> -<section id="howto.mbeans"> +<section id = "howto.mbeans"> <title>How to Integrate Custom MBeans</title> <para> <author> <firstname>Scott</firstname> <surname>Stark</surname> </author> - <email>[EMAIL PROTECTED]</email> + <email>[EMAIL PROTECTED]</email> </para> <section> <title>Introduction</title> - <para>If you want to add services to the JBoss server, the best way to do that is to write your own JMX MBeans. Then they can be configured in jboss.jcml like the core JBoss MBeans. The best way for your EJBs to access your new services is to make them accessible via JNDI.</para> - <para>More to come... - </para> + <para>The best way to add services to the JBoss server is to write your own JMX MBeans. An MBean is a Java object which implement resources and their instrumentation interfaces as defined in the Java Management Extensions(JMX) specification. Once written they are added to JBoss using the jboss.jcml which is used to configure the core JBoss MBeans. The best way for your EJBs to access your new services is to make them accessible via JNDI.</para> + <para>There are two classes of MBeans; those that are independent of JBoss services and those that are dependent on JBoss services. MBeans that are independent of JBoss services are the trival case and can be written per the JMX specification and added to a JBoss server by adding their MLET tag to the jboss.conf file. Writing an MBean that relieas on a JBoss service like naming requires one to follow the JBoss service pattern.</para> + <section> + <title>The ConfigurationService MBean</title> + <para>JBoss manages dependencies between its MBeans via a custom MBean that loads an xml variation of the standard MLet configuration file. This custom MBean is implemented in the org.jboss.configuration.ConfigurationService class. The ConfigurationService MBean is loaded when JBoss starts up by the JMX MLet due to its entry in the jboss.conf file. The jboss.jcml configuration is then loaded by invoking loadConfiguration() on the ConfigurationService MBean. The loadConfiguratoin method performs the following steps:</para> + <procedure> + <step> + <para>Parse the jboss.jcml file and instantiate all MBeans</para> + </step> + <step> + <substeps> + <step> + <para>Parse the optional jboss-auth.jcml file and instantiate any MBeans that were not created by the parser of the jboss.jcml file.</para> + </step> + <step> + <para>Apply the MBean attribute settings from the jboss-auto.jcml file.</para> + </step> + </substeps> + </step> + <step> + <para>Apply the attribute settings from the jboss.jcml file.</para> + </step> + </procedure> + </section> + </section> + <section> + <title>Writing JBoss MBean Services</title> + <para/> </section> </section> _______________________________________________ Jboss-development mailing list [EMAIL PROTECTED] http://lists.sourceforge.net/lists/listinfo/jboss-development