289.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 （文档列表）。例 289.2 “IDoc Message Body in XML” 显示一个 IDoc 文档，已序列化为 idoc:Document 元素。
例 289.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>