JavaTM Platform
Standard Ed. 6

javax.xml.transform
类 OutputKeys

java.lang.Object
  继承者 javax.xml.transform.OutputKeys

public class OutputKeys
     
extends Object

提供可用于设置 Transformer 的输出属性或从 Transformer 或 Templates 对象检索输出属性的字符串常量。

此类中的所有字段均为只读的。

另请参见:
XSL Transformations (XSLT) W3C Recommendation 的第 16 小节

字段摘要
static String CDATA_SECTION_ELEMENTS
          cdata-section-elements = expanded names. cdata-section-elements 指定了由空白分隔的元素名称列表,其中的文本节点子级应使用 CDATA 部分来输出。
static String DOCTYPE_PUBLIC
          doctype-public = string. 有关关键值应为何值的描述,请参阅 DOCTYPE_SYSTEM 属性文档。
static String DOCTYPE_SYSTEM
          doctype-system = string. doctype-system 指定了要在文档类型声明中使用的系统标识符。
static String ENCODING
          encoding = string. encoding 指定了首选的字符编码,Transformer 应使用此编码将字符序列编码作为字节序列进行编码。
static String INDENT
          indent = "yes" | "no". indent 指定了当输出结果树时,Transformer 是否可以添加额外的空白;其值必须为 yesno
static String MEDIA_TYPE
          media-type = string. media-type 指定了输出结果树得到的数据的介质类型(MIME 内容类型)。
static String METHOD
          method = "xml" | "html" | "text" | expanded name
static String OMIT_XML_DECLARATION
          omit-xml-declaration = "yes" | "no". omit-xml-declaration 指定了 XSLT 处理器是否应输出 XML 声明,其值必须为 yesno
static String STANDALONE
          standalone = "yes" | "no". standalone 指定了 Transformer 是否应输出单独的文档声明,其值必须为 yesno
static String VERSION
          version = nmtoken. version 指定了输出方法的版本。
 
方法摘要
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

字段详细信息

METHOD

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

方法属性的值标识了应用于输出结果树的总体方法。可以使用其他非名称空间的值,例如 "xhtml",但如果接受的话,这样的值的处理是由实现定义的。如果不接受任何方法值,或方法值不是名称空间限定的,则 Transformer.setOutputProperty(java.lang.String, java.lang.String)Transformer.setOutputProperties(java.util.Properties) 将抛出 IllegalArgumentException

另请参见:
XSL Transformations (XSLT) W3C Recommendation 的第 16 小节, 常量字段值

VERSION

public static final String VERSION
version = nmtoken.

version 指定了输出方法的版本。

当输出方法为 "xml" 时,版本值指定了要用于输出结果树的 XML 的版本。xml 输出方法的默认值为 1.0。当输出方法为 "html" 时,版本值指示了 HTML 的版本。xml 输出方法的置信值为 4.0,它指定了结果应以遵守 HTML 4.0 Recommendation [HTML] 的 HTML 格式输出。如果输出方法为 "text",则忽略版本属性。

另请参见:
XSL Transformations (XSLT) W3C Recommendation 的第 16 小节, 常量字段值

ENCODING

public static final String ENCODING
encoding = string.

encoding 指定了首选的字符编码,Transformer 应使用此编码将字符序列编码作为字节序列进行编码。编码属性值应是不区分大小写的。该值必须只包含 #x21 到 #x7E(即可打印的 ASCII 字符)范围内的字符。值要么为 Internet Assigned Numbers Authority [IANA], [RFC2278] 中注册的 charset,要么以 X- 开头。

另请参见:
XSL Transformations (XSLT) W3C Recommendation 的第 16 小节, 常量字段值

OMIT_XML_DECLARATION

public static final String OMIT_XML_DECLARATION
omit-xml-declaration = "yes" | "no".

omit-xml-declaration 指定了 XSLT 处理器是否应输出 XML 声明,其值必须为 yesno

另请参见:
XSL Transformations (XSLT) W3C Recommendation 的第 16 小节, 常量字段值

STANDALONE

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

standalone 指定了 Transformer 是否应输出单独的文档声明,其值必须为 yesno

另请参见:
XSL Transformations (XSLT) W3C Recommendation 的第 16 小节, 常量字段值

DOCTYPE_PUBLIC

public static final String DOCTYPE_PUBLIC
doctype-public = string.

有关关键值应为何值的描述,请参阅 DOCTYPE_SYSTEM 属性文档。

另请参见:
XSL Transformations (XSLT) W3C Recommendation 的第 16 小节, 常量字段值

DOCTYPE_SYSTEM

public static final String DOCTYPE_SYSTEM
doctype-system = string.

doctype-system 指定了要在文档类型声明中使用的系统标识符。

如果指定了 doctype-system 属性,则 xml 输出方法应在首个元素的正前面输出文档类型声明。紧跟 <!DOCTYPE 后面的名称应为第一个元素的名称。如果还指定了 doctype-public 属性,则 xml 输出方法应输出 PUBLIC,后跟公共标识符,再后跟系统标识符,否则,它应输出 SYSTEM,后跟系统标识符。内部子集应为空。如果没有指定 doctype-system 属性,则应忽略 doctype-public 属性值。

如果指定了 doctype-public 或 doctype-system 属性,则 html 输出方法应在第一个元素的正前面输出文档类型声明。紧跟 <!DOCTYPE 后面的名称应为 HTML 或 html。如果指定了 doctype-public 属性,则输出方法应输出 PUBLIC,后跟指定的公共标识符;如果还指定了 doctype-system 属性,则它还应在公共标识符后面输出指定的系统标识符。如果指定了 doctype-system 属性但未指定 doctype-public 属性,则输出方法应输出 SYSTEM,后跟指定的系统标识符。

doctype-system 指定了要在文档类型声明中使用的系统标识符。

另请参见:
XSL Transformations (XSLT) W3C Recommendation 的第 16 小节, 常量字段值

CDATA_SECTION_ELEMENTS

public static final String CDATA_SECTION_ELEMENTS
cdata-section-elements = expanded names.

cdata-section-elements 指定了由空白分隔的元素名称列表,其中的文本节点子级应使用 CDATA 部分来输出。注意这些名称必须使用 javax.xml.transform 的 Qualfied Name Representation 节中描述的格式。

另请参见:
XSL Transformations (XSLT) W3C Recommendation 的第 16 小节., 常量字段值

INDENT

public static final String INDENT
indent = "yes" | "no".

indent 指定了当输出结果树时,Transformer 是否可以添加额外的空白;其值必须为 yesno

另请参见:
XSL Transformations (XSLT) W3C Recommendation 的第 16 小节, 常量字段值

MEDIA_TYPE

public static final String MEDIA_TYPE
media-type = string.

media-type 指定了输出结果树得到的数据的介质类型(MIME 内容类型)。不应显式指定charset 参数;相反,当顶层介质类型为 text 时,应根据输出方法实际使用的字符编码来添加 charset 参数。

另请参见:
s ection 16 of the XSL Transformations (XSLT) W3C Recommendation, 常量字段值

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策