Generating Stubs (wscompile)

Mobile clients can use the Stub Generator to access web services. The wscompile tool generates stubs, ties, serializers, and WSDL files used in Java API for XML (JAX) RPC clients and services. The tool reads a configuration file, that specifies either a WSDL file, a model file, or a compiled service endpoint interface. The syntax for the stub generator command is as follows:

wscompile [options] configuration-files

Table 1 lists the wscompile options:

`wscompile` Options

Option	Description
`-d` output directory	Specifies where to place generated output files
`-f:`features	Enables the given features
`-features:`features	Same as `-f:`features
`-g`	Generates debugging info
`-gen`	Same as `-gen:client`
`-gen:client`	Generates client artifacts (stubs, etc.)
`-httpproxy:`host:port	Specifies a HTTP proxy server (port defaults to 8080)
`-import`	Generates interfaces and value types only
`-model` file	Writes the internal model to the given file
`-O`	Optimizes generated code
`-s` directory	Specifies where to place generated source files
`-verbose`	Outputs messages about what the compiler is doing
`-version`	Prints version information
`-cldc1.0`	Sets the CLDC version to 1.0 (default). Float and double become String.
`-cldc1.1`	Sets the CLDC version to 1.1 (float and double are OK)
`-cldc1.0info`	Shows all CLDC 1.0 information and warning messages.

Note - Exactly one -gen option must be specified. The -f option requires a comma-separated list of features.

Table 2 lists the features (delimited by commas) that can follow the -f option. The wscompile tool reads a WSDL file, compiled service endpoint interface (SEI), or model file as input. The Type of File column indicates which of these files can be used with a particular feature.

Command Supported Features (`-f`) for `wscompile`

Option	Description	Type of File
`explicitcontext`	Turns on explicit service context mapping	WSDL
`nodatabinding`	Turns off data binding for literal encoding	WSDL
`noencodedtypes`	Turns off encoding type information	WSDL, SEI, model
`nomultirefs`	Turns off support for multiple references	WSDL, SEI, model
`novalidation`	Turns off full validation of imported WSDL documents	WSDL
`searchschema`	Searches schema aggressively for subtypes	WSDL
`serializeinterfaces`	Turns on direct serialization of interface types	WSDL, SEI, model
`wsi`	Enables WSI-Basic Profile features (default)	WSDL
`resolveidref`	Resolves `xsd:IDREF`	WSDL
`nounwrap`	No unwrap.	WSDL

Examples

wscompile -gen -d generated config.xml
wscompile -gen -f:nounwrap -O -cldc1.1 -d generated config.xml

Exit Print View
Java Platform Micro Edition Software Development Kit Version 3.0

Java Platform Micro Edition Software Development Kit Version 3.0