首页 > 代码库 > 14_CXF发布REST服务
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
14_CXF发布REST服务