`
cxshun
  • 浏览: 720101 次
  • 性别: Icon_minigender_1
  • 来自: 广州
社区版块
存档分类
最新评论

JAVA webservice之CXF

 
阅读更多

昨天我们一起学习了一下xfire,今天我们来看一下CXF,为什么学完那个接着学这个呢。因为CXF是在xfire的基础上实现

的,所以我们学习它会比较简单点,毕竟我们昨天刚看过了xfire的实现方法。废话少说,直接来例子。

1)首先呢,还是包的问题,在http://cxf.apache.org/download.html这里可以下到最新版的CXF,当然,我用的是最新版的。接下来还是那句废话,建WEB项目,放入JAR包。而JAR包我们就不选择了,一堆全部放入。

我们会看到它包含了spring的JAR包,后面当我们需要把CXF作为WEB项目部署时,就需要用到spring的配置文件,这个后面再讲。

还是接口类和实现类:

@WebService
public interface IReaderService {
	public Reader getReader(@WebParam(name="name") String name,@WebParam(name="password") String password);
	public List<Reader> getReaders();
}
@WebService(endpointInterface="com.cxf.servlet.IReaderService",serviceName="readerService")
public class ReaderService implements IReaderService{
	public Reader getReader(@WebParam(name="name") String name,@WebParam(name="password") String password) {
		return new Reader(name,password);
	}
	
	public List<Reader> getReaders(){
		List<Reader> readerList = new ArrayList<Reader>();
		readerList.add(new Reader("shun1","123"));
		readerList.add(new Reader("shun2","123"));
		return readerList;
	}
}

 这两个类除了加入注解外,其他均和昨天讲的webservice的一样。这里就不多讲了,对注解的解释,大家可以看看JAVAEE的文档。不过按意思应该很容易理解的。

接下来就是JAVABEAN,还是那个Reader类:

public class Reader{
	private static final long serialVersionUID = 1L;
	private String name;
	private String password;
	
	public Reader(){}
	public Reader(String name,String password) {
		this.name = name;
		this.password = password;
	}
	//Get/Set方法省略
	public String toString(){
		return "Name:"+name+",Password:"+password;
	}
	
}

 上面的已经写完了。

2)我们要用做WEB项目吗?不急,先不用,CXF自带了一个轻量的容器服务,相当于spring自己提供了IOC容器一样。我们可以先用它来测试一下我们部署成功没。

直接来一个测试类:

public static void main(String[] args) {
		System.out.println("Server is starting...");
		ReaderService readerService = new ReaderService();
		Endpoint.publish("http://localhost:8080/readerService",readerService);
		System.out.println("Server is started...");
	}

 简单得不得了吧。直接publish地址,然后指定接口或类就OK了。我这里用的是类,但尽量用接口,毕竟面向接口编程才是真正的面对对象思想。

我们启动看看结果:

 我们看到启动已经完成,接着启动浏览器看看是否成功了。

直接在浏览器输入http://localhost:8080/readerService?wsdl,我们可以看到:

 它生成了我们所需要的wsdl文件,说明我们部署成功了。

3)部署成功后,我们就是要调用啦,它的调用也相当简单,跟xfire类似,取得接口,然后就可以跟本地类一样调用方法了。

public static void main(String[] args) {
		JaxWsProxyFactoryBean factoryBean = new JaxWsProxyFactoryBean();
		factoryBean.setServiceClass(IReaderService.class);
		factoryBean.setAddress("http://localhost:8080/readerService");
		
		IReaderService readerService = (IReaderService)factoryBean.create();
		Reader reader = readerService.getReader("shun","123");
		System.out.println("Reader:"+reader);
	}

 这里很简单,也是取得一个工厂类,然后直接设接口和地址再create就可以得取相应的接口了,这里跟xfire一样,也是需要调用端先定义好接口原型,否则这些调用将无从说起。

我们运行得到结果:

 没问题,跟我们预想的结果一致。

 

4)但很多情况下,我们并不希望我们的webservice和我们的应用分开两个服务器,而希望他们在同一个容器,tomcat或JBOSS或其他的,这样我们就必须通过WEB来部署我们前面完成的webservice。

注意,我们这里需要用到spring定义文件。

首先看看web.xml:

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
	id="WebApp_ID" version="3.0">
	
	<context-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>WEB-INF/beans.xml</param-value>
	</context-param>
	
	<listener>
		<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
	</listener>
	
	<servlet>
		<servlet-name>CXFServlet</servlet-name>
		<servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
	</servlet>
	<servlet-mapping>
		<servlet-name>CXFServlet</servlet-name>
		<url-pattern>/webservice/*</url-pattern>
	</servlet-mapping>
</web-app>

 这里很简单,只是指定了spring的监听器和相应的配置文件路径,并且指定了CXF的拦截方式。

接下来看看beans.xml:

<?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:jaxws="http://cxf.apache.org/jaxws"
    xsi:schemaLocation="
	    http://www.springframework.org/schema/beans
	    http://www.springframework.org/schema/beans/spring-beans.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:endpoint id="readerServicce2"
        implementor="com.cxf.servlet.ReaderService" address="/readerService2" />
</beans>

 这里很简单,只是通过jaxws:endpoint定义了一个webservice,implementor是webservice的处理类,而address是它的访问路径,跟我们前面写的readerService类似。

这时我们可以把它部署到tomcat中,通过http://localhost:8080/CXFWebservice/webservice/readerService2?wsdl可以直接访问。

 

有些朋友会问,为什么这次访问的URL跟前面的不一样呢。其实前面的访问地址是我们自己定义的,而这里的webservice地址是我们在配置文件中配置好的,并且是通过web项目来部署的,这里就需要用项目名称,而且我们在CXFServlet那里配置了url-pattern是webservice,所以最后的URL就跟上面一致了。

我们可以看到效果:

 这证明我们部署成功了。

 

可以再次用前面的测试类测试一下,注意,需要把address修改成我们发布后的URL。

CXF相比xfire又更简洁了一些,虽然它增加了一些注解,但这些无伤大雅,它只是把以前的services.xml中的信息集中到类中,反而更方便维护,但这还是见仁见智的,有些人就喜欢配置文件,而有些人就不喜欢。另外CXF的调用方式更加简洁,比起xfire它的代码量更小了,是一个较大的进步。

 

有些朋友在搭建的过程中出现了一些问题,免去一个个回复了,这里放出代码,有需要的朋友可以下载看看。

lib目录下的所有包均没有放入,把cxf的所有包放入即可。

注:所用IDE为idea,文件结构跟eclipse不通用,如果需要在eclipse下使用的,可以直接复制代码和文件到eclipse新建的项目即可。

 

  • 大小: 19.6 KB
  • 大小: 40.4 KB
  • 大小: 8.7 KB
  • 大小: 37.6 KB
21
1
分享到:
评论
22 楼 wangyudong 2017-11-27  
由CXF实现的微服务需要有比较好的工具去测试RESTful API,很多REST Client是不支持自动化测试RESTful API,也不支持自动生成API文档.
之前习惯用一款名字为 WisdomTool REST Client,支持自动化测试RESTful API,输出精美的测试报告,并且自动生成精美的RESTful API文档。
轻量级的工具,功能却很精悍哦!

https://github.com/wisdomtool/rest-client

Most of REST Client tools do not support automated testing.

Once used a tool called WisdomTool REST Client supports automated testing, output exquisite report, and automatically generating RESTful API document.

Lightweight tool with very powerful features!

https://github.com/wisdomtool/rest-client
21 楼 CmdSmith 2017-01-13  
楼主写的很好强大,按楼主写的我也搞通了,就是如果service和client不在一个项目里这个怎么调用呢?
20 楼 jiayin315578188 2016-04-29  
Craycha 写道
为什么我的new Reader说的是Cannot instantiate the type Reader??


看看是不是引用了错误的Reader类。
19 楼 Craycha 2016-04-13  
为什么我的new Reader说的是Cannot instantiate the type Reader??
18 楼 cxshun 2015-06-05  
kkrgwbj 写道
为什么调用方法成功了但是参数都是null Reader类中已经添加了set/get方法

看一下参数名大小写有没有一些,检查一下是否漏了@WebParam这个注解。
17 楼 cxshun 2015-06-05  
springmvc-freemarker 写道
如何在java Web项目中开发WebService接口
http://www.zuidaima.com/question/1925428495420416.htm


文章里面有个不错的回答,但可惜我这里用的是CXF,你贴的文章对想学习CXF的朋友来说,用处不算太大。但如果是没有限定技术类型,这倒是一个很简单的做法。
16 楼 springmvc-freemarker 2015-05-28  
如何在java Web项目中开发WebService接口
http://www.zuidaima.com/question/1925428495420416.htm
15 楼 kkrgwbj 2015-03-09  
为什么调用方法成功了但是参数都是null Reader类中已经添加了set/get方法
14 楼 abcsjun 2014-03-29  
abcsjun 写道
Server is started 可是为何还是出错?
2014-3-29 18:38:53 org.apache.cxf.interceptor.AttachmentInInterceptor handleMessage
信息: AttachmentInInterceptor skipped in HTTP GET method
2014-3-29 18:38:53 org.apache.cxf.interceptor.StaxInInterceptor handleMessage
信息: StaxInInterceptor skipped.


这个已经好了,现在有出现这个问题,LZ,帮忙看下
严重: Allocate exception for servlet CXFServlet
org.springframework.beans.factory.NoSuchBeanDefinitionException: No bean named 'cxf' is defined
at org.springframework.beans.factory.support.DefaultListableBeanFactory.getBeanDefinition(DefaultListableBeanFactory.java:529)
at org.springframework.beans.factory.support.AbstractBeanFactory.getMergedLocalBeanDefinition(AbstractBeanFactory.java:1094)
at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:276)
at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:196)
at org.springframework.context.support.AbstractApplicationContext.getBean(AbstractApplicationContext.java:1079)
at org.apache.cxf.transport.servlet.CXFServlet.loadBus(CXFServlet.java:77)
at org.apache.cxf.transport.servlet.CXFNonSpringServlet.init(CXFNonSpringServlet.java:71)
at org.apache.catalina.core.StandardWrapper.loadServlet(StandardWrapper.java:1206)
at org.apache.catalina.core.StandardWrapper.allocate(StandardWrapper.java:827)
at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:129)
at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:191)
at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:127)
at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:103)
at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:109)
at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:293)
at org.apache.coyote.http11.Http11Processor.process(Http11Processor.java:861)
at org.apache.coyote.http11.Http11Protocol$Http11ConnectionHandler.process(Http11Protocol.java:606)
at org.apache.tomcat.util.net.JIoEndpoint$Worker.run(JIoEndpoint.java:489)
at java.lang.Thread.run(Unknown Source)
13 楼 abcsjun 2014-03-29  
Server is started 可是为何还是出错?

2014-3-29 18:38:53 org.apache.cxf.interceptor.AttachmentInInterceptor handleMessage
信息: AttachmentInInterceptor skipped in HTTP GET method
2014-3-29 18:38:53 org.apache.cxf.interceptor.StaxInInterceptor handleMessage
信息: StaxInInterceptor skipped.
2014-3-29 18:38:53 org.apache.cxf.binding.soap.interceptor.ReadHeadersInterceptor handleMessage
信息: ReadHeadersInterceptor skipped in HTTP GET method
2014-3-29 18:38:53 org.apache.cxf.phase.PhaseInterceptorChain doIntercept
信息: Interceptor has thrown exception, unwinding now
org.apache.cxf.interceptor.Fault: No such operation:
at org.apache.cxf.interceptor.URIMappingInterceptor.handleMessage(URIMappingInterceptor.java:77)
at org.apache.cxf.phase.PhaseInterceptorChain.doIntercept(PhaseInterceptorChain.java:220)
at org.apache.cxf.transport.ChainInitiationObserver.onMessage(ChainInitiationObserver.java:77)
at org.apache.cxf.transport.http_jetty.JettyHTTPDestination.serviceRequest(JettyHTTPDestination.java:278)
at org.apache.cxf.transport.http_jetty.JettyHTTPDestination.doService(JettyHTTPDestination.java:252)
at org.apache.cxf.transport.http_jetty.JettyHTTPHandler.handle(JettyHTTPHandler.java:62)
at org.mortbay.jetty.handler.ContextHandler.handle(ContextHandler.java:726)
at org.mortbay.jetty.handler.ContextHandlerCollection.handle(ContextHandlerCollection.java:206)
at org.mortbay.jetty.handler.HandlerWrapper.handle(HandlerWrapper.java:152)
at org.mortbay.jetty.Server.handle(Server.java:324)
at org.mortbay.jetty.HttpConnection.handleRequest(HttpConnection.java:505)
at org.mortbay.jetty.HttpConnection$RequestHandler.headerComplete(HttpConnection.java:828)
at org.mortbay.jetty.HttpParser.parseNext(HttpParser.java:514)
at org.mortbay.jetty.HttpParser.parseAvailable(HttpParser.java:211)
at org.mortbay.jetty.HttpConnection.handle(HttpConnection.java:380)
at org.mortbay.io.nio.SelectChannelEndPoint.run(SelectChannelEndPoint.java:395)
at org.mortbay.thread.BoundedThreadPool$PoolThread.run(BoundedThreadPool.java:450)
12 楼 cxshun 2014-03-07  
xueshuanglong 写道
Server is starting...
三月 06, 2014 3:55:28 下午 org.apache.cxf.jaxws.EndpointUtils isValidImplementor
信息: Implementor is not annotated with WebService annotation.
Exception in thread "main" javax.xml.ws.WebServiceException: Cannot create Endpoint for implementor that does not have a WebService annotation and does not implement the Provider interface
at org.apache.cxf.jaxws.spi.ProviderImpl.createEndpoint(ProviderImpl.java:135)
at org.apache.cxf.jaxws.spi.ProviderImpl.createAndPublishEndpoint(ProviderImpl.java:154)
at javax.xml.ws.Endpoint.publish(Endpoint.java:240)
at com.rock.cxf.TestMain.main(TestMain.java:30)


为什么我运行是这样,有没整个例子呢?



这个看样子是你没有使用@WebService这个annotation,我回去弄一下下载出来。
11 楼 xueshuanglong 2014-03-06  
Server is starting...
三月 06, 2014 3:55:28 下午 org.apache.cxf.jaxws.EndpointUtils isValidImplementor
信息: Implementor is not annotated with WebService annotation.
Exception in thread "main" javax.xml.ws.WebServiceException: Cannot create Endpoint for implementor that does not have a WebService annotation and does not implement the Provider interface
at org.apache.cxf.jaxws.spi.ProviderImpl.createEndpoint(ProviderImpl.java:135)
at org.apache.cxf.jaxws.spi.ProviderImpl.createAndPublishEndpoint(ProviderImpl.java:154)
at javax.xml.ws.Endpoint.publish(Endpoint.java:240)
at com.rock.cxf.TestMain.main(TestMain.java:30)


为什么我运行是这样,有没整个例子呢?
10 楼 zjb_0308 2014-02-11  
打印是空的哥们儿,人家上面不写了吗?缺少set/get方法在Reader 类里.文章写的很好,小弟佩服
9 楼 itabclichao 2014-01-16  
强大,一切正常,几经波折
8 楼 a331251021 2013-12-05  
a331251021 写道
写的很好。。不过这鬼东西貌似有缓存的问题。

把工程clean就可以了。。。
7 楼 a331251021 2013-12-05  
写的很好。。不过这鬼东西貌似有缓存的问题。
6 楼 wjp227 2013-09-04  
aishu 写道
为什么我的,打印对象的时候,怎么全是空啊?
hubowei1 写道
Reader reader = readerService.getReader("shun","123");  
System.out.println("Reader:"+reader);  

我怎么打印出来的结果是:

Reader:Name:null,Password:null


在Reader bean中缺少了name和password的get、set方法,加上去就好了。
5 楼 juning5418 2013-05-10  
juning5418 写道
public Reader getReader(@WebParam(name="name") String name,@WebParam(name="password")

改成
public Reader getReader(@WebParam(name="names") String name,@WebParam(name="passwords")


最后测试地址 应该是这个

factoryBean.setAddress("http://localhost:8080/CfxTest/webservice/readerService2");
4 楼 juning5418 2013-05-10  
public Reader getReader(@WebParam(name="name") String name,@WebParam(name="password")

改成
public Reader getReader(@WebParam(name="names") String name,@WebParam(name="passwords")
3 楼 cxshun 2013-01-31  
hubowei1 写道
Reader reader = readerService.getReader("shun","123");  
System.out.println("Reader:"+reader);  

我怎么打印出来的结果是:

Reader:Name:null,Password:null

你检查一下你的webservice相关的annotation有没有注解正确,最重要的是@WebParam和@Webservice。

相关推荐

Global site tag (gtag.js) - Google Analytics