/* * 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-.

* @see * section 16 of the XSL Transformations (XSLT) W3C Recommendation */ public static final String ENCODING = "encoding"; /** * omit-xml-declaration = "yes" | "no". * *

omit-xml-declaration specifies whether the XSLT * processor should output an XML declaration; the value must be * yes or no.

* @see * section 16 of the XSL Transformations (XSLT) W3C Recommendation */ public static final String OMIT_XML_DECLARATION = "omit-xml-declaration"; /** * standalone = "yes" | "no". * *

standalone specifies whether the Transformer * should output a standalone document declaration; the value must be * yes or no.

* @see * section 16 of the XSL Transformations (XSLT) W3C Recommendation */ public static final String STANDALONE = "standalone"; /** * doctype-public = string. *

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.

* @see * section 16 of the XSL Transformations (XSLT) W3C Recommendation */ public static final String DOCTYPE_SYSTEM = "doctype-system"; /** * cdata-section-elements = expanded names. * *

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}.

* * @see * section 16 of the XSL Transformations (XSLT) W3C Recommendation. */ public static final String CDATA_SECTION_ELEMENTS = "cdata-section-elements"; /** * indent = "yes" | "no". * *

indent specifies whether the Transformer may * add additional whitespace when outputting the result tree; the value * must be yes or no.

* @see * section 16 of the XSL Transformations (XSLT) W3C Recommendation */ public static final String INDENT = "indent"; /** * media-type = string. * *

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.

* @see s * ection 16 of the XSL Transformations (XSLT) W3C Recommendation */ public static final String MEDIA_TYPE = "media-type"; }