wsgen (1)

Leading comments

Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation.

This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE...

(The comments found at the beginning of the groff file "man1/wsgen.1".)

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 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 "{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 "{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)

*

The Tools tab of the JAX-WS (wsgen) page jax-ws.java.net/nonav/2.1.1/docs/wsgenant.html