]> &project; Amy Roh MBean Descriptor How To MBean記述子の設定 田中 ラ・マンチャ 良浩 高橋 達男

Tomcat 5 uses JMX MBeans as the technology for implementing manageability of Tomcat.

The descriptions of JMX MBeans for Catalina are in the org.apache.catalina.mbeans.mbeans-descriptor.xml file.

You will need to add MBean descriptions for your custom components in order to avoid a "ManagedBean is not found" exception.

Tomcat 5は、管理性(manageability)を実現する技術としてJMX MBeansを使用しています。

Catalinaが使用するJMX MBeansに関する記述は、 org.apache.catalina.mbeans.mbeans-descriptor.xml ファイルにあります。

「ManagedBean が見つかりません」という例外を防ぐために、 カスタムコンポーネント向けのMBeanに関する記述を追加する必要があります。

You may configure custom components (e.g. Valves/Realms) by including your own mbean-descriptor file(s), and setting the "descriptors" attribute to point to a ';' separated list of paths (in the ClassLoader sense) of files to add to the default list under ServerLifecycleListener definition in server.xml.

自作のmbean-descriptor ファイルを読み込ませることによってカスタムコンポーネント(例えば Valve/Realm)を設定出来ます。 server.xml ファイル内の ServerLifecycleListener の定義にあるデフォルト設定に対して、 クラスローダが使うようなセミコロン( ; )で区切られたファイルパス(スラッシュ区切り)の一覧を指すように "descriptors"属性を追加します。 in the ClassLoader sense の意図が不明。単純に訳すと「クラスローダの点で」となるが... ClassLoader クラスはスラッシュ区切りのパス名で指定された名前でリソースを取得しますが、 それと同じやり方でファイルのパスを指定することと解釈しました。(高橋)

<Listener className="org.apache.catalina.mbeans.ServerLifecycleListener" debug="0" descriptors="/com/myfirm/mypackage/mbean-descriptor.xml"/>

You may also add MBean descriptions for custom components in org.apache.catalina.mbeans.mbeans-descriptor.xml file.

<mbean name="LDAPRealm" className="org.apache.catalina.mbeans.ClassNameMBean" description="Custom LDAPRealm" domain="Catalina" group="Realm" type="com.myfirm.mypackage.LDAPRealm"> <attribute name="className" description="Fully qualified class name of the managed object" type="java.lang.String" writeable="false"/> <attribute name="debug" description="The debugging detail level for this component" type="int"/> . . . </mbean>

カスタムコンポーネントの MBean に関する記述は、 org.apache.catalina.mbeans.mbeans-descriptor.xml ファイルに追加してもかまいません。

<mbean name="LDAPRealm" className="org.apache.catalina.mbeans.ClassNameMBean" description="自作のLDAPレルム" domain="Catalina" group="Realm" type="com.myfirm.mypackage.LDAPRealm"> <attribute name="className" description="管理されるオブジェクトの完全修飾クラス名" type="java.lang.String" writeable="false"/> <attribute name="debug" description="このコンポーネントのデバッグレベル" type="int"/> . . . </mbean>