290.9. IDoc 的 XML Serialization

概述

IDoc 消息正文可以序列化为 XML 字符串格式，并提供内置类型转换器的帮助。

XML 命名空间

每个序列化 IDoc 均与 XML 命名空间关联，其格式为以下通用格式： 

http://sap.fusesource.org/idoc/repositoryName/idocType/idocTypeExtension/systemRelease/applicationRelease

repositoryName （远程 SAP meta-data 存储库的名称）和 idocType (IDoc 文档类型)是必需的，但命名空间的其他组件可以留空。例如，您可以有一个类似以下的 XML 命名空间： 

http://sap.fusesource.org/idoc/MY_REPO/FLCUSTOMER_CREATEFROMDATA01///

内置类型转换器

Camel SAP 组件具有一个内置类型转换器，它能够将 Document 对象或 DocumentList 对象转换为 String 类型。

例如，要将 Document 对象序列化为 XML 字符串，您只需向 XML DSL 中的路由中添加以下行： 

<convertBodyTo type="java.lang.String"/>

您还可以使用此方法将 XML 消息序列化为 Document 对象。例如，假设当前消息正文是一个序列化 XML 字符串，您可以通过将以下行添加到 XML DSL 中的路由将其重新转换为 Document 对象： 

<convertBodyTo type="org.fusesource.camel.component.sap.model.idoc.Document"/>

XML 格式的 IDoc 消息正文示例

当您将 IDoc 消息转换为 字符串 时，它将被序列化为 XML 文档，其中 root 元素是 idoc:Document （表示单个文档）或 idoc:DocumentList （文档列表）。例 290.2 “IDoc Message Body in XML” 显示一个 IDoc 文档，已序列化为 idoc:Document 元素。

例 290.2. IDoc Message Body in XML

<?xml version="1.0" encoding="ASCII"?>
<idoc:Document
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:FLCUSTOMER_CREATEFROMDATA01---="http://sap.fusesource.org/idoc/XXX/FLCUSTOMER_CREATEFROMDATA01///"
    xmlns:idoc="http://sap.fusesource.org/idoc"
    creationDate="2015-01-28T12:39:13.980-0500"
    creationTime="2015-01-28T12:39:13.980-0500"
    iDocType="FLCUSTOMER_CREATEFROMDATA01"
    iDocTypeExtension=""
    messageType="FLCUSTOMER_CREATEFROMDATA"
    recipientPartnerNumber="QUICKCLNT"
    recipientPartnerType="LS"
    senderPartnerNumber="QUICKSTART"
    senderPartnerType="LS">
  <rootSegment xsi:type="FLCUSTOMER_CREATEFROMDATA01---:ROOT" document="/">
    <segmentChildren parent="//@rootSegment">
      <E1SCU_CRE parent="//@rootSegment" document="/">
        <segmentChildren parent="//@rootSegment/@segmentChildren/@E1SCU_CRE.0">
          <E1BPSCUNEW parent="//@rootSegment/@segmentChildren/@E1SCU_CRE.0"
              document="/"
              CUSTNAME="Fred Flintstone" FORM="Mr."
              STREET="123 Rubble Lane"
              POSTCODE="01234"
              CITY="Bedrock"
              COUNTR="US"
              PHONE="800-555-1212"
              EMAIL="fred@bedrock.com"
              CUSTTYPE="P"
              DISCOUNT="005"
              LANGU="E"/>
        </segmentChildren>
      </E1SCU_CRE>
    </segmentChildren>
  </rootSegment>
</idoc:Document>