简单的Jax-WS WebService实现

最新推荐文章于 2021-02-25 05:14:13 发布
最新推荐文章于 2021-02-25 05:14:13 发布
阅读量156 收藏
点赞数
分类专栏： Webservice 文章标签： cxf spring Maven java2ws cxf-codegen-plugin

目录

 

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方法的时候也是不会成功的。

 

3       客户端访问Service

 

类似于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       基于Spring的Jax-ws WebService

 

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"));
	}
	
}

 

6       WSDL生成Java代码

 

       如果我们已经有了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>

 

 

 

iteye_13139
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
jax-ws webservice demo
03-16
基于jax-ws 实现的web service client和server端的demo程序。 注:如果使用的是 myeclipse 时 server 部署到tomcat 启动的时候会报错 解决办法:找到myeclipse安装目录下的 plugins 目录里 查找 webservices-rt.jar，...
java2wsdl_Axis2用法：JAVA2WSDL和WSDL2JAVA
weixin_34509784的博客
02-12 556
1、Axis2简介Web Service是现在最适合实现SOA的技术，而Axis2是实现Web Service的一种技术框架。Axis2提供了较多的工具以便开发者使用，比如：java2wsdl和wsdl2java。深入使用Axis2框架前，说明下java2wsdl和wsdl2java的使用。具体解释访问：http://axis.apache.org/axis2/java/core/download...
java2wsdl cxf_cxf使用 wsdl2java
weixin_35854667的博客
02-25 378
1、需要 一个包：apache-cxf-2.6.1.gz这个包里有好多jar包，一定要下载下来。将此包解压，我是放在：E:\CXF\apache-cxf-2.6.1 2、将URL调用成功的页面内容，另存为XML 3、在cmd中通过wsdl2java生成客户端文件 cd 进入apache-cxd-2.6.1\bin目录执行命名：wsdl2java -p service.webservice.clie...
java2wsdl_Java2WSDL之java实现
weixin_35414437的博客
02-12 357
cxf java2wsdlimport org.apache.cxf.tools.java2ws.JavaToWS;public class Java2WSDL {private Class> className;public String[] args1,args2,args3;/*** 构造函数* @param args 要生成WSDL的Java类*/public Java2WSDL(C...
WSDL2Java详细使用说明【官方最全说明】
热门推荐
良心有约
12-11 1万+
WSDL to Java 命名 wsdl2java - 获取WSDL文档并生成完全带注释的Java代码，并实现相关服务。 概要 用例 : wsdl2java -fe|-frontend &lt;front-end-name&gt; -db|-databinding &lt;data-binding-name&gt; -wv &lt;wsdl-version&gt; -p &lt...
maven wsdl2java_使用maven从java生成WSDL：CXF java2ws目标
weixin_39761255的博客
02-12 499
有没有一个可理解的教程,展示了如何使用maven和cxf目标java2ws从java代码生成WSDL？我想在包含@WebService注释类的项目上执行mvn install,并在目标文件夹内的某处生成WSDL,以便其他开发人员可以使用它来生成订阅者类.此外,我希望将Webservice包含在我可以在WebService容器内部署的jar中,以便该服务可供订阅者使用.到目前为止,我的pom看起来像...
jax-ws实现webservice调用
12-29
公司代码实现，简单的webservice服务 发布，实现客户端的调用。
Jax-ws所需要的JAR包
08-28
亲测可用，Jax-ws所需要的JAR包，拷贝到tomcat安装路径的lib里，实现了webservice发布到tomcat，赞！
JAX-WS 实现WebService发布
05-27
NULL 博文链接：https://wujianjun.iteye.com/blog/531039
JAX-WS实现WebService.zip
01-15
欢迎下载JAX-WS实现WebService.zip。本压缩文件介绍了如何使用JAX-WS技术实现WebService 参考博客：http://blog.csdn.net/gaohuanjie/article/details/50523517
WebService概述（转载）
雨钓的专栏
03-05 969
WebService概述
Java开发WebService（使用Java-WS）
weixin_30894583的博客
04-16 191
前言： 初学Java，因为工作需要，直接跳到开发WebService。以前用.NET开发过WebService，对比一下，Java的WebService开发部署难度高了不止一个档次。网上的教程各式各异，刚开始我学着使用XFire开发，但是配置过程已经把我给搞糊涂了，弄了两天没搞好。 最后使用Java1.6的新特性，Java-WS专门用于开发WebService，发现这个方法特别的简单（相对而言...
java 调用ws 方式
baby_it的专栏
08-11 5798
webservice 调用方式
小程序websocket java_java与微信小程序实现websocket长连接
weixin_42664597的博客
02-13 613
本文实例为大家分享了java与微信小程序实现websocket长连接的具体代码，供大家参考，具体内容如下背景：需要在小程序实现地图固定坐标下实时查看消息java环境 :tomcat7 jdk1.71.javawebsocket 类package com.qs.util;import java.io.BufferedReader;import java.io.IOException;import j...
WebService学习——利用Eclipse生成JAX-WS WebService服务端
记录只为更好地前行
06-14 1万+
最近在学习WebService，今天尝试用Eclipse的插件生成JAX-WS WebService，结果遇到了不少的问题啊，调试了大半天终于把程序跑通了。现在把步骤和问题记录一下，也为了以后遇到相同的问题时能够及时解决。首先利用Eclipse生成WebService的服务端。 1、 创建一个web工程，DynamicWeb Project (File->New->Dynamic Web P
使用jaxws:server 还是使用jaxws:endpoint发布webservice
qq_32699999的博客
07-28 1万+
今天在学习使用spring+cxf发布webservice时遇到个问题，我原来是用<jaxws:endpoint id="helloWorld" implementor="org.andy.cxf.HelloWorldImpl" address="/HelloWorld" />来发布的，但是有个问题，是方法发布不上去，调用的时候会报错，原因是我的两个文件不在同一级目录下
为什么我在eclipse中新建一个java web项目的时候多出了几个文件（Jax-Ws-Web Services 等等）我
Jacky的专栏
01-20 5904
为什么我在eclipse中新建一个java web项目的时候多出了几个文件（Jax-Ws-Web Services 等等）我原先的项  分享| 2012-02-23 09:44zhang352954605 | 浏览 5383 次 项目中也出现了这几个文件 ，现在我每次运行eclipse的时候无论是关闭的项目还是正 处于打开状态的项目前面都是+号 ，我点击关闭的项目前面的+号时
webservice之jax-ws实现方式
TalkLessDoMore的博客
03-19 615
1.什么是webservice? webservice是一种远程资源调用技术，它的实现方式主要分为两种，第一种是jaxws方式,它是面向方法的，它的数据类型是xml是基于soap实现传输；第二种是jaxrs方式,它是面向资源的，它的数据类型是xml或json是基于http协议实现传输。 2.jaxws简单应用 服务端： 第一步：创建一个简单的web项目，略 　　 第二步：添加web...
如何使用JAX-WS API生成wsdl文件？请给出详细步骤和代码
最新发布
06-08
生成 WSDL 文件是使用 JAX-WS API 的一个常见任务。以下是使用 JAX-WS API 生成 WSDL 文件的步骤： 1. 创建一个 Java 类，该类将充当 Web 服务的实现。这个实现类应该有一个无参构造函数，并且应该被注释为 @WebService。 2. 使用 JAX-WS API 的 Endpoint 类来发布 Web 服务。在发布 Web 服务时，您需要指定 Web 服务的地址和实现类。例如，以下代码发布了 Web 服务，该服务使用 MyServiceImpl 类作为其实现，并在 localhost 的端口 8080 上运行： ```java MyServiceImpl myService = new MyServiceImpl(); String address = "http://localhost:8080/myservice"; Endpoint.publish(address, myService); ``` 3. 在 Web 服务发布后，您可以使用 JAX-WS API 的 WSDLGenerator 类生成 WSDL 文件。以下是使用 WSDLGenerator 生成 WSDL 文件的代码： ```java WSDLFactory factory = WSDLFactory.newInstance(); WSDLGenerator wsdlGenerator = factory.newWSDLGenerator(); StringWriter writer = new StringWriter(); wsdlGenerator.generateWSDL(MyServiceImpl.class, new StreamResult(writer)); String wsdl = writer.toString(); System.out.println(wsdl); ``` 在这段代码中，我们首先创建了一个 WSDLFactory 实例，然后使用该工厂创建一个 WSDLGenerator 实例。接下来，我们创建一个 StringWriter 对象，以便将生成的 WSDL 文件写入字符串。最后，我们调用 WSDLGenerator 的 generateWSDL() 方法来生成 WSDL 文件，并将其写入 StringWriter 中。 以上就是使用 JAX-WS API 生成 WSDL 文件的详细步骤和代码。希望对您有所帮助！

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值