调用WebService实例，javaEE6 Feature之wsimport工具

     在javaEE6的bin文件夹时，有一个wsimport.exe，这个工具在5.0之前的版本里是没有的，这个工具依据wsdl文件生成相应的类文件，然后用这些类文件，就可以像调用本地的类一样调用WebService提供的方法了

 

• wsimport工具详细参数

The wsimport tool generates JAX-WS portable artifacts, such as:

• Service Endpoint Interface (SEI)
• Service
• Exception class mapped from wsdl:fault (if any)
• Async Reponse Bean derived from response wsdl:message (if any)
• JAXB generated value types (mapped java classes from schema types)

These artifacts can be packaged in a WAR file with the WSDL and schema documents along with the endpoint implementation to be deployed. The generated Service class can be used to invoke the Web Service endpoint.

 

wsimport [options] <wsdl>

 

Option	Description
-d <directory>	Specify where to place generated output files
-b <path>	Specify external JAX-WS or JAXB binding files (Each <file> must have its own -b)
-catalog	Specify catalog file to resolve external entity references, it supports TR9401, XCatalog, and OASIS XML Catalog format. Please read the XML Entity and URI Resolvers document or seewsimport_catalog sample.
-extension	allow vendor extensions (functionality not specified by the specification). Use of extensions may result in applications that are not portable or may not interoperate with other implementations
-help	Display help
-httpproxy:<host>:<port>	Specify an HTTP proxy server (port defaults to 8080)
-keep	Keep generated files
-p	Specifying a target package via this command-line option, overrides any wsdl and schema binding customization for package name and the default package name algorithm defined in the specification
-s <directory>	Specify where to place generated source files
-verbose	Output messages about what the compiler is doing
-version	Print version information
-wsdllocation <location>	@WebService.wsdlLocation and @WebServiceClient.wsdlLocation value

 

• wsimport工具用法实例

 

首先，须保证你的jdk为6.0以上版本，可以在command line下试运行这个命令

c:\test> wsimport

 

假设我们有下面的wsdl文件

http://localhost:9080/WebService/TestService/TestService.wsdl

 

我们要把生成的代码放到c:/test/com.bjmaxinfo.rpc.merchantware.ws目录下，那么我们运行以下命令即可

 

c:\test> wsimport -p com.bjmaxinfo.rpc.merchantware.ws -keep  http://localhost:9080/WebService/TestService/TestService.wsdl

 

然后，你就会看到在c:\test\generate目录下生成了一些java代码文件，wsimport就是如此简单

 

 

• 编写调用WebService的客户端

假如我们要调用的WebService就是之前举例提到的TestService，它只有下面这样一个方法

 

public String test(String name) throws SOAPException
{
     if (name == null)
    {
        throw new SOAPException("name can't be null!");
    }

    return "hello " + name;
}

 

用wsimport工具，我们可以得到如下代码文件

 

generate

    |--com

        |--company

            |--ObjectFactory.java

            |--SOAPException.java

            |--SOAPException_Exception.java

            |--Test.java

            |--TestResponse.java

            |--TestService.java

            |--TestService_Service.java

            |--package-info.java

 

把它们编译，然后写下面这样一个application去测试

 

 

public static void main(String[] args)
{
    TestService_Service serviceFactory = new TestService_Service();
    TestService service = serviceFactory.getTestServicePort();
    try
    {
        System.out.println(service.test(null));
    }
    catch (SOAPException_Exception ex)
    {
        System.out.println(ex.getMessage());
    }
}

 

运行它，屏幕就会输出

name can't be null

 

因为我们之前传了一个null值进去嘛，其实这也是为了测试SOAPException是否正常运行，如果你传个正确的字符串进去，webservice就可以正常运行，如System.out.println(service.test("javaeye"));，屏幕上就会显示，

Hello javaeye!

 

顺便提一下WebService的异常处理，所有WebService的异常都必须用SOAPException抛出，它是java.xml.soap包中的一个类 (本人试过其它一些Exception，都不能被正常捕捉，只有SOAPException可以正常工作，具体原因不明，如果有哪个人清楚这一点，请评论告之，谢谢)