CXF WebService以及RestFulWebService搭建整理_restful和webservice和cxf

<jaxws:server id=“userService” serviceClass=“com.IUserService”

address=“/userService”>

jaxws:serviceBean

</jaxws:serviceBean>

</jaxws:server>

 

F.启动服务器进行发布部署，在浏览器中输入http://localhost:8080/SpringCXF/services/userService?wsdl 看页面是否会出现xml文档,来判断服务是否配置成功

G:客户端配置

server.client 的配置

<? xml version ="1.0" encoding ="UTF-8"? > < beans xmlns ="http://www.springframework.org/schema/beans" xmlns:context ="http://www.springframework.org/schema/context" xmlns:jaxws ="http://cxf.apache.org/jaxws" xmlns:xsi ="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation ="http://www.springframework.org/schema/beans > http://www.springframework.org/schema/beans/spring-beans-3.0.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd" < import resource ="classpath:META-INF/cxf/cxf.xml"/> < import resource ="classpath:META-INF/cxf/cxf-extension-soap.xml"/> < import resource ="classpath:META-INF/cxf/cxf-servlet.xml"/> < jaxws:client id ="userWsClient" serviceClass ="com.hoo.service.IComplexUserService" address ="http://localhost:8080/ /SpringCXF/services/userService "/> 2. RESTful Webservice RESTful风格的 WebService 主张重用 HTTP 协议，面向资源编程（ ROA ）。扼要的说， RESTful 风格 WebService 中，每一个 URL 即表示一个资源. RESTful 简化了 web service 的设计，它不再需要 wsdl ，也不再需要 soap 协议，而是通过最简单的 http 协议传输数据 ( 包括 xml 或 json) 。既简化了设计，也减少了网络传输量（因为只传输代表数据的 xml 或 json ，没有额外的 xml 包装） A.pom.xml配置,引入依赖的jar包 javax.ws.rs jsr311-api 1.1.1 org.apache.cxf cxf-rt-frontend-jaxrs 2.4.4 web.xml配置           Apache CXF Endpoint           cxf           cxf           org.apache.cxf.transport.servlet.CXFServlet           1                       cxf           /services/\*         B.restful webService 注解讲解 | | | | --- | --- | | 标签 | 用法和解释 | | @GET,@POST,@PUT,@DELETE | 该组标签将一个标注方法的 HTTP 请求类型 | | @PATH | 该标签可用于类或者方法，表示定位此 RESTful 资源的路径。 | | @Produces | 该标签标注资源类或方法返回的 MIME 类型 , 也就是资源方法产生并且返回给客户端的响应消息的类型。例如 application/xml. | | @Consumes | 该标签标注资源类或方法可以接受的请求消息的类型，也就是客户端发送的请求中可以包含的 Http Entity 的类型。 | | @PathParam，@QueryParam，@HeaderParam，@CookieParam | 该组分别标注方法的参数来自于 HTTP 请求的不同位置，例如，@PathParam 来自于 URL 的路径，@QueryParam 来自于 URL 的查询参数，@HeaderParam 来自于 HTTP 请求的头信息，@CookieParam 来自于 HTTP 请求的 Cookie。 | | @Context | 该标签标注资源请求或者响应的上下文实例，例如我们可以再资源方法参数中注入 HttpServletRequest (@Context HttpServletRequest httpRequest) 来获取 Http 请求的相关信息 | Demo: @GET @PATH(value=”/staff/query/{id}”) @Produces(“application/xml”) Staff getStaffById(@PathParam("id") int id) C.restful webservice注解释义 @XmlAccessorType(XmlAccessType. PROPERTY ) @XmlRootElement(name = "User") @XmlType(propOrder = { "userId", "nickname", "gender","registerDate"}) publicclassUser implementsSerializable { privatestaticfinallong serialVersionUID= 1L; privateString userId; privateString nickname; privateString gender; privateDate registerDate; publicUser(String userId, String nickname, String gender, Date registerDate) { this.userId = userId; this.nickname = nickname; this.gender = gender; this.registerDate = registerDate; } publicString getUserId()  { returnuserId; } publicvoidsetUserId(String userId)  { this.userId = userId; } publicString getNickname()  { returnnickname; } publicvoidsetNickname(String nickname) { this.nickname = nickname; }   publicString getGender() { returngender; }   publicvoidsetGender(String gender)  { this.gender = gender; } @XmlJavaTypeAdapter(DateConverter. class )   publicDate getRegisterDate() { returnregisterDate; }   publicvoidsetRegisterDate(Date registerDate)  { this.registerDate = registerDate; } @Override publicString toString() { return"User [userId=" + userId + ", nickname=" + nickname + ", gender=" + gender + ", registerDate =" + registerDate + "]"; } } 为了用 XML 映射多个用户，我们定义了 Users 类，Users 类只有一个成员变量，它是一个装有 User 对象的 java.util.List 列表。 @XmlRootElement(name = "Users" ) publicclassUsers  { @XmlElement(name = "User") privateList users; publicList getUsers()  { returnusers; }   publicvoidsetUsers(List users)  { this.users = users; } } 对于注册日期 registerDate 变量的映射，需要做一些必要的处理，我们希望日期被映射为 yyyy-mm-dd 的形 式，上述 User 类中， 我们用 @XmlJavaTypeAdapter 标签 注释 registerDate 的 getter 方法， 希望 告知 JAXB 遇到这个属性的时候， 用 DateConverter 类做处理 @Produces({ MediaType. APPLICATION\_XML })  @Consumes({ MediaType. APPLICATION\_XML }) publicinterface UserService  { @GET @Produces(MediaType. APPLICATION\_XML ) @Path("/searchuser/{userId}") User searchUser( @PathParam("userId") String userId);   @POST @Consumes(MediaType. APPLICATION\_XML ) @Path("/adduser") Response addUser(User user); @DELETE @Consumes(MediaType. APPLICATION\_XML ) @Path("/deleteuser/{userId}") Response deleteUser( @PathParam("userId") String userId);   @PUT @Path("/category") @Consumes(MediaType. APPLICATION\_XML ) Response updateUser(User user); @GET @Path("/getusers/startdate/{startDate}/enddate/{endDate}") @Produces({ MediaType. APPLICATION\_XML }) Users getUsers( @PathParam("startDate") String startDate , @PathParam("endDate") String endDate); } publicclass UserServiceImpl implements UserService { public User searchUser(String userId) { User user = UserDAO. searchUser (userId); if (user == null )  { ResponseBuilder builder = Response. status ( Status. NOT\_FOUND ); builder.type("application/xml"); builder.entity("User with id:" + userId + " can not be found!"); thrownew WebApplicationException(builder.build()); } else { System. out .println("User with id:" + userId + " is found"); return user; } }   public Response addUser(User user) { User userObj = (User) UserDAO. searchUser (user.getUserId());   if (userObj != null )  { ResponseBuilder builder = Response. status ( Status. FORBIDDEN ) ; builder.type("application/xml"); builder.entity("User with id:" + user.getUserId() + " already exists") ; thrownew WebApplicationException(builder.build()); } else { UserDAO. addUser (user); return Response. ok (user).build(); } } public Response deleteUser(String userId) { User userObj = (User) UserDAO. searchUser (userId); if (userObj == null )  { ResponseBuilder builder = Response. status ( Status. FORBIDDEN ); builder.type("application/xml"); builder.entity("User with id:" + userId + " is not existed, delettion request is rejected"); thrownew WebApplicationException(builder.build()); } else { UserDAO. deleteUser (userId); return Response. ok ().build(); } } public Response updateUser(User user) { User userObj = (User) UserDAO. searchUser (user.getUserId()); if (userObj == null ) { ResponseBuilder builder = Response. status ( Status. FORBIDDEN ); builder.type("application/xml"); builder.entity("User with id:" + user.getUserId() + " is not existed, update request is rejected"); thrownew WebApplicationException(builder.build()); } else { UserDAO. updateUser (user); return Response. ok (user).build(); } } public Users getUsers(String startDate, String endDate) { List userList = new ArrayList(); ResponseBuilder builder = Response. status (Status. OK ) ; builder.type("application/xml"); try { userList = UserDAO. getUsersByRegDate (startDate, endDate); } catch (Exception e) { e.printStackTrace(); builder = Response. status (S tatus. NOT\_ACCEPTABLE ) ; builder.entity("" + "not accpertable date format for startDate or endDate"); thrownew WebApplicationException(builder.build()); } if (userList.size() < 1) { builder = Response. status (Status. NOT\_FOUND ) ; builder.entity("no user found registered between" +startDate+ " and " + endDate + ""); thrownew WebApplicationException(builder.build()); } else { Users users = new Users(); users.setUsers(userList); return users; } } D.spring集成restful webService   E. 客户端调用 1. 添加:post请求 private static void testAddUser()  { WebClient client = WebClient.create(SERVICE\_URL);   **网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。** >   E. 客户端调用 1. 添加:post请求 private static void testAddUser()  { WebClient client = WebClient.create(SERVICE\_URL); [外链图片转存中...(img-lrCeiQO0-1726060047340)] [外链图片转存中...(img-YTLLwWUN-1726060047341)] **网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。**