使用 WebSphere Application Server 管理 Java API 创建定制 Java 管理客户机程序

您可以使用产品管理应用程序编程接口 (API) 来开发用于访问 WebSphere® Application Server 管理系统的 Java™ 程序。

准备工作

此任务假设您基本熟悉 Java 管理扩展 (JMX) API 编程。有关 Java API 的信息，请查看应用程序编程接口文档。

有关此任务

当您开发和运行使用各种 JMX 连接器并启用安全性的管理客户机时，使用下列准则。当您遵循这些准则时，您保证 JMS 连接器不同实现之间的行为。偏离这些准则的任何编程模型不受支持。

在创建和使用另一个管理客户机前，创建和使用单个管理客户机。
在同一线程上创建和使用管理客户机。
使用下列某种方法指定用于创建新管理客户机的用户标识和密码：
- 在属性文件中指定缺省用户标识和密码。
- 指定不同于缺省值的用户标识和密码。一旦您使用非缺省用户标识和密码创建管理客户机后，在您创建后续管理客户机时也指定非缺省用户标识和密码。

过程

开发管理客户机程序。
构建并运行管理客户机程序。
构建并运行程序的所需步骤取决于代码运行的应用程序环境类型。

请参阅『使用应用程序客户机』，以获取有关如何构建并运行管理客户机程序的详细信息。
如果管理客户机使用简单对象访问协议 (SOAP) 作为其连接器，那么必须将 Java 安全套接字扩展 (JSSE) 配置为传输层。该产品使用安全套接字层 (SSL) 支持以及带有 Java 安全套接字扩展 (JSSE) 及系统 SSL 包的传输层安全性 (TLS) 支持。
为用于运行管理客户机的用户标识配置数字证书。如果要使用系统授权工具 (SAF) 来创建数字证书并将它们存储在 SAF 密钥环中，请参阅为客户机出站请求定义 SSL 安全性。（可保存创建的密钥环名称以便在下一步中使用。）
更新soap.client.props文件中的文件profile_root/properties使用 SAF 密钥环的管理客户机所使用的目录。请参阅 "将系统授权工具密钥环与 Java 安全套接字扩展配合使用" 中的第二步，以获取有关更新soap.client.props中。
构建管理客户机程序。
用 javac 命令编译它，并在类路径参数中提供必需的 JAR 文件的位置。
例如，如果您的安装目录是/DeploymentManager典型命令将类似于以下示例:
```
javac -extdirs "$JAVA_HOME/lib/ext;
/DeploymentManager/classes;/DeploymentManager/lib;
/DeploymentManager/lib/ext"  MyAdminClient.java
```
（前一条命令分割成多行以便于排版。）

运行管理客户机程序。

通过设置运行时环境运行管理客户机程序，这样该程序可以查找所有的先决条件。其中的许多批处理或脚本文件bin安装根目录下的目录执行类似的功能。以下是运行名为管理客户机程序的批处理文件的示例MyAdminClient如下所示：

@echo off

call "%~dp0setupCmdLine.bat"

"%JAVA_HOME%\bin\java" "%CLIENTSAS%" "-Dwas.install.root=%WAS_HOME%" 
"-Dwas.repository.root=%CONFIG_ROOT%" 
-Dcom.ibm.CORBA.BootstrapHost=%COMPUTERNAME% 
 "-Djava.ext.dirs=%JAVA_HOME%\jre\lib\ext;%WAS_HOME%\classes;
%WAS_HOME%\lib;%WAS_HOME%\lib\ext" MyAdminClient %*</pre>--><!--(The contents of the previous batch file is split on multiple lines for publication.)--><pre>@echo off

binDir=`dirname "$0"`       
. "$binDir/setupCmdLine.sh"


"$JAVA_HOME/bin/java" "$CLIENTSOAP" "-Dwas.install.root=$WAS_HOME"
"-Dwas.repository.root=$CONFIG_ROOT" 
-Dcom.ibm.CORBA.BootstrapHost=$COMPUTERNAME 
 "-Djava.ext.dirs=$JAVA_HOME/lib/ext;$WAS_HOME/classes;
$WAS_HOME/lib;$WAS_HOME/lib/ext" MyAdminClient $@

（前一个批处理文件的内容分割成多行以便于排版。）