# wsgen(1) - man - phpMan

[wsgen(1)](https://www.chedong.com/phpMan.php/man/wsgen/1/markdown)                               Java Web Services Tools                              [wsgen(1)](https://www.chedong.com/phpMan.php/man/wsgen/1/markdown)



## NAME
       wsgen - Reads a web service endpoint implementation (SEI) class and generates all of the
       required artifacts for web service deployment, and invocation.

## SYNOPSIS
       **wsgen** [ _options_ ] _SEI_


       _options_
              The command-line options. See Options.

       _SEI_    The web service endpoint implementation class (SEI) to be read.

## DESCRIPTION
       The **wsgen** command 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 the _Tools_ tab
       of the JAX-WS (wsgen) page at <http://jax-ws.java.net/nonav/2.1.1/docs/wsgenant.html>

       To start the **wsgen** command, do the following:

       **export** **JAXWS**___**HOME=/pathto/jaxws-ri**
       **$JAXWS**___**HOME/bin/wsgen.sh** **-help**


## OPTIONS
       -classpath _path_
              The location of the input class files.

       -cp _path_
              The location of the input class files.

       -d _directory_
              The location for where to place generated output files.

### -extension
              Allow vendor extensions. Use of extensions can result in applications that are not
              portable or that do not work with other implementations.

### -help
              Displays a help message about the **wsgen** command.

### -keep
              Keeps the generated files.

       -r _directory_
              Uses this option with the **-wsdl** option to specify where to place generated resource
              files such as WSDLs.

       -s _directory_
              The location for where to place generated source files.

### -verbose
              Displays compiler messages.

### -version
              Prints release information.

### -wsdl [ :protocol ]
              An optional command that generates a WSDL file to review before endpoint deployment.
              The WSDL files contains a machine-readable description of how the service can be
              called, what parameters it expects, and what data structures it returns.

              By default the **wsgen** command does not generate a WSDL file. The **protocol** value is
              optional and is used to specify what protocol should be used for the WSDL binding
              (**wsdl:binding**). Valid protocols are **soap1.1** and **Xsoap1.2**. The default is **soap1.1**. The
              **Xsoap1.2** protocol is not standard and can only be used with the **-extension** option.

       -servicename _name_
              Used only with the **-wsdl** option to specify a particular WSDL service (**wsdl:service**)
              name to be generated in the WSDL, for example: **-servicename**
              **"{<http://mynamespace/>}MyService"**.

       -portname _name_
              Used only with the **-wsdl** option to specify a particular WSDL port (**wsdl:port**) name to
              be generated in the WSDL, for example: **-portname** **"{<http://mynamespace/>}MyPort"**.

## EXAMPLES
       The following example generates the wrapper classes for **StockService** with **@WebService**
       annotations inside stock directory.

### wsgen -d stock -cp myclasspath stock.StockService

       The following example generates a SOAP 1.1 WSDL and schema for the **stock.StockService** class
       with **@WebService** annotations.

### wsgen -wsdl -d stock -cp myclasspath stock.StockService

       The following example generates a SOAP 1.2 WSDL.

### wsgen -wsdl:Xsoap1.2 -d stock -cp myclasspath stock.StockService

       _Note:_ You do not have to generate WSDL at development time because the JAXWS run time
       environment generates a WSDL for you when you deploy your service.

## SEE ALSO
       • [wsimport(1)](https://www.chedong.com/phpMan.php/man/wsimport/1/markdown)

       • _The_ _Tools_ tab of the JAX-WS (wsgen) page <http://jax>-
         ws.java.net/nonav/2.1.1/docs/wsgenant.html



JDK 8                                     21 November 2013                                  [wsgen(1)](https://www.chedong.com/phpMan.php/man/wsgen/1/markdown)