首页 > 代码库 > cxf 相关知识整理

cxf 相关知识整理

① 请求方式为GET

   @GET    @Path(value = "/userAddressManage")    @Produces( { MediaType.APPLICATION_JSON, "text/html; charset=UTF-8" })    public BuyerAddressResponseModel userAddressManage(            @QueryParam("buyerTel") String buyerTel,              @QueryParam("detailAddress") String detailAddress);

 和POST请求方式对应的获取参数数据的方式是: @QueryParam

 

② 请求方式为POST

通过GET的方式来提交数据,参数的长度是都限制的,当数据的长度超过了限制,请求会失败。

这种情况下就不得不使用POST请求了。

    @POST    @Path(value = "/addOrder")    @Produces( { MediaType.APPLICATION_JSON, "text/html; charset=UTF-8" })    public OrderResponseModel addOrder(            @FormParam("orderInfo") String orderInfo,            @FormParam("orderDetailsList") String orderDetailsList,            @FormParam("addressInfo") String addressInfo);

 和POST请求方式对应的获取参数数据的方式是: @FormParam

 

③ CXF相关注解整理

1)@WebService 和 @WebMethod 是 WSDL 映射 Annatotion。描述 Web Service 的 WSDL 文档元素和 Java 源代码联系在一起。

2)@WebParam 用来获取请求参数

3)@WebResult用来定义返回值

4)@SOAPBinding 是一个绑定的 annotation 用来说明网络协议和格式。 

 

使用annotation 定义了webservice

import java.util.List;import javax.jws.WebMethod;import javax.jws.WebParam;import javax.jws.WebResult;import javax.jws.WebService;import com.cxf.pojo.User;@WebService(targetNamespace = "http://jdk.study.hermit.org/client")public interface UserService {    @WebMethod(operationName = "Insert")    public void insert(
       @WebParam(name = "userId") String userid, @WebParam(name = "userName") String username, @WebParam(name = "userEmail") String useremail, @WebParam(name = "userAge") int userage); @WebMethod(operationName = "GetUserById") @WebResult(name = "result") public User getUserById(@WebParam(name = "userid") String userid); @WebMethod(operationName = "GetAllUsers") @WebResult(name = "result") public List getAllUsers();}

 

实现类如下:

import  java.util.List; import  javax.jws.WebService; import  com.cxf.dao.UserDao; import  com.cxf.pojo.User; import  com.cxf.service.UserService; @WebService (endpointInterface= "com.cxf.service.UserService" ) publicclass UserServiceImpl  implements  UserService {   private UserDao  userDao ;   public List getAllUsers() { return userDao .findAllUser(); }   public User  getUserById(String userid) { return userDao .findUserById(userid);}   publicvoid insert(String userid, String username, String useremail,  int  userage) {     User user= new  User();     user.setUserage(userage);     user.setUseremail(useremail);     user.setUserid(userid);     user.setUsername(username);     userDao .insert(user);     System. out .println( "insert successfully!" );   }   public   void  setUserDao(UserDao userDao) {     this . userDao  = userDao;   } } 
注意:实现类中的@WebService ,其中的 endpointInterface 成员指定了该类实现的接口

下面介绍restful在springMVC下的注解

  
Annotation 注解在 javax.ws.rs.* 中定义,是 JAX-RS (JSR 311) 规范的一部分。
@Path       定义资源基 URI。由上下文根和主机名组成,资源标识符类似于 http://localhost:8080/RESTful/rest/hello 在类和方法上使用
@GET      这意味着以下方法可以响应 HTTP GET 方法
@Produces   以纯文本方式定义响应内容 MIME 类型
@Context    使用该注释注入上下文对象,比如 Request、Response、UriInfo、ServletContext
@FormParam  接收POST方式提交的参数
@QueryParam 接收GET方式提交的参数
@Consumes    声明该方法使用 HTML FORM
@Produces( { MediaType.APPLICATION_JSON, "text/html; charset=UTF-8" })

定义REST接口服务

package demo.ws.rest_cxf; import java.util.List;import java.util.Map;import javax.ws.rs.Consumes;import javax.ws.rs.DELETE;import javax.ws.rs.FormParam;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.core.MediaType; public interface ProductService {     @GET    @Path("/products")    @Produces(MediaType.APPLICATION_JSON)    List<Product> retrieveAllProducts();     @GET    @Path("/product/{id}")    @Produces(MediaType.APPLICATION_JSON)    Product retrieveProductById(@PathParam("id") long id);     @POST    @Path("/products")    @Consumes(MediaType.APPLICATION_FORM_URLENCODED)    @Produces(MediaType.APPLICATION_JSON)    List<Product> retrieveProductsByName(@FormParam("name") String name);     @POST    @Path("/product")    @Consumes(MediaType.APPLICATION_JSON)    @Produces(MediaType.APPLICATION_JSON)    Product createProduct(Product product);     @PUT    @Path("/product/{id}")    @Consumes(MediaType.APPLICATION_JSON)    @Produces(MediaType.APPLICATION_JSON)    Product updateProductById(@PathParam("id") long id, Map<String, Object> fieldMap);     @DELETE    @Path("/product/{id}")    @Produces(MediaType.APPLICATION_JSON)    Product deleteProductById(@PathParam("id") long id);}

 

以上 ProductService 接口中提供了一系列的方法,在每个方法上都使用了 JAX-RS 提供的注解,主要包括以下三类:

  1. 请求方式注解,包括:@GET、@POST、@PUT、@DELETE
  2. 请求路径注解,包括:@Path ,其中包括一个路径参数
  3. 数据格式注解,包括:@Consumes(输入)、@Produces(输出),可使用 MediaType 常量
  4. 相关参数注解,包括:@PathParam(路径参数)、@FormParam(表单参数),此外还有 @QueryParam(请求参数)

针对 updateProductById 方法,简单解释一下:

该方法将被 PUT:/product/{id} 请求来调用,请求路径中的 id 参数将映射到 long id 参数上,请求体中的数据将自动转换为 JSON 格式并映射到 Map<String, Object> fieldMap 参数上,返回的 Product 类型的数据将自动转换为 JSON 格式并返回到客户端。

 

参考网址:

http://my.oschina.net/huangyong/blog/294324

http://www.cnblogs.com/hoojo/archive/2012/07/23/2605219.html

 

cxf 相关知识整理