290.12. RFC 的 XML Serialization

SAP 请求和响应对象支持 XML 序列化格式，从而使这些对象可以序列化至 XML 文档。

每个软件仓库中的 RFC 都定义了特定的 XML 命名空间，用于编写其 Request 和 Response 对象的序列化形式。此命名空间 URL 的形式如下：

http://sap.fusesource.org/rfc/<Repository Name>/<RFC Name>

RFC 命名空间 URL 具有通用 http://sap.fusesource.org/rfc 前缀，后跟定义 RFC 元数据的存储库的名称。URL 中的最后一个组件是 RFC 本身的名称。

SAP 请求对象使用名为 Request 的 root 元素序列化为 XML 文档，并由请求的 RFC 的命名空间的范围。

<?xml version="1.0" encoding="ASCII"?>
<BOOK_FLIGHT:Request
     xmlns:BOOK_FLIGHT="http://sap.fusesource.org/rfc/nplServer/BOOK_FLIGHT">
    ...
</BOOK_FLIGHT:Request>

SAP 响应对象使用名为 Response 的 root 元素序列化为 XML 文档，并由响应的 RFC 的命名空间限定。

<?xml version="1.0" encoding="ASCII"?>
<BOOK_FLIGHT:Response
     xmlns:BOOK_FLIGHT="http://sap.fusesource.org/rfc/nplServer/BOOK_FLIGHT">
    ...
</BOOK_FLIGHT:Response>

参数列表或嵌套结构中的结构字段被序列化为元素。序列化结构的元素名称对应于它所驻留的参数列表、结构或表行中的结构的字段名称。

<BOOK_FLIGHT:FLTINFO
     xmlns:BOOK_FLIGHT="http://sap.fusesource.org/rfc/nplServer/BOOK_FLIGHT">
    ...
</BOOK_FLIGHT:FLTINFO>

<xs:schema
     targetNamespace="http://sap.fusesource.org/rfc/nplServer/BOOK_FLIGHT">
     xmlns:xs="http://www.w3.org/2001/XMLSchema">
    ...
    <xs:complexType name="FLTINFO_STRUCTURE”>
    ...
    </xs:complexType>
    ...
</xs:schema>

在指定 JAXB bean to marshal 和 unmarshal the 结构时，这种区别很重要，如 第 290.14.3 节 “示例 3：从 SAP 处理请求” 中所示。

参数列表或嵌套结构中的表字段作为元素序列化。序列化结构的元素名称对应于它所驻留的参数列表、结构或表行中的表的字段名称。table 元素包含一系列行元素，用于保存表行条目的序列化值。

<BOOK_FLIGHT:CONNINFO
     xmlns:BOOK_FLIGHT="http://sap.fusesource.org/rfc/nplServer/BOOK_FLIGHT">
    <row ... > ... </row>
    ...
    <row ... > ... </row>
</BOOK_FLIGHT:CONNINFO>

<xs:schema
     targetNamespace="http://sap.fusesource.org/rfc/nplServer/BOOK_FLIGHT"
     xmlns:xs="http://www.w3.org/2001/XMLSchema">
    ...
    <xs:complextType name="CONNECTION_INFO_STRUCTURE_TABLE”>
        <xs:sequence>
            <xs:element
                name="row”
                minOccures="0”
                maxOccurs="unbounded”
                type="CONNECTION_INFO_STRUCTURE”/>
            ...
            <xs:sequence>
        </xs:sequence>
    </xs:complexType>

    <xs:complextType name="CONNECTION_INFO_STRUCTURE”>
            ...
    </xs:complexType>
    ...
</xs:schema>

在指定 JAXB bean to marshal 和 unmarshal the 结构时，这种区别很重要，如 第 290.14.3 节 “示例 3：从 SAP 处理请求” 中所示。

参数列表或嵌套结构中的 Elementary 字段被序列化为封闭参数列表或结构元素的属性。serialized 字段的属性名称对应于它所在的参数列表、结构或表行条目中字段的字段名称，如下例所示：

<?xml version="1.0" encoding="ASCII"?>
<BOOK_FLIGHT:Request
     xmlns:BOOK_FLIGHT="http://sap.fusesource.org/rfc/nplServer/BOOK_FLIGHT"
     CUSTNAME="James Legrand"
    PASSFORM="Mr"
    PASSNAME="Travelin Joe"
    PASSBIRTH="1990-03-17T00:00:00.000-0500"
    FLIGHTDATE="2014-03-19T00:00:00.000-0400"
    TRAVELAGENCYNUMBER="00000110"
    DESTINATION_FROM="SFO"
    DESTINATION_TO="FRA"/>

日期和时间字段使用以下格式序列化为属性值：

yyyy-MM-dd'T'HH:mm:ss.SSSZ

日期字段只对年、月、天和时区组件进行了序列化：

DEPDATE="2014-03-19T00:00:00.000-0400"

时间字段只序列化为小时、分钟、第二个、millisecond 和 timezone 组件设置：

DEPTIME="1970-01-01T16:00:00.000-0500"