BEA Tuxedo 控件 8.1 上手指南

作者：
日期：2003-10-31

演示BEA Tuxedo 控件 8.1

内容列表

概览

按照本上手指南中提到的步骤，您将可以在WebLogic Workshop上运行我们提供的Web服务应用程序，该应用程序将会访问Tuxedo Bike Order Fulfillment Inventory应用程序提供的服务。从Web服务应用程序中访问Tuxedo服务是借助Tuxedo 控件来完成的。

JumpStart工具包中包含一个Tuxedo 控件扩展（名为uBike.jcx的Java控件）和一个Web服务文件（uBikeWS.jws），以及uBike Tuxedo 应用程序（tuxubikeapp.zip）。

uBike应用程序提供的服务包括 SEARCHINVENTORY、ORDERITEM、SOLDITEM、MODIFYITEM 和DUMPDATABASE。除了DUMPDATABASE，其他服务的输入都是FML32 buffer。所有服务的返回值都是FML32 buffer。除此之外，Tuxedo应用程序中还含有Tuxedo simpapp ATMI server，它可以提供一个名为TOUPPER的Tuxedo服务，该服务接收一个STRING buffer并返回一个STRING buffer。

这个demo只演示如何使用现有的代码；也就是说，它不是一个开发demo，而是一个开发完成的代码的demo。您可以通过它来了解如何在WebLogic Workshop中使用Tuxedo 控件。

准备

为了运行这个demo，您需要安装WebLogic Platform 8.1。您还需要安装Tuxedo系统（运行Tuxedo 8.1、8.0、7.1 或 6.5）来运行Tuxedo应用程序。不需要使用C/C++编译器，因为我们已经提供了Tuxedo应用程序的二进制文件。如果现在没有安装Tuxedo，您最好安装和配置Tuxedo 8.1。所有产品都可以从以下地址获得http://commerce.bea.com/index.jsp。

本demo假定Tuxedo 和 WebLogic Platform 8.1 被安装在同一个系统之上。尽管实际上产品并没有这个需求，但为了简化demo的安装和配置，我们做了这个假设。目前，该demo只支持Windows平台。

安装和配置Jumpstart应用程序
1. 解压缩TuxedoControlJSKit.zip 的内容到一个空目录中，保留zip文件的目录结构。该操作将创建两个子目录，分别是"tux"和"wlw"。Tux目录中包含Tuxedo应用程序以及安装脚本。Wlw目录中包含部分Web服务应用程序。
2. 启动WebLogic Workshop。选择"开始"菜单，打开"所有程序-> BEA WebLogic Platform 8.1->WebLogic Workshop 8.1"。
3. 当WebLogic Workshop IDE启动之后，单击"File->New->Application"创建一个名为uBikeApp的新应用程序。选择"Empty Application"，并选择"workshop"作为server，如下图所示。

4. 为了使Tuxedo 控件能够被您的应用程序所使用，您必须添加TuxedoControl.jar文件到Weblogic Workshop IDE的[application]面板的[Libraries]文件夹中。右键单击刚创建的应用程序的[Libraries]文件夹并选择[Add Library]。这将打开一个对话框，请浏览到TuxedoControl.jar文件所在的位置。它位于"BEAHOME" 目录下的 ext_components\Tuxedo\controls目录中，其中"BEAHOME"代表WebLogic Platform 8.1的安装位置。

5. 创建一个名为"uBikeWS"的新Web服务项目。在[application]面板中右键单击"uBikeApp"应用程序，选择[New Project]。请确保在右边的列中选择了正确的Web服务项目类型。

6. 导入位于"wlw"目录下的Jumpstart工具包提供的文件。在[application]面板中右键单击"uBikeApp"应用程序，选择[Import]。浏览到"wlw"目录，同时选中"controls"目录和"uBikeWS.jws"文件，单击[Import]按钮。

7. 启动WebLogic Server。在Weblogic Workshop IDE中选择"Tools->Weblogic Server->Start Weblogic Server"。
8. 在命令行提示窗口中执行"setWLSEnv.cmd"脚本，设置WebLogic Server环境变量。setWLSEnv.cmd位于"BEAHOME"下的weblogic81\server\bin目录中，其中"BEAHOME"代表WebLogic Platform 8.1的安装目录

9. 如果不存在"TUXDIR"环境变量，请设置它，并使其指向您的Tuxedo安装位置。
10. 进入步骤1创建的"tux"目录，执行ant命令。该命令将会执行"build.xml"脚本，这个脚本将会：
1. 在系统上配置我们提供的Tuxedo应用程序
2. 为系统和Tuxedo应用程序配置WebLogic Server提供的WebLogic Tuxedo Connector (WTC) 服务。
3. 启动Tuxedo应用程序。
在执行过程中，脚本将会提示输入用户名和密码。该用户名和密码就是您的 WebLogic Server的管理员用户名和密码。默认为"weblogic"和"weblogic"。除此之外，脚本还可能弹出消息，说无法找到实例，可以忽略它。

11. 在[application]面板的"uBikeWS"项目下双击"uBikeWS.jws"文件，打开Java Web服务文件。

12. 在WebLogic Workshop中单击[start]按钮或按下"Ctrl+F5"，启动Web服务应用程序。集成的测试浏览器应该出现在屏幕上，并显示出"uBikeWS.jws "文件提供的Web服务。在测试浏览器中向下拉动滚动条，察看所有可用的Web服务。

13. 在Workshop测试浏览器中，在"SearchInventory"Web服务的"color"参数中输入"GREEN"，并单击[SearchInventory]按钮，您将获得一组绿色自行车的列表。

14. 向下拖动滚动条，察看包含了所有绿色自行车的Web服务响应。

15. 从结果集中选择并复制一个序列号，单击页面顶部的[Test Operations]链接。如果您选择的条目没有库存，下一步的结果将会略有不同。
16. 粘贴序列号到"soldBike"服务的[SerialNumber]字段中，单击[soldBike]。
17. 检查页面底部的成功消息。

18. 再次选择[Test Operations]链接，并执行"getAllBikes"服务，察看自行车是否已经不在商品目录中。
19. 选择[Test Operations]链接运行"SearchInventory"服务，输入一或多个字段，比如在[Color]中输入"RED"、在[Size]中输入"56"，并单击"SearchInventory"按钮。察看返回的结果，并确认只返回符合指定条件的自行车。

20. 如果愿意，可以在Tuxedo系统的命令提示窗口中使用tmadmin命令显示服务的统计情况。使用printserver (psr)或printservice (psc)显示各个服务器或服务的请求统计。请确认已经设置了TUXCONFIG环境变量。如果没有设置，请执行位于Jumpstart工具包的"tux"目录下的"setenv.cmd"命令脚本。
21. 察看控件扩展uBike.jcx的代码
a. 它只是一个接口定义。开发扩展不需要任何代码，所有的一切都是描述性的。
b. 操作的方法签名决定了数据在buffer中如何存放。
c. 注解可以提供描述服务的附加信息
d. 一般只有那些十分了解Tuxedo应用程序的人才能开发该文件。即他需要了解服务、buffer内容、等等。
e. 该控件扩展可以被一个Java控件封装，这个Java控件可以改变用户看到的接口。
f. 该控件可以应用于各种Workshop类型的应用程序。
22. 察看Web服务扩展uBikeWS.jws的代码
a. 控件实例被声明但没有被初始化。当控件真正被使用时，Workshop运行时环境执行实例化的工作。
b. SearchInventory、orderBike、modifyBike、soldBike、和getAllBikes Web服务只是简单地发布它们底层使用的Tuxedo 服务。Web服务实现没有执行任何操作。
c. getBikesWithinPriceRange Web服务的确执行了一些处理。它调用控件扩展的getAllBikes方法，然后基于传递给Web服务的参数进行结果过滤。