You can use the Bean2WebService tool from a command line
to generate a web service from a Java™ bean
using the IBM® WebSphere® runtime environment.
Syntax
Once you have set up your command line, you can use the
following syntax and arguments to run the tool:
- Windows: Bean2WebService
[<optional arguments>] -cp <Classpath> -project <ProjectName> <BeanName>
- Linux: Bean2WebService.sh
[<optional arguments>] -cp <Classpath> -project <ProjectName> <BeanName>
Note: <BeanName> must be the final argument.
Arguments
Mandatory arguments:
- -project <ProjectName>
- Specifies the project name. This is used to create a directory
under the current working directory in which to store all the generated
files. If the project name already exists, a backup copy of
the existing EAR file is created. For example, if you have a project
named MyWebService, then the MyWebService.ear file would be renamed
MyWebService.ear.backup.
- -cp <ClassPath>
- Specifies a list of JAR files and directories (separated by the
platform-specific path delimiter character) that contains the Java bean and all of the dependencies
required to make it run.
- <BeanName>
- Specifies the fully-qualified package name of the compiled Java class that will be exposed
as a web service. Compile the Java class
using the
- -g option so that the part name attributes
in the generated WSDL file is to contain the correct parameter names
for the methods.
Optional arguments:
- -methods <method list>
- Specifies which public, non-static methods in the Java bean to expose in the web service. The
default is to include all of these methods. The methods in the <method
list> must be separated by spaces.
- -clientType <J2SE | Application | Servlet | EJB>
- Generates a skeleton implementation class for the type of client
specified. You can only use this argument in conjunction with the
-genMain argument. You cannot use this argument if you have already
specified the -server-side-only argument.
- -genMain <name of main class>
- Specifies the name of the main class to generate. You can only
use this argument in conjunction with the -clientType argument. You
cannot use this argument if you have already specified the -server-side-only
argument.
- -voidReturn [ONEWAY | TWOWAY]
- Indicates whether you want a void return method to be a request/response
operation (the default) or a one-way operation.
- -host <hostName:portNumber>
- Specifies the host name and port number. The default value is
localhost:6080.
- -contextRoot <ContextRoot>
- Specifies the context root for the web service. The default value
is <ProjectName>.
- -servicePortName <PortName>
- Specifies the port name for the web service. The default value
is the name of the Java bean.
Use the arguments -host, -contextRoot,
and -servicePortName to specify the URL of
the service endpoint. The format is as follows: http://HostName:PortNumber/<ContextRoot>/services/<PortName>
- -sei <endpoint interface>
- Specifies the fully-qualified path name of a prewritten Service
Endpoint Interface (Java source
code file). If none is specified, the tool dynamically generates one
at run time.
- -server-side-only
- Generates server-side helper classes only. The default is to generate
server-side as well as client-side helper classes.
- -clientEJBName <EJB client filename>
- Uses the information in the client EJB file to configure the client-side
webservicesclient.xml descriptor with the name of the client application.
If you do not supply this option, you must edit webservicesclient.xml
manually before adding it to the client EJB file.
- -style <style type>
- Generates WSDL with style RPC,
Doc, or Wrapped as
specified by <style type>. The default
style is Wrapped. Note that if you set -style=DOC unwrapped
WSDL will be generated.
- -use <bindings>
- Generates WSDL with either literal or
encoded bindings as specified by <bindings>.
The default is literal.
- -splitWsdl
- Generates separate interface and implementation WSDL documents
that are not deployed. The default is the creation of a single document
combining both interface and implementation information.
- - wsSecDir <directory>
- Specifies the full path to a directory containing templates to
configure the generated deployment descriptors with WS-Security information.
The directory must contain ibm-webservices-bnd.xmi and
ibm-webservices-ext.xmi files, and also ibm-webservicesclient-bnd.xmi and
ibm-webservicesclient-ext.xmi if generating
client-side bindings.
- -PkgtoNS <package> <namespace>
- Indicates the mapping of a Java package
to a namespace. If a package is found that does not have a namespace,
a suitable namespace name is generated. This argument can be repeated
to specify mappings for multiple packages.
- -verbose
- Displays extra information as the tool runs.
- -help
- Displays the help information.
Note: the -deploy option
is not supported.