级别： 初级 Srinivas Shettigar (shsriniv@in.ibm.com), 软件工程师, IBM
2005 年 9 月 14 日 本文描述了如何使用 Telecom Web Services Toolkit（IBM® WebSphere® Everyplace Server for Telecom V5.1 的一个组件）开发电信应用程序。该工具包可以帮助您构建和测试使用 Parlay X Web 服务，即 Parlay Group 和 European Telecommunications Standards Institute (ETSI) 共同发布的开放式标准规范的应用程序。Parlay X Web 服务是 3GPP（Third Generation Partnership Project）中标准化流程的一部分。
关于 Telecom Web Services Toolkit
Telecom Web Services Toolkit for WebSphere Studio Application Developer 是 WebSphere Everyplace Server for Telecom 的一个组件。Everyplace Server for Telecom 使您能够将电子商务应用和数据与电信网络集成起来。它通过对 Parlay API 的支持扩展了 WebSphere Application Server，Parlay API 提供的接口,可以将电信网络和连接器集成到 Parlay 网关。Parlay 网关实现了 Parlay API，使电信应用程序能够与公用电话网络交互。
通过 Telecom Web Services Toolkit，可以构建和测试使用 Parlay X Web 服务的应用程序。该工具包包含下列组件：
- 加速应用程序开发的向导。
- 一个模拟器和测试环境，用于在没有实际网络连接或者实际环境情况下的测试工作。Web 服务模拟器可以模拟某些标准的 Parlay X 1.0 和 Parlay X 2.0 服务，其中包括帐户管理、位置、通知管理、付款、SMS、第三方呼叫、用户状态、组位置以及终端状态和位置。
- 代码片段，它用作 Parlay X 应用程序的构造块。
- 电信 Web 应用程序模板，用于创建具有所必需的 Parlay X Web 服务库的 Web 项目。
- 配置编辑器，用于编辑配置文件 (.WSS，可以用作模拟器的输入，并提供完整的帐户和服务信息）。
- 在模拟器内配置的设备的会话数据的运行时视图。当事件发生在更改会话数据的模拟器时，视图将动态地更新到反映当前的状态。视图中的数据将根据内容适当呈现。您可以在视图中直接修改数据，这使您能够使用不同的输入值快速测试应用程序。模拟器客户机提供了以下视图：Activity、Device、Map、Call 和 Group。
图 1 展示了服务器/客户机模型的各个不同组件如何互相交互的高级视图。我们将使用配置编辑器在 Application Developer 中创建配置文件；这些值存储在 XML 文件中。WSS 运行时模拟器通过 MBean 操作数据。Web 服务测试应用程序通过模拟的服务从 XML 文件中读取配置数据。
图 1. 电信应用程序组件
先决条件
要完成本文中的操作步骤，需要安装下列软件：
- WebSphere Studio Application Developer V5.1.2 或更高版本
- WebSphere Application Server 5.1.1，它具有：
- Application Server Fix Pack 5.1.1
- Application Server eFix for APAR PQ93557
- WebSphere Telecom Web Services Toolkit 5.1
创建模拟器配置文件
我们需要做的第一件事情就是创建模拟器配置文件。该文件使应用程序能够模拟真实的情况，并通过不同的值、设备或帐户进行测试。Parlay X Web 项目使用缺省配置文件 Configuration.wss。我们建议您创建自己的配置文件，这样可以获得对模拟情况的更多控制。
通过完成以下步骤，使用工具包的向导创建新的模拟器配置文件：
- 选择 File => New => Other。
- 在 New 向导的左列中，展开 Web Services 并选择 Telecom。
- 在右面的列中，单击图 2 中所示的 Telecom Simulator Configuration。
- 单击 Next。
图 2. 电信模拟器配置
- 输入新名称，如
TrialConfiguration。
- 如果稍后需要为新的配置文件定义帐户和设备，请单击 Finish。否则，单击 Next。
- 在 Specify Accounts 向导中单击 New 创建新帐户。
- 单击 Next。
- 在 Specify Devices 向导中单击 New。
- 更改完成后，单击 Finish。重复步骤 9 为该帐户创建更多设备，或者单击 Finish 返回到 Specify Account 向导。重复步骤 7 可以创建更多帐户。
- 如果完成了创建帐户，请单击 Finish。创建的新配置文件 (TrialConfiguration.wss) 具有新的帐户和设备。Web 服务模拟器欢迎页面显示。
创建电信应用程序
我们创建的应用程序将存储在工作区中的 Web 项目文件夹。项目文件夹包括 Web 内容文件夹，它包含您使用的文件。缺省情况下，该文件夹名为 WebContent。通过完成以下步骤来创建 Web 项目：
- 选择 File> => New => Other。
- 在 New 窗口的左列，展开 Web Services。
- 选择 Telecom。
- 在窗口的右列，选择 Telecom Web Application Template Parlay X 1.0 或者 Telecom Web Application Template Parlay X 2.0。
- 单击 Next。
图 3. 电信 Web 应用程序模板 Parlay X 2.0
- 在 Telecom Web Application Template 窗口中，输入项目的名称。
- 单击 Finish。
创建 JSP 并添加 Web 服务调用
使用代码片段创建 JSP 并添加 Web 服务调用。代码片段类似于可在其中传递参数的方法调用。这些变量是代码片段使用的内部对象，您需要向其分配相应的值。所有代码片段的变量都是 String 对象。任何非必需的变量都可以为空。
要向 JSP 添加 Web 服务调用，请执行以下步骤：
- 在 Project Navigator 视图中转到 J2EE 透视图。
- 如果应用程序在编辑器中还未打开，则展开应用程序项目并双击 JSP 或者 Servlet 文件。
- 在编辑器中，将光标放置在需要包含代码片段的代码中的某个位置。如果创建的是 JSP，则代码片段必须用 <%%> 结构括在一起。如果创建的是 Servlet，则将光标放置在需要包含代码片段的方法内。
- 在工作区左下角中的 Snippets 视图中，单击包含目标 Web 服务代码片段的某个特定抽屉。
- 双击需要放置在应用程序中的 Web 服务调用。Insert Template 窗口显示。
可以单击 Web 服务所需的每一个变量名称并读取它的描述。JSP 或者 Servlet 必须为每一个 Web 服务变量定义 String 变量。
- 在相应的 Web 服务变量值字段中输入应用程序变量的名称。
- 单击 Insert。
现在可以操作代码片段生成的代码来满足您的设计要求。由于要在模拟器中使用 TrialConfiguration.wss，因此使用在代码中的 TrialConfiguration.wss 提供的帐户和设备信息。
测试示例代码
通过完成以下部分中的步骤来测试示例代码。
创建服务器实例
可以使用在 Application Developer 中集成的服务器测试示例代码，但是，首先我们需要完成以下步骤来定义服务器：
- 打开服务器透视图。
- 在 Server Configuration 窗口中，在工作区的左下角，右键单击 Servers => New => Server and Server Configuration。
- 在 Create a New Server and Server Configuration 窗口中，输入新服务器的名称（在本例中，服务器的名称为
test_server），并在 Server Type 字段中选择 Test Environment。
- 单击 Finish。
- 在 Server Configuration 窗口中，展开 Servers，并右键单击 test_server => Add and remove projects。
- 在 Add and Remove Projects 窗口中，选择 ear => Add 向服务器中添加项目。
- 单击 Finish。
启用模拟器
由于我们创建的服务器实例不使用任何模拟器，因此必须为创建的实例显式启用模拟器。我们还可以指定模拟器在运行时应该使用哪一个配置文件。
要使用具有某个特定服务器实例的模拟器，请执行以下步骤：
- 打开服务器透视图。
- 在 Server Configuration 窗口中，在工作区的左下角，展开 Servers 文件夹。
- 要打开服务器的配置，双击 test_server。
- 在 Editor 窗口中，单击窗口底部的 Telecom Simulator 选项卡。
- 选择 Enable Telecom Web Services Simulator。
- 单击 Browse 加载 TrialConfiguration.wss。
- 关闭编辑器窗口，然后在 Save Resource 对话框中单击 Yes。
运行 JSP
按照以下步骤在 Telecom Web Services Simulator 中运行应用程序：
- 打开服务器透视图。
- 在 Server Configuration 窗口中展开 Servers 文件夹。
- 右键单击 test_server 并选择 Run。
- 右键单击 JSP 文件，然后单击 Run on Server。
Web 服务模拟器客户机 (Web Services Simulator Client) 用于在没有实际的网络连接的情况下测试应用程序。模拟器有几个不同的视图，如前所述。当从代码中执行对设备的调用时，该设备进入 Busy 状态。可以在模拟器客户机中观察和分析这一活动。
启动 Web 服务模拟器客户机
要启动 Web 服务模拟器客户机，请执行以下步骤：
- 打开服务器透视图。
- 在 Server Configuration 窗口中展开 Servers 文件夹。
- 右键单击 test_server 并选择 Run Web Services Simulator Client。模拟器视图显示。通过选择视图底部的选项卡，可以更改视图的类型。
图 4. Web 服务模拟器视图
总结
本文介绍了使用 Telecom Web Services Toolkit 开发电信应用程序的主要方面。通过使用该工具包，您可以在 WebSphere Application Server 上轻松地开发、测试和部署 ParlayX 应用程序。
总的说来，我们做了以下工作来创建和测试电信应用程序：
- 在 Application Developer V5.1.2 上安装 WebSphere Telecom Web Services Toolkit V5.1。
- 创建模拟器配置文件。
- 创建电信应用程序并使用代码片段写入代码。
- 创建启用模拟器的测试服务器。
- 在测试服务器上运行应用程序。
参考资料 - 您可以参阅本文在 developerWorks 全球站点上的 英文原文。
- 有关 Parlay 和 OSA 的更多信息，请参见：
- 有关本文中使用的 WebSphere 产品的更多信息，请参见：
关于作者  | 
| | Srinivas Shettigar 当前在 IBM 印度软件实验室的普及计算 (Pervasive Computing) 小组主管 WebSphere Everyplace Server for Telecom 6.0 测试项目。他参与过为自动化 ParlayX 1.0/ParlayX 2.0 API 测试开发 API 测试代码。Srinivas 在 Java 技术方面有三年多的工作经验，他从事于 WebSphere 产品测试已有一年多的时间。您可以通过 shsriniv@in.ibm.com 与他联系。 |
对本文的评价
| 
