モジュールの準備とプログラミングによる既存アプリケーションへの追加
既存のアプリケーションへのモジュールの追加は、管理コンソール、wsadmin ツール、またはプログラミングによって行うことができます。この例を使用し、プログラミングによってモジュールを追加します。
始める前に
このタスクでは、MBean プログラミングに関する基本的な知識があることが前提になっています。MBean プログラミングについて詳しくは、MBean Java™ アプリケーション・プログラミング・インターフェース (API) に関する文書を参照してください。このインフォメーション・センターでは、 をクリックします。
WebSphere® Application Server 上のアプリケーションにモジュールを追加する前に、アプリケーションをインストールする必要があります。
このタスクについて
以下のタスクを実行し、プログラミングによってアプリケーションにモジュールを追加します。
手順
タスクの結果
コードが正常に実行されると、モジュールがアプリケーションに追加されます。
例
以下の例には、前のステップに基づいた、アプリケーションへのモジュールの追加方法が示されています。 一部のステートメントは印刷目的のために複数行に分割されています。
//Inputs:
//moduleName specifies the name of the module that you add to the application.
//moduleURI specifies a URI that gives the target location of the module
// archive contents on a file system. The URI provides the location of the new
// module after installation. この URI は、アプリケーションの URL について相対です。
//uniquemoduleURI specfies the URI that gives the target location of the
// deployment descriptor file. この URI は、アプリケーションの URL について相対です。
//target specifies the cell, node, and server on which the module is installed.
![[Windows]](../images/windows.gif)
String moduleName = "C:¥apps¥foo.jar";
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
![[z/OS]](../images/ngzos.gif)
![[IBM i]](../images/iseries.gif)
String moduleName = "/apps/foo.jar";
String moduleURI = "Increment.jar";
String uniquemoduleURI = "Increment.jar+META-INF/ejb-jar.xml";
String target = "WebSphere:cell=cellname,node=nodename,server=servername";
//Create an application deployment controller instance, AppDeploymentController,
//to populate the Java Archive (JAR) file with binding information.
//The binding information is WebSphere Application Server-specific deployment information.
Hashtable preferences = new Hashtable();
preferences.put (AppConstants.APPDEPL_LOCALE, Locale.getDefault());
preferences.put (AppConstants.APPUPDATE_CONTENTTYPE, AppConstants.APPUPDATE_CONTENT_MODULEFILE);
AppDeploymentController controller = AppManagementFactory.readArchiveForUpdate(
moduleName,
moduleURI,
AppConstants.APPUPDATE_ADD,
preferences,
null);
アプリケーションに追加するモジュールにバインディングがない場合は、 バインディングを追加することによって、モジュールの追加が機能します。本製品 で提供されているパブリック API を使用して、バインディングを収集および追加します。 WebSphere Application Server固有のバインディング情報を収集してタスクに取り込む方法について詳しくは、com.ibm.websphere.management.application.client.AppDeploymentController インスタンスに関する Java の文書を参照してください。AppDeploymentController インスタンスには、入力モジュール内の Java クラスに定義されているアノテーションとともに、XML ベースのデプロイメント記述子に定義されているメタデータが含まれています。
//After you collect all the binding information, save it in the module.
controller.saveAndClose();
//Get the installation options.
Hashtable options = controller.getAppDeploymentSavedResults();
//Connect the administrative client, AdminClient, to WebSphere Application Server.
AdminClient client = ...;
//Create the application management proxy.
AppManagement proxy = AppManagementProxy.getJMXProxyForClient (client);
//Update the existing application, MyApp, by adding the module.
String appName = "MyApp";
options.put (AppConstants.APPUPDATE_CONTENTTYPE,
AppConstants. APPUPDATE_CONTENT_MODULEFILE);
//Create the notification filter.
NotificationFilterSupport myFilter = new NotificationFilterSupport();
myFilter.enableType (NotificationConstants.TYPE_APPMANAGEMENT);
//Add the listener.
NotificationListener listener = new AListener(_soapClient, myFilter,
"Install: " + appName, AppNotification.UPDATE);
//Specify the target for the new module.
Hashtable mod2svr = new Hashtable();
options.put (AppConstants.APPDEPL_MODULE_TO_SERVER, mod2svr);
mod2svr.put (uniquemoduleURI, target);
proxy.updateApplication ( appName,
moduleURI,
moduleName,
AppConstants.APPUPDATE_ADD,
options,
null);
// Wait for some timeout. The installation application programming interface (API) is
// asynchronous and so returns immediately.
// If the program does not wait here, the program ends.
Thread.sleep(300000); // Wait so that the program does not end.
}
catch (Exception e) {
e.printStackTrace();
}
}
}
// Specify the Java Management Extensions (JMX) notification listener for JMX events.
class AListener implements NotificationListener
{
AdminClient _soapClient;
NotificationFilterSupport myFilter;
Object handback;
ObjectName on;
String eventTypeToCheck;
public AListener(AdminClient cl, NotificationFilterSupport fl,
Object h, String eType) throws Exception
{
_soapClient = cl;
myFilter = fl;
handback = h;
eventTypeToCheck = eType;
Iterator iter = _soapClient.queryNames (new ObjectName(
"WebSphere:type=AppManagement,*"), null).iterator();
on = (ObjectName)iter.next();
System.out.println ("ObjectName: " + on);
_soapClient.addNotificationListener (on, this, myFilter, handback);
}
public void handleNotification (Notification notf, Object handback)
{
AppNotification ev = (AppNotification) notf.getUserData();
System.out.println ("!! JMX event Recd: (handback obj= " + handback+ "): " + ev);
//When the installation is done, remove the listener and quit
if (ev.taskName.equals (eventTypeToCheck) &&
(ev.taskStatus.equals (AppNotification.STATUS_COMPLETED) ||
ev.taskStatus.equals (AppNotification.STATUS_FAILED)))
{
try
{
_soapClient.removeNotificationListener (on, this);
}
catch (Throwable th)
{
System.out.println ("Error removing listener: " + th);
}
System.exit (0);
}
}
}
次のタスク
モジュールを正常に追加した後、リスナーを除去して終了します。