diff -r 16ba58282d11 -r a754d69d5e60 jaxp/src/share/classes/javax/xml/transform/OutputKeys.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/jaxp/src/share/classes/javax/xml/transform/OutputKeys.java Sun Mar 04 11:55:34 2012 -0800 @@ -0,0 +1,200 @@ +/* + * Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved. + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * This code is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License version 2 only, as + * published by the Free Software Foundation. Oracle designates this + * particular file as subject to the "Classpath" exception as provided + * by Oracle in the LICENSE file that accompanied this code. + * + * This code is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License + * version 2 for more details (a copy is included in the LICENSE file that + * accompanied this code). + * + * You should have received a copy of the GNU General Public License version + * 2 along with this work; if not, write to the Free Software Foundation, + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. + * + * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA + * or visit www.oracle.com if you need additional information or have any + * questions. + */ + +package javax.xml.transform; + +/** + * Provides string constants that can be used to set + * output properties for a Transformer, or to retrieve + * output properties from a Transformer or Templates object. + *
All the fields in this class are read-only.
+ * + * @see + * section 16 of the XSL Transformations (XSLT) W3C Recommendation + */ +public class OutputKeys { + + /** + * Default constructor is private on purpose. This class is + * only for static variable access, and should never be constructed. + */ + private OutputKeys() { } + + /** + * method = "xml" | "html" | "text" | expanded name. + * + *The value of the method property identifies the overall method that + * should be used for outputting the result tree. Other non-namespaced + * values may be used, such as "xhtml", but, if accepted, the handling + * of such values is implementation defined. If any of the method values + * are not accepted and are not namespace qualified, + * then {@link javax.xml.transform.Transformer#setOutputProperty} + * or {@link javax.xml.transform.Transformer#setOutputProperties} will + * throw a {@link java.lang.IllegalArgumentException}.
+ * + * @see + * section 16 of the XSL Transformations (XSLT) W3C Recommendation + */ + public static final String METHOD = "method"; + + /** + * version = nmtoken. + * + *version
specifies the version of the output
+ * method.
When the output method is "xml", the version value specifies the + * version of XML to be used for outputting the result tree. The default + * value for the xml output method is 1.0. When the output method is + * "html", the version value indicates the version of the HTML. + * The default value for the xml output method is 4.0, which specifies + * that the result should be output as HTML conforming to the HTML 4.0 + * Recommendation [HTML]. If the output method is "text", the version + * property is ignored.
+ * @see + * section 16 of the XSL Transformations (XSLT) W3C Recommendation + */ + public static final String VERSION = "version"; + + /** + * encoding = string. + * + *encoding
specifies the preferred character
+ * encoding that the Transformer should use to encode sequences of
+ * characters as sequences of bytes. The value of the encoding property should be
+ * treated case-insensitively. The value must only contain characters in
+ * the range #x21 to #x7E (i.e., printable ASCII characters). The value
+ * should either be a charset
registered with the Internet
+ * Assigned Numbers Authority [IANA],
+ * [RFC2278]
+ * or start with X-
.
omit-xml-declaration
specifies whether the XSLT
+ * processor should output an XML declaration; the value must be
+ * yes
or no
.
standalone
specifies whether the Transformer
+ * should output a standalone document declaration; the value must be
+ * yes
or no
.
See the documentation for the {@link #DOCTYPE_SYSTEM} property + * for a description of what the value of the key should be.
+ * + * @see + * section 16 of the XSL Transformations (XSLT) W3C Recommendation + */ + public static final String DOCTYPE_PUBLIC = "doctype-public"; + + /** + * doctype-system = string. + *doctype-system
specifies the system identifier
+ * to be used in the document type declaration.
If the doctype-system property is specified, the xml output method + * should output a document type declaration immediately before the first + * element. The name following <!DOCTYPE should be the name of the first + * element. If doctype-public property is also specified, then the xml + * output method should output PUBLIC followed by the public identifier + * and then the system identifier; otherwise, it should output SYSTEM + * followed by the system identifier. The internal subset should be empty. + * The value of the doctype-public property should be ignored unless the doctype-system + * property is specified.
+ *If the doctype-public or doctype-system properties are specified, + * then the html output method should output a document type declaration + * immediately before the first element. The name following <!DOCTYPE + * should be HTML or html. If the doctype-public property is specified, + * then the output method should output PUBLIC followed by the specified + * public identifier; if the doctype-system property is also specified, + * it should also output the specified system identifier following the + * public identifier. If the doctype-system property is specified but + * the doctype-public property is not specified, then the output method + * should output SYSTEM followed by the specified system identifier.
+ * + *doctype-system
specifies the system identifier
+ * to be used in the document type declaration.
cdata-section-elements
specifies a whitespace delimited
+ * list of the names of elements whose text node children should be output
+ * using CDATA sections. Note that these names must use the format
+ * described in the section Qualfied Name Representation in
+ * {@link javax.xml.transform}.
indent
specifies whether the Transformer may
+ * add additional whitespace when outputting the result tree; the value
+ * must be yes
or no
.
media-type
specifies the media type (MIME
+ * content type) of the data that results from outputting the result
+ * tree. The charset
parameter should not be specified
+ * explicitly; instead, when the top-level media type is
+ * text
, a charset
parameter should be added
+ * according to the character encoding actually used by the output
+ * method.