使用CXF开发RESTFul服务
相信大家在阅读CXF官方文档(http://cxf.apache.org/docs/index.html)时,总是一知半解。这里向大家推荐一本PacktPub.Apache.CXF.Web.Service.Development。目前,这本书是没有中文版的,为此笔者简单的写了一些经验总结。
CXF官方文档(http://cxf.apache.org/docs/index.html)时,总是一知半解。这里向大家推荐一本PacktPub.Apache.CXF.Web.Service.Development。目前,这本书是没有中文版的,为此笔者简单的写了一些经验总结。
这本书内容上安排的比较浅显,语言上也没有什么深奥的,值得一读。另外值得一提的是,这本书比官方文档高明之处是每个概念就介绍得很清楚,像第二章的Code-first和Contract-first,第5章的Feature和Interceptor概念的介绍,还有第6章的REST概念简介,内容上都比官方文档详细很多。缺点就是并没有将CXF所有的特性都写下来,这就需要将samples中的内容好好消化一下了。
代码使用Maven组织
http://dl.iteye.com/topics/download/fbbf344b-2357-33fe-86d7-a44116e6de85
使用CXF开发RESTFul服务
在各个系统交互领域,Web services逐渐成为主流。有两种主要方式来开发Web Services:Simple Object Access Protocol (SOAP)和Representational State Transfer (REST)
开发基于SOAP的Web Services需要很多的约束, 以便客户端和服务端交互信息,例如,使用Web Service Description Language (WSDL)来描述信息。还有很多WS的标准如WS-Security。
使用REST构架的服务被称为RESTful服务。这种架构利用简单的XML在HTTP协议上,就像网页一样发送请求,简化了基于SOAP架构开发。RESTful Web Services尤其适用于只需要提交和接受简单的XML信息。
接下来会介绍使用CXF框架来开发RESTful风格的Web Services。
简介
Java API for RESTful services
CXF JAX-RS实现
开发RESTful服务
简介
REST也就是Representational State Transfer。REST并不特指一种技术,也不是一个标准,它仅仅是一个构架风格。REST 指的是一组架构约束条件和原则。满足这些约束条件和原则通过网络暴露资源给用户。事实上,WWW就是经典的REST架构风格。在服务器端,应用程序状态和功能可以分为各种资源。它向客户端公开。每个资源都使用 URI (Universal Resource Identifier) 得到一个惟一的地址。所有资源都共享统一的界面,以便在客户端和服务器之间传输状态。使用的是标准的 HTTP 方法,比如 GET、PUT、POST 和 DELETE。客户端通过交换各种资源的表现体来查询或更新资源。资源的表现体包括HTML,XML,JSON等。客户端需要解析响应服务器的表现体。客户端和服务器之间的交互在请求之间是无状态的,无状态请求可以由任何可用服务器应答。
下面是一些RESTfu例子,提供雇员和部门的信息,并介绍客户端怎样访问这些服务
URI for the RESTful service—http://<host>/department/deptname/employee:
• GET—获得deptname部门的所有员工信息
• POST—为deptname部门创建员工信息。
• DELETE—删除 deptname部门一名员工信息
URI for the RESTful service—http://<host>/department/deptname/employee/naveen:
• GET—获得deptname部门名叫naveen的员工信息
• PUT—为deptname部门创建名叫naveen的员工信息
• DELETE—删除deptname部门名叫naveen的员工信息
下面是POST请求的例子http://<host>/department/deptname/employee
POST /department/deptname/employee HTTP/1.1
Content-Type: */*
Accept: application/xml
User-Agent: Apache CXF 2.2.2
Cache-Control: no-cache
Pragma: no-cache
Host: 127.0.0.1:9001
<employee><firstname>rajeev</firstname><lastname>hathi</lastname>
<dob>10/26/78</dob></employee>
Java API for RESTful services
上一节,我们了解雇员POST请求。如果需要提供一种实现去识别雇员POST请求,我们应该做如下工作:
识别这是否一个HTTP POST请求。
将HTTP POST请求中的XML的内容转换为实现端所需要的格式,例如JAVA对象。
执行指定的操作,例如插入雇员信息到数据库。
以HTTP形式响应客户端,例如设置标志响应成功的HTTP状态200 ,并将响应转换到指定格式(XML或JSON),最后将其设置到HTTP Body。
依据需求,可能你要实现所有的HTTP方法,如GET,PUT,DELETE等。这不就是标准的RESTful JAVA开发模式吗?接着,Java API for RESTful Web services (JAX-RS)规范制定了开发RESTful的标准。
JAX-RS规范定义了创建RESTful服务的语法。JAX-RS使用annotations注解在实现RESTful的服务,使用annotations注解POJO将它暴露为RESTful资源。RESTful服务类中,通过URI(/category)和HTTP(GET, POST)方法注解方法。
@GET
@Path("/category/{id}")
public Category getCategory(@PathParam("id") String id)
实现JAX-RS的框架在运行的时候,通过映射HTTP请求到RESTful方法,负责调用正确的JAVA实现方法。JAX-RS规范提供这种映射的方法的算法。基础算法包括,判断JAVA资源类,判断HTTP URI请求,判断内容格式(例如application/xml),还有HTTP方法(例如GET)
JAX-RS规范提出如下要点:
POJO依赖性
为了暴露为资源,使用annotations注解POJO,
HTTP依赖性
RESTful资源暴露在HTTP中,规范中将HTTP 协议和JAX-RS API相对应映射。
格式独立性
API中提供嵌入式的方法,标准化添加HTTP内容的类型。例如,application/xml就是HTTP内容的类型中的一种。
容器独立性
可以在任何一种容器中部署实现JAX-RS规范的应用程序。
CXF JAX-RS实现
CXF实现了JAX-RS1.0规范,并提供了很多特性帮助开发者搭建企业级的RESTful服务。
下面是CXF框架提供创建RESTful服务的各种特性。
集成Spring
Spring框架已经变成事实上的构建企业级JAVA应用程序集成框架。CXF提供与Spring整合,简化了配置和部署RESTful应用程序。Spring提供依赖注入促进松散耦合,提供各种服务,像声明式事务管理。所有这些Spring提供的特性都可以被开发RESTful服务的CXF框架使用。
插入式数据绑定
数据库绑定就是映射HTTP请求,例如JSON或XML,到对应的JAVA对象。同样的,在发送HTTP响应之前,服务端的JAVA实现需要映射为客户端所需要的格式。通过提供数据库绑定组件,CXF在后台透明的处理映射。CXF支持各种数据绑定机制,如JAXB,JSON,XMLBean和Aegis。CXF允许指定特定的绑定机制。
客户端API
JAX-RS规范并没有提供客户端调用REST服务的API。CXF提供了这种API直接调用RESTful服务,也可以使用Spring框架配置到应用程序中。
安全
CXF可以使用Spring框架集成的声明式安全组件,按照应用程序的需要限制资源类和方法,而不必使用代码处理安全性问题。
过滤器
过滤器用来预处理或后处理信息。CXF可以创建和配置过滤器来审核信息,记录信息的日志,还有基于应用要求修改请求或响应。
CXF也运行开发者使用JAX-WS Provider和Dispatch API来创建RESTful服务。
开发RESTful服务
本节将介绍使用JAX-RS实现的方法来开发RESTful服务,并执行CRUD操作。首先看一下Book Shop应用。
Book Shop应用是一款网络应用,提供技术书籍(JAVA或.NET)的分类。Book Shop让管理员为新的书籍创建分类,修改分类等。一旦这个分类存在,应用可以为这个分类添加新的书籍。
这个应用将提供如下方法:
创建分类
更新分类
删除分类
获取分类列表
获取特定分类
为特定分类添加书籍
获取特定分类中所有书籍
为了开发RESTful服务,需要做如下工作:
创建POJO类
为POJO类提供数据绑定
创建实现RESTful功能的服务类
创建调用RESTful服务的客户端
创建POJO类
- package demo.restful;
- import javax.xml.bind.annotation.XmlRootElement;
- @XmlRootElement(name = "Book")
- public class Book {
- private String bookId;
- private String bookISBNnumber;
- private String bookName;
- //Let assume one author only
- private String author;
- public String getBookId() {
- return bookId;
- }
- public void setBookId(String bookId) {
- this.bookId = bookId;
- }
- public String getBookISBNnumber() {
- return bookISBNnumber;
- }
- public void setBookISBNnumber(String bookISBNnumber) {
- this.bookISBNnumber = bookISBNnumber;
- }
- public String getBookName() {
- return bookName;
- }
- public void setBookName(String bookName) {
- this.bookName = bookName;
- }
- public String getAuthor() {
- return author;
- }
- public void setAuthor(String author) {
- this.author = author;
- }
- }
package demo.restful; import javax.xml.bind.annotation.XmlRootElement; @XmlRootElement(name = "Book")
public class Book { private String bookId; private String bookISBNnumber; private String bookName; //Let assume one author only
private String author; public String getBookId() {
return bookId;
} public void setBookId(String bookId) {
this.bookId = bookId;
} public String getBookISBNnumber() {
return bookISBNnumber;
} public void setBookISBNnumber(String bookISBNnumber) {
this.bookISBNnumber = bookISBNnumber;
} public String getBookName() {
return bookName;
} public void setBookName(String bookName) {
this.bookName = bookName;
} public String getAuthor() {
return author;
} public void setAuthor(String author) {
this.author = author;
} }
- package demo.restful;
- import java.util.Collection;
- import javax.xml.bind.annotation.XmlRootElement;
- @XmlRootElement(name = "Category")
- public class Category {
- private String categoryId;
- private String categoryName;
- private Collection<Book> books;
- public String getCategoryId() {
- return categoryId;
- }
- public void setCategoryId(String categoryId) {
- this.categoryId = categoryId;
- }
- public String getCategoryName() {
- return categoryName;
- }
- public void setCategoryName(String categoryName) {
- this.categoryName = categoryName;
- }
- public Collection<Book> getBooks() {
- return books;
- }
- public void setBooks(Collection<Book> books) {
- this.books = books;
- }
- }
package demo.restful; import java.util.Collection; import javax.xml.bind.annotation.XmlRootElement; @XmlRootElement(name = "Category")
public class Category { private String categoryId; private String categoryName; private Collection<Book> books; public String getCategoryId() {
return categoryId;
} public void setCategoryId(String categoryId) {
this.categoryId = categoryId;
} public String getCategoryName() {
return categoryName;
} public void setCategoryName(String categoryName) {
this.categoryName = categoryName;
} public Collection<Book> getBooks() {
return books;
} public void setBooks(Collection<Book> books) {
this.books = books;
} }
为POJO类提供数据绑定
为了提供RESTful服务端和客户端通信,POJO需要转换为特定的格式,例如XML或JSON。为了实现这部分功能,需要一个数据绑定的组件来映射JAVA对象和XML(或者指定的格式)。
CXF使用JAXB作为默认的数据绑定组件。JAXB使用注解来定义JAVA对象和XML之间映射的关系。
在POJO类Category中,注解@XmlRootElement指定Category为XML的根元素。Category类的属性默认指定映射为@XmlElement。@XmlElement用来定义XML中的子元素。@XmlRootElement和@XmlElement允许自定义命名空间和XML中元素的名称。如果没有定义的话,JAXB在运行的时候默认的使用同样的属性名和类名来定义XML元素。
下面的XML请求表示了Category数据对象。
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Category>
<books>
<author>Naveen Balani</author>
<bookISBNnumber>ISBNB001</bookISBNnumber>
<bookId>NB001</bookId>
<bookName>Fiction Book1</bookName>
</books>
<categoryId>005</categoryId>
<categoryName>Fiction Series</categoryName>
</Category>
创建实现RESTful功能的服务类
类注解
CategoryService的类声明上定义了@Path 和@Produces注解。@Path定义了URI路径,客户端可以通过这个路径访问到CategoryService对象。如@Path("/categoryservice"),那么URI请求,就可以是http://localhost:9000/categoryservice/。@Produces定义了服务类和方法生产内容的类型。如@Produces("application/xml"),那么CategoryService只会生产application/xml。
方法注解
每个方法都和@Produces相关,它决定了这个方法生产什么样的响应。每个方法都有和HTTP方法映射的的注解,例如@GET 和@POST。方法中的@Path注解指定了该方法的URI。例如getCategory()方法上的@Path("/category/{id}"),可以使用http://localhost:9000/categoryservice/category/001,访问到category id 为001的分类。{id}就好比参数。接着,让我们看看@PathParam注解。@PathParam注解是用来给URI 路径一个模板变量,方法的输入参数。@PathParam("id") 就是URI中的 @Path ("/category/{id}")。
@GET
@Path("/category/{id}")
public Category getCategory(@PathParam("id") String id)
异常处理
让我们看一种情况,客户端发送一个请求删除或者更新一个分类,但是这个分类并不存在,那么服务端需要返回正确的错误信息给客户端。
为了处理异常,JAX-RS提供了WebApplicationException,它继承自RuntimeException类。WebApplicationException可以使用HTTP状态代码或者javax.ws.rs.core.Response对象作为构造器。Response对象除了提供HTTP状态代码外,还可以提供用户容易识别的错误信息。
RESTful服务的异常处理可以分为如下几类:
实现类抛出带有HTTP错误代码的WebApplicationException异常。一般的,4XX定义了客户端错误,如错误请求;5XX定义了服务端错误,如服务器没有完成请求。
直接发回javax.ws.rs.core.Response对象,Response对象中包含了HTTP错误代码。
为了测试异常处理代码,启动CategoryServerStart类。在IE浏览器中输入
http://localhost:9000/categoryservice/category/011
由于IE不会显示自定义的错误信息,我们会看到HTTP 400 BAD Request。
如果你在Firefox或者Chrome,就会返回
<error>Category Not Found</error>
添加JSON支持
在@Produces 和 @Consumes注解中添加application/json,指定CategoryService除了application/xml外,还接收和产生application/json。CXF运行时会处理HTTP JSON请求到JAVA对象的转换,还有JAVA对象到HTTP JSON响应的映射。
- package demo.restful;
- //JAX-RS Imports
- import javax.ws.rs.Consumes;
- import javax.ws.rs.DELETE;
- import javax.ws.rs.GET;
- import javax.ws.rs.POST;
- import javax.ws.rs.PUT;
- import javax.ws.rs.Path;
- import javax.ws.rs.PathParam;
- import javax.ws.rs.Produces;
- import javax.ws.rs.WebApplicationException;
- import javax.ws.rs.core.Response;
- import javax.ws.rs.core.Response.ResponseBuilder;
- import javax.ws.rs.core.Response.Status;
- /*
- * CategoryService class - Add/Removes category for books
- */
- @Path("/categoryservice")
- @Produces({"application/json","application/xml"})
- public class CategoryService {
- private CategoryDAO categoryDAO = new CategoryDAO();
- public CategoryDAO getCategoryDAO() {
- return categoryDAO;
- }
- public void setCategoryDAO(CategoryDAO categoryDAO) {
- this.categoryDAO = categoryDAO;
- }
- @GET
- @Path("/category/{id}")
- @Produces({"application/json","application/xml"})
- public Category getCategory(@PathParam("id") String id) {
- System.out.println("getCategory called with category id: " + id);
- Category cat = (Category) getCategoryDAO().getCategory(id);
- if (cat == null) {
- ResponseBuilder builder = Response.status(Status.BAD_REQUEST);
- builder.type("application/xml");
- builder.entity("<error>Category Not Found</error>");
- throw new WebApplicationException(builder.build());
- } else {
- return cat;
- }
- }
- @POST
- @Path("/category")
- @Consumes({"application/json","application/xml"})
- public Response addCategory(Category category) {
- System.out.println("addCategory called");
- Category cat = (Category) getCategoryDAO().getCategory(
- category.getCategoryId());
- if (cat != null) {
- return Response.status(Status.BAD_REQUEST).build();
- } else {
- getCategoryDAO().addCategory(category);
- return Response.ok(category).build();
- }
- }
- @DELETE
- @Path("/category/{id}")
- @Consumes({"application/json","application/xml"})
- public Response deleteCategory(@PathParam("id") String id) {
- System.out.println("deleteCategory with category id : " + id);
- Category cat = (Category) getCategoryDAO().getCategory(id);
- if (cat == null) {
- return Response.status(Status.BAD_REQUEST).build();
- } else {
- getCategoryDAO().deleteCategory(id);
- return Response.ok().build();
- }
- }
- @PUT
- @Path("/category")
- @Consumes({"application/json","application/xml"})
- public Response updateCategory(Category category) {
- System.out.println("updateCategory with category id : "
- + category.getCategoryId());
- Category cat = (Category) getCategoryDAO().getCategory(
- category.getCategoryId());
- if (cat == null) {
- return Response.status(Status.BAD_REQUEST).build();
- } else {
- getCategoryDAO().updateCategory(category);
- return Response.ok(category).build();
- }
- }
- @POST
- @Path("/category/book")
- @Consumes({"application/json","application/xml"})
- public Response addBooks(Category category) {
- System.out.println("addBooks with category id : "
- + category.getCategoryId());
- Category cat = (Category) getCategoryDAO().getCategory(
- category.getCategoryId());
- if (cat == null) {
- return Response.status(Status.NOT_FOUND).build();
- } else {
- getCategoryDAO().addBook(category);
- return Response.ok(category).build();
- }
- }
- @GET
- @Path("/category/{id}/books")
- @Consumes("application/xml,application/json")
- public Response getBooks(@PathParam("id") String id) {
- System.out.println("getBooks called with category id : " + id);
- Category cat = (Category) getCategoryDAO().getCategory(id);
- if (cat == null) {
- return Response.status(Status.NOT_FOUND).build();
- } else {
- cat.setBooks(getCategoryDAO().getBooks(id));
- return Response.ok(cat).build();
- }
- }
- }
package demo.restful; //JAX-RS Imports
import javax.ws.rs.Consumes;
import javax.ws.rs.DELETE;
import javax.ws.rs.GET;
import javax.ws.rs.POST;
import javax.ws.rs.PUT;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.WebApplicationException;
import javax.ws.rs.core.Response;
import javax.ws.rs.core.Response.ResponseBuilder;
import javax.ws.rs.core.Response.Status; /*
* CategoryService class - Add/Removes category for books
*/ @Path("/categoryservice")
@Produces({"application/json","application/xml"})
public class CategoryService { private CategoryDAO categoryDAO = new CategoryDAO(); public CategoryDAO getCategoryDAO() {
return categoryDAO;
} public void setCategoryDAO(CategoryDAO categoryDAO) {
this.categoryDAO = categoryDAO;
} @GET
@Path("/category/{id}")
@Produces({"application/json","application/xml"})
public Category getCategory(@PathParam("id") String id) { System.out.println("getCategory called with category id: " + id); Category cat = (Category) getCategoryDAO().getCategory(id);
if (cat == null) {
ResponseBuilder builder = Response.status(Status.BAD_REQUEST);
builder.type("application/xml");
builder.entity("<error>Category Not Found</error>");
throw new WebApplicationException(builder.build());
} else {
return cat;
}
} @POST
@Path("/category")
@Consumes({"application/json","application/xml"})
public Response addCategory(Category category) { System.out.println("addCategory called"); Category cat = (Category) getCategoryDAO().getCategory(
category.getCategoryId()); if (cat != null) {
return Response.status(Status.BAD_REQUEST).build();
} else {
getCategoryDAO().addCategory(category);
return Response.ok(category).build();
} } @DELETE
@Path("/category/{id}")
@Consumes({"application/json","application/xml"})
public Response deleteCategory(@PathParam("id") String id) { System.out.println("deleteCategory with category id : " + id); Category cat = (Category) getCategoryDAO().getCategory(id);
if (cat == null) {
return Response.status(Status.BAD_REQUEST).build();
} else {
getCategoryDAO().deleteCategory(id);
return Response.ok().build();
}
} @PUT
@Path("/category")
@Consumes({"application/json","application/xml"})
public Response updateCategory(Category category) { System.out.println("updateCategory with category id : "
+ category.getCategoryId()); Category cat = (Category) getCategoryDAO().getCategory(
category.getCategoryId());
if (cat == null) {
return Response.status(Status.BAD_REQUEST).build();
} else {
getCategoryDAO().updateCategory(category);
return Response.ok(category).build();
}
} @POST
@Path("/category/book")
@Consumes({"application/json","application/xml"})
public Response addBooks(Category category) { System.out.println("addBooks with category id : "
+ category.getCategoryId()); Category cat = (Category) getCategoryDAO().getCategory(
category.getCategoryId());
if (cat == null) {
return Response.status(Status.NOT_FOUND).build();
} else {
getCategoryDAO().addBook(category);
return Response.ok(category).build();
}
} @GET
@Path("/category/{id}/books")
@Consumes("application/xml,application/json")
public Response getBooks(@PathParam("id") String id) { System.out.println("getBooks called with category id : " + id); Category cat = (Category) getCategoryDAO().getCategory(id); if (cat == null) {
return Response.status(Status.NOT_FOUND).build();
} else {
cat.setBooks(getCategoryDAO().getBooks(id));
return Response.ok(cat).build(); }
} }
DAO
- package demo.restful;
- import java.util.ArrayList;
- import java.util.Collection;
- import java.util.HashMap;
- import java.util.Map;
- /*
- * DataAcess object for performing CRUD operations.
- * Dummy implementation.
- */
- public class CategoryDAO {
- private static Map<String, Category> categoryMap = new HashMap<String, Category>();
- private static Map<String, Collection<Book>> bookMap = new HashMap<String, Collection<Book>>();
- static {
- Category category1 = new Category();
- category1.setCategoryId("001");
- category1.setCategoryName("Java");
- categoryMap.put(category1.getCategoryId(), category1);
- Book book1 = new Book();
- book1.setAuthor("Naveen Balani");
- book1.setBookName("Spring Series");
- book1.setBookId("001");
- book1.setBookISBNnumber("ISB001");
- Book book2 = new Book();
- book2.setAuthor("Rajeev Hathi");
- book2.setBookName("CXF Series");
- book2.setBookId("002");
- book2.setBookISBNnumber("ISB002");
- Collection<Book> booksList = new ArrayList<Book>();
- booksList.add(book1);
- booksList.add(book2);
- bookMap.put(category1.getCategoryId(), booksList);
- }
- public void addCategory(Category category) {
- categoryMap.put(category.getCategoryId(), category);
- }
- public void addBook(Category category) {
- bookMap.put(category.getCategoryId(), category.getBooks());
- }
- public Collection<Book> getBooks(String categoryId) {
- return bookMap.get(categoryId);
- }
- public Category getCategory(String id) {
- Category cat = null;
- //Dummy implementation to return a new copy of category to
- //avoid getting overridden by service
- if(categoryMap.get(id) != null) {
- cat = new Category();
- cat.setCategoryId(categoryMap.get(id).getCategoryId());
- cat.setCategoryName(categoryMap.get(id).getCategoryName());
- }
- return cat;
- }
- public void deleteCategory(String id) {
- categoryMap.remove(id);
- // Remove association of books
- bookMap.remove(id);
- }
- public void updateCategory(Category category) {
- categoryMap.put(category.getCategoryId(), category);
- }
- }
package demo.restful; import java.util.ArrayList;
import java.util.Collection;
import java.util.HashMap;
import java.util.Map; /*
* DataAcess object for performing CRUD operations.
* Dummy implementation.
*/
public class CategoryDAO { private static Map<String, Category> categoryMap = new HashMap<String, Category>();
private static Map<String, Collection<Book>> bookMap = new HashMap<String, Collection<Book>>(); static { Category category1 = new Category();
category1.setCategoryId("001");
category1.setCategoryName("Java");
categoryMap.put(category1.getCategoryId(), category1); Book book1 = new Book();
book1.setAuthor("Naveen Balani");
book1.setBookName("Spring Series");
book1.setBookId("001");
book1.setBookISBNnumber("ISB001"); Book book2 = new Book();
book2.setAuthor("Rajeev Hathi");
book2.setBookName("CXF Series");
book2.setBookId("002");
book2.setBookISBNnumber("ISB002"); Collection<Book> booksList = new ArrayList<Book>();
booksList.add(book1);
booksList.add(book2); bookMap.put(category1.getCategoryId(), booksList);
} public void addCategory(Category category) {
categoryMap.put(category.getCategoryId(), category); } public void addBook(Category category) {
bookMap.put(category.getCategoryId(), category.getBooks()); } public Collection<Book> getBooks(String categoryId) {
return bookMap.get(categoryId); } public Category getCategory(String id) {
Category cat = null;
//Dummy implementation to return a new copy of category to
//avoid getting overridden by service
if(categoryMap.get(id) != null) {
cat = new Category();
cat.setCategoryId(categoryMap.get(id).getCategoryId());
cat.setCategoryName(categoryMap.get(id).getCategoryName());
}
return cat;
} public void deleteCategory(String id) {
categoryMap.remove(id);
// Remove association of books
bookMap.remove(id);
} public void updateCategory(Category category) {
categoryMap.put(category.getCategoryId(), category); } }
创建调用RESTful服务的客户端
JAX-RS并不提供调用RESTful服务客户端。CXF框架提供了两种方式来创建客户端,这两种都可以使用Spring配置。
代理API
代理API允许你使用RESTful服务的资源类和接口。代理类是客户端直接调用接口方法,使用户不需要手工创建HTTP请求。将RESTful服务类传递给org.apache.cxf.jaxrs.client.JAXRSClientFactory类。一旦代理类创建好了,你可以直接使用RESTful服务接口类的任何方法。
CategoryService store = JAXRSClientFactory.create("http://
localhost:9000", CategoryService.class);
//Makes remote call to Category RESTFul service
store.getBooks("001");
HTTP客户端
使用org.apache.cxf.jaxrs.client.WebClient调用RESTful服务。本例中采用HTTP客户端。
- package demo.restful.client;
- import java.util.ArrayList;
- import java.util.Collection;
- import java.util.Iterator;
- import javax.ws.rs.core.Response;
- import org.apache.cxf.jaxrs.client.WebClient;
- import demo.restful.Book;
- import demo.restful.Category;
- public class CategoryServiceRESTClient {
- //Put some static value
- private static final String CATEGORY_URL = "http://localhost:9000/";
- private static final String CATEGORY_ID = "005";
- private static final String TYPE_XML = "application/xml";
- private static final String TYPE_JSON = "application/json";
- public static void main(String[] args) {
- //System.out.println("Format is " + args[0]);
- testAddCategory(TYPE_XML);
- testUpdateCategory(TYPE_XML);
- testGetCategory(TYPE_XML);
- testAddBooksForCategory(TYPE_XML);
- testGetBooksForCategory(TYPE_XML);
- testDeleteCategory(TYPE_XML);
- testAddCategory(TYPE_JSON);
- testUpdateCategory(TYPE_JSON);
- testGetCategory(TYPE_JSON);
- testAddBooksForCategory(TYPE_JSON);
- testGetBooksForCategory(TYPE_JSON);
- testDeleteCategory(TYPE_JSON);
- // if(args[0] !=null && args[0].equalsIgnoreCase(TYPE_XML)){
- // //Content type- XML
- // testAddCategory(TYPE_XML);
- // testUpdateCategory(TYPE_XML);
- // testGetCategory(TYPE_XML);
- // testAddBooksForCategory(TYPE_XML);
- // testGetBooksForCategory(TYPE_XML);
- // testDeleteCategory(TYPE_XML);
- // }
- //
- // if(args[0] !=null && args[0].equalsIgnoreCase(TYPE_JSON)){
- // //ContentType- JSON
- // testAddCategory(TYPE_JSON);
- // testUpdateCategory(TYPE_JSON);
- // testGetCategory(TYPE_JSON);
- // testAddBooksForCategory(TYPE_JSON);
- // testGetBooksForCategory(TYPE_JSON);
- // testDeleteCategory(TYPE_JSON);
- // }
- }
- private static void testAddCategory(final String format) {
- System.out.println("testAddCategory called with format " + format);
- WebClient client = WebClient.create(CATEGORY_URL);
- client.path("/categoryservice/category").accept(
- format).type(format);
- Category cat = new Category();
- cat.setCategoryId(CATEGORY_ID);
- cat.setCategoryName("Fiction");
- Category catResponse = client.post(cat, Category.class);
- System.out.println("Category Id retreived for format " + format + " is " + catResponse.getCategoryId());
- assertEquals(catResponse.getCategoryId(), CATEGORY_ID);
- }
- private static void testUpdateCategory(final String format) {
- System.out.println("testUpdateCategory called with format " + format);
- WebClient client = WebClient.create(CATEGORY_URL);
- client.path("/categoryservice/category").accept(
- format).type(format);
- Category cat = new Category();
- cat.setCategoryId(CATEGORY_ID);
- cat.setCategoryName("Fiction Series");
- Response response = client.put(cat);
- System.out.println("Status retreived for update category for format " + format + " is " + response.getStatus());
- assertEquals("200", String.valueOf(response.getStatus()));
- }
- private static void testGetCategory(final String format) {
- System.out.println("testGetCategory called with format " + format);
- WebClient client = WebClient.create(CATEGORY_URL);
- Category category = client.path("/categoryservice/category/" + CATEGORY_ID).accept(
- format).type(format).get(Category.class);
- System.out.println("Category details retreived from service with format " + format);
- System.out.println("Category Name " + category.getCategoryName());
- System.out.println("Category Id " + category.getCategoryId());
- assertEquals(CATEGORY_ID, category.getCategoryId());
- }
- private static void testAddBooksForCategory(final String format) {
- System.out.println("testAddBooksForCategory called with format " + format);
- WebClient client = WebClient.create(CATEGORY_URL);
- client.path("/categoryservice/category/book").type(format).
- accept(format);
- Category cat = new Category();
- cat.setCategoryId(CATEGORY_ID);
- cat.setCategoryName("Fiction Series");
- Book book1 = new Book();
- book1.setAuthor("Naveen Balani");
- book1.setBookId("NB001");
- book1.setBookISBNnumber("ISBNB001");
- book1.setBookName("Fiction Book1");
- Collection<Book> booksList = new ArrayList<Book>();
- booksList.add(book1);
- cat.setBooks(booksList);
- client.post(cat, Category.class);
- }
- private static void testGetBooksForCategory(final String format) {
- System.out.println("testGetBooksForCategory called with format " + format);
- WebClient clientBook = WebClient.create(CATEGORY_URL);
- Category categoryBooks = clientBook.path(
- "/categoryservice/category/" + CATEGORY_ID + "/books").type(format).accept(format).get(Category.class);
- System.out.println("Book details retreived from service with format " + format);
- assertEquals(String.valueOf(categoryBooks.getBooks().size()), "1");
- Iterator<Book> iterator = categoryBooks.getBooks().iterator();
- while (iterator.hasNext()) {
- Book book = iterator.next();
- System.out.println("Book Name " + book.getBookName());
- System.out.println("Book ISBN " + book.getBookISBNnumber());
- System.out.println("Book ID " + book.getBookId());
- System.out.println("Book Author " + book.getAuthor());
- }
- }
- private static void testDeleteCategory(final String format) {
- System.out.println("testDeleteCategory called with format " + format);
- WebClient client = WebClient.create(CATEGORY_URL);
- client.path("/categoryservice/category/" + CATEGORY_ID).type(format).
- accept(format);
- Response response = client.delete();
- System.out.println("Status retreived for delete category for format " + format + " is " + response.getStatus());
- assertEquals("200", String.valueOf(response.getStatus()));
- }
- private static void assertEquals(String expected, String result) {
- if (!expected.equalsIgnoreCase(result)) {
- throw new RuntimeException("Expecte value " + expected + ", Got value" + result);
- }
- }
- }
http://reymont.iteye.com/blog/1523822
使用CXF开发RESTFul服务的更多相关文章
- 用cxf开发restful风格的WebService
我们都知道cxf还可以开发restful风格的webService,下面是利用maven+spring4+cxf搭建webService服务端和客户端Demo 1.pom.xml <projec ...
- WebService--使用 CXF 开发 REST 服务
现在您已经学会了如何使用 CXF 开发基于 SOAP 的 Web 服务,也领略了 Spring + CXF 这个强大的组合,如果您错过了这精彩的一幕,请回头看看这篇吧: Web Service 那点事 ...
- CXF 开发 REST 服务
今天我们将视角集中在 REST 上,它是继 SOAP 以后,另一种广泛使用的 Web 服务.与 SOAP 不同,REST 并没有 WSDL 的概念,也没有叫做"信封"的东西,因为 ...
- weblogic 10.x 上开发restful服务
之前已经学习过 利用JAX-RS快速开发RESTful 服务,当时是jboss环境,如果原封不动的迁移到weblogic 10.x 版本,会杯具的发现应用启动失败,需要做些小调整: 项目结构如下: 需 ...
- 基于CXF开发crm服务
1 基于CXF开发crm服务 1.1 数据库环境搭建 1.2 web项目环境搭建 第一步:创建动态web项目 第二步:导入CXF相关jar包 第三步:配置web.xml <context-par ...
- 使用Apache CXF开发WebServices服务端、客户端
在前一篇的博客中,我使用Xfire1.x来开发了WebServies的服务端. 但是如果你访问Apache的官网,可以看到xfire已经被合并了. 最新的框架叫做CXF. Apache CXF = C ...
- WebService- 使用 CXF 开发 SOAP 服务
选框架犹如选媳妇,选来选去,最后我还是选了“丑媳妇(CXF)”,为什么是它?因为 CXF 是 Apache 旗下的一款非常优秀的 WS 开源框架,具备轻量级的特性,而且能无缝整合到 Spring 中. ...
- java 利用JAX-RS快速开发RESTful 服务
JAX-RS(Java API for RESTful Web Services)同样也是JSR的一部分,详细规范定义见 https://jcp.org/en/jsr/detail?id=311 .从 ...
- java_java 利用JAX-RS快速开发RESTful 服务
JAX-RS(Java API for RESTful Web Services)同样也是JSR的一部分,详细规范定义见 https://jcp.org/en/jsr/detail?id=311 .从 ...
随机推荐
- 孤荷凌寒自学python第四天 安装python的其它IDE环境
孤荷凌寒自学python第四天 安装python的其它IDE环境 (完整学习过程屏幕记录视频地址在文末) 因为是完全的新手,对python环境搭建完全一无所知,因此,可真是大费周章才配置了其它多个Id ...
- inspect流程
当node节点state为manage时,可执行inspector ironic node-set-provision-state <node_uuid> manage ironic no ...
- 【志银】nginx_php_mysql_phpMyAdmin配置(Windows)
✄更新中... 更新日期:2018.11.22 ★版本说明+快捷下载(官网) nginx nginx-1.14.1 http://nginx.org/download/nginx-1.14.1. ...
- hnust 分蛋糕
问题 B: 分蛋糕 时间限制: 1 Sec 内存限制: 128 MB提交: 2430 解决: 966[提交][状态][讨论版] 题目描述 今天是DK生日,由于DK的朋友很多,所以DK在蛋糕店定制了 ...
- mongodb 部署
安装mongodb-3.4 1)将安装包上传至服务器 2)对压缩文件进行解压 tar -zxvf mongodb-linux-x86_64-suse12-v3.4-latest.tar.gz 3)把解 ...
- JSP/Servlet Web 学习笔记 DayFive
ServletConfig <只对当前Servlet有效> (1)在Web容器初始化Servlet实例时,都会为这个Servlet准备一个唯一的ServletConfig实例(俗称Serv ...
- Python 3.x的编码问题
Python 3的源码.py文件的默认编码方式为UTF-8(Python 2.x的默认编码格式为unicode). encode的作用,使我们看到的直观的字符转换成计算机内的字节形式. decode刚 ...
- 网络战争 [KD-Tree+最小割树]
题面 思路 首先吐槽一下: 这题是什么东西啊??出题人啊,故意拼题很有意思吗??还拼两个这么毒瘤的东西???? 10K代码了解一下???? 然后是正经东西 首先,本题可以理解为这样: 给定$n$个块, ...
- JavaScript的团队编程规范
本规范是针对javascript函数式编程风格与公司严重依赖于jQuery进行编码的现实制定出来. 禁止使用eval,with与caller(ecma262 v5 的use strict要求).eva ...
- vue的main.js
import Vue from 'vue'; import App from './App.vue'; //================http 请求======================= ...