jdk/src/solaris/doc/sun/man/man1/xjc.1
author bpatel
Wed, 14 Jul 2010 15:42:06 -0700
changeset 5865 47da38a8c0f0
parent 5506 202f599c92aa
child 9573 c02ff5a7c67b
permissions -rw-r--r--
6955341: Oracle rebranding changes for man pages Reviewed-by: darcy
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
5865
47da38a8c0f0 6955341: Oracle rebranding changes for man pages
bpatel
parents: 5506
diff changeset
     1
." Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
     2
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
90ce3da70b43 Initial load
duke
parents:
diff changeset
     3
."
90ce3da70b43 Initial load
duke
parents:
diff changeset
     4
." This code is free software; you can redistribute it and/or modify it
90ce3da70b43 Initial load
duke
parents:
diff changeset
     5
." under the terms of the GNU General Public License version 2 only, as
90ce3da70b43 Initial load
duke
parents:
diff changeset
     6
." published by the Free Software Foundation.
90ce3da70b43 Initial load
duke
parents:
diff changeset
     7
."
90ce3da70b43 Initial load
duke
parents:
diff changeset
     8
." This code is distributed in the hope that it will be useful, but WITHOUT
90ce3da70b43 Initial load
duke
parents:
diff changeset
     9
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
90ce3da70b43 Initial load
duke
parents:
diff changeset
    10
." FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
90ce3da70b43 Initial load
duke
parents:
diff changeset
    11
." version 2 for more details (a copy is included in the LICENSE file that
90ce3da70b43 Initial load
duke
parents:
diff changeset
    12
." accompanied this code).
90ce3da70b43 Initial load
duke
parents:
diff changeset
    13
."
90ce3da70b43 Initial load
duke
parents:
diff changeset
    14
." You should have received a copy of the GNU General Public License version
90ce3da70b43 Initial load
duke
parents:
diff changeset
    15
." 2 along with this work; if not, write to the Free Software Foundation,
90ce3da70b43 Initial load
duke
parents:
diff changeset
    16
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    17
."
5506
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2692
diff changeset
    18
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2692
diff changeset
    19
." or visit www.oracle.com if you need additional information or have any
202f599c92aa 6943119: Rebrand source copyright notices
ohair
parents: 2692
diff changeset
    20
." questions.
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    21
."
5865
47da38a8c0f0 6955341: Oracle rebranding changes for man pages
bpatel
parents: 5506
diff changeset
    22
.TH xjc 1 "02 Jun 2010"
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    23
90ce3da70b43 Initial load
duke
parents:
diff changeset
    24
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
    25
.ad c
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    26
.SH "Name"
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    27
xjc \- Java(TM) Architecture for XML Binding
90ce3da70b43 Initial load
duke
parents:
diff changeset
    28
.br
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    29
Binding Compiler 
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    30
.LP
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    31
\f3Specification Version:\fP 2.1
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    32
.br
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    33
\f3Reference Implementation (RI) Version:\fP 2.1.3 .ad l
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    34
90ce3da70b43 Initial load
duke
parents:
diff changeset
    35
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
    36
.SH "Launching xjc"
90ce3da70b43 Initial load
duke
parents:
diff changeset
    37
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
    38
.LP
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    39
The binding compiler can be launched using the appropriate \f2xjc\fP shell script in the \f2bin\fP directory for your platform. We also provide an Ant task to run the binding complier \- see the instructions for 
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    40
.na
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    41
\f2using the XJC Ant task\fP @
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    42
.fi
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    43
https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.html.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    44
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
    45
.RS 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
    46
90ce3da70b43 Initial load
duke
parents:
diff changeset
    47
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
    48
.LP
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    49
\f2% xjc \-help\fP
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    50
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
    51
.RE
90ce3da70b43 Initial load
duke
parents:
diff changeset
    52
\f3Output\fP
90ce3da70b43 Initial load
duke
parents:
diff changeset
    53
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
    54
.RS 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
    55
90ce3da70b43 Initial load
duke
parents:
diff changeset
    56
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
    57
.nf
90ce3da70b43 Initial load
duke
parents:
diff changeset
    58
\f3
90ce3da70b43 Initial load
duke
parents:
diff changeset
    59
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
    60
Usage: xjc [\-options ...] <schema_file/URL/dir> ... [\-b <bindinfo>] ...
90ce3da70b43 Initial load
duke
parents:
diff changeset
    61
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
    62
Options:
90ce3da70b43 Initial load
duke
parents:
diff changeset
    63
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
    64
 \-nv                  : do not perform strict validation of the input schema(s)
90ce3da70b43 Initial load
duke
parents:
diff changeset
    65
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
    66
 \-extension           : allow vendor extensions \- do not strictly follow the
90ce3da70b43 Initial load
duke
parents:
diff changeset
    67
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
    68
                        Compatibility Rules and App E.2 from the JAXB Spec
90ce3da70b43 Initial load
duke
parents:
diff changeset
    69
.fl
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    70
 \-b <file/dir>        : specify external bindings files (each <file> must have its own \-b)
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    71
.fl
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    72
                        If a directory is given, **/*.xjb is searched
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    73
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
    74
 \-d <dir>             : generated files will go into this directory
90ce3da70b43 Initial load
duke
parents:
diff changeset
    75
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
    76
 \-p <pkg>             : specifies the target package
90ce3da70b43 Initial load
duke
parents:
diff changeset
    77
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
    78
 \-httpproxy <proxy>   : set HTTP/HTTPS proxy. Format is [user[:password]@]proxyHost:proxyPort
90ce3da70b43 Initial load
duke
parents:
diff changeset
    79
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
    80
 \-httpproxyfile <file>: set the proxy string (same format as above).
90ce3da70b43 Initial load
duke
parents:
diff changeset
    81
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
    82
 \-classpath <arg>     : specify where to find user class files
90ce3da70b43 Initial load
duke
parents:
diff changeset
    83
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
    84
 \-catalog <file>      : specify catalog files to resolve external entity references
90ce3da70b43 Initial load
duke
parents:
diff changeset
    85
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
    86
                        support TR9401, XCatalog, and OASIS XML Catalog format.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    87
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
    88
 \-readOnly            : generated files will be in read\-only mode
90ce3da70b43 Initial load
duke
parents:
diff changeset
    89
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
    90
 \-npa                 : suppress generation of package level annotations (**/package\-info.java)
90ce3da70b43 Initial load
duke
parents:
diff changeset
    91
.fl
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    92
 \-no\-header           : suppress generation of a file header with timestamp
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    93
.fl
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    94
 \-target 2.0          : behave like XJC 2.0 and generate code that doesnt use any 2.1 features.
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    95
.fl
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    96
 \-xmlschema           : treat input as W3C XML Schema (default)
90ce3da70b43 Initial load
duke
parents:
diff changeset
    97
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
    98
 \-relaxng             : treat input as RELAX NG (experimental,unsupported)
90ce3da70b43 Initial load
duke
parents:
diff changeset
    99
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
   100
 \-relaxng\-compact     : treat input as RELAX NG compact syntax (experimental,unsupported)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   101
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
   102
 \-dtd                 : treat input as XML DTD (experimental,unsupported)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   103
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
   104
 \-wsdl                : treat input as WSDL and compile schemas inside it (experimental,unsupported)
90ce3da70b43 Initial load
duke
parents:
diff changeset
   105
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
   106
 \-verbose             : be extra verbose
90ce3da70b43 Initial load
duke
parents:
diff changeset
   107
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
   108
 \-quiet               : suppress compiler output
90ce3da70b43 Initial load
duke
parents:
diff changeset
   109
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
   110
 \-help                : display this help message
90ce3da70b43 Initial load
duke
parents:
diff changeset
   111
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
   112
 \-version             : display version information
90ce3da70b43 Initial load
duke
parents:
diff changeset
   113
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
   114
\fP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   115
.fi
90ce3da70b43 Initial load
duke
parents:
diff changeset
   116
.RE
90ce3da70b43 Initial load
duke
parents:
diff changeset
   117
90ce3da70b43 Initial load
duke
parents:
diff changeset
   118
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   119
.SH "OPTIONS"
90ce3da70b43 Initial load
duke
parents:
diff changeset
   120
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   121
90ce3da70b43 Initial load
duke
parents:
diff changeset
   122
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   123
.RS 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   124
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   125
\-nv 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   126
By default, the XJC binding compiler performs strict validation of the source schema before processing it. Use this option to disable strict schema validation. This does not mean that the binding compiler will not perform any validation, it simply means that it will perform less\-strict validation. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   127
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   128
\-extension 
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   129
By default, the XJC binding compiler strictly enforces the rules outlined in the Compatibility chapter of the JAXB Specification. Appendix E.2 defines a set of W3C XML Schema features that are not completely supported by JAXB v1.0. In some cases, you may be allowed to use them in the "\-extension" mode enabled by this switch. In the default (strict) mode, you are also limited to using only the binding customizations defined in the specification. By using the "\-extension" switch, you will be allowed to use the JAXB Vendor Extensions 
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   130
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   131
\-b <file> 
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   132
Specify one or more external binding files to process. (Each binding file must have its own \f2"\-b"\fP switch.) The syntax of the external binding files is extremely flexible. You may have a single binding file that contains customizations for multiple schemas or you can break the customizations into multiple bindings files: 
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   133
.RS 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   134
90ce3da70b43 Initial load
duke
parents:
diff changeset
   135
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   136
\f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings123.xjb\fP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   137
.br
90ce3da70b43 Initial load
duke
parents:
diff changeset
   138
\f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings1.xjb \-b bindings2.xjb \-b bindings3.xjb\fP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   139
.RE
90ce3da70b43 Initial load
duke
parents:
diff changeset
   140
In addition, the ordering of the schema files and binding files on the command line does not matter. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   141
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   142
\-d <dir> 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   143
By default, the XJC binding compiler will generate the Java content classes in the current directory. Use this option to specify an alternate output directory. The output directory must already exist, the XJC binding compiler will not create it for you. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   144
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   145
\-p <pkg> 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   146
Specifying a target package via this command\-line option overrides any binding customization for package name and the default package name algorithm defined in the specification. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   147
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   148
\-httpproxy <proxy> 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   149
Specify the HTTP/HTTPS proxy. The format is [user[:password]@]proxyHost[:proxyPort]. The old \f2\-host\fP and \f2\-port\fP are still supported by the RI for backwards compatibility, but they have been deprecated. Note that the password specified with this option is an argument that is visible to other users who use the \f2top\fP command, for example. For greater security, use \f2\-httpproxyfile\fP, below. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   150
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   151
\-httpproxyfile <file> 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   152
Specify the HTTP/HTTPS proxy using a file. Same format as above, but the password specified in the file is not visible to other users. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   153
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   154
\-classpath <arg> 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   155
Specify where to find client application class files used by the \f2<jxb:javaType>\fP and \f2<xjc:superClass>\fP customizations. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   156
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   157
\-catalog <file> 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   158
Specify catalog files to resolve external entity references. Supports TR9401, XCatalog, and OASIS XML Catalog format. Please read the XML Entity and URI Resolvers document or the \f2catalog\-resolver\fP sample application. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   159
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   160
\-readOnly 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   161
By default, the XJC binding compiler does not write\-protect the Java source files it generates. Use this option to force the XJC binding compiler to mark the generated Java sources read\-only. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   162
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   163
\-npa 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   164
Supress the generation of package level annotations into **/package\-info.java. Using this switch causes the generated code to internalize those annotations into the other generated classes. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   165
.TP 3
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   166
\-no\-header 
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   167
Supress the generation of a file header comment that includes some note and timestamp. Using this makes the generated code more diff\-friendly. 
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   168
.TP 3
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   169
\-target 2.0 
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   170
Avoid generating code that relies on any JAXB 2.1 features. This will allow the generated code to run with JAXB 2.0 runtime (such as JavaSE 6.) 
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   171
.TP 3
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   172
\-xmlschema 
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   173
Treat input schemas as W3C XML Schema (default). If you do not specify this switch, your input schemas will be treated as W3C XML Schema. 
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   174
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   175
\-relaxng 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   176
Treat input schemas as RELAX NG (experimental, unsupported). Support for RELAX NG schemas is provided as a JAXB Vendor Extension. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   177
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   178
\-relaxng\-compact 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   179
Treat input schemas as RELAX NG compact syntax(experimental, unsupported). Support for RELAX NG schemas is provided as a JAXB Vendor Extension. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   180
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   181
\-dtd 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   182
Treat input schemas as XML DTD (experimental, unsupported). Support for RELAX NG schemas is provided as a JAXB Vendor Extension. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   183
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   184
\-wsdl 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   185
Treat input as WSDL and compile schemas inside it (experimental,unsupported). 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   186
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   187
\-quiet 
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   188
Suppress compiler output, such as progress information and warnings. 
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   189
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   190
\-verbose 
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   191
Be extra verbose, such as printing informational messages or displaying stack traces upon some errors. 
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   192
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   193
\-help 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   194
Display a brief summary of the compiler switches. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   195
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   196
\-version 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   197
Display the compiler version information. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   198
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   199
<schema file/URL/dir> 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   200
Specify one or more schema files to compile. If you specify a directory, then xjc will scan it for all schema files and compile them. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   201
.RE
90ce3da70b43 Initial load
duke
parents:
diff changeset
   202
.SS 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   203
Summary of Deprecated and Removed Command Line Options
90ce3da70b43 Initial load
duke
parents:
diff changeset
   204
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   205
.RS 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   206
90ce3da70b43 Initial load
duke
parents:
diff changeset
   207
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   208
.RS 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   209
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   210
\-host & \-port 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   211
These options have been deprecated and replaced with the \f3\-httpproxy\fP option. For backwards compatibility, we will continue to support these options, but they will no longer be documented and may be removed from future releases. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   212
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   213
\-use\-runtime 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   214
Since the JAXB 2.0 specification has defined a portable runtime, it is no longer necessary for the JAXB RI to generate **/impl/runtime packages. Therefore, this switch is obsolete and has been removed. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   215
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   216
\-source 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   217
The \-source compatibility switch was introduced in the first JAXB 2.0 Early Access release. We have decided to remove this switch from future releases of JAXB 2.0. If you need to generate 1.0.x code, please use an installation of the 1.0.x codebase. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   218
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   219
\-Xlocator & \-Xsync\-methods 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   220
These switches have been disabled for now. We plan on releasing this functionality as a separate download in the future. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   221
.RE
90ce3da70b43 Initial load
duke
parents:
diff changeset
   222
90ce3da70b43 Initial load
duke
parents:
diff changeset
   223
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   224
.RE
90ce3da70b43 Initial load
duke
parents:
diff changeset
   225
.SS 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   226
Compiler Restrictions
90ce3da70b43 Initial load
duke
parents:
diff changeset
   227
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   228
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   229
In general, it is safest to compile all related schemas as a single unit with the same binding compiler switches.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   230
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   231
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   232
Please keep the following list of restrictions in mind when running xjc. Most of these issues only apply when compiling multiple schemas with multiple invocations of xjc.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   233
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   234
.RS 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   235
.TP 2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   236
o
90ce3da70b43 Initial load
duke
parents:
diff changeset
   237
To compile multiple schemas at the same time, keep the following precedence rules for the target Java package name in mind: 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   238
.RS 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   239
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   240
1.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   241
The "\f2\-p\fP" command line option takes the highest precedence. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   242
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   243
2.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   244
<\f2jaxb:package\fP> customization 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   245
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   246
3.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   247
If \f2targetNamespace\fP is declared, apply \f2targetNamespace\fP \-> Java package name algorithm defined in the specification. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   248
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   249
4.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   250
If no \f2targetNamespace\fP is declared, use a hardcoded package named "generated". 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   251
.RE
90ce3da70b43 Initial load
duke
parents:
diff changeset
   252
.TP 2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   253
o
90ce3da70b43 Initial load
duke
parents:
diff changeset
   254
It is not legal to have more than one <\f2jaxb:schemaBindings\fP> per namespace, so it is impossible to have two schemas in the same target namespace compiled into different Java packages. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   255
.TP 2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   256
o
90ce3da70b43 Initial load
duke
parents:
diff changeset
   257
All schemas being compiled into the same Java package must be submitted to the XJC binding compiler at the same time \- they cannot be compiled independently and work as expected. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   258
.TP 2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   259
o
90ce3da70b43 Initial load
duke
parents:
diff changeset
   260
Element substitution groups spread across multiple schema files must be compiled at the same time. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   261
.RE
90ce3da70b43 Initial load
duke
parents:
diff changeset
   262
90ce3da70b43 Initial load
duke
parents:
diff changeset
   263
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   264
.SH "See Also"
90ce3da70b43 Initial load
duke
parents:
diff changeset
   265
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   266
.RS 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   267
.TP 2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   268
o
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   269
Running the binding compiler (XJC): [
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   270
.na
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   271
\f2command\-line instructions\fP @
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   272
.fi
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   273
https://jaxb.dev.java.net/nonav/2.1.3/docs/xjc.html, 
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   274
.na
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   275
\f2using the XJC Ant task\fP @
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   276
.fi
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   277
https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.html] 
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   278
.TP 2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   279
o
90ce3da70b43 Initial load
duke
parents:
diff changeset
   280
.na
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   281
\f2Java Architecture for XML Binding (JAXB)\fP @
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   282
.fi
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   283
http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html 
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   284
.RE
90ce3da70b43 Initial load
duke
parents:
diff changeset
   285
90ce3da70b43 Initial load
duke
parents:
diff changeset
   286
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   287