MyEclipse开发教程：REST Web Service（一）

本教程示例将创建一个简单的Web服务来维护客户列表。

MyEclipse 在线订购年终抄底促销！火爆开抢>>

MyEclipse最新版下载

使用MyEclipse开发RESTWeb服务来放大您的Web应用程序。在本教程示例中，您将创建一个简单的Web服务来维护客户列表。你将学会：

用于开发REST Web服务的过程
部署到MyEclipse Tomcat服务器
使用REST Web服务资源管理器进行测试

没有MyEclipse立即下载

1.从REST Web服务项目开始

REST Web服务项目向导使您能够开始项目配置。

单击工具栏上的New图标MyEclipse REST Web Service上的下拉箭头，并从菜单中选择Web Service Project。
在Project Name字段中输入restdemo，选择REST（JAX-RS）框架选项，然后单击Next。
注意：本教程使用JavaEE 6版本；但是，在创建新项目时，JavaEE 7是可用的选项。
创建Web服务项目
接受默认的源文件夹，然后单击Next。
单击Finish以接受本示例的默认值。 完成项目

2.创建新的REST Web服务

有了项目，就可以创建Web服务了。您将创建管理客户实体所需的类和资源方法的类。

2.1创建客户实体

这个简单的Customer类包含id、name和地址字段，并且表示使用Web服务管理的Customer实体。

右键单击restdemo项目，并选择New>Class。
在Package字段中键入com.myeclipseide.ws，在Name字段中键入Customer，如果选中则取消选择Public Static Void Main复选框，并单击Finish。

创建Java类

用下面的代码替换生成的类的默认内容，并保存文件。

package com.myeclipseide.ws;  import javax.xml.bind.annotation.XmlRootElement;@XmlRootElement  public class Customer {  private int id;  private String name;  private String address;  public int getId() {     return id;  }  public void setId(int id) {    this.id = id;  }  public String getName() {     return name;  }  public void setName(String name) {     this.name = name;  }  public String getAddress() {     return address;  }  public void setAddress(String address) {    this.address = address;  }}

您使用XML作为序列化格式，即使用XML从Web服务发送和接收客户实体。

Customer类中的@ XMLROOTE元素注释是一个JAXB注释，允许JAXB将这个实体从Java转换为XML并返回。可以对类中的字段和方法进行注释以定制序列化，但是对于本教程，JAXB默认设置是可以的。

2.2创建资源类，即Web服务的核心

右键单击restdemo项目，并选择New>Other。
在过滤器字段中输入Web服务，选择Web服务，然后单击Next

创建新的Web服务
从Java类选项中选择“Create web service”，选择“Create new Java bean”复选框，然后单击“Next”。

创建新的Web服务
在URL路径字段中键入客户，选择Stutelon生命周期选项，从产品下拉中选择Apple /XML，键入JavaSpand字段中的COM.MycliestId.WSN，并在Java类字段中键入CuulsRes资源。

Web服务配置详细说明URL路径：指示可以到达此资源的路径。对于本教程，资源将托管在“/customer”。

Singleton Lifecycle：确保每个web应用程序仅由Jersey创建该类的一个实例。

Consumes and Produces：可用于指定该资源可以接受和生成的数据的默认mime类型。这些值可以由类中的单个方法覆盖。如上所述，您正在序列化XML，因此您使用application/xml mime类型。

单击Add按钮添加获取客户列表的方法。
在返回类型字段中，在方法名称字段java.util.List<Customer>中键入getCustomers，然后单击“Finish”。

添加methodHTTP方法：在本例中，可以用来指定该方法响应的HTTP请求的类型。
Method Signature preview：在对页面进行更改时更新，让您了解生成的方法的外观。

再次单击Add按钮以添加返回特定客户的详细信息的方法。
在方法名称字段中输入getCustomer，在返回类型字段中输入Customer，在URL路径字段中输入{id}。

添加第二种方法
单击Add按钮添加Method参数。在Java类型字段中键入int，在Java名称字段中键入CID，从PARAM类型下拉中选择PathParam，并在PARAM名称字段中键入ID。单击Finish。

addingmethodparametersURLPath：指定相对于包含的资源可以到达此方法的路径。

在本例中，您指定{id}，这意味着可以在/customer/{id}处到达此资源方法。花括号表示URI变量。这些变量在运行时替换为资源，以响应基于替换URI的请求。

参数：直接在表中编辑参数。因为需要id变量的值，所以使用PathParam注释将其映射到cId参数。
添加允许向列表中添加新客户的方法。填入如下所示的字段，然后单击Finish。

在本例中，您正在响应POST请求并期望应用程序/xml输入，该输入将被反序列化为客户参数。customerparameter是一个Entity参数（未注明），并且直接从传入请求的消息主体映射。您还可以重写CustomersResource类指定的默认应用程序/xml输出，并指定text/html。