XMLEncoder (Java Platform SE 8 )

java.lang.Object
- java.beans.Encoder
- - java.beans.XMLEncoder

All Implemented Interfaces:

AutoCloseable
```
public class XMLEncoder
extends Encoder
implements AutoCloseable
```
的 XMLEncoder类是一个另类的 ObjectOutputStream可以用来生成， ObjectOutputStream可以用来创建对象的二进制表示 Serializable同样一个JavaBean的文本表示形式。例如，以下片段可以用来创建一个文本表示提供的JavaBean和它所有的特性：
```
xmlencoder E =新XMLEncoder（新的缓冲输出流（新的输出（“测试。XML”）））；e.writeobject（新JButton（“你好，世界”））；E（）；
```
尽管他们相似的API， XMLEncoder班是专为存档图的JavaBeans作为他们的公共属性的文本表示的目的。像java源文件，这样写的文件有一种天然的免疫变化的类的实现涉及。的 ObjectOutputStream继续被推荐用于进程间通信和通用的序列化。
的XMLEncoder类提供JavaBeans它们表示为XML文档符合XML规范的版本1和编码的Unicode / ISO 10646字符集UTF-8字符默认的外延。由XMLEncoder类生成的XML文档：
- 便携版的弹性：他们对任何类和私人实施无依赖性，喜欢java源文件，它们之间可以交换的环境中，可能会有一些类的不同版本和虚拟机之间，从不同的供应商。
- 结构紧凑：的XMLEncoder类使用冗余消除算法的内部，一个bean的属性的默认值是不写入到流。
- 容错：文件中的非结构错误，无论是由文件损坏或由文件的原料药的变化对类保持本地化，使读者可以报告的错误，并继续加载不受错误影响的文档的部分。
下面是一个包含来自挥杆工具包的一些用户界面组件的XML文档的例子：
```
<？xml version=“1”encoding=“utf-8”？>< java版本=“1”class=“java beans。xmldecoder”>
 
        
 
        
 
        
 
        

 
        
        
        
      
        
      <对象类=“javax.摆动。jframe”>
  
         
  
         
  
         
  
         
 
  
         
         
         
       
         
       <无效属性=“名称”> 
        <字符串> 
         <字符串>
           frame1 /< /空> 
          <无效属性=“界限”> 
           <对象类=“java awt，矩形”>
             < 0 > > < / int int< 0 > > < / int int< 200 > > < / int int< 200 > > < / int int< /对象>< /空> 
            <无效的财产=“contentpane”> 
             <无效方法=“添加”> 
              <对象类=“javax.摆动。jbutton”> 
               <无效属性=“标签”> 
                <字符串>
                  “你好” 
                 <字符串>
                   < /空>< /对象>< /空>< /空> 
                  <无效属性=“可见”> 
                   <布尔>
                     真< /布尔>< /空>< /对象>< / java > 
                    
                   
                  
                 
                
               
              
             
            
           
          
         
       
 
        
 
        
 
        
 
        

 
        
        
        
      
        
      
```
XML语法使用以下约定：
- 每个元素表示一个方法调用。
- “对象”标签表示一个表达式，该表达式的值将被用作封闭元素的参数。
- “无效”标签表示将要执行的语句，但其结果将不会作为封闭方法的参数使用。
- 包含元素的元素使用这些元素作为参数，除非它们有标记：“无效”。
- 该方法的名称由“方法”属性表示。
- XML是标准的“身份证”和“IDREF属性进行引用之前的表达式以便处理对象图中圆圈。
- “类”属性是用来指定一个静态方法或构造函数的目标，它的值是类的完全限定名称。
- 以“无效”标签的元素为目标，如果没有目标是由“类”属性定义的。
- java的String类的特殊处理，是写 <字符串> <字符串> /你好，世界在字符串中的字符转换为使用UTF-8字符编码的字节。
虽然所有的对象图可以使用只是这三个标签，下面的定义包括在内，使常见的数据结构可以更简洁地表达：
- 默认的方法名称是“新的”。
- 引用一个java类的形式写入 <类> javax.摆动。JButton < /班>。
- 对于java的原始数据类型的包装类的实例使用的原始类型作为标签的名称。例如，在Integer类的一个实例可以写： <国际> 123 < / int >。请注意， XMLEncoder类使用java反射包之间的转换java的基本类型及其关联的“包装类”是在内部处理。为 XMLEncoder阶级本身的API只涉及 Objects。
- 在代表一个无参的方法名字以“得”开始的一个元素，“法”属性与“财产”属性的值是通过去除“得到”的前缀和decapitalizing结果给予更换。
- 在一个元素代表一个单一方法的名字都以“套”、“法”属性与“财产”属性的值是通过删除“设置”前缀和decapitalizing结果给予更换。
- 在表示名为“获取”的方法的元素中的一个元素中，“方法”属性被一个值为第一个参数值的“索引”属性所取代。
- 在表示一个名为“集”的方法的元素中，第一个是一个整数，“方法”属性被一个值为第一个参数值的“索引”属性替换。
- 对一个数组的引用是使用“数组”标签的。“类”和“长度”属性指定数组的子类型和它的长度。
更多的信息，你也可能想看看Using XMLEncoder，在秋千上连接的一篇文章。
从以下版本开始：

一点四

另请参见：

XMLDecoder， ObjectOutputStream

构造方法摘要

构造方法
Constructor and Description
`XMLEncoder(OutputStream out)` 创建一个新的XML编码写出来的JavaBeans组件使用xml编码流 `out`。
`XMLEncoder(OutputStream out, String charset, boolean declaration, int indentation)` 创建一个新的XML编码写出来的JavaBeans的流 `out`使用给定的 `charset`从给定的 `indentation`。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`close()` 此方法调用 `flush`，将关闭后再关闭这个流相关的输出流。
`void`	`flush()` 这种方法写出来的如果不是已经写好并写出所有的价值观，是自从上次 `flush`被称为流用XML编码相关的序言。
`Object`	`getOwner()` 获取此编码器的所有者。
`void`	`setOwner(Object owner)` 设置此编码器的业主 `owner`。
`void`	`writeExpression(Expression oldExp)` 记录表达式，以便在刷新流时，编码器将产生实际输出。
`void`	`writeObject(Object o)` 将指定对象的XML表示形式写入输出。
`void`	`writeStatement(Statement oldStm)` 记录语句，以便在刷新流时，编码器将产生实际输出。

Methods inherited from class java.beans.Encoder
get, getExceptionListener, getPersistenceDelegate, remove, setExceptionListener, setPersistenceDelegate

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - XMLEncoder
```
public XMLEncoder(OutputStream out)
```
    创建一个新的XML编码写出来的JavaBeans组件使用xml编码流 out。
    
    参数
    
    out -流对象的XML表示形式将写
    
    异常
    
    如果是 null out IllegalArgumentException
    
    另请参见：
    
    XMLDecoder.XMLDecoder(InputStream)
  - XMLEncoder
```
public XMLEncoder(OutputStream out,
                  String charset,
                  boolean declaration,
                  int indentation)
```
    创建一个新的XML编码写出来的JavaBeans的流 out使用给定的 charset从给定的 indentation。
    
    参数
    
    out -流对象的XML表示形式将写
    
    charset -请求的字符集的名称；可以是一个名称或别名
    
    declaration无论XML声明应该产生；这个设置 false当嵌入另一个XML文档的内容
    
    indentation -空格字符数缩进整个XML文档
    
    异常
    
    IllegalArgumentException -如果 out或 charset是 null，或者如果 indentation小于0
    
    IllegalCharsetNameException -如果 charset名称是非法的
    
    UnsupportedCharsetException -如果不支持指定的字符中的java虚拟机实例是可用的
    
    UnsupportedOperationException如果加载字符集不支持编码
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    Charset.forName(String)
- 方法详细信息
  - setOwner
```
public void setOwner(Object owner)
```
    设置此编码器的业主 owner。
    
    参数
    
    owner -此编码器的主人。
    
    另请参见：
    
    getOwner()
  - getOwner
```
public Object getOwner()
```
    获取此编码器的所有者。
    
    结果
    
    该编码器的所有者。
    
    另请参见：
    
    setOwner(java.lang.Object)
  - writeObject
```
public void writeObject(Object o)
```
    将指定对象的XML表示形式写入输出。
    
    重写：
    
    writeObject 方法重写，继承类 Encoder
    
    参数
    
    o -要写入流对象。
    
    另请参见：
    
    XMLDecoder.readObject()
  - writeStatement
```
public void writeStatement(Statement oldStm)
```
    记录语句，以便在刷新流时，编码器将产生实际输出。
    此方法只能在初始化调用持久委托的上下文。
    
    重写：
    
    writeStatement 方法重写，继承类 Encoder
    
    参数
    
    oldStm的语句将被写入到流。
    
    另请参见：
    
    PersistenceDelegate.initialize(java.lang.Class<?>, java.lang.Object, java.lang.Object, java.beans.Encoder)
  - writeExpression
```
public void writeExpression(Expression oldExp)
```
    记录表达式，以便在刷新流时，编码器将产生实际输出。
    此方法只能在初始化调用持久委托或设置编码器从资源束阅读语境。
    
    有关使用资源包的xmlencoder，更多信息请参阅HTTP：/ / java。太阳。COM /产品/ JFC / TSC /文章/坚持到底的精神/ # i18n
    
    重写：
    
    writeExpression 方法重写，继承类 Encoder
    
    参数
    
    oldExp的表达，将写入到流。
    
    另请参见：
    
    PersistenceDelegate.initialize(java.lang.Class<?>, java.lang.Object, java.lang.Object, java.beans.Encoder)
  - flush
```
public void flush()
```
    这种方法写出来的如果不是已经写好并写出所有的价值观，是自从上次 flush被称为流用XML编码相关的序言。冲洗后，所有写入到该流的值的内部引用都被清除。
  - close
```
public void close()
```
    此方法调用 flush，将关闭后再关闭这个流相关的输出流。
    
    Specified by:
    
    close 接口 AutoCloseable

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class XMLEncoder

构造方法摘要

方法摘要

Methods inherited from class java.beans.Encoder

Methods inherited from class java.lang.Object

Constructor Detail

XMLEncoder

XMLEncoder

方法详细信息

setOwner

getOwner

writeObject

writeStatement

writeExpression

flush

close