CXF建立webservice客戶端和服務端
一、CXF的介紹
Apache CXF是一個開源的WebService框架,CXF大大簡化了Webservice的建立,同時它繼承了XFire的傳統,一樣可以和spring天然的進行無縫的整合。CXF框架是一種基於servlet技術的SOA應用開發框架,要正常運用基於CXF應用框架開發的企業應用,除了CXF應用本身之外,還需要JDK和servlet容器的支援。
二、CXF的準備條件
所需要的jar包:
xmlbeans-2.4.0.jar
wss4j-1.5.9.jar
jetty-server-7.1.6.v20100715.jar
jetty-util-7.1.6.v20100715.jar
geronimo-ws-metadata_2.0_spec-1.1.3.jar
geronimo-activation_1.1_spec-1.1.jar
geronimo-servlet_3.0_spec-1.0.jar
velocity-1.6.4.jar
jaxb-xjc-2.2.1.1.jar
xml-resolver-1.2.jar
wsdl4j-1.6.2.jar
cxf-2.3.0.jar
XmlSchema-1.4.7.jar
jaxb-api-2.2.1.jar
jaxb-impl-2.2.1.1.jar
neethi-2.0.4.jar
geronimo-annotation_1.0_spec-1.1.1.jar
geronimo-stax-api_1.0_spec-1.0.1.jar
三、建立webservice服務端
1、先將jar包放入lib目錄
2、在web.xml中配置CXF框架的核心servlet
<!-- CXF --> <servlet> <servlet-name>CXFServlet</servlet-name> <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>CXFServlet</servlet-name> <url-pattern>/services/*</url-pattern> </servlet-mapping>
3、在applicationContext.xml中匯入xml,並且釋出webservice服務。
<?xml version="1.0" encoding="UTF-8"?>
<beans
xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:p="http://www.springframework.org/schema/p"
xmlns:tx="http://www.springframework.org/schema/tx"
xmlns:aop="http://www.springframework.org/schema/aop"
xmlns:jaxws="http://cxf.apache.org/jaxws"
xmlns:jaxrs="http://cxf.apache.org/jaxrs"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx-2.5.xsd
http://www.springframework.org/schema/aop
http://www.springframework.org/schema/aop/spring-aop-2.5.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
"
default-autowire="byName"
>
<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:endpoint id="facelookWebService" address="/facelookWebService" implementor="com.facelook.webservice.server.FacelookWebServiceImpl"></jaxws:endpoint> -->
<!-- 不知道為什麼,這裡的webservice配置,只能用bean來實現,否則 注入的service為空。但是之前有個專案卻可以,百思不得其解。。 -->
<bean id="facelookWebService" class="com.facelook.webservice.server.FacelookWebServiceImpl"/>
<jaxws:endpoint id="facelookWebService1" address="/facelookWebService" implementorClass="com.facelook.webservice.server.FacelookWebServiceImpl">
<jaxws:implementor ref="facelookWebService"/>
</jaxws:endpoint>
</beans>
4、定義webservice介面FacelookWebService 和 實現類FacelookWebServiceImpl。
@WebService
public interface FacelookWebService {
/**
* 根據傳遞的條件獲取相簿資訊
* xml的格式規範
* <?xml version=\"1.0\" encoding=\"UTF-8\"?>
* <facelook>
* <condition>
* <name></name>
* <description></description>
* <pageno></pageno>
* <pagesize></pagesize>
* </condition>
* </facelook>
* 這裡的WebParam必須指定,否則呼叫的時候返回null
* @return
*/
public String getAlbumList(@WebParam(name="xmlStr") String xmlStr);
}
@WebService
//這後面的可以不寫註釋後面的配置,在applicationContext配置也一樣(serviceName="facelookWebService",endpointInterface="com.facelook.webservice.server.FacelookWebService")
public class FacelookWebServiceImpl implements FacelookWebService{
@Autowired
private AlbumService albumService;
@Override
public String getAlbumList(String xmlStr) {
try {
List<Album> albumList = getAlbumPage(xmlStr);
JSONArray jsonArray = JSONArray.fromObject(albumList);
return jsonArray.toString();
} catch (Exception e) {
e.printStackTrace();
}
return null;
}
}
這樣子,基本上就可以了。
5、儲存程式碼,釋出專案,啟動tomact。
在位址列輸入:http://localhost:8080/house/services/houseWebService?wsdl 即可看到釋出的服務端的明細。
顯示如下:
這就表示CXF釋出的webservice服務端成功了。
6、通過客戶端呼叫服務端webservice。
axis的客戶端訪問:
public static void main(String[] args) throws ServiceException, RemoteException, MalformedURLException {
String xmlStr = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>"
+ " <facelook>"
+ " <condition>"
+ " <name>家</name>"
+ " <description></description>"
+ " <pageno></pageno>"
+ " <pagesize></pagesize>"
+ " </condition>"
+ " </facelook>";
Service service = new Service();
Call call = (Call) service.createCall();
call.setTargetEndpointAddress("http://localhost:8080/facelook/services/facelookWebService?wsdl");
QName qName = new QName("http://server.webservice.facelook.com/", "getAlbumList");
call.setOperationName(qName);
call.setUseSOAPAction(true);
//這下面兩行一定要加上,否則接收在伺服器端收不到。
call.addParameter("xmlStr", XMLType.XSD_STRING, ParameterMode.IN);
call.setReturnType(XMLType.XSD_STRING);
String result = (String) call.invoke(new Object[] { xmlStr });
System.out.println(result);
//將返回的字串轉換成list集合
//JSONArray array = JSONArray.fromObject(result);
//List<Album> list = JSONArray.toList(array,Album.class);
}
CXF客戶端訪問:
public static void main(String[] args) throws Exception {
//這個是用cxf 客戶端訪問cxf部署的webservice服務
//千萬記住,訪問cxf的webservice必須加上namespace ,否則通不過
//現在又另外一個問題,傳遞過去的引數服務端接收不到
JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
org.apache.cxf.endpoint.Client client = dcf.createClient("http://localhost:8080/facelook/services/facelookWebService?wsdl");
//url為呼叫webService的wsdl地址
QName name=new QName("http://server.webservice.facelook.com/","getAlbumList");
//namespace是名稱空間,methodName是方法名
String xmlStr = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>"
+ " <facelook>"
+ " <condition>"
+ " <name>家</name>"
+ " <description></description>"
+ " <pageno></pageno>"
+ " <pagesize></pagesize>"
+ " </condition>"
+ " </facelook>";
//paramvalue為引數值
Object[] objects=client.invoke(name,xmlStr);
//呼叫web Service//輸出呼叫結果
System.out.println(objects[0].toString());
}
在這裡面傳遞的xml規範由 服務端自己規範好了,然後去解析、獲取引數,執行相應的操作,返回想要的結果給呼叫的客戶端。。