apache-cxf-3.0.4和spring实现rest服务

1、新建动态web项目CXFRestService，结构如下：

2、引入jar包如下：

aopalliance-1.0.jar
commons-logging-1.1.3.jar
cxf-core-3.0.4.jar
cxf-rt-frontend-jaxrs-3.0.4.jar
cxf-rt-rs-client-3.0.4.jar
cxf-rt-rs-extension-providers-3.0.4.jar
cxf-rt-rs-extension-search-3.0.4.jar
cxf-rt-rs-security-cors-3.0.4.jar
cxf-rt-rs-security-jose-3.0.4.jar
cxf-rt-rs-security-oauth-3.0.4.jar
cxf-rt-rs-security-oauth2-3.0.4.jar
cxf-rt-rs-security-sso-saml-3.0.4.jar
cxf-rt-rs-security-xml-3.0.4.jar
cxf-rt-rs-service-description-3.0.4.jar
cxf-rt-transports-http-3.0.4.jar
javax.ws.rs-api-2.0.1.jar
jaxb-api-2.2.11.jar
jaxb-core-2.2.11.jar
jaxb-impl-2.2.11.jar
jcl-over-slf4j-1.7.9.jar
jettison-1.3.7.jar
log4j-1.2.13.jar
slf4j-api-1.7.9.jar
slf4j-jdk14-1.7.9.jar
spring-aop-3.2.6.RELEASE.jar
spring-beans-3.2.6.RELEASE.jar
spring-context-3.2.6.RELEASE.jar
spring-core-3.2.6.RELEASE.jar
spring-expression-3.2.6.RELEASE.jar
spring-web-3.2.6.RELEASE.jar
stax2-api-3.1.4.jar
woodstox-core-asl-4.4.1.jar
wsdl4j-1.6.3.jar
xmlschema-core-2.2.1.jar

同样参考WHICH_JARS中要点：

For JAX-RS support:
- abdera*  (optional: for AtomPub support, but also needed for the 
            Management log browser console)
- commons-codec.jar (Needed for Abdera)
- jaxen.jar (Needed for Abdera)
- axiom* (Needed for Abdera)
- javax.ws.rs-api.jar
- jettison.jar (Needed for JSON services only)
- oauth*.jar (Needed for OAuth support)
- cxf-rt-frontend-jaxrs.jar
- cxf-rt-rs-*.jar as needed

但实际执行时发现还是需要cxf-rt-transports-http-3.0.4.jar，不然会提示cxf-servlet.xml找不到。

3、配置文件

web.xml和log4j.properties还是一样没有变化，来看applicationContext-server.xml

<?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:jaxrs="http://cxf.apache.org/jaxrs"
	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
    http://cxf.apache.org/jaxrs
    http://cxf.apache.org/schemas/jaxrs.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" />

	<bean id="userRestServiceBean" class="com.java.service.impl.UserRestServiceImpl" />
	<!-- 这里的地址很重要，客户端需要通过这个地址来访问WebService -->
	<jaxrs:server id="restServiceContainer" address="/rest">
		<jaxrs:serviceBeans>
			<ref bean="userRestServiceBean" />
		</jaxrs:serviceBeans>
		<jaxrs:extensionMappings>
			<entry key="json" value="application/json" />
			<entry key="xml" value="application/xml" />
		</jaxrs:extensionMappings>
		<jaxrs:languageMappings>
			<entry key="en" value="en-gb" />
		</jaxrs:languageMappings>
	</jaxrs:server>
</beans>  

主要注意beans的引用和jaxrs:server定义。

4、实体和服务定义

User.java

import java.io.Serializable;

import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement(name = "UserInfo")
public class User implements Serializable {
	private static final long serialVersionUID = 677484458789332877L;
	private int id;
	private String name;
	private String email;
	private String address;

	@Override
	public String toString() {
		return this.id + "#" + this.name + "#" + this.email + "#"
				+ this.address;
	}

	// getter/setter
	public int getId() {
		return id;
	}

	public void setId(int id) {
		this.id = id;
	}

	public String getName() {
		return name;
	}

	public void setName(String name) {
		this.name = name;
	}

	public String getEmail() {
		return email;
	}

	public void setEmail(String email) {
		this.email = email;
	}

	public String getAddress() {
		return address;
	}

	public void setAddress(String address) {
		this.address = address;
	}
}

IUserRestService.java

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.java.entity.User;

@Path(value = "/rest/")
public interface IUserRestService {
	@GET
    @Path("/user/{id}")
    @Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
    public User getUser(@PathParam("id") int id);
}

UserRestServiceImpl.java

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.java.entity.User;
import com.java.service.IUserRestService;

@Path(value = "/user/")
public class UserRestServiceImpl implements IUserRestService {
	@GET
	@Path("/user/{id}")
    @Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
    public User getUser(@PathParam("id") int id) {
        User user = new User();
        user.setId(id);
        user.setName("test_name");
        return user;
    }
}

5、运行、测试

在tomcat中运行，

地址栏输入http://localhost:8080/CXFRestService/rest/user/user/123，执行结果如下：

<UserInfo>
<id>123</id>
<name>test_name</name>
</UserInfo>

这就是最简单的GET服务了，返回指定ID的用户信息，其他更详细的用法可以参考之前转载的文。