Many options can be specified on the command line to customize the behavior
of the binding generator. Each option is indicated by a hyphen character ('-')
followed by a character that identifies the option. Most options require
additional information, and for these the next command line argument following
the option supplies the necessary information. All command line options must be
given before the list of classes to be included in the generated binding. Here's
the complete list of options:
Option |
Description |
Repeatable |
-a arg |
Abstract base class The argument following
the flag is the fully-qualified name of a class
to be treated as an abstract base class, where references to this class
will actually use a subclass instance at runtime. |
Yes |
-b arg |
Bean property class definition The argument
following the flag is of the form class-name=pname1,pname2,...,
where class-name is the fully-qualified name of a class to be
treated as a Java Bean and pname# is a property name to be
accessed using getPname# and setPname# methods. |
Yes |
-c arg |
Custom mapped class The argument following
the flag is of the form class-name=handler-class-name, where
class-name is the fully-qualified name of a class to be mapped,
and handler-class-name is the fully qualified class name of the
custom marshaller/unmarshaller class to be used for this mapping. |
Yes |
-e arg |
Enumeration class definition The argument
following the flag is of the form class-name[=deser-meth], where
class-name is the fully-qualified name of a class to be treated
as a type-safe enumeration. If this class name is given by itself the
enumeration class must define a static method getCName(),
where CName is the simple name of the class (without any package
information), which takes a single java.lang.String
parameter representing a text value for the enumeration and returns an
instance of the class. If the optional =deser-meth version of the
argument is used the specified deser-meth must be a static method
of this type. The deser-meth can be given with a leading package
and class name; if given as a simple method name it must be defined by
the type-safe enumeration class itself. The enumeration class must
always return an appropriate text representation for a value from the
toString() method, since this is how the enumeration values
are serialized during marshalling. |
Yes |
-f arg |
Binding file path The argument following the
flag is the path to be used for the generated binding definition file.
If not specified this defaults to binding.xml. |
No |
-i arg |
Ignored class The argument following
the flag is the fully-qualified name of a class to be ignored in the
constructed binding. This allows you to skip classes which require
special handling beyond the limits of the binding generator's
customizations, though you'll generally need to modify the generated
binding to deal with these classes before you can use it. |
Yes |
-m |
Mixed case names This option changes the
form of generated element and attribute names to use mixed (camel) case,
rather than the default hyphenated names. |
No |
-n arg |
Namespace URI The argument following
the flag is the URI of the namespace to be used for all generated
element definitions. Attributes in the generated binding never use a
namespace. |
No |
-p arg |
Class load path The argument following the
flag is a path component to be used for loading the classes to be
included in the generated binding definition. By default the current
directory is used in the class load path, along with all entries from
the classpath used in running the binding generation tool. |
Yes |
-v |
Verbose This option enables printing of
detailed information during the execution of the binding generation
tool, useful for isolating problems with the tool. |
No |