netbeans.apache.org/src/content/kb/docs/websvc/flower_ws_zh_CN.asciidoc - netbeans-website - Git at Google

 //
 //     Licensed to the Apache Software Foundation (ASF) under one
 //     or more contributor license agreements.  See the NOTICE file
 //     distributed with this work for additional information
 //     regarding copyright ownership.  The ASF licenses this file
 //     to you under the Apache License, Version 2.0 (the
 //     "License"); you may not use this file except in compliance
 //     with the License.  You may obtain a copy of the License at
 //
 //       http://www.apache.org/licenses/LICENSE-2.0
 //
 //     Unless required by applicable law or agreed to in writing,
 //     software distributed under the License is distributed on an
 //     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 //     KIND, either express or implied.  See the License for the
 //     specific language governing permissions and limitations
 //     under the License.
 //

 = 端到端二进制 SOAP 附件 2：创建 Web 服务
 :jbake-type: tutorial
 :jbake-tags: tutorials
 :jbake-status: published
 :icons: font
 :syntax: true
 :source-highlighter: pygments
 :toc: left
 :toc-title:
 :description: 端到端二进制 SOAP 附件 2：创建 Web 服务 - Apache NetBeans
 :keywords: Apache NetBeans, Tutorials, 端到端二进制 SOAP 附件 2：创建 Web 服务

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


 *本教程中的课程*

 image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 NetBeans IDE 7.2、7.3、7.4 和 8.0"]

 1. link:./flower_overview.html[+概述+]
 2. => 创建 Web 服务
 3. link:flower-code-ws.html[+对 Web 服务进行编码和测试+]
 4. link:./flower_wsdl_schema.html[+修改方案文件和 WSDL 文件以传递二进制数据+]
 5. link:./flower_swing.html[+创建 Swing 客户端+]

 *本课内容*

 [start=1]
 1. <<create-web-app,创建 Web 应用程序>>
 2. <<add-ws,添加 Web 服务>>


 [[create-web-app]]
 == 创建 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 包）。


 [start=6]
 . 将包命名为  ``org.flower.resources`` 。单击 "Finish"（完成）。
 image::images/new-package.png[]

 [start=7]
 . 将以下图像复制到  ``org.flower.resources``  中：
 * link:images/rose.jpg[+rose.jpg+]
 * link:images/sunflower.jpg[+sunflower.jpg+]
 * link:images/aster.jpg[+aster.jpg+]
 * link:images/honeysuckle.jpg[+honeysuckle.jpg+]

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

 image::images/project-w-resources.png[]


 [[add-ws]]
 == 添加 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"（完成）。
 image::images/new-service.png[]

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

 image::images/project-w-service-and-resources.png[]

 [start=3]
 . 在编辑器中打开  ``FlowerService.java`` 。切换到 "Design"（设计）视图。随即出现一个窗体，在该窗体中可以向 Web 服务中添加操作和服务质量元素。
 image::images/flower-service-empty-design.png[]

 [start=4]
 . 单击 "Add Operation"（添加操作）。此时将打开添加操作向导。

 [start=5]
 . 将操作命名为  ``getFlower`` 。在 "Return Type"（返回类型）字段中，键入或浏览以找到  ``java.awt.Image`` 。

 [start=6]
 . 在 "Parameters"（参数）标签中，单击 "Add"（添加）。将参数命名为  ``name``  并接受默认的  ``java.lang.String``  类型。
 image::images/add-getflower-param.png[]

 [start=7]
 . 打开 "Exceptions"（异常错误）标签。添加一个  ``IOException`` 。
 image::images/io-exception.png[]

 [start=8]
 . 单击 "OK"（确定）并关闭向导。然后再次单击 "Add Operation"（添加操作），并添加带有以下属性的操作：
 * *Name（名称）：*getThumbnails
 * *Return type（返回类型）：*java.util.List
 * *Exception（异常错误）：*IOException

 现在 "Design"（设计）视图中显示了  ``getFlower``  和  ``getThumbnails``  操作。切换至这两个操作的“列表视图”，将看到其所有参数。

 image::images/flower-service-full-design.png[]


 ==


 == 后续步骤：

 link:./flower-code-ws.html[+对 Web 服务进行编码和测试+]

 link:/about/contact_form.html?to=3&subject=Feedback:%20Flower%20Creating%20WS%20EE6[+发送有关此教程的反馈意见+]


 要发送意见和建议、获得支持以及随时了解 NetBeans IDE Java EE 开发功能的最新开发情况，请link:../../../community/lists/top.html[+加入 nbj2ee@netbeans.org 邮件列表+]。
	//
	// Licensed to the Apache Software Foundation (ASF) under one
	// or more contributor license agreements. See the NOTICE file
	// distributed with this work for additional information
	// regarding copyright ownership. The ASF licenses this file
	// to you under the Apache License, Version 2.0 (the
	// "License"); you may not use this file except in compliance
	// with the License. You may obtain a copy of the License at
	//
	// http://www.apache.org/licenses/LICENSE-2.0
	//
	// Unless required by applicable law or agreed to in writing,
	// software distributed under the License is distributed on an
	// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
	// KIND, either express or implied. See the License for the
	// specific language governing permissions and limitations
	// under the License.
	//

	= 端到端二进制 SOAP 附件 2：创建 Web 服务
	:jbake-type: tutorial
	:jbake-tags: tutorials
	:jbake-status: published
	:icons: font
	:syntax: true
	:source-highlighter: pygments
	:toc: left
	:toc-title:
	:description: 端到端二进制 SOAP 附件 2：创建 Web 服务 - Apache NetBeans
	:keywords: Apache NetBeans, Tutorials, 端到端二进制 SOAP 附件 2：创建 Web 服务

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


	本教程中的课程

	image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 NetBeans IDE 7.2、7.3、7.4 和 8.0"]

	1. link:./flower_overview.html[+概述+]
	2. => 创建 Web 服务
	3. link:flower-code-ws.html[+对 Web 服务进行编码和测试+]
	4. link:./flower_wsdl_schema.html[+修改方案文件和 WSDL 文件以传递二进制数据+]
	5. link:./flower_swing.html[+创建 Swing 客户端+]

	本课内容

	[start=1]
	1. <<create-web-app,创建 Web 应用程序>>
	2. <<add-ws,添加 Web 服务>>


	[[create-web-app]]
	== 创建 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 包）。


	[start=6]
	. 将包命名为 ``org.flower.resources`` 。单击 "Finish"（完成）。
	image::images/new-package.png[]

	[start=7]
	. 将以下图像复制到 ``org.flower.resources`` 中：
	* link:images/rose.jpg[+rose.jpg+]
	* link:images/sunflower.jpg[+sunflower.jpg+]
	* link:images/aster.jpg[+aster.jpg+]
	* link:images/honeysuckle.jpg[+honeysuckle.jpg+]

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

	image::images/project-w-resources.png[]


	[[add-ws]]
	== 添加 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"（完成）。
	image::images/new-service.png[]

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

	image::images/project-w-service-and-resources.png[]

	[start=3]
	. 在编辑器中打开 ``FlowerService.java`` 。切换到 "Design"（设计）视图。随即出现一个窗体，在该窗体中可以向 Web 服务中添加操作和服务质量元素。
	image::images/flower-service-empty-design.png[]

	[start=4]
	. 单击 "Add Operation"（添加操作）。此时将打开添加操作向导。

	[start=5]
	. 将操作命名为 ``getFlower`` 。在 "Return Type"（返回类型）字段中，键入或浏览以找到 ``java.awt.Image`` 。

	[start=6]
	. 在 "Parameters"（参数）标签中，单击 "Add"（添加）。将参数命名为 ``name`` 并接受默认的 ``java.lang.String`` 类型。
	image::images/add-getflower-param.png[]

	[start=7]
	. 打开 "Exceptions"（异常错误）标签。添加一个 ``IOException`` 。
	image::images/io-exception.png[]

	[start=8]
	. 单击 "OK"（确定）并关闭向导。然后再次单击 "Add Operation"（添加操作），并添加带有以下属性的操作：
	* Name（名称）：getThumbnails
	* Return type（返回类型）：java.util.List
	* Exception（异常错误）：IOException

	现在 "Design"（设计）视图中显示了 ``getFlower`` 和 ``getThumbnails`` 操作。切换至这两个操作的“列表视图”，将看到其所有参数。

	image::images/flower-service-full-design.png[]


	==


	== 后续步骤：

	link:./flower-code-ws.html[+对 Web 服务进行编码和测试+]

	link:/about/contact_form.html?to=3&subject=Feedback:%20Flower%20Creating%20WS%20EE6[+发送有关此教程的反馈意见+]


	要发送意见和建议、获得支持以及随时了解 NetBeans IDE Java EE 开发功能的最新开发情况，请link:../../../community/lists/top.html[+加入 nbj2ee@netbeans.org 邮件列表+]。