14_CXF发布REST服务

【rest服务】

　　REST服务是一种软件架构模式，只是一种风格。REST服务采用HTTP做传输协议。

REST对于HTTP的利用分为以下两种：

一.资源定位

　　REST要求对方资源定位更加准确，如下：

　　非REST方式：http://127.0.0.1:12345/queryUser.action?userType=student&id=001

　　REST 方式：htpp://127.0.0.1:12345/student/001

　　REST方式表示互联网上的资源更加准确，但也有缺点，当目录的层级较多时会导致较难理解。

二.资源操作

　　利用HTTP的GET、POST、PUT、DELETE四种操作来表示数据库操作的SELECT、UPDATE、INSERT、DELETE操作。

　　比如：

　　1.查询学生的方法，设置HTTP的请求方法为GET，

　　url如下：http://127.0.0.1:12345/user/student/001

　　2.添加学生的方法，设置HTTP的请求方法为PUT，

　　url如下：http://127.0.0.1:12345/user/student/001/张三/...
　　REST常用于资源定位，资源的操作方式较少使用。

【使用场景】

　　REST是一种软件架构理念，现在被移植到web服务上，那么在开发Web服务上，偏于面向资源的服务的适用于REST，REST简单易用，效率高，SOAP成熟度较高，安全性好。

　　注意：REST不等于WebService，JAX-RS只是将REST设计风格应用到Web服务上。

【代码需求】

查询学生信息，传输参数为学生信息id，在url中定义，如http://127.0.0.1:12345/user/student/001,

其中001就是参数。

注意：REST一般返回结果格式：XML 或 JSON

【工程截图】



【Student.java】

package com.Higgin.ws.cxf.rest.pojo;

import java.util.Date;

import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement(name="student")
public class Student {
private long id;
private String name;
private Date birthday;

//忽略 get/set 方法.....
}

【StudentService.java】

package com.Higgin.ws.cxf.rest.service;

import java.util.List;

import javax.jws.WebService;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;

import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;

import com.Higgin.ws.cxf.rest.pojo.Student;

@WebService
@Path("/student")
public interface StudentService {

//查询学生信息
@GET    //http的get方法
@Path("/query/{id}")  //id参数通过url传递
@Produces(MediaType.APPLICATION_XML)  //设置媒体类型xml格式
public Student queryStudent(@PathParam("id")long id);

//查询学生列表
    @GET
@Path("/queryList/{type}")
//设置媒体类型为XML格式和JSON格式
@Produces({"application/json;charset=utf-8",MediaType.APPLICATION_XML})
/* 如果想让rest返回xml,需要在rest的url后边添加 ?_type=xml,默认为xml
如果想让rest返回json.需要在rest的url后边添加?_type=json*/
public List<Student> queryStudentList(@PathParam("type") String type);
}

【StudentServiceImpl.java】

package com.Higgin.ws.cxf.rest.service;

import java.util.ArrayList;
import java.util.Date;
import java.util.List;

import com.Higgin.ws.cxf.rest.pojo.Student;

public class StudentServiceImpl implements StudentService{

@Override
public Student queryStudent(long id) {
//使用静态数据来表示
Student student=new Student();
student.setId(id);
student.setName("张三");
student.setBirthday(new Date());
return student;
}

@Override
public List<Student> queryStudentList(String type) {
//使用静态数据来表示
List<Student> list=new ArrayList<>();
Student student1=new Student();
student1.setId(1001);
student1.setName("张三");
student1.setBirthday(new Date());

Student student2=new Student();
student2.setId(1002);
student2.setName("张三");
student2.setBirthday(new Date());

list.add(student1);
list.add(student2);

return list;
}
}

【StudentServer.java】

package com.Higgin.ws.cxf.rest.server;

import org.apache.cxf.jaxrs.JAXRSServerFactoryBean;

import com.Higgin.ws.cxf.rest.service.StudentServiceImpl;

public class StudentServer {

public static void main(String[] args) {
//使用jaxrsServerFactoryBean发布rest服务
JAXRSServerFactoryBean jaxrsServerFactoryBean=new JAXRSServerFactoryBean();
//设置rest的服务地址
jaxrsServerFactoryBean.setAddress("http://127.0.0.1:12345/rest");
//设置服务对象
jaxrsServerFactoryBean.setServiceBean(new StudentServiceImpl());
//设置资源对象（如果有多个pojo对象，对象中间以","隔开即可）
jaxrsServerFactoryBean.setResourceClasses(StudentServiceImpl.class);
//发布rest服务
jaxrsServerFactoryBean.create();
}
}

【启动服务】使用Java Application启动main方法



1.在浏览器中输入 http://127.0.0.1:12345/rest/student/query/666


2.在浏览器中输入 http://127.0.0.1:12345/rest/student/queryList/123


3.在浏览器中输入 http://127.0.0.1:12345/rest/student/queryList/001?_type=xml


4.在浏览器中输入 http://127.0.0.1:12345/rest/student/queryList/001?_type=json