Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

Anchor
top
top

Apache Geronimo provides several tools for administering the server. These tools are available via command line and some via a Web based console. The Web based Geronimo console is explained in detail in the following section Introducing Geronimo Administration Console. The currently available command line tools are located in the <geronimo<GERONIMO_home>HOME>/bin directory and are enumerated in the following list:

Children Display
all
all
excerpttrue

Although the tools name is self-explanatory, it may not be the same case with the tool's parameters. The following sections explain more in detail these tools and commands usage.

jaxws-tools

The jaxws-tools command can be used to generate portable artifacts used in JAX-WS web services. For example, portable artifacts such as Service Endpoint Interface (SEI) class, Service class, JAXB generated value types, etc.

This command has the following syntax:

Wiki Markup
{{*<geronimo_home>/bin/jaxws-tools toolName \[toolOptions\] ...*}}

Where toolName can be either:

  • #wsgen - generate portable artifacts from Java
  • #wsimport - generate portable artifacts from WSDL

The jaxws-tools command can also be started by using the java -jar command:

Wiki Markup
{{{*}java \-Djava.endorsed.dirs=lib/endorsed \-jar bin/jaxws-tools.jar toolName \[toolOptions\] ...*}}

wsgen

The jaxws-tools uses the wsgen tool provided by Sun to generate the portable artifacts from Java class. The wsgen tools has the following syntax:

Wiki Markup
{{*<geronimo_home>/bin/jaxws-tools wsgen \[options\] <SEI>*}}

  • -classpath <path>
    Specifies where to find input class files.
  • -d <directory>
    Specifies where to place generated output files.
  • -keep
    Keep generated files.
  • -r <directory>
    Specifies where to place resource files such as WSDLs.
  • -s <directory>
    Specifies where to place generated source files.
  • -wsdl
    Generate a WSDL file.
  • -servicename <name>
    Specifies the Service name to use in the generated WSDL (used in conjunction with the -wsdl option).

...

.

...

Example:

Code Block

<geronimo_home>/bin/jaxws-tools wsgen -d output -keep -wsdl -classpath . foo.BarService

wsimport

The jaxws-tools uses the wsimport tool provided by Sun to generate the portable artifacts from WSDL. The wsimport has the following syntax:

Wiki Markup
{{*<geronimo_home>/bin/jaxws-tools wsimport \[options\] <WSDL_URI>*}}

  • -d <directory>
    Specifies where to place generated output files.
  • -keep
    Keep generated files.
  • -p <pkg>
    Specifies the target package.
  • -s <directory>
    Specifies where to place generated source files.
  • -wsdllocation <location>
    Specified @WebService.wsdlLocation and @WebServiceClient.wsdlLocation value.

Example:

...