|
作者:Beth Stearns 和 David Botterill
|
|
|
| Sun Java Studio Creator 集成开发环境可以帮助您创建使用 Web 服务的应用程序。这意味着您可以利用 IDE 创建一个 Web 服务客户端,供您的 Web 应用程序使用。 |
为了创建使用 Web 服务的应用程序,您需要执行以下任务:
- 找到要添加的 Web 服务。
- 检查应用程序与该 Web 服务的接口是否正常运行(可选任务)。这可能涉及测试各个 Web 服务方法。
- 将 Web 服务添加到“服务器”窗口中。
- 将 Web 服务从“服务器”窗口拖到 Web 表单或 Web 页上。
- 利用代码完成功能,可以轻松地导航 IDE 生成并放置在 Web 服务旁边的包装类(可选任务)。包装类是 Web 服务客户端的支持 Java 源代码,您无法编辑此类。
- 部署应用程序。
- 查看该服务的 Web 服务定义语言 (Web Services Definition Language, WSDL) 文件(可选任务)。
尽管看起来似乎要完成很多操作,但是 IDE 可以帮助您轻松地完成这些任务。首先可以指定 Web 服务源的位置,Web 服务源既可以是统一资源定位器 (Uniform Resource Locator, URL),也可以是本地文件。这些资源代表一个 Web 服务定义语言 (Web Services Definition Language, WSDL) 文件,并且此类文件可以代表多项 Web 服务。因此,您还必须指定所需的源服务。
首先,找到 Web 服务。在“服务器”窗口中右键单击“Web 服务”节点,弹出其上下文菜单。选择“添加 Web 服务”选项。这将打开“添加 Web 服务”对话框窗口。输入 WSDL 文件的 URL 或找到代表 WSDL 文件的本地文件。
图 1:“添加 Web 服务”对话框 |
一旦指定了 WSDL 文件的位置,IDE 就可以检索有关 Web 服务的信息。IDE 会检查所引用的条目,并在“Web 服务信息”部分显示有关 Web 服务及其方法的信息。此对话框还允许您检查该服务的 WSDL 文件是否符合 WS-I Basic Profile 1.0。如果选中此选项,IDE 会解析 WSDL 文件,并且在该对话框底部的“结果”部分列出所有不符合规范的条目。您还可以让 IDE 生成 SOAP 标头。如果您对该 Web 服务很满意,则可以完成此过程来添加 Web 服务。
图 2:Web 服务信息 |
当您向 IDE 中添加了 Web 服务后会发生哪些情况呢?IDE 会创建一个 Web 服务客户端,允许您正在开发的 Web 应用程序调用此项 Web 服务。添加的 Web 服务以节点形式出现在“服务器”窗口的“Web 服务”节点下,您可以看到该服务的可用方法。
图 3:“服务器”窗口的“Web 服务”节点 |
IDE 还提供了一个对话框窗口,通过该窗口,您可以测试在 WSDL 文件中定义的各个 Web 服务方法。在“服务器”窗口的“Web 服务”节点下,右键单击要进行测试的方法,然后通过对话框输入该方法的参数值。当您准备测试该方法时,按一下“提交”按钮,IDE 就会用指定的参数值执行该方法。在对话框的“结果”部分,IDE 会在服务执行了方法后显示这些值。
图 4:“测试 Web 服务方法”对话框 |
IDE 还为 Web 服务客户端创建了特有的包装类。包装类的确是一个方便的 Java 源代码类,它能够为您处理 Web 服务语义。这种方便的类通过实例变量来表示,并且具有代码完成功能在内的所有可视编辑器编辑功能。所有包装类至少为每项服务提供了三种简便的方法:
- SetUsername 用来设置该服务的登录用户名
- SetPassword 用来设置该服务的登录口令
- SetAddress 用来设置该服务的端点地址
您只需将某个 Web 服务节点从“服务器”窗口拖放到 Web 页上,即可添加该 Web 服务。当您完成此操作后,Web 服务会以客户端的形式出现在“概要”窗口的该页中。图 5 显示了将 AmazonSearchService 拖到 Page1 上的结果。
图 5:“概要”窗口中的 Web 服务客户端和方法 |
您还可以将某个特定的 Web 服务方法节点拖放到 Web 页中接受数据的可视组件上。IDE 会根据 Web 服务方法的返回值类型将该方法绑定到组件上。在该页的“概要”显示区域上,您还能看到方法的一个条目。为了便于说明,我们将 AmazonSearchService 方法 authorSearchRequest 拖放到 Page1 的文本字段组件上。IDE 会将方法 amazonSearchServiceAuthorSearchRequest1 添加到 Page1 中,如图 5 中的“概要”窗口所示。
您可以像查看 Java 源代码那样查看 Web 服务的 WSDL 文件。右键单击“服务器”窗口中该 Web 服务的节点,然后选择“查看 WSDL”选项。WSDL 文件是以 XML 格式编写的,因此,IDE 在显示该文件内容时所采用的颜色及语法与其他 XML 文档相同。在 IDE 中 WSDL 文件是只读的,所以您无法编辑它。
|