端到端二进制 SOAP 附件 2:创建 Web 服务

This tutorial needs a review. You can open a JIRA issue, or edit it in GitHub following these contribution guidelines.

本课的目标是创建一个包含 Web 服务的 Web 应用程序。您会将 Web 服务作为一个无状态会话 Bean 来实现。

本教程中的课程

netbeans stamp 80 74 73
Figure 1. 此页上的内容适用于 NetBeans IDE 7.2、7.3、7.4 和 8.0

本课内容

创建 Web 应用程序

在此部分,您将创建一个 Java EE Web 应用程序。向此应用程序中添加 Web 服务将其作为二进制数据传递的图像。

创建 Web 应用程序:

  1. 选择 "File"(文件)> "New Project"(新建项目)(在 Linux 和 Windows 上为 Ctrl-Shift-N 组合键,在 MacOS 上为 ⌘-Shift-N 组合键)。此时将打开新建项目向导。从 "Java Web" 类别中选择 "Web Application"(Web 应用程序),然后单击 "Next"(下一步)。"Name and Location"(名称和位置)页打开。

  2. 在 "Project Name"(项目名称)字段中键入 FlowerAlbumService 。为该项目选择所需的位置。保留其他选项为默认设置,然后单击 "Next"(下一步)。"Server and Settings"(服务器和设置)页面打开。

  3. 选择 "GlassFish Server",并选择 Java EE 版本 "Java EE 6 Web" 或 "Java EE 7 Web"。

  4. 单击 "Finish"(完成)。将创建 FlowerAlbumService 项目并将其显示在 "Projects"(项目)窗口中。

  5. 右键单击 "Source Packages"(源包)节点,然后选择 "New"(新建)> "Java Package"(Java 包)。

也可以选择 "New"(新建)> "Other"(其他),然后在新建文件向导的 "Java" 类别中选择 "Java Package"(Java 包)。

  1. 将包命名为 org.flower.resources 。单击 "Finish"(完成)。

new package
  1. 将以下图像复制到 org.flower.resources 中:

现在此项目在 "Source Package"(源包)中具有包 org.flower.resources 。未添加任何其他内容。

project w resources

添加 Web 服务

在此部分,将在 Web 应用程序中创建一个 Web 服务。该服务将作为无状态会话 Bean 来创建。将以下 Web 操作添加到该服务中:

  • 获取鲜花名称及其相关 Image 的操作。

  • 获取所有鲜花图像的缩略图并将其作为 List 返回的操作。

添加 Web 服务:

  1. 在 "Projects"(项目)窗口中,右键单击 FlowerAlbumService 项目节点,然后选择 "New"(新建)> "Web Service"(Web 服务)。也可以选择 "New"(新建)> "Other"(其他),然后在新建文件向导中选择 "Web Services"(Web 服务)下的 "Web Service"(Web 服务)。此时将打开新建 Web 服务向导。

  2. 在新建 Web 服务向导中,在 "Web Service Name"(Web 服务名称)中键入 FlowerService ,在 "Package Name"(包名称)中键入 org.flower.service 。选择 "Create Web Service from Scratch"(从头开始创建 Web 服务)。选中 "Implement Service as Stateless Session Bean"(将 Web 服务作为无状态会话 Bean 实现)。单击 "Finish"(完成)。

new service

Web 服务出现在 "Projects"(项目)窗口中的项目节点中。"Source Packages"(源包)目录包括了服务包和资源包。

project w service and resources
  1. 在编辑器中打开 FlowerService.java 。切换到 "Design"(设计)视图。随即出现一个窗体,在该窗体中可以向 Web 服务中添加操作和服务质量元素。

flower service empty design
  1. 单击 "Add Operation"(添加操作)。此时将打开添加操作向导。

  1. 将操作命名为 getFlower 。在 "Return Type"(返回类型)字段中,键入或浏览以找到 java.awt.Image

  1. 在 "Parameters"(参数)标签中,单击 "Add"(添加)。将参数命名为 name 并接受默认的 java.lang.String 类型。

add getflower param
  1. 打开 "Exceptions"(异常错误)标签。添加一个 IOException

io exception
  1. 单击 "OK"(确定)并关闭向导。然后再次单击 "Add Operation"(添加操作),并添加带有以下属性的操作:

    • *Name(名称):*getThumbnails

    • *Return type(返回类型):*java.util.List

    • *Exception(异常错误):*IOException

现在 "Design"(设计)视图中显示了 getFlowergetThumbnails 操作。切换至这两个操作的“列表视图”,将看到其所有参数。

flower service full design

 

后续步骤:

要发送意见和建议、获得支持以及随时了解 NetBeans IDE Java EE 开发功能的最新开发情况,请加入 nbj2ee@netbeans.org 邮件列表