java.lang.Object javax.xml.transform.OutputKeys
public class OutputKeys
提供可用于设置 Transformer 的输出属性或从 Transformer 或 Templates 对象检索输出属性的字符串常量。
此类中的所有字段均为只读的。
字段摘要 | |
---|---|
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 是否可以添加额外的空白;其值必须为 yes 或 no 。 |
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 声明,其值必须为 yes 或 no 。 |
static String |
STANDALONE standalone = "yes" | "no". standalone 指定了 Transformer 是否应输出单独的文档声明,其值必须为 yes 或 no 。 |
static String |
VERSION version = nmtoken. version 指定了输出方法的版本。 |
方法摘要 |
---|
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
字段详细信息 |
---|
public static final String METHOD
方法属性的值标识了应用于输出结果树的总体方法。可以使用其他非名称空间的值,例如 "xhtml",但如果接受的话,这样的值的处理是由实现定义的。如果不接受任何方法值,或方法值不是名称空间限定的,则 Transformer.setOutputProperty(java.lang.String, java.lang.String)
或 Transformer.setOutputProperties(java.util.Properties)
将抛出 IllegalArgumentException
。
public static final String VERSION
version
指定了输出方法的版本。
当输出方法为 "xml" 时,版本值指定了要用于输出结果树的 XML 的版本。xml 输出方法的默认值为 1.0。当输出方法为 "html" 时,版本值指示了 HTML 的版本。xml 输出方法的置信值为 4.0,它指定了结果应以遵守 HTML 4.0 Recommendation [HTML] 的 HTML 格式输出。如果输出方法为 "text",则忽略版本属性。
public static final String ENCODING
encoding
指定了首选的字符编码,Transformer 应使用此编码将字符序列编码作为字节序列进行编码。编码属性值应是不区分大小写的。该值必须只包含 #x21 到 #x7E(即可打印的 ASCII 字符)范围内的字符。值要么为 Internet Assigned Numbers Authority [IANA], [RFC2278] 中注册的 charset
,要么以 X-
开头。
public static final String OMIT_XML_DECLARATION
omit-xml-declaration
指定了 XSLT 处理器是否应输出 XML 声明,其值必须为 yes
或 no
。
public static final String STANDALONE
standalone
指定了 Transformer 是否应输出单独的文档声明,其值必须为 yes
或 no
。
public static final String DOCTYPE_PUBLIC
有关关键值应为何值的描述,请参阅 DOCTYPE_SYSTEM
属性文档。
public static final String DOCTYPE_SYSTEM
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
指定了要在文档类型声明中使用的系统标识符。
public static final String CDATA_SECTION_ELEMENTS
cdata-section-elements
指定了由空白分隔的元素名称列表,其中的文本节点子级应使用 CDATA 部分来输出。注意这些名称必须使用 javax.xml.transform
的 Qualfied Name Representation 节中描述的格式。
public static final String INDENT
indent
指定了当输出结果树时,Transformer 是否可以添加额外的空白;其值必须为 yes
或 no
。
public static final String MEDIA_TYPE
media-type
指定了输出结果树得到的数据的介质类型(MIME 内容类型)。不应显式指定charset
参数;相反,当顶层介质类型为 text
时,应根据输出方法实际使用的字符编码来添加 charset
参数。