[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