wsdl2java- jBroker Web WSDL to Java compiler

wsdl2java is the jBroker Web WSDL to Java compiler.

SYNOPSIS

wsdl2java [options] wsdl-file(s)

where options include:
    -help                print out this message
    -J<vm flag>          pass argument to the java interpreter
    -ds <directory>      destination directory for generated source files
    -package <pkg>       specify package for generated files
    -nspkg <ns> <pkg>    map namespace ns to package pkg
    -notypes             do not map complex XML types to Java types
    -typemapping <file>  load type mappings from file
    -I <directory>       directory with local XSD files
    -nostub              do not generate the stubs
    -noskel              do not generate the skeletons
    -notie               do not generate the TIE based skeletons
    -noserv              do not generate the service interfaces
    -keep                do not delete generated source files
    -keepgenerated       same as -keep
    -verbose             turn verbose mode on
    -nocompile           do not compile the generated source files
    -nowarn              generate no warnings
    -wsdllocation <url>  the URL to be returned by getWSDLDocumentLocation()
    -genclient           generate a sample client for the web service
    -gencallclient       generate a call based sample client for the web service
    -genserver           generate a sample server for the web service
java-compiler options:
    -classpath <path>    specify where to find user class files
    -d <directory>       destination directory for classes
    -g                   enable generation of debugging information
    -O                   generate optimized code
    -depend              make compiler consider compiling dependencies
    -nowarn              generate no warnings from Java compiler
    -nohttp              do not generate interfaces and bindings for http
 

DESCRIPTION

The wsdl2java compiler transforms WSDL documents into Java interfaces (RMI). The wsdl2java compiler first transforms the WSDL into Java RMI and then invokes the rmi2soap compiler to generate SOAP stubs and skeletons. The wsdl2java compiler passes the information from the SOAP binding to the rmi2soap compiler, i.e. the resulting stubs and skeletons will typically contain more information than if rmi2soap was ran over the remote interface. The following table shows the combinations of style, use and part supported by the wsdl2java compiler.
 
 
Combination style use part
1 document literal element
2 RPC encoded type

OPTIONS

-help
Prints out the command syntax.
-J<vm flag>
Pass a flag to the jvm. As an example -J-Xms100m sets the maximum heap size to 100 MB when running wsdl2java. This option can be used multiple times on the command line.
-ds <directory>
Output generated Java files to the specified directory. The directory will automatically be created if it doesn't exist. Depending on the package and nspkg flags additional directories may be created below this directory.
-package <pkg>
Make pkg the default package for all generated Java interfaces, regardless of which namespace is used in the WSDL file. If the package or nspkg flags are not present, the wsdl2java compiler will place generated Java files into a package derived from the targetNamespace of the WSDL document.
-nspkg <ns> <pkg>
Map the WSDL namespace ns to the Java package pkg. If different XML types, or XML types and WSDL portType's are defined in different namespaces, this option provides a flexible mechanism for mapping different namespaces to different Java packages. This option overrides the -package option. This option can be used multiple times on the command line.
-notypes
Do not generate Java types for complex XML data types. This effectively maps all complex XML data types to the org.w3c.dom.Element Java type. By default the wsdl2java compiler will try to map XML types defined in the WSDL document to Java types by using the type mapping functionality.
-typemapping <file>
Load type mappings from file. This argument can be specified multiple times.
-I <directory>
Instruct the compiler to look in this include directory for XML type definitions. If the file specified in the location attribute of an import element could not be loaded, the compiler will try to locate it in the directory specified with the -I flag. This option can be used multiple times on the command line.
-nostub
Instruct the rmi2soap compiler not to generate stubs. This options is typically used by developers who only wish to implement a Web Service, but do not require calling said Web Service.
-noskel
Instructs the rmi2soap compiler not to generate skeletons. This option is typically used by developers who are implementing Web Services client applications, but do not need to implement the Web Service itself.
-notie
Instruct the rmi2soap compiler not to generate tie classes. Tie classes are also used by Web Service developers, and is an advanced server-side construct that allows delegation to another Java class.
-noserv
Instruct the rmi2soap compiler not to generate service classes. This option can be used for server-side implementations that don't use the service interface.
-keep
Keep the source files generated by the rmi2soap compiler. Typically, developers will not need the generated stub and skeleton source files so the default behavior is to delete those files.
-keepgenerated
Same as -keep.
-verbose
Print out details about the compilation. This includes information about type and package mappings.
-nocompile
Do not compile  Java source generated by rmi2soap into class files. Note that the wsdl2java compiler will still compile the generated Java RMI interface.
-nowarn
Do not print out warning messages. The wsdl2java compiler was built to be tolerant towards malformed WSDL documents and it is therefore recommended that this flag is only used when the WSDL is known to be compliant to the WSDL 1.1 specification.
-wsdllocation  <url>
Specify the URL to be returned by the getWSDLDocumentLocation() method of the Service.
-genclient
This flag will cause the wsdl2java compiler to generate a sample client, which can be used to invoke the Web Service(s) defined in the WSDL document.
-gencallclient
This flag will cause the wsdl2java compiler to generate a sample client that uses the call API, which can be used to invoke the Web Service(s) defined in the WSDL document.
-genserver
This flag will cause the wsdl2java compiler to generate a sample server implementation of the Web Service(s) defined in the WSDL document.

JAVA COMPILER OPTIONS

-classpath
Set the classpath available to the java compiler (javac) when compiling the generated Java files.
-d <directory>
Set the output directory for compiled class files. The directory will automatically be created if it doesn't exist. Depending on the package of the source file additional directories may be created below this directory.
-g
Enables generation of debugging information.
-O
Generates optimized code.
-depend
Make the javac compiler consider dependencies.
-nowarn
Do not generate warning messages from the javac compiler.
-nohttp
Do not generate interfaces and bindings for port types used in a HTTP binding in the WSDL document.

Copyright © 2001-2002, SilverStream Software, Inc. All rights reserved.