JMC の拡張

JRun を使用すると、JMC の左側パネルにある JRun ナビゲーション ツリーにカスタム リンクを追加できます。追加できるのは、メニュー、サブメニュー、およびオプションです。たとえば、Web サイト上のテクニカル サポート ページや特別記事へのリンクを含めることができます。数多くのテクニカル サポート記事にリンクする場合は、
トピックごとに記事をグループ化し、サブメニューとしてナビゲーション ツリーに含めることができます。

次の例では、[JavaSoft] がメニューであり、[JDBC] がサブメニューであり、[Servlets]、[JSP]、[Drivers]、および [Articles] がオプションです。

メニュー名またはオプション名をクリックすると、対応するリンクが JMC のメイン ターゲット ウィンドウに表示されます。

JMC 拡張の構文

JMC の拡張は、admin JRun サーバの local.properties ファイルにプロパティを追加することによって行われます。

トップレベルのオプションまたはメニューをサーバの項目リストに追加する必要があります。

admin.jmcMenu.<server_name>.items=<options_list>

server_name は、JMC ナビゲーション ツリーで下にリンクを表示するサーバの名前です。たとえば、default などです。

options_list は、ナビゲーション ツリーに表示するトップレベル オプションのカンマ区切りリストです。

name および link プロパティを使用して、オプションのリンク先および表示名を追加します。

admin.jmcMenu.<server_name>.<options_name>.name=<display_name>
admin.jmcMenu.<server_name>.<options_name>.link=<target_link>

option_name は、プロパティ ファイル内でこのリンクを参照するときに使用するリンクの名前です。この名前はスペースや特殊文字を含まない 1 つの単語でなければなりません。たとえば、sun などです。次に、この option_name を使用してサブメニュー項目を追加します。

display_name では、JMC ナビゲーション ツリーに表示するリンクの名前を定義します。たとえば、JavaSoft などです。この値にはスペースを含めることができます。

target_link は、ユーザがリンクをクリックしたときに JMC のターゲット ウィンドウに表示される Web ページです。

リンクの項目リストを使用してサブメニューを追加します。

admin.jmcMenu.<server_name>.<options_name>.items=<sub-menu_list>

sub-menu_list は、options_name サブメニューの下に表示されるサブメニュー オプションのカンマ区切りリストです。任意の数のネストされたメニューを作成できます。

これらの変更を有効にするには、admin JRun サーバを再起動して JMC にログインし直す必要があります。新しいメニューやオプションが表示される JRun サーバを再起動する必要はありません。

JMC 拡張の追加

JMC ナビゲーション メニューに新しいリンクを追加するには

  1. admin JRun サーバの local.properties ファイルを開きます。
  2. 項目リストに新しいオプションを追加します。たとえば、sun というオプションを
    default JRun サーバに追加するには、次のように入力します。
    admin.jmcMenu.default.items=sun
    

    新しいオプションを JMC に初めて追加する場合は、行全体を入力する必要があり ます。それ以外の場合は、カンマ区切りリストに新しいオプションを追加します。

  3. 新しいオプションの名前およびリンクを追加します。
    admin.jmcMenu.default.sun.name=JavaSoft
    admin.jmcMenu.default.sun.link=http://java.sun.com
    
  4. 必要な場合は、項目リストを使用してサブメニュー内のオプションを現在のオプションに追加できます。サブメニュー内の jdbc というオプションを sun に追加するには、次のように入力します。
    admin.jmcMenu.default.sun.items=jdbc
    
  5. 次に、サブメニュー内の jdbc オプションの名前およびリンクを追加します。
    admin.jmcMenu.default.jdbc.name=JDBC
    admin.jmcMenu.default.jdbc.link=http://java.sun.com/jdbc
    
  6. JMC からログアウトします。
  7. admin JRun サーバを再起動します。
  8. JMC にログインし直し、新しいリンクをテストします。

JMC 拡張の例

次の例は、admin JRun サーバの local.properties ファイルの内容です。これにより、 ページの画像に示されているメニュー、サブメニュー、およびオプションが表示されます。

admin.jmcMenu.default.items=sun,microsoft
admin.jmcMenu.default.sun.items=servlets,jsp,jdbc
admin.jmcMenu.default.sun.name=JavaSoft
admin.jmcMenu.default.sun.link=http://java.sun.com
admin.jmcMenu.default.servlets.name=Servlets
admin.jmcMenu.default.servlets.link=http://java.sun.com/products/
servlets
admin.jmcMenu.default.jsp.name=JSP
admin.jmcMenu.default.jsp.link=http://java.sun.com/products/jsp
admin.jmcMenu.default.jdbc.items=jdbc_drivers,jdbc_articles
admin.jmcMenu.default.jdbc.name=JDBC
admin.jmcMenu.default.jdbc.link=http://java.sun.com/products/jdbc
admin.jmcMenu.default.jdbc_drivers.name=Drivers
admin.jmcMenu.default.jdbc_drivers.link=http://
industry.java.sun.com/products/jdbc/drivers
admin.jmcMenu.default.jdbc_articles.name=Articles
admin.jmcMenu.default.jdbc_articles.link=http://java.sun.com/
products/jdbc/articles.html
admin.jmcMenu.default.microsoft.name=Microsoft
admin.jmcMenu.default.microsoft.link=http://www.microsoft.com

次の図は、ナビゲーション要素とそのサブ要素が追加された JMC を示します。