xmlc [options] [optfile.xmlc ...] src.ext
Compiles an XML document or page into a class that can be used to dynamically alter the page. Various options controlling the behavior of the compiler may be specified on the command line or in a separate file.
The generated class, which extends XMLObject
, will contain a
DOM
representation of the original XML page. In addition to the
standard DOM
document access method, the generated class will contain
a get method for each XML element that contains the id
attribute.
The get method will be named in the form getElementIdname
.
With the first character of the id being shifted to upper case.
The options file, with the extension .xmlc
, is used to hold options
that are too verbose to include on the command line or are shared by multiple
files. The format for the options file is:
-class classname
- Fully qualified class name for
the generated class.
-keep
- Keep the generate Java source, do not delete it.
-nocompile
- If specified, don't compile the generate Java
file. Useful with the -keep
option or the various information
reporting options.
-implements interface
- Specifies that the generate
class will implement interface
. This option maybe specified
multiple times.
-urlmapping orgURL newURL
-
Specify a URL to modify in the DOM. All occurances of orgURL
will be changed to newURL
when referenced in tag attributes
that are specified to contain a URL. This option maybe specified multiple
times.
-urlsetting id newURL
- Specify
a URL to modify in the DOM by tag id. The URL in the tag with the id id
will be changed to newURL
. This option maybe specified
multiple times.
-info
- Print useful information about the page object, such
as ids and URLs.
-dump
- Dump out the DOM tree for the page.
-verbose
- Generate useful output about the compiler process.
-parseinfo
- Print detailed information about the page parsing.
-methods
- Print the signature of each generated access method.
-html:frameset
- A HTML frameset is being compiled.
-javac prog
- Specify the Java compiler to use. The
xmlc compiler passes the these arguments directly to the Java compiler and
don't require the -javac
option: -g
, -O
,
-debug
-classpath
, -d
.
-javacflag flag
- Aribitrary flag to pass to the
javac
program. This options maybe specified multiple times. The
flag
argument should contain the leading `-' or `+'
characters. This is used to for javac
options that don't take
values.
-javacopt opt value
- Aribitrary option and value
to pass to the javac
program. This option maybe specified multiple
times. The opt
argument should contain the leading `-'
or `+' characters.
-docout file
- Write a static document to file
instead of generating and compiling Java code. This is useful for pages where
the URL's must be mapped to reference dynamic pages, but there is no other
dynamic content. javac
are:
-g
-O
-debug
-classpath path
-d dir