在命令窗口中，安装该 OC4J 示例并设置管理员口令：

cd \oc4j1013\j2ee\home
java -jar oc4j.jar -install

当提示输入口令时，请使用值 welcome。

要在 D:\oc4j1013\j2ee\home 目录中启动该 OC4J 实例，请在命令窗口中输入下列命令：

java -jar oc4j.jar

当命令窗口中出现类似下列内容的消息时，就可以使用该 OC4J 实例了：

05/01/06 15:45:21 Oracle Containers for J2EE 10g (10.1.3.0.0) - Developer Preview 3 initialized  

要访问 Application Server Control，请启动一个浏览器窗口，并输入下列 URL：

http://localhost:1810

要登录 Application Server Control，请输入 User Name admin 和 Password welcome。

单击 Login。

成功登录时，将出现 Application Server Control OC4J:Home 页。

启动 JDeveloper

要在 JDeveloper 中打开初始 JMX 应用程序工作区，请选择 File > Open：

在 Open 对话框中，找到 D:\JDeveloper\JDev1012\jdev\mywork\jmxobe 目录。选择 jmxobe.jws：

单击 Open。

如果展开该 jmxobe 工作区，它则包含下面两个项目：

	App，用于创建部署到该 Oracle Application Server Containers for J2EE (OC4J) 实例的 EAR 文件
	WebApp，包含 Java Web 应用程序查询 EMP 表、格式化并显示员工姓名、编号和工的代码

要创建用于部署的 EAR 文件，请在 Applications - Nagivator 窗格中展开 jmxobe > App > resources 节点。然后右键单击 jmxobeapp.deploy，然后选择 Deploy to EAR file：

日志消息 Deployment 窗口显示该部署操作的结果。记住所创建的 EAR 文件的目录和文件名。

则创建了 EAR 文件 D:\jmxobe\App\deploy\jmxobeapp.ear。

返回显示 OC4J:Home 页并且可以看到 Administration 页的浏览器窗口：

单击 Applications 页链接。

在 Applications 页上，单击 Deploy：

在 Deploy:Select Archive 页的 Archive 部分的 Archive Location 域中输入 D:\jmxobe\App\deploy\jmxobeapp.ear。

注意：您可以单击 Browse 来导航并从文件系统目录中选择该 EAR 文件。

单击 Next。

在 Deploy:Application Attributes 页上，输入或选择下列域值：

	Application Name：jmxobeapp
	Parent Application：default
	Bind Web Module to Site：http-web-site

单击 Next。

在 Deploy:Deployment Settings 页上，单击 Deploy：

等待部署过程成功完成：

单击 Return。

要运行最初的 Web 应用程序，请打开一个新的浏览器窗口，然后输入下列 URL：

http://localhost:8888/jmxobe/

单击 Query 链接。

查询结果窗口显示下列数据：

注意：员工数据以普通格式显示，没有颜色。再次单击 Query 链接，返回同样的数据，外观没有变化。

在 JDeveloper Applications - Navigator 窗格中，右键单击 jmxobe 工作区节点：

选择 New Project。

在 New Gallery 窗口中，从 Projects 类别中选择 Empty Project 项：

单击 OK。

在 Create Project 对话框的 Project Name 域中输入 MBean：

注意：DIrectory Name 域中的最后一个名称使用同样的项目名称。

单击 OK。

要设置 MBean 项目属性，请在 Applications - Navigator 中右键单击 MBean 节点：

选择 Project Properties。

在 Project Properties 窗口中，选择 Libraries 节点：

注意：不要关闭 Project Properties 窗口。

单击 Add Jar... ，然后从 OC4J 目录树中选择 jmxri.jar 文件（提示：请看一下 j2ee\home\lib 子目录）

单击 Open。

JMX 库 jmxri.jar 此时出现在库列表中。

单击 OK 关闭 Project Properties 窗口。按 [Ctrl] + [S] 保存对该 MBean 项目的更改。

要创建 FormatMBean 接口，请在 Applications - Navigator 中右键单击 MBean 节点：

单击 New。

在 New Gallery 窗口中，从 General 类别中选择 Java Interface 项：

单击 OK。

在 Create Java Interface 对话框中，输入下列域值：

	Name：FormatMBean
	Package：oracle.obe.jmx.mbeans

单击 OK。

在 FormatMBean.java 页的 Source 页中，在 Java 接口的大括号内定义 FormatMBean 接口操作：

 // Salary attributes 
public void setSalaryColor(String color);
public String getSalaryColor();
public void setSalarySymbol(String symbol);
public String getSalarySymbol();
public void setSalaryThreshold(long threshold);
public long getSalaryThreshold();
 
// Name attributes 
public void setNameBold(boolean bold);
public boolean isNameBold();
public void setNameItalic(boolean italic);
public boolean isNameItalic();
public void setNameColor(String color);
public String getNameColor();

按 [Ctrl] + [S] 保存对该 FormatMBean.java 文件的更改。

要创建实现 FormatMBean 接口的 Format MBean 类，请在 Applications - Navigator 中右键单击 MBean 节点。

单击 New。

在 New Gallery 窗口中，从 General 类别中选择 Java Class 项：

单击 OK。

在 Create Java Class 窗口中，输入下列域值：

	Name：Format
	Package： oracle.obe.jmx.mbeans
	Extends：java.lang.Object

单击 OK。

让 Format.java 文件在 Code Editor Source 页中处于打开状态，选择 Tools > Implement Interface：

在 Implement Interface 窗口中，展开 oracle > obe > jmx > mbeans 节点。选择 FormatMBean 接口：

单击 OK。

Format.java 源代码现在从它所实现接口中包含了下列类结构框架：

在 Format.java MBean 类的 Source 页中，在该类的起始大括号后添加下列带有默认值的属性声明：

public class Format implements FormatMBean
{
  // Attributes of the MBean
private String salaryColor = "red";
private long salaryThreshold = 1500;
private String salarySymbol = "$";
private boolean nameBold = false;
private boolean nameItalic = false;
private String nameColor = "black";
  
public Format()
  {
  }
  
}    

要实现 Format.java 方法的功能，请在 Source 页中修改代码，使之与下列 Java 源代码类似：

  
public Format()
  {
System.out.println("-->Format constructor");
  }

  /**
* Salary methods implementations 
   */
  public void setSalaryColor(String color)
  {
this.salaryColor = color;
  }

public String getSalaryColor()
  {
return salaryColor;
  }

public void setSalarySymbol(String symbol)
  {
this.salarySymbol = symbol;
  }

public String getSalarySymbol()
  {
return salarySymbol;
  }

public void setSalaryThreshold(long threshold)
  {
this.salaryThreshold = threshold;
  }

public long getSalaryThreshold()
  {
return salaryThreshold;
  }

  /**
* Name methods implementation 
   */
  public void setNameBold(boolean bold)
  {
this.nameBold = bold;
  }

public boolean isNameBold()
  {
return nameBold;
  }

public void setNameItalic(boolean italic)
  {
this.nameItalic = italic;
  }

public boolean isNameItalic()
  {
return nameItalic;
  }

public void setNameColor(String color)
  {
this.nameColor = color;
  }

public String getNameColor()
  {
return nameColor;
  }

选择 File > Save All 保存对 Format.java 文件和 MBean 项目的更改。

要编译该 FormatMBean Java 接口和 Format MBean 类，请在 Applications - Navigator 中右键单击 MBean 项目节点：

选择 Make。

在 Messages - Log 窗口的 Messages 页中，确认该 Java 接口和 Java 类的编译成功后再继续。

编译错误消息（如果有的话）显示在 Compile 页上。这种情况下，请在源代码中更正这些错误，然后对该项目或文件选择 Make 选项。

在 JDeveloper Applications - Navigator 中，右键单击 WebApp 节点：

选择 Project Properties。

在 Project Properties 窗口中，选择 Dependencies 树节点。在 Project Dependencies 列表中选中 MBean.jpr 复选框：

单击 OK。

注意：不要关闭 Project Properties 窗口。

在 Project Properties 窗口中，选择 Libraries，然后单击 Add Jar ...

在 OC4J 目录树中找到 jmxri.jar 文件：

单击 Open。

将 jmxri.jar 库添加到 Selected Libraries 中后，单击 OK 关闭 Project Properties 窗口：

按 [Ctrl] + [S] 保存对该项目的更改。

5.

在 JDeveloper Applications - Navigator 中，展开 WebApp > Application Sources > oracle.obe.jmx.webapp 节点。右键单击 QueryServlet.java：

选择 Open。

要在 QueryServlet.java 的 Code Editor Source 页中使用该 JMX Format MBean，请在 import oracle.obe.jmx.webapp.formatters.*; 语句后添加下列 import 语句：

import javax.management.*;
import oracle.obe.jmx.mbeans.*;

在 QueryServlet 类中，在 private InitialContext m_ic 声明之前声明下列实例变量：

  private static final String FORMATMBEAN_NAME = ":name=FormatMBean";

private MBeanServer m_MBeanServer = null;
private ObjectName m_FormatMBean = null;

在 init() 方法中，要创建 MBeanServer 并动态注册该应用程序的 FormatMBean，请在创建了 InitialContext 对象之后添加下列代码行：

  // Create an MBeanServer and dynamically register 
// the FormatMBean for this application
m_MBeanServer = MBeanServerFactory.createMBeanServer();
m_FormatMBean = new ObjectName(FORMATMBEAN_NAME);
m_MBeanServer.registerMBean(new Format(),m_FormatMBean);

在 getSalaryFormatter() 方法中，请在 return 语句前添加下列代码，以便从该 MBean 获取工资格式选项：

  try
  {
Long threshold = (Long)m_MBeanServer.getAttribute(m_FormatMBean,"SalaryThreshold");
String color = (String) m_MBeanServer.getAttribute(m_FormatMBean,"SalaryColor");
String symbol = (String) m_MBeanServer.getAttribute(m_FormatMBean,"SalarySymbol");

format.setColor(color);
format.setSymbol(symbol);
format.setThreshold(threshold.longValue());
  }
catch (Exception e)
  {
logException(e);
  }

在 getNameFormatter() 方法中，请在 return 语句前添加下列代码，以便从该 MBean 获取姓名格式选项：

try
  {
Boolean italic = (Boolean) m_MBeanServer.getAttribute(m_FormatMBean,"NameItalic");
Boolean bold = (Boolean) m_MBeanServer.getAttribute(m_FormatMBean,"NameBold");
String color = (String) m_MBeanServer.getAttribute(m_FormatMBean,"NameColor");

format.setColor(color);
format.setBold(bold.booleanValue());
format.setItalic(italic.booleanValue());
  }
catch (Exception e)
  {
logException(e);
  }

在 destroy() 方法中，添加下列代码以取消注册和释放该 MBean 实例：

  try
  {
m_MBeanServer.unregisterMBean(m_FormatMBean);
  }
catch (Exception e)
  {
logException(e);
  }

注意：按 [Ctrl]+[S] 保存对该 QueryServlet 源代码的更改。

要编译 QueryServlet，请在 Applications - Navigator 中右键单击 QueryServlet 节点：

选择 Make。

注意：输入 [Ctrl]+[Shift]+[F9] 编译所选的文件。检查 Messages - Log 窗口 Messages 页中的结果，看是否存在下列文本行，以确认编译是否成功：

Successful compilation:0 errors, 0 warnings.

消除任何编译错误，确保重新编译成功，然后再继续后面的步骤。

要为该 MBean 项目创建部署配置文件，请在 Applications - Navigator 中右键单击该 MBean 项目：

选择 New。

在 New Gallery 中，展开 General 节点，然后选择 Deployment Profiles 类别。在 Items 中选择 JAR File：

单击 OK。

在 Create Deployement Profile - JAR File 对话框的 Deployment Profile Name 域中输入 FormatMBean：

单击 OK。

在 JAR Deployement Profiles Properties 窗口中，单击 OK 接受默认设置：

选择 File > Save All 保存对 MBean 项目的所有更改。

在 Applications - Navigator 中，展开 App > Resources 节点。右键单击 jmxobeapp.deploy：

选择 Properties。

在 EAR Deployment Profile Properties 窗口中，选择 Application Assembly 节点。选中 J2EE Modules 部分 MBean.jpr 节点下面的 FormatMBean.deploy 复选框：

单击 OK。按 [Ctrl] + [S] 保存对该部署配置文件的更改。

右键单击 jmxobeapp.deploy：

选择 Deploy to EAR file。

在显示 OC4J:home 页的 Applications 页的浏览器窗口中，选择用于 jmxobeapp 应用程序的选项：

单击 Undeploy。

在 Undeploy Application 页中，单击 Yes：

在显示已经成功取消部署 jmxobeapp 的 Confirmation 页上，单击 Return：

在 OC4J:home 页的 Administration 页上，单击 Deploy：

在 Deploy:Select Archive 页的 Archive Location 域中，输入 D:\jmxobe\App\deploy\jmxobeapp.ear：

注意：您可以单击 Browse 来找到并从文件系统目录中选择该 EAR 文件。

单击 Next。

在 Deploy:Application Attributes 页中，输入或选择下列域值：

	Application Name：jmxobeapp
	Parent Application：default
	Bind Web Module to Site：http-web-site

单击 Next。

在 Deploy:Deployment Settings 页上，单击 Deploy：

等待出现 Confirmation 页，表明部署已经成功：

单击 Return。

要运行更新的 Web 应用程序，请打开一个新的浏览器窗口，然后输入下列 URL：

http://localhost:8888/jmxobe/

单击 Query 链接。

此时显示下列查询响应页：

注意：Name 和 Salary 列中的值应用了默认的格式。但是单击 Query 链接会启动 QueryServlet，该 Servlet 会在 Application Server J2EE container 中注册该 FormatMBean 实例。通过使用 OC4J 管理界面可以更改 FormatMBean 的属性，从而使得该 Web 应用程序显示的数据产生可视格式变化。

在显示 OC4J:home 的 Applications 页的浏览器窗口中，单击 jmxobeapp 链接：

在 Application:jmxobeapp 页上，Home 页显示该特定已部署 Web 应用程序的详细信息：

单击 Related Links 标头下面的 Application Defined MBeans 链接。

在 Application MBeans 页上，值 jmxobeapp:name=FormatMBean 出现在 Name 列中：

单击 jmxobeapp:name=FormatMBean 链接。

在 MBean:jmxobeapp:name=FormatMBean 页的 Attributes 选项卡页中，更改下列属性值：

	SalaryColor：magenta
	SalaryThreshold： 2000
	NameBold：true
	NameColor：purple

单击 Apply Changes。

注意：显示的 MBean:jmxobeapp:name=FormatMBean 页包含一个 Information 部分，其中包含下列消息：

Attributes has been updated successfully.

返回运行该 Web 应用程序的浏览器窗口，其中包含了 Employees 数据页：

单击页底部的 Query 链接，重新查询员工数据。

在结果 Employees 网页上，已经应用了下列格式更改：

	Name 列以紫色粗体显示员工姓名。
	Salary 列以洋红显示超过 $2,000 的工资。

注意：QueryServlet 已经应用了在 MBean:jmxobeapp:name=FormatMBean 管理网页上应用于属性的更改。此过程显示了管理员如何使用该 JMX MBean 来设置或获取一个设计用于与该 MBean 进行交互的应用程序的信息。

安装和使用 Oracle Containers for J2EE 10g (10.1.3)。

使用 Application Server Control 管理控制台浏览 OC4J MBean

扩展 Web 应用程序，以使用 JMX MBean 获取用于应用程序数据可视表示的设置。

使用 Application Server Control 修改 Web 应用程序 MBean 属性。

部署和测试 Web 应用程序及其 MBean 管理接口。

有关 JMX 的信息，请参见 Sun Developer Network 网站上的 Java 管理扩展。