目录
1 定义Service
2 服务端发布Service
2.1 排除WebService中的某个方法
3 客户端访问Service
4 java2ws工具的使用
4.1 命令行使用java2ws
4.2 Maven使用java2ws
5 基于Spring的Jax-ws WebService
5.1 Service定义
5.2 服务端发布Service
5.3 客户端获取Service
6 WSDL生成Java代码
6.1 wsdl2java工具
6.2 cxf-codegen-plugin
Jax-ws是WebService的一种规范。
1 定义Service
Jax-ws的WebService定义是通过注解进行的,我们必须在其WebService类的接口上使用@WebService注解进行标记。
@WebService public interface HelloWorld { public String sayHi(String who); }
如上,我们把HelloWorld定义为一个WebService,其对应有一个sayHi操作。其对应的实现类如下:
public class HelloWorldImpl implements HelloWorld { @Override public String sayHi(String who) { return"Hi, " + who; } }
2 服务端发布Service
对于Jax-ws WebService而言,发布Service有两种方式。
第一种:
public class Server { private final static String ADDRESS = "http://localhost:8080/test/jaxws/services/HelloWorld"; public static void main(String args[]) { HelloWorld hw = new HelloWorldImpl(); Endpoint.publish(ADDRESS, hw); } }
第二种:
public class Server { private final static String ADDRESS = "http://localhost:8080/test/jaxws/services/HelloWorld"; public static void main(String args[]) { HelloWorld hw = new HelloWorldImpl(); JaxWsServerFactoryBean jwsFactory = new JaxWsServerFactoryBean(); jwsFactory.setAddress(ADDRESS); //指定WebService的发布地址 jwsFactory.setServiceClass(HelloWorld.class);//WebService对应的类型 jwsFactory.setServiceBean(hw);//WebService对应的实现对象 jwsFactory.create(); } }
发布之后我们就可以通过发布地址?wsdl查看WebService的定义了(WSDL是Web Service Description Language的简称,即网络服务描述语言)。通过在浏览器输入http://localhost:8080/test/jaxws/services/HelloWorld?wsdl我们可以看到如下内容:
This XML file does not appear to have any style information associated with it. The document tree is shown below. <wsdl:definitions xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:tns="http://jaxws.sample.cxftest.tiantian.com/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:ns1="http://schemas.xmlsoap.org/soap/http" name="HelloWorldImplService" targetNamespace="http://jaxws.sample.cxftest.tiantian.com/"> <wsdl:types> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://jaxws.sample.cxftest.tiantian.com/" elementFormDefault="unqualified" targetNamespace="http://jaxws.sample.cxftest.tiantian.com/" version="1.0"> <xs:element name="sayHi" type="tns:sayHi" /> <xs:element name="sayHiResponse" type="tns:sayHiResponse" /> <xs:complexType name="sayHi"> <xs:sequence> <xs:element minOccurs="0" name="arg0" type="xs:string" /> </xs:sequence> </xs:complexType> <xs:complexType name="sayHiResponse"> <xs:sequence> <xs:element minOccurs="0" name="return" type="xs:string" /> </xs:sequence> </xs:complexType> </xs:schema> </wsdl:types> <wsdl:message name="sayHiResponse"> <wsdl:part element="tns:sayHiResponse" name="parameters"></wsdl:part> </wsdl:message> <wsdl:message name="sayHi"> <wsdl:part element="tns:sayHi" name="parameters"></wsdl:part> </wsdl:message> <wsdl:portType name="HelloWorld"> <wsdl:operation name="sayHi"> <wsdl:input message="tns:sayHi" name="sayHi"></wsdl:input> <wsdl:output message="tns:sayHiResponse" name="sayHiResponse"></wsdl:output> </wsdl:operation> </wsdl:portType> <wsdl:binding name="HelloWorldImplServiceSoapBinding" type="tns:HelloWorld"> <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http" /> <wsdl:operation name="sayHi"> <soap:operation soapAction="" style="document" /> <wsdl:input name="sayHi"> <soap:body use="literal" /> </wsdl:input> <wsdl:output name="sayHiResponse"> <soap:body use="literal" /> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="HelloWorldImplService"> <wsdl:port binding="tns:HelloWorldImplServiceSoapBinding" name="HelloWorldImplPort"> <soap:address location="http://localhost:8080/test/jaxws/services/HelloWorld" /> </wsdl:port> </wsdl:service> </wsdl:definitions>
我们可以看到在上面我们的sayHi操作的参数who变成了arg0,这是因为接口在被编译为class文件的时候不能保存参数名,有时候这会影响可读性。如果需要参数名显示的可读性强一些的话,我们可以使用@WebParam来指定,如:
@WebService(serviceName="!@#$%^", name="123456") public interface HelloWorld { public String sayHi(@WebParam(name="who") String who); }
@WebService的serviceName可以用来指定service的名称,默认情况下如果Service是通过Endpoint.publish()方法发布的则serviceName为实现类的简单名称+Service(如HelloWorldImplService),如果是通过JaxWsServerFactoryBean的create方法发布的则为接口的简单名称+Service(如HelloWorldService)。name属性可以用来指定service对应的portName,默认情况下如果Service是通过Endpoint.publish()方法发布的则portName为实现类的简单名称+Port(如HelloWorldImplPort),如果是通过JaxWsServerFactoryBean的create方法发布的则为接口的简单名称+Port(如HelloWorldPort)。
除了@WebService、@WebParam之外,Jax-ws还为我们提供了一系列的注解,如@WebMethod、@OneWay。
@WebMethod是用来标注在WebService的方法即操作上的,通过它我们可以指定某一个操作的操作名、使用SOAP绑定时的Action名称,以及该方法是否允许发布为WebService。@WebMethod有三个属性:operationName、action和exclude。@WebMethod还是挺有用的,当你发布的WebService中有方法不希望WebService访问的时候就可以通过@WebMethod来指定将其排除在外。下面我们来介绍一下使用WebMethod排除WebService中的一个方法。
@Oneway是标注在Service接口的操作方法上的。使用@Oneway标注的方法表示它不需要等待服务端的返回,也不需要预留资源来处理服务端的返回。
2.1 排除WebService中的某个方法
首先我们往我们的HelloWorld接口中新增一个方法sayHello。
@WebService public interface HelloWorld { public String sayHi(@WebParam(name="who") String who); public String sayHello(@WebParam(name="who") String who); }
对于有接口的WebService而言,@WebMethod的exclude定义必须指定在其实现类对应的需要排除的方法上,而其他属性则必须在接口方法上定义。所以我们的实现类定义如下:
public class HelloWorldImpl implements HelloWorld { @Override public String sayHi(String who) { return"Hi, " + who; } @Override @WebMethod(exclude=true) public String sayHello(String who) { return"Hello, " + who; } }
这样,在服务发布时就会把sayHello方法排除在外。有兴趣的朋友可以通过查看指定exclude前后的wsdl文件验证一下sayHello方法是否在exclude为true时被排除了。客户端在访问sayHello方法的时候也是不会成功的。
类似于WebService简单实现里面的ClientProxyFactoryBean,在使用Jax-ws时我们可以通过JaxWsProxyFactoryBean来访问服务,如:
public class Client { private final static String ADDRESS = "http://localhost:8080/test/jaxws/services/HelloWorld"; public static void main(String args[]) { JaxWsProxyFactoryBean jwpFactory = new JaxWsProxyFactoryBean(); jwpFactory.setAddress(ADDRESS); jwpFactory.setServiceClass(HelloWorld.class); HelloWorld hw = (HelloWorld)jwpFactory.create(); String response = hw.sayHi("world"); System.out.println(response); } }
除了上面的方式之外,我们还可以这样获取Service:
//第一个参数为服务发布的targetNameSpace,可以通过查看对应的wsdl文件获得,默认是发布Service所在包的包名倒过来的形式;第二个参数是serviceName private final static QName SERVICE_NAME = new QName("http://jaxws.sample.cxftest.tiantian.com/", "HelloWorldService"); //第一个参数是服务发布的targetNameSpace,第二个参数是portName private final static QName PORT_NAME = new QName("http://jaxws.sample.cxftest.tiantian.com/", "HelloWorldPort"); //服务发布的地址 private final static String ADDRESS = "http://localhost:8080/test/jaxws/services/HelloWorld"; public static void main(String args[]) { Service service = Service.create(SERVICE_NAME); //根据portName、服务发布地址、数据绑定类型创建一个Port。 service.addPort(PORT_NAME, SOAPBinding.SOAP11HTTP_BINDING, ADDRESS);//默认是SOAP1.1Binding //获取服务 HelloWorld hw = service.getPort(HelloWorld.class); String response = hw.sayHi("world"); System.out.println(response); }
在上面的代码中我们只需要有一个Service实例,就能通过它来获取真正的WebService,所以,我们如果把上面的代码改成如下形式也是可以的。
//第一个参数为服务发布的targetNameSpace,可以通过查看对应的wsdl文件获得,默认是发布Service所在包的包名倒过来的形式;第二个参数是serviceName private final static QName SERVICE_NAME = new QName("http://jaxws.sample.cxftest.tiantian.com/", "HelloWorldService"); //第一个参数是服务发布的targetNameSpace,第二个参数是portName private final static QName PORT_NAME = new QName("http://jaxws.sample.cxftest.tiantian.com/", "HelloWorldPort"); //服务发布的地址 private final static String ADDRESS = "http://localhost:8080/test/jaxws/services/HelloWorld"; public static void main(String args[]) { Service service = Service.create(null); //根据portName、服务发布地址、数据绑定类型创建一个Port。 service.addPort(PORT_NAME, SOAPBinding.SOAP11HTTP_BINDING, ADDRESS);//默认是SOAP1.1Binding //获取服务 HelloWorld hw = service.getPort(HelloWorld.class); String response = hw.sayHi("world"); System.out.println(response); }
上面这种通过Service来获取WebService的方法是不适用前面介绍的简单WebService实现的,即不适用获取通过ServerFactoryBean发布的WebService。
4 java2ws工具的使用
Cxf为我们提供了一个java2ws工具。通过该工具我们可以根据SEI(Service Endpoint Implementation的缩写)类及其相关的类来生成WebService的服务端、客户端和wsdl文件等。SEI需要是使用了@WebService标注的Service接口或类。
4.1 命令行使用java2ws
在Cxf根目录下的bin目录下有一个java2ws工具,我们可以在命令行下使用该指令生成相应代码。Java2ws指令后面可以接很多参数,主要有:
参数名 |
作用 |
-?|-h|-help |
这三个参数都可输出java2ws指令的帮助信息 |
-wsdl |
生成wsdl文件 |
-o fileName |
指定生成的wsdl文件的名称 |
-d resourceDir |
指定资源文件存放的目录,生成的wsdl文件也会放在该目录下 |
-server |
指定生成服务端代码 |
-client |
指定生成客户端代码 |
-wrapperbean |
指定生成wrapper和fault bean |
-cp classpath |
指定java2ws搜寻SEI和相关类型类的路径 |
-t targetNameSpace |
指定targetNameSpace |
-servicename serviceName |
指定serviceName |
-verbose |
在生成代码的时候显示注释信息 |
-quiet |
在生成代码的时候不显示注释信息 |
-s sourceDir |
指定生成的java代码存放的目录 |
-classdir classdir |
指定生成的java代码编译后的class类存放的目录 |
className |
指定SEI类的名称 |
在使用java2ws指令时className是必须给定的,其他的参数都可选。java2ws将会到classpath路径下或使用-cp参数指定的classpath路径下寻找SEI类及其相关类型。
示例:
java2ws –server com.tiantian.cxftest.sample.jaxws.HelloWorld(生成服务端代码)
java2ws –wsdl –cp . com.tiantian.cxftest.sample.jaxws.HelloWorld(在当前目录下寻找HelloWorld类生成wsdl文件)
4.2 Maven使用java2ws
Cxf为java2ws工具提供了一个Maven的插件,叫cxf-java2ws-plugin。所以当我们的项目是使用Maven的时候我们可以在项目的pom.xml文件中加入Cxf提供的cxf-java2ws-plugin,这样当我们执行Maven的某个操作的时候就会触发java2ws指令生成对应的代码。如:
<plugin> <groupId>org.apache.cxf</groupId> <artifactId>cxf-java2ws-plugin</artifactId> <version>${cxf.version}</version> <executions> <execution> <id>process-classes</id> <phase>process-classes</phase> <configuration> <className>com.tiantian.cxftest.sample.jaxws.HelloWorld</className> <genWsdl>true</genWsdl> <verbose>true</verbose> </configuration> <goals> <goal>java2ws</goal> </goals> </execution> </executions> </plugin>
对于java2ws指令的参数可以通过configuration元素下的元素来指定。可以配置的参数如下:
参数名 |
作用 |
className |
指定SEI类的名称 |
classpath |
搜选SEI类等相关类的类路径,默认情况下会到当前项目的类路径下寻找 |
outputFile |
生成的wsdl文件存放的位置,默认是${project.build.directory}/generated/wsdl/${className}.wsdl |
genWsdl |
默认为true。是否生成wsdl文件。 |
genServer |
默认false。是否生成Server端代码。 |
genClient |
默认为false。是否生成Client端代码。 |
genWrapperbean |
默认为false。是否生成wrapper bean |
frontend |
表明使用的frontend。支持jaxws和simple,默认是jaxws。 |
databinding |
指定数据绑定。默认frontend为jaxws时用jaxb,simple用aegis |
serviceName |
指定serviceName |
soap12 |
指定生成的wsdl文件包含soap1.2绑定 |
targetNameSpace |
指定用来生成wsdl文件时的target namespace |
verbose |
生成代码的过程中显示注释信息 |
quiet |
在生成代码的时候不显示注释信息 |
attachWsdl |
当为true时,在对当前项目进行Maven的install操作时会把生成的wsdl文件以当前项目的groupId、artifactId和version,以type为wsdl一起安装到Maven的repository中去。默认为true |
address |
指定port的address |
使用cxf-java2ws-plugin插件生成的Java代码默认会放在项目的根目录下。
5.1 Service定义
Service定义跟之前的定义是一样的。
5.2 服务端发布Service
首先在web.xml文件中定义一个CXFServlet,用于发布和拦截WebService请求。
<!-- Jax-ws实现 --> <servlet> <display-name>jaxws-cxf</display-name> <servlet-name>jaxws-cxf</servlet-name> <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class> <load-on-startup>1</load-on-startup> <init-param> <param-name>config-location</param-name> <param-value>WEB-INF/jaxws-cxf-servlet.xml</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>jaxws-cxf</servlet-name> <url-pattern>/jaxws/services/*</url-pattern> </servlet-mapping>
接下来在我们的WebService配置文件里面定义我们的WebService发布,即CXFServlet指定的jaxws-cxf-servlet.xml文件(默认是cxf-servlet.xml文件)。这里我们定义如下:
<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"> <!-- 相当于使用Endpoint.publish()进行服务发布 --> <jaxws:endpoint address="/HelloWorld" implementorClass="com.tiantian.cxftest.sample.jaxws.HelloWorldImpl"/> <!-- 相当于使用JaxWsServerFactoryBean进行服务发布 --> <jaxws:server address="/HelloWorld2" serviceClass="com.tiantian.cxftest.sample.jaxws.HelloWorldImpl"/> <!-- JaxWsServerFactoryBean使用外部bean作为服务进行发布 --> <jaxws:server address="/HelloWorld3" serviceBean="#hw"/> <!-- 普通bean对象 --> <bean id="hw" class="com.tiantian.cxftest.sample.jaxws.HelloWorldImpl"/> <!-- JaxWsServerFactoryBean使用内部bean作为服务进行发布 --> <jaxws:server address="/HelloWorld4"> <jaxws:serviceBean> <bean class="com.tiantian.cxftest.sample.jaxws.HelloWorldImpl"/> </jaxws:serviceBean> </jaxws:server> </beans>
5.3 客户端获取Service
客户端可以直接从Spring的bean配置文件中把WebService配置为一个个普通的Spring bean对象进行使用。这主要有两种方式,第一种是使用Jaxws命名空间,第二种是使用JaxWsProxyFactoryBean。
第一种:
在定义之前需要往bean配置文件中引入Jax-ws的命名空间。这里我们在classpath下定义一个jaxws-cxf-client.xml文件,其内容如下所示:
<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"> <jaxws:client id="hw" address="http://localhost:8080/test/jaxws/services/HelloWorld" serviceClass="com.tiantian.cxftest.sample.jaxws.HelloWorld" /> <jaxws:client id="hw2" address="http://localhost:8080/test/jaxws/services/HelloWorld2" serviceClass="com.tiantian.cxftest.sample.jaxws.HelloWorld"/> <jaxws:client id="hw3" address="http://localhost:8080/test/jaxws/services/HelloWorld3" serviceClass="com.tiantian.cxftest.sample.jaxws.HelloWorld"/> <jaxws:client id="hw4" address="http://localhost:8080/test/jaxws/services/HelloWorld4" serviceClass="com.tiantian.cxftest.sample.jaxws.HelloWorld"/> </beans>
第二种:
<bean id="factoryBean" class="org.apache.cxf.jaxws.JaxWsProxyFactoryBean"> <property name="address" value="http://localhost:8080/test/jaxws/services/HelloWorld"/> <property name="serviceClass" value="com.tiantian.cxftest.sample.jaxws.HelloWorld"/> </bean> <bean id="helloWorld" factory-bean="factoryBean" factory-method="create"/>
之后我们就可以把这些定义好的WebService当做一个普通的bean对象来使用了,如:
public class SpringClient { public static void main(String args[]) { ApplicationContext context = new ClassPathXmlApplicationContext("jaxws-cxf-client.xml"); accessService(context, "hw"); accessService(context, "hw2"); accessService(context, "hw3"); accessService(context, "hw4"); accessService(context, "helloWorld"); } private static void accessService(ApplicationContext context, String beanName) { HelloWorld hw = context.getBean(beanName, HelloWorld.class); System.out.println(hw.sayHi("world")); } }
如果我们已经有了wsdl定义文件的话,我们就可以通过wsdl文件生成对应的Java代码,包括WebService的Service类定义、服务端代码、客户端代码等。这里主要介绍两种WSDL生成Java代码的方式。
6.1 wsdl2java工具
wsdl2java是CXF自带的工具,在CXF根目录下的bin目录下。我们可以在命令行使用这一工具。wsdl2java命令后可以接很多参数,主要有:
参数 |
作用 |
-?|-h|-help |
这三个参数都可以查看wsdl2java指令的帮助信息,可以查看wsdl2java可以带哪些参数 |
-p packageName |
指定生成的java类使用的包名称,如未指定将根据wsdl文件里面的targetNameSpace来决定。 |
-d dir |
生成的Java文件的存放在dir目录 |
-compile |
编译生成的Java文件 |
-classdir dir |
指定编译生成的文件存放在dir目录下 |
-server |
生成WebService的服务端发布代码 |
-client |
生成WebService的客户端访问代码 |
-impl |
生成Service类的实现类代码,即上面的HelloWorldImpl |
-all |
生成所有可以生成的代码 |
wsdlurl |
Wsdl文件的访问路径,可以是本地file,也可以是web上的请求。 |
如:wsdl2java –all http://localhost:8080/test/services/HelloWorld?wsdl
wsdl2java在生成Service实现类的时候只会生成基本的代码结构,至于里面的操作的具体逻辑还需要我们自己来实现。
6.2 cxf-codegen-plugin
cxf-codegen-plugin是cxf针对于maven的一个插件。当我们的项目是基于Maven的项目时,我们可以在pom.xml文件中引入cxf-codegen-plugin,如:
<plugin> <groupId>org.apache.cxf</groupId> <artifactId>cxf-codegen-plugin</artifactId> <version>2.7.6</version> <executions> <execution> <id>generate-sources</id> <phase>generate-sources</phase> <goals> <goal>wsdl2java</goal> </goals> <configuration> <sourceRoot>${project.build.directory}/generated-sources/cxf</sourceRoot> <wsdlOptions> <wsdlOption> <wsdl>${basedir}/src/main/resources/HelloWorld.wsdl</wsdl> </wsdlOption> </wsdlOptions> </configuration> </execution> </executions> </plugin>
在上面例子中,当我们执行mvn generate-sources时就会运行wsdl2java这个指令。其配置信息是通过configuration元素来指定的。通过sourceRoot可以指定生成的Java代码的存放位置,上面我们指定了生成代码的存放位置为target目录下的generated-sources/cxf目录,该目录也是在没有指定sourceRoot时,cxf-codegen-plugin存放生成的Java代码的默认位置。每个wsdlOption元素对应于一个用来生成代码的WSDL定义。wsdl元素用于指定wsdl文件的存放位置。wsdl2java指令的其他参数可以通过wsdlOption元素下的extraargs元素来指定。如:
<plugin> <groupId>org.apache.cxf</groupId> <artifactId>cxf-codegen-plugin</artifactId> <version>2.7.6</version> <executions> <execution> <id>generate-sources</id> <phase>generate-sources</phase> <goals> <goal>wsdl2java</goal> </goals> <configuration> <wsdlOptions> <wsdlOption> <wsdl>${basedir}/src/main/resources/HelloWorld.wsdl</wsdl> <extraargs> <extraarg>-impl</extraarg> <extraarg>-server</extraarg> </extraargs> </wsdlOption> </wsdlOptions> </configuration> </execution> </executions> </plugin>
每一个extraarg元素代表一个参数,如果使用extraarg元素指定wsdl2java参数后面还带有参数值时,参数值也用一个extraarg来表示。如我们需要指定生成代码的包名时,我们的cxf-codegen-plugin应该这样声明:
<plugin> <groupId>org.apache.cxf</groupId> <artifactId>cxf-codegen-plugin</artifactId> <version>2.7.6</version> <executions> <execution> <id>generate-sources</id> <phase>generate-sources</phase> <goals> <goal>wsdl2java</goal> </goals> <configuration> <wsdlOptions> <wsdlOption> <wsdl>${basedir}/src/main/resources/HelloWorld.wsdl</wsdl> <extraargs> <extraarg>-impl</extraarg> <extraarg>-server</extraarg> <extraarg>-p</extraarg><!-- 指定包名,后面紧跟着的extraarg为对应的值 --> <extraarg>com.tiantian</extraarg> </extraargs> </wsdlOption> </wsdlOptions> </configuration> </execution> </executions> </plugin>
使用serviceName元素指定要生成Java代码的service
通过serviceName元素我们可以指定要针对当前wsdl文件里面的哪个service定义来生成文件。如:
<configuration> <wsdlOptions> <wsdlOption> <wsdl>${basedir}/src/main/resources/HelloWorld.wsdl</wsdl> <!-- 指定要生成代码的service名称 --> <serviceName>HelloWorldImplService</serviceName> </wsdlOption> </wsdlOptions> </configuration>
使用wsdlRoot来指定wsdl文件存放的目录
我们知道在使用cxf-codegen-plugin的时候一个wsdlOption元素代表要生成的一个wsdl定义,当我们有多个wsdl文件时就需要定义多个wsdlOption,如:
<configuration> <wsdlOptions> <wsdlOption> <wsdl>${basedir}/src/main/resources/wsdl/HelloWorld.wsdl</wsdl> </wsdlOption> <wsdlOption> <wsdl>${basedir}/src/main/resources/wsdl/HelloWorld2.wsdl</wsdl> </wsdlOption> </wsdlOptions> </configuration>
当我们的wsdl文件少的时候这样做还可以,但是当wsdl文件比较多的时候这样做就有点麻烦了。这个时候我们可以通过wsdlRoot元素来指定我们的wsdl文件存放的目录,cxf-codegen-plugin在扫描的时候只会扫描wsdlRoot指定的目录,而不会扫描其子目录。光指定了wsdlRoot还不能起作用,wsdlRoot必须和includes元素或者excludes元素配合使用。includes元素表示要包含哪些文件,而excludes元素表示要排除哪些文件。所以当我们要使用wsdl2java指定对wsdlRoot下的所有文件生成java代码时,我们可以这样做:
<configuration> <wsdlRoot>${basedir}/src/main/resources/wsdl</wsdlRoot> <includes> <include>*.wsdl</include> </includes> </configuration>
或者这样做:
<configuration> <wsdlRoot>${basedir}/src/main/resources/wsdl</wsdlRoot> <excludes> <exclude>null</exclude> </excludes> </configuration>
使用defaultOptions来指定公共的选项
当我们使用wsdlRoot元素来指定wsdl文件存放目录时,我们就不能再指定wsdl2java指令执行时的可选参数了。这个时候我们可以通过defaultOptions元素来指定。defaultOptions元素下指定的选项对所有的wsdlOption元素都会产生作用。如:
<configuration> <defaultOptions> <extraargs> <extraarg>-all</extraarg> </extraargs> </defaultOptions> <wsdlRoot>${basedir}/src/main/resources/wsdl</wsdlRoot> <includes> <include>helloWorld.wsdl</include> </includes> </configuration>
相关推荐
基于jax-ws 实现的web service client和server端的demo程序。 注:如果使用的是 myeclipse 时 server 部署到tomcat 启动的时候会报错 解决办法:找到myeclipse安装目录下的 plugins 目录里 查找 webservices-rt.jar,...
在这个"jax-ws webservice简单demo"中,我们将探讨JAX-WS的基础知识、如何创建一个简单的Web服务以及如何测试这个服务。 首先,JAX-WS的核心组件包括: 1. **Service端点接口(SEI, Service Endpoint Interface)**...
**Java API for XML Web ...在"HelloServer"这个示例中,我们可以看到一个基本的JAX-WS服务端实现,它演示了如何发布一个简单的"Hello, World"服务。通过学习和实践,你将能够构建更复杂、功能丰富的Web服务应用。
通过这个"jax-ws WebService客户端与服务端工程",你可以实践创建一个简单的JAX-WS服务,了解服务端的部署,以及客户端如何通过WSDL找到服务并进行调用。同时,还可以学习到JAXB在数据转换中的作用,以及如何处理Web...
JAX-WS提供了一种简单的方式来创建SOAP(Simple Object Access Protocol)Web服务,它集成了Java SE和Java EE平台,使得开发者可以方便地实现服务接口和服务实现,然后通过工具自动生成WSDL(Web Service ...
这些JAR文件包含了JAX-WS的运行时库和相关的服务实现。描述中提到的"Jax-ws所需要的JAR包"很可能包括了以下几个关键组件: 1. **jaxws-api.jar**:这是JAX-WS的API规范JAR,包含了用于开发JAX-WS服务和客户端的接口...
Java 基于第三方插件实现WebService实在麻烦,尤其是要添加几十M的Jar包...还好,自从JDK 1.6开始,Java自身已经支持WebSeervice的开发即JAX-WS,附件是一个简单的示例,供入门参考。注意,JDK环境要求1.6及以上版本。
`jaxws-ri`是JAX-WS参考实现的源代码包,包含JAX-WS API的实现以及相关的工具,如`wsimport`,用于从WSDL生成客户端代码。开发者可以使用这个库来快速开发和测试JAX-WS Web服务。 **7. JAX-WS与JAX-RS比较** JAX-...
通过定义服务接口,实现服务逻辑,以及使用`Endpoint.publish()`发布服务,我们可以轻松地创建一个基于JAX-WS的Web服务。同时,利用`wsimport`工具生成客户端代码,可以方便地进行服务调用。在"jax-ws-server"和"jax...
3. **JAX-WS的实现方式** - **注解驱动**:通过在SEI类和方法上使用注解(如`@WebService`、`@WebMethod`等),可以直接在编译时生成服务代理和部署描述符。 - **基于XML的配置**:对于更复杂的场景,可以通过XML...
JAX-WS允许开发者以面向对象的方式构建Web服务,简化了Web服务开发过程,使得Java程序员可以更加便捷地实现服务接口和服务实现。 在给定的压缩包文件"jax-ws api jar包"中,包含的是JAX-WS 2.2.1版本的API库,即`...
欢迎下载JAX-WS实现WebService.zip。本压缩文件介绍了如何使用JAX-WS技术实现WebService 参考博客:http://blog.csdn.net/gaohuanjie/article/details/50523517
JAX-WS 2.0 API通常由Java EE服务器提供实现,例如Sun的Metro或Apache CXF。`jaxws-2_0-pfd-spec-api.jar`可能包含了JAX-WS 2.0规范的API类库,供开发者在应用中导入并使用。在实际开发中,还需要相应的实现库,如`...
jax-ws允许开发人员通过简单的编程模型来实现基于SOAP的Web服务,从而简化了Web服务的开发流程。 在MyEclipse环境中创建jax-ws Web服务的过程主要包括以下几个步骤: 1. **创建Web服务接口**:首先,你需要定义一...
总结来说,JAX-WS通过简单的Java编程模型实现了Web服务的发布和调用,极大地简化了Web服务的开发流程。通过定义接口、实现服务、部署服务和生成客户端存根,开发者可以快速地构建基于SOAP的Web服务系统。在实际项目...
在"浔阳江上 - BlogJava.htm"和"MyEclipse6_5上基于JAX-WS开发Webservice(中文示例) - 浔阳江上 - BlogJava_files"这两个文件中,可能包含了作者在BlogJava网站上分享的具体步骤和示例代码,帮助读者更好地理解和...
在这个“webservice Demo注解+jax-ws”示例中,我们将深入探讨Web服务的注解使用以及基于Java API for XML Web Services (JAX-WS)的实现。 首先,让我们了解一下JAX-WS。它是Java平台的标准组件,用于创建和处理Web...
### JAX-WS WebService简明教程知识点梳理 #### 一、JAX-WS概述与特点 ##### 1.1 JAX-WS简介 - **定义**:JAX-WS (Java API for XML-Based Web Services) 是一种用于构建基于XML的Web服务的标准API。 - **历史**:...
这个压缩包可能包含了JAX-WS实现的核心库和其他相关组件。 **描述中的文件列表:** 1. **webservices-api.jar** - 这个JAR文件包含了JAX-WS的API接口定义,它定义了开发者用来创建和消费Web服务的类和接口。这些...
【标题】"metro-jax-ws-jaxws221x.zip" 提供的是一个关于JAX-WS(Java API for XML Web Services)的开发示例,其中包含了JAX-WS 2.2.1版本的相关组件和库文件。这个压缩包是针对Java开发者设计的,用于帮助他们理解...