290.6. Configuration

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 )的映射。此映射中的每个条目都指定 function 模块的接口，每个条目的键是指定的 function 模块的名称。

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

<?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>

功能模块的接口由四个参数列表组成，其数据被回传输至 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>

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

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

以下元数据配置指定了一个可选的 24 位打包的 BCD 号参数，其两个十进制位置名为 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>

以下元数据配置指定名为 CONNINFO 的必要 TABLE 参数，其中包含 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，指定带有结构的参数字段的名称和类型。

记录字段元数据对象与参数字段元数据对象类似，但还必须额外指定嵌套结构或表行中各个字段位置的偏移量。单个字段的非Unicode 和 Unicode 偏移量必须从结构或行中前字段的非Unicode 和 Unicode 字节长度的总和指定。

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

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

以下元数据配置指定了名为 ARR DATE 的 DATE 字段参数，它位于 85 字节，在非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 和 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>