jdk/src/solaris/doc/sun/man/man1/xjc.1
author bpatel
Wed, 11 May 2011 08:30:46 -0700
changeset 9573 c02ff5a7c67b
parent 5865 47da38a8c0f0
child 21743 3d979da7bdf0
permissions -rw-r--r--
7043684: Update man pages for JDK 7 tools Reviewed-by: skannan
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
     1
." Copyright (c) 2005, 2011, 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
."
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    22
.TH xjc 1 "10 May 2011"
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    23
90ce3da70b43 Initial load
duke
parents:
diff changeset
    24
.LP
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    25
.SH "Name"
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    26
xjc \- Java(TM) Architecture for XML Binding
90ce3da70b43 Initial load
duke
parents:
diff changeset
    27
.br
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    28
Binding Compiler
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    29
.LP
2692
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
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    33
\f3Reference Implementation (RI) Version:\fP 2.1.3
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    34
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
    35
.SH "Launching xjc"
90ce3da70b43 Initial load
duke
parents:
diff changeset
    36
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
    37
.LP
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    38
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
    39
.na
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    40
\f2using the XJC Ant task\fP @
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    41
.fi
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    42
https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.html.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    43
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
    44
.LP
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    45
\f2% xjc \-help\fP
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    46
.LP
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    47
.SS 
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    48
Output
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    49
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
    50
.nf
90ce3da70b43 Initial load
duke
parents:
diff changeset
    51
\f3
90ce3da70b43 Initial load
duke
parents:
diff changeset
    52
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    53
Usage: xjc [\-options ...] <schema file/URL/dir/jar> ... [\-b <bindinfo>] ...
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    54
.fl
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    55
If dir is specified, all schema files in it will be compiled.
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    56
.fl
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    57
If jar is specified, /META\-INF/sun\-jaxb.episode binding file will be compiled.
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    58
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
    59
Options:
90ce3da70b43 Initial load
duke
parents:
diff changeset
    60
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    61
  \-nv                :  do not perform strict validation of the input schema(s)
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    62
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    63
  \-extension         :  allow vendor extensions \- do not strictly follow the Compatibility Rules and App E.2 from the JAXB Spec
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    64
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    65
  \-b <file/dir>      :  specify external bindings files (each <file> must have its own \-b); if a directory is given, **/*.xjb is searched
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    66
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    67
  \-d <dir>           :  generated files will go into this directory
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    68
.fl
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    69
  \-p <pkg>           :  specifies the target package
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    70
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    71
  \-httpproxy <proxy> :  set HTTP/HTTPS proxy; format is [user[:password]@]proxyHost:proxyPort
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    72
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    73
  \-httpproxyfile <f> :  works like \-httpproxy but takes the argument in a file to protect password
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    74
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    75
  \-classpath <arg>   :  specify where to find user class files
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    76
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    77
  \-catalog <file>    :  specify catalog files to resolve external entity references; support TR9401, XCatalog, and OASIS XML Catalog format
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    78
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    79
  \-readOnly          :  generated files will be in read\-only mode
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    80
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    81
  \-npa               :  suppress generation of package level annotations (**/package\-info.java)
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    82
.fl
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    83
  \-no\-header         :  suppress generation of a file header with timestamp
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    84
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    85
  \-target 2.0        :  behave like XJC 2.0 and generate code that doesnt use any 2.1 features
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    86
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    87
  \-xmlschema         :  treat input as W3C XML Schema (default)
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    88
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    89
  \-relaxng           :  treat input as RELAX NG (experimental,unsupported)
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    90
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    91
  \-relaxng\-compact   :  treat input as RELAX NG compact syntax (experimental,unsupported)
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    92
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    93
  \-dtd               :  treat input as XML DTD (experimental,unsupported)
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    94
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    95
  \-wsdl              :  treat input as WSDL and compile schemas inside it (experimental,unsupported)
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    96
.fl
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    97
  \-verbose           :  be extra verbose
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
    98
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
    99
  \-quiet             :  suppress compiler output
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   100
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   101
  \-help              :  display this help message
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   102
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   103
  \-version           :  display version information
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   104
.fl
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   105
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   106
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   107
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   108
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   109
Extensions:
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   110
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   111
  \-Xlocator          :  enable source location support for generated code
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   112
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   113
  \-Xsync\-methods     :  generate accessor methods with the 'synchronized' keyword
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   114
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   115
  \-mark\-generated    :  mark the generated code as @javax.annotation.Generated
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   116
.fl
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   117
  \-episode <FILE>    :  generate the episode file for separate compilation
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   118
.fl
90ce3da70b43 Initial load
duke
parents:
diff changeset
   119
\fP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   120
.fi
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
.SH "OPTIONS"
90ce3da70b43 Initial load
duke
parents:
diff changeset
   124
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   125
.RS 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   126
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   127
\-nv 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   128
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
   129
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   130
\-extension 
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   131
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
   132
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   133
\-b <file> 
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   134
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: \f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings123.xjb\fP
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   135
.br
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   136
\f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings1.xjb \-b bindings2.xjb \-b bindings3.xjb\fP In addition, the ordering of the schema files and binding files on the command line does not matter. 
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   137
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   138
\-d <dir> 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   139
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
   140
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   141
\-p <pkg> 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   142
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
   143
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   144
\-httpproxy <proxy> 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   145
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
   146
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   147
\-httpproxyfile <file> 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   148
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
   149
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   150
\-classpath <arg> 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   151
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
   152
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   153
\-catalog <file> 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   154
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
   155
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   156
\-readOnly 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   157
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
   158
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   159
\-npa 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   160
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
   161
.TP 3
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   162
\-no\-header 
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   163
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
   164
.TP 3
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   165
\-target 2.0 
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   166
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
   167
.TP 3
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   168
\-xmlschema 
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   169
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
   170
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   171
\-relaxng 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   172
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
   173
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   174
\-relaxng\-compact 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   175
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
   176
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   177
\-dtd 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   178
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
   179
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   180
\-wsdl 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   181
Treat input as WSDL and compile schemas inside it (experimental,unsupported). 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   182
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   183
\-quiet 
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   184
Suppress compiler output, such as progress information and warnings. 
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   185
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   186
\-verbose 
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   187
Be extra verbose, such as printing informational messages or displaying stack traces upon some errors. 
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   188
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   189
\-help 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   190
Display a brief summary of the compiler switches. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   191
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   192
\-version 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   193
Display the compiler version information. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   194
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   195
<schema file/URL/dir> 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   196
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
   197
.RE
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   198
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   199
.LP
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   200
.SS 
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   201
Non\-Standard Command Line Options
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   202
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   203
.RS 3
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   204
.TP 3
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   205
\-Xlocator 
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   206
Causes the generated code to expose SAX Locator information about the source XML in the Java bean instances after unmarshalling. 
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   207
.TP 3
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   208
\-Xsync\-methods 
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   209
Causes all of the generated method signatures to include the \f2synchronized\fP keyword. 
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   210
.TP 3
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   211
\-mark\-generated 
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   212
Mark the generated code with the annotation \f2@javax.annotation.Generated\fP. 
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   213
.TP 3
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   214
\-episode <file> 
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   215
Generate the specified episode file for separate compilation. 
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   216
.RE
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   217
90ce3da70b43 Initial load
duke
parents:
diff changeset
   218
.LP
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   219
.SS 
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   220
Deprecated and Removed Command Line Options
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   221
.LP
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   222
.RS 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   223
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   224
\-host & \-port 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   225
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
   226
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   227
\-use\-runtime 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   228
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
   229
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   230
\-source 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   231
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
   232
.RE
90ce3da70b43 Initial load
duke
parents:
diff changeset
   233
90ce3da70b43 Initial load
duke
parents:
diff changeset
   234
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   235
.SS 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   236
Compiler Restrictions
90ce3da70b43 Initial load
duke
parents:
diff changeset
   237
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   238
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   239
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
   240
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   241
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   242
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
   243
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   244
.RS 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   245
.TP 2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   246
o
90ce3da70b43 Initial load
duke
parents:
diff changeset
   247
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
   248
.RS 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   249
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   250
1.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   251
The "\f2\-p\fP" command line option takes the highest precedence. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   252
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   253
2.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   254
<\f2jaxb:package\fP> customization 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   255
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   256
3.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   257
If \f2targetNamespace\fP is declared, apply \f2targetNamespace\fP \-> Java package name algorithm defined in the specification. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   258
.TP 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   259
4.
90ce3da70b43 Initial load
duke
parents:
diff changeset
   260
If no \f2targetNamespace\fP is declared, use a hardcoded package named "generated". 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   261
.RE
90ce3da70b43 Initial load
duke
parents:
diff changeset
   262
.TP 2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   263
o
90ce3da70b43 Initial load
duke
parents:
diff changeset
   264
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
   265
.TP 2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   266
o
90ce3da70b43 Initial load
duke
parents:
diff changeset
   267
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
   268
.TP 2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   269
o
90ce3da70b43 Initial load
duke
parents:
diff changeset
   270
Element substitution groups spread across multiple schema files must be compiled at the same time. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
   271
.RE
90ce3da70b43 Initial load
duke
parents:
diff changeset
   272
90ce3da70b43 Initial load
duke
parents:
diff changeset
   273
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   274
.SH "See Also"
90ce3da70b43 Initial load
duke
parents:
diff changeset
   275
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   276
.RS 3
90ce3da70b43 Initial load
duke
parents:
diff changeset
   277
.TP 2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   278
o
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   279
Running the binding compiler (XJC): [
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   280
.na
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   281
\f2command\-line instructions\fP @
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   282
.fi
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   283
https://jaxb.dev.java.net/nonav/2.1.3/docs/xjc.html, 
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   284
.na
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   285
\f2using the XJC Ant task\fP @
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   286
.fi
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   287
https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.html] 
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   288
.TP 2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   289
o
90ce3da70b43 Initial load
duke
parents:
diff changeset
   290
.na
2692
345bc8d65b19 6837214: Update JDK7 man pages
tbell
parents: 2
diff changeset
   291
\f2Java Architecture for XML Binding (JAXB)\fP @
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   292
.fi
9573
c02ff5a7c67b 7043684: Update man pages for JDK 7 tools
bpatel
parents: 5865
diff changeset
   293
http://download.oracle.com/javase/7/docs/technotes/guides/xml/jaxb/index.html 
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
   294
.RE
90ce3da70b43 Initial load
duke
parents:
diff changeset
   295
90ce3da70b43 Initial load
duke
parents:
diff changeset
   296
.LP
90ce3da70b43 Initial load
duke
parents:
diff changeset
   297