Name

wsgen - Java(TM) API for XML Web Services (JAX-WS) 2.0

f3Specification Version: 2.1
f3Implementation Version: 2.1.1

The f2wsgen tool generates JAX-WS portable artifacts used in JAX-WS web services. The tool reads a web service endpoint implementation class (SEI) and generates all the required artifacts for web service deployment, and invocation

Overview

The f2wsgen tool generates JAX-WS portable artifacts used in JAX-WS web services. The tool reads a web service endpoint class and generates all the required artifacts for web service deployment, and invocation. JAXWS 2.1.1 RI also provides a wsgen ant task, see

f2Wsgen ant task @

https://jax-ws.dev.java.net/nonav/2.1.1/docs/wsgenant.html for details.

Launching wsgen

o f3Solaris/Linux

* f2export JAXWS_HOME=/pathto/jaxws-ri

* f2$JAXWS_HOME/bin/wsgen.sh -help

o f3Windows

* f2set JAXWS_HOME=c:\pathto\jaxws-ri

* f2%JAXWS_HOME%\bin\wsgen.bat -help

Syntax

f3
wsgen [options] <SEI>

f3

The following table lists the f2wsgen options.

Specify where to find input class files


Same as f2-classpath <path>


Specify where to place generated output files


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


Used only in conjunction with the -wsdl option. Specify where to place generated resource files such as WSDLs


Specify where to place generated source files


Output messages about what the compiler is doing


Print version information. Use of this option will ONLY print version information. Normal processing will not occur.


By default f2wsgen does not generate a WSDL file. This flag is optional and will cause f2wsgen to generate a WSDL file and is usually only used so that the developer can look at the WSDL before the endpoint is deploy. The f2protocol is optional and is used to specify what protocol should be used in the f2wsdl:binding. Valid protocols include: f2soap1.1 and f2Xsoap1.2. The default is f2soap1.1. f2Xsoap1.2 is not standard and can only be used in conjunction with the f2-extension option.


Used only in conjunction with the f2-wsdl option. Used to specify a particular f2wsdl:service name to be generated in the WSDL. Example, f2-servicename "{http://mynamespace/}MyService"


Used only in conjunction with the f2-wsdl option. Used to specify a particular f2wsdl:port name to be generated in the WSDL. Example, f2-portname "{http://mynamespace/}MyPort"


h'|n(40u'f3Optionh'|n(41u'f3Description
h'|n(40u'f4-classpath <path>h'|n(41u'
h'|n(40u'f4-cp <path>h'|n(41u'
h'|n(40u'f4-d <directory>h'|n(41u'
h'|n(40u'f4-extensionh'|n(41u'
h'|n(40u'f4-helph'|n(41u'Display help
h'|n(40u'f4-keeph'|n(41u'Keep generated files
h'|n(40u'f4-r <directory>h'|n(41u'
h'|n(40u'f4-s <directory>h'|n(41u'
h'|n(40u'f4-verboseh'|n(41u'
h'|n(40u'f4-versionh'|n(41u'
h'|n(40u'f4-wsdl[:protocol]h'|n(41u'
h'|n(40u'f4-servicename <name>h'|n(41u'
h'|n(40u'f4-portname <name>h'|n(41u'
 

Example
f3
f3wsgen -d stock -cp myclasspath stock.StockService 



This will generate the wrapper classes needed for StockService annotated with @WebService annotation inside f3stockdirectory. 
f3
f3wsgen -wsdl -d stock -cp myclasspath stock.StockService 



This will generate a SOAP 1.1 WSDL and schema for your Java class stock.StockService annotated with @WebService annotation. 
f3
f3wsgen -wsdl:Xsoap1.2 -d stock -cp myclasspath stock.StockService 



Will generate a SOAP 1.2 WSDL. 
Note that you do not have to generate WSDL at the development time as JAXWS runtime will automatically generate a WSDL for you when you deploy your service.