290.6. 配置

SAP 组件维护三个映射，以存储目标数据、服务器数据和存储库数据。组件的属性 destinationDataStore 存储目标数据，按目标名称密钥。属性 serverDataStore 存储按服务器名称密钥的服务器数据。属性 repositoryDataStore 存储按存储库名称密钥的存储库数据。您必须在初始化过程中将这些配置传递给组件。

以下示例演示了如何在 Blueprint XML 文件中配置示例目标数据存储和示例服务器数据存储。sap-configuration bean （类型为 SapConnectionConfiguration）会自动注入到此 XML 文件中使用的任何 SAP 组件中。

<?xml version="1.0" encoding="UTF-8"?>
<blueprint ... >
    ...
    <!-- Configures the Inbound and Outbound SAP Connections -->
    <bean id="sap-configuration"
        class="org.fusesource.camel.component.sap.SapConnectionConfiguration">
        <property name="destinationDataStore">
            <map>
                <entry key="quickstartDest" value-ref="quickstartDestinationData" />
            </map>
        </property>
        <property name="serverDataStore">
            <map>
                <entry key="quickstartServer" value-ref="quickstartServerData" />
            </map>
        </property>
    </bean>

    <!-- Configures an Outbound SAP Connection -->
    <!-- *** Please enter the connection property values for your environment *** -->
    <bean id="quickstartDestinationData"
        class="org.fusesource.camel.component.sap.model.rfc.impl.DestinationDataImpl">
        <property name="ashost" value="example.com" />
        <property name="sysnr" value="00" />
        <property name="client" value="000" />
        <property name="user" value="username" />
        <property name="passwd" value="passowrd" />
        <property name="lang" value="en" />
    </bean>

    <!-- Configures an Inbound SAP Connection -->
    <!-- *** Please enter the connection property values for your environment ** -->
    <bean id="quickstartServerData"
        class="org.fusesource.camel.component.sap.model.rfc.impl.ServerDataImpl">
        <property name="gwhost" value="example.com" />
        <property name="gwserv" value="3300" />
        <!-- Do not change the following property values -->
        <property name="progid" value="QUICKSTART" />
        <property name="repositoryDestination" value="quickstartDest" />
        <property name="connectionCount" value="2" />
    </bean>
</blueprint>

目的地的配置在 SAP 组件的 destinationDataStore 属性中维护。此映射中的每个条目都配置与 SAP 实例不同的出站连接。每个条目的键是出站连接的名称，并在目标端点 URI 的 destinationName 组件中使用，如 URI 格式部分所述。

每个条目的值都是目标数据配置对象 - org.fusesource.camel.component.sap.model.rfc.impl.DestinationDataImpl -，用于指定出站 SAP 连接的配置。

以下蓝图 XML 代码演示了如何使用名称 QuickstartDest 配置示例目的地。

<?xml version="1.0" encoding="UTF-8"?>
<blueprint ... >
    ...
    <!-- Create interceptor to support tRFC processing -->
    <bean id="currentProcessorDefinitionInterceptor"
          class="org.fusesource.camel.component.sap.CurrentProcessorDefinitionInterceptStrategy" />

    <!-- Configures the Inbound and Outbound SAP Connections -->
    <bean id="sap-configuration"
        class="org.fusesource.camel.component.sap.SapConnectionConfiguration">
        <property name="destinationDataStore">
            <map>
                <entry key="quickstartDest" value-ref="quickstartDestinationData" />
            </map>
        </property>
    </bean>

    <!-- Configures an Outbound SAP Connection -->
    <!-- *** Please enter the connection property values for your environment *** -->
    <bean id="quickstartDestinationData"
        class="org.fusesource.camel.component.sap.model.rfc.impl.DestinationDataImpl">
        <property name="ashost" value="example.com" />
        <property name="sysnr" value="00" />
        <property name="client" value="000" />
        <property name="user" value="username" />
        <property name="passwd" value="password" />
        <property name="lang" value="en" />
    </bean>

</blueprint>

例如，在配置目的地（如前面的 Blueprint XML 文件所示），您可以使用以下 URI 在 QuickstartDest 目标上调用 BAPI_FLCUST_GETLIST 远程函数调用：

sap-srfc-destination:quickstartDest:BAPI_FLCUST_GETLIST

前面的目标配置示例显示了 CurrentProcessorDefinitionInterceptStrategy 对象的实例化。此对象在 Camel 运行时中安装一个拦截器，使 Camel SAP 组件能够在处理 RFC 事务时跟踪其在 Camel 路由内的位置。如需了解更多详细信息，请参阅 “事务 RFC 目标端点”一节。

下表列出了用于在 SAP 目标数据存储中配置目的地的 登录和验证 选项：

下表列出了用于在 SAP 目标数据存储中配置目的地的连接选项：

下表列出了用于在 SAP 目标数据存储中配置目的地的 连接池 选项：

下表列出了用于在 SAP 目标数据存储中配置目的地 的安全网络选项 ：

下表列出了用于在 SAP 目标数据存储中配置目的地 的存储库 选项：

下表列出了用于在 SAP 目标数据存储中配置目的地的 trace 配置选项 ：

服务器的配置在 SAP 组件的 serverDataStore 属性中维护。此映射中的每个条目都配置与 SAP 实例不同的入站连接。每个条目的键是出站连接的名称，并在服务器端点 URI 的 serverName 组件中使用，如 URI 格式部分所述。

每个条目的值都是 服务器数据配置对象 org.fusesource.camel.component.sap.model.rfc.impl.ServerDataImpl，用于定义入站 SAP 连接的配置。

以下蓝图 XML 代码演示了如何使用名称 QuickstartServer 创建示例服务器配置。

<?xml version="1.0" encoding="UTF-8"?>
<blueprint ... >
    ...
    <!-- Configures the Inbound and Outbound SAP Connections -->
    <bean id="sap-configuration"
        class="org.fusesource.camel.component.sap.SapConnectionConfiguration">
        <property name="destinationDataStore">
            <map>
                <entry key="quickstartDest" value-ref="quickstartDestinationData" />
            </map>
        </property>
        <property name="serverDataStore">
            <map>
                <entry key="quickstartServer" value-ref="quickstartServerData" />
            </map>
        </property>
    </bean>

    <!-- Configures an Outbound SAP Connection -->
    <!-- *** Please enter the connection property values for your environment *** -->
    <bean id="quickstartDestinationData"
        class="org.fusesource.camel.component.sap.model.rfc.impl.DestinationDataImpl">
        <property name="ashost" value="example.com" />
        <property name="sysnr" value="00" />
        <property name="client" value="000" />
        <property name="user" value="username" />
        <property name="passwd" value="passowrd" />
        <property name="lang" value="en" />
    </bean>

    <!-- Configures an Inbound SAP Connection -->
    <!-- *** Please enter the connection property values for your environment ** -->
    <bean id="quickstartServerData"
        class="org.fusesource.camel.component.sap.model.rfc.impl.ServerDataImpl">
        <property name="gwhost" value="example.com" />
        <property name="gwserv" value="3300" />
        <!-- Do not change the following property values -->
        <property name="progid" value="QUICKSTART" />
        <property name="repositoryDestination" value="quickstartDest" />
        <property name="connectionCount" value="2" />
    </bean>
</blueprint>

注意本示例如何配置目标连接 QuickstartDest，服务器使用它来从远程 SAP 实例检索元数据。此目的地通过 repositoryDestination 选项在服务器数据中配置。如果您没有配置这个选项，则需要创建本地元数据存储库（请参阅 第 290.6.4 节 “仓库配置”）。

例如，在配置目的地（如前面的 Blueprint XML 文件所示），您可以使用以下 URI 处理来自调用客户端的 BAPI_FLCUST_GETLIST 远程功能调用：

sap-srfc-server:quickstartServer:BAPI_FLCUST_GETLIST

服务器数据配置对象所需的选项有，如下所示：

服务器数据配置对象的安全连接选项是，如下所示：

服务器数据配置对象的其他选项有如下：

存储库的配置在 SAP 组件的 repositoryDataStore 属性中维护。此映射中的每个条目都配置不同的存储库。每个条目的键是存储库的名称，此键也对应于附加到此存储库的服务器的名称。

每个条目的值都是存储库数据配置对象 org.fusesource.camel.component.sap.model.rfc.impl.RepositoryDataImpl，用于定义元数据存储库的内容。存储库数据对象是功能模板配置对象 org.fuesource.camel.component.sap.model.rfc.impl.FunctionTemplateImpl 的映射。此映射中的每个条目都指定函数模块的接口，每个条目的键是指定的功能模块的名称。

以下代码显示了配置元数据存储库的简单示例：

<?xml version="1.0" encoding="UTF-8"?>
<blueprint ... >
    ...
    <!-- Configures the sap-srfc-server component -->
    <bean id="sap-configuration"
        class="org.fusesource.camel.component.sap.SapConnectionConfiguration">
        <property name="repositoryDataStore">
            <map>
                <entry key="nplServer" value-ref="nplRepositoryData" />
            </map>
        </property>
    </bean>

    <!-- Configures a metadata Repository -->
    <bean id="nplRepositoryData"
        class="org.fusesource.camel.component.sap.model.rfc.impl.RepositoryDataImpl">
        <property name="functionTemplates">
            <map>
                <entry key="BOOK_FLIGHT" value-ref="bookFlightFunctionTemplate" />
            </map>
        </property>
    </bean>
    ...
</blueprint>

function 模块的接口由四个参数列表组成，其数据会重新传输到 RFC 调用中的 function 模块。每个参数列表由一个或多个字段组成，每个字段都是在 RFC 调用中传输的命名参数。支持以下参数列表和异常列表：

功能模板描述了函数接口的每个参数列表中的名称和参数类型，以及函数引发的 ABAP 异常。功能模板对象维护五个元数据对象的属性列表，如下表所述。

以下示例演示了如何配置功能模板：

<bean id="bookFlightFunctionTemplate"
    class="org.fusesource.camel.component.sap.model.rfc.impl.FunctionTemplateImpl">
    <property name="importParameterList">
        <list>
            ...
        </list>
    </property>
    <property name="changingParameterList">
        <list>
            ...
        </list>
    </property>
    <property name="exportParameterList">
        <list>
            ...
        </list>
    </property>
    <property name="tableParameterList">
        <list>
            ...
        </list>
    </property>
    <property name="exceptionList">
        <list>
            ...
        </list>
    </property>
</bean>

列表字段元数据对象 org.fusesource.camel.component.sap.model.rfc.impl.ListFieldMeataDataImpl 指定参数列表中字段的名称和类型。对于 elementary 参数字段(CHAR,DATE,BCD,TIME,BYTE,NUM,FLOAT,INT 1 ,INT1,INT2,DECF16,DECF34,STRING,XSTRING)），下表列出了可能在列表元数据上设置的配置属性：

对于类型为 TABLE 或 STRUCTURE 的复杂参数字段，下表列出了列表字段 metadata 对象可能设置的配置属性：

以下元数据配置指定一个一个可选的 24 位打包的 BCD number 参数，它有两个十进制位置，名为 TICKET_PRICE ：

<bean class="org.fusesource.camel.component.sap.model.rfc.impl.ListFieldMetaDataImpl">
    <property name="name" value="TICKET_PRICE" />
    <property name="type" value="BCD" />
    <property name="byteLength" value="12" />
    <property name="unicodeByteLength" value="24" />
    <property name="decimals" value="2" />
    <property name="optional" value="true" />
</bean>

以下元数据配置指定所需的 TABLE 参数，名为 CONNINFO，其行结构由 connectionInfo 记录元数据对象指定：

<bean    class="org.fusesource.camel.component.sap.model.rfc.impl.ListFieldMetaDataImpl">
    <property name="name" value="CONNINFO" />
    <property name="type" value="TABLE" />
    <property name="recordMetaData" ref="connectionInfo" />
</bean>

记录元数据对象 org.fusesource.camel.component.sap.model.rfc.impl.RecordMetaDataImpl 指定嵌套 STRUCTURE 或 TABLE 参数的行。记录元数据对象维护一个记录字段元数据对象列表 org.fusesource.camel.component.sap.model.rfc.impl.FieldMetaDataImpl，用于指定嵌套结构或表行中的参数。

下表列出了可以在记录元数据对象上设置的配置属性：

以下示例演示了如何配置记录元数据对象：

<bean id="connectionInfo"
        class="org.fusesource.camel.component.sap.model.rfc.impl.RecordMetaDataImpl">
    <property name="name" value="CONNECTION_INFO" />
    <property name="recordFieldMetaData">
        <list>
            ...
        </list>
    </property>
</bean>

记录字段元数据对象 org.fusesource.camel.component.sap.model.rfc.impl.FieldMetaDataImpl 指定具有结构的参数字段的名称和类型。

记录字段 metadata 对象与参数字段 metadata 对象类似，但必须额外指定嵌套结构或表行中单个字段位置的偏移。单个字段的非统一代码和 Unicode 偏移量必须从结构或行中上述字段的总和和指定。

对于 elementary 参数字段(CHAR,DATE,BCD,TIME,BYTE,NUM,FLOAT,INT 1 ,INT1,INT2,DECF16,DECF34,STRING,XSTRING)），下表列出了可能在记录元数据上设置的配置属性：

对于类型为 TABLE 或 STRUCTURE 的复杂参数字段，下表列出了可以在记录字段 metadata 对象上设置的配置属性：

以下元数据配置指定名为 ARR DATE 的 85 字节的 DATE 字段参数，到非Unicode 布局，将位置 170 字节到 Unicode 布局的内线结构中：

<bean    class="org.fusesource.camel.component.sap.model.rfc.impl.FieldMetaDataImpl">
    <property name="name" value="ARRDATE" />
    <property name="type" value="DATE" />
    <property name="byteLength" value="8" />
    <property name="unicodeByteLength" value="16" />
    <property name="byteOffset" value="85" />
    <property name="unicodeByteOffset" value="170" />
</bean>

以下元数据配置指定了名为 FLTINFO 的 STRUCTURE 字段参数，其结构由 flightInfo 记录元数据对象指定。在非统一代码和 Unicode 布局的情况下，参数位于封闭结构的开头。

<bean    class="org.fusesource.camel.component.sap.model.rfc.impl.FieldMetaDataImpl">
    <property name="name" value="FLTINFO" />
    <property name="type" value="STRUCTURE" />
    <property name="byteOffset" value="0" />
    <property name="unicodeByteOffset" value="0" />
    <property name="recordMetaData" ref="flightInfo" />
</bean>