JavaTM 2 Platform
Std. Ed. v1.4.2

javax.xml.transform
Class OutputKeys

java.lang.Object
  extended byjavax.xml.transform.OutputKeys

public class OutputKeys
extends Object

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.

A properties in this class are read-only.

See Also:
section 16 of the XSL Transformations (XSLT) W3C Recommendation

Field Summary
static String CDATA_SECTION_ELEMENTS
          cdata-section-elements = expanded names.
static String DOCTYPE_PUBLIC
          doctype-public = string.
static String DOCTYPE_SYSTEM
          doctype-system = string.
static String ENCODING
          encoding = string.
static String INDENT
          indent = "yes" | "no".
static String MEDIA_TYPE
          media-type = string.
static String METHOD
          method = "xml" | "html" | "text" | expanded name.
static String OMIT_XML_DECLARATION
          omit-xml-declaration = "yes" | "no".
static String STANDALONE
          standalone = "yes" | "no".
static String VERSION
          version = nmtoken.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

METHOD

public static final String METHOD
method = "xml" | "html" | "text" | expanded name.

The method attribute 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 Transformer.setOutputProperty(java.lang.String, java.lang.String) or Transformer.setOutputProperties(java.util.Properties) will throw a IllegalArgumentException.

See Also:
section 16 of the XSL Transformations (XSLT) W3C Recommendation, Constant Field Values

VERSION

public static final String VERSION
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 Also:
section 16 of the XSL Transformations (XSLT) W3C Recommendation, Constant Field Values

ENCODING

public static final String ENCODING
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 attribute 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 Also:
section 16 of the XSL Transformations (XSLT) W3C Recommendation, Constant Field Values

OMIT_XML_DECLARATION

public static final String OMIT_XML_DECLARATION
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 Also:
section 16 of the XSL Transformations (XSLT) W3C Recommendation, Constant Field Values

STANDALONE

public static final String STANDALONE
standalone = "yes" | "no".

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

See Also:
section 16 of the XSL Transformations (XSLT) W3C Recommendation, Constant Field Values

DOCTYPE_PUBLIC

public static final String DOCTYPE_PUBLIC
doctype-public = string.

See the documentation for the DOCTYPE_SYSTEM property for a description of what the value of the key should be.

See Also:
section 16 of the XSL Transformations (XSLT) W3C Recommendation, Constant Field Values

DOCTYPE_SYSTEM

public static final String DOCTYPE_SYSTEM
doctype-system = string.

doctype-public specifies the public 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 doctype-public attribute should be ignored unless the doctype-system attribute is specified.

If the doctype-public or doctype-system attributes 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 attribute is specified, then the output method should output PUBLIC followed by the specified public identifier; if the doctype-system attribute is also specified, it should also output the specified system identifier following the public identifier. If the doctype-system attribute is specified but the doctype-public attribute 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 Also:
section 16 of the XSL Transformations (XSLT) W3C Recommendation, Constant Field Values

CDATA_SECTION_ELEMENTS

public static final String CDATA_SECTION_ELEMENTS
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.

See Also:
section 16 of the XSL Transformations (XSLT) W3C Recommendation., Constant Field Values

INDENT

public static final String INDENT
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 Also:
section 16 of the XSL Transformations (XSLT) W3C Recommendation, Constant Field Values

MEDIA_TYPE

public static final String MEDIA_TYPE
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 Also:
section 16 of the XSL Transformations (XSLT) W3C Recommendation, Constant Field Values

JavaTM 2 Platform
Std. Ed. v1.4.2

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.