第 121 章 SAP 组件


SAP 组件是一个由 10 个不同的 SAP 组件组成的软件包。有远程功能调用(RFC)组件支持 sRFC、tRFC 和 qRFC 协议,并且有 IDoc 组件以 IDoc 格式使用消息。组件使用 SAP Java Connector (SAP JCo)库来协助双向通信 SAP 和 SAP IDoc 库,以 Intermediate Document (IDoc)格式传输文档。

121.1. 依赖项

将以下依赖项添加到此组件的 pom.xml 中:

<dependency>
    <groupId>org.fusesource</groupId>
    <artifactId>camel-sap-starter</artifactId>
    <version>4.10.7.redhat-00009</version>
</dependency>

121.1.1. SAP 组件的其他平台限制

由于 SAP 组件依赖于第三方 JCo 3 和 IDoc 3 库,因此只能安装到这些库支持的平台上。

121.1.2. SAP JCo 和 SAP IDoc 库

使用 SAP 组件的先决条件是 SAP Java Connector (SAP JCo)库和 SAP IDoc 库被安装到 Java 运行时的 lib/ 目录中。您必须确保从 SAP Service Marketplace 下载适用于您的目标操作系统的适当 SAP 库集合。

库文件的名称因目标操作系统而异,如下所示。

表 121.1. 所需的 SAP 库
SAP 组件Linux 和 UNIXWindows

SAP JCo 3

sapjco3.jar

libsapjco3.so

sapjco3.jar

sapjco3.dll

SAP IDoc

sapidoc3.jar

sapidoc3.jar

121.1.2.1. 安装 SAP JCo 和 SAP IDoc 库

安装 SAP JCo 和 SAP IDoc 库的说明如下。在 OpenShift Container Platform 上运行以及本地运行的说明有所不同。建议创建两个 Maven 配置集,如 openshift 和 local。

流程

  1. 将工件安装到本地 maven 存储库中。进入项目的 lib 目录并保存 SAP 库。
  2. 在 pom.xml 中定义依赖项。

    <dependency>
        <groupId>com.sap.conn.jco</groupId>
        <artifactId>sapjco3</artifactId>
        <version>${sapjco3-version}</version>
        <scope>system</scope>
        <systemPath>${basedir}/lib/sapjco3.jar</systemPath>
    </dependency>
    
    <dependency>
        <groupId>com.sap.conn.idoc</groupId>
        <artifactId>sapidoc3</artifactId>
        <version>${sapidoc3-version}</version>
        <scope>system</scope>
        <systemPath>${basedir}/lib/sapidoc3.jar</systemPath>
    </dependency>
  3. 定义 spring-boot-maven-plugin。

    对于本地 配置集

    <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
        <version>${spring.boot-version}</version>
        <executions>
            <execution>
                <goals>
                    <goal>repackage</goal>
                </goals>
            </execution>
        </executions>
        <configuration>
            <additionalClasspathElements>${basedir}/lib</additionalClasspathElements>
        </configuration>
    </plugin>

    对于 openshift 配置集

    <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
        <version>${spring.boot-version}</version>
        <executions>
            <execution>
                <goals>
                    <goal>repackage</goal>
                </goals>
            </execution>
        </executions>
        <configuration>
            <!-- <includeSystemScope>false</includeSystemScope> -->
            <layout>ZIP</layout>
            <excludeGroupIds>com.sap.conn.jco,com.sap.conn.idoc</excludeGroupIds>
        </configuration>
    </plugin>

  4. 定义 openshift-maven-plugin。

                        <plugin>
                            <groupId>org.eclipse.jkube</groupId>
                            <artifactId>openshift-maven-plugin</artifactId>
                            <version>1.16.2.redhat-00013</version>
                            <configuration>
                                <images>
                                    <image>
                                        <name>${project.build.finalName}</name>
                                        <alias>${project.build.finalName}</alias>
                                        <build>
                                            <from>${jkube.generator.from}</from>
                                            <assembly>
                                                <targetDir>/deployments</targetDir>
                                                <layers>
                                                    <layer>
                                                        <id>lib</id>
                                                        <fileSets>
                                                            <fileSet>
                                                                <directory>lib</directory>
                                                                <outputDirectory>data</outputDirectory>
                                                            </fileSet>
                                                        </fileSets>
                                                    </layer>
                                                </layers>
                                            </assembly>
                                        </build>
                                    </image>
                                </images>
                                <resources>
                                    <env>
                                        <JAVA_OPTS_APPEND>-Dloader.path=/deployments/data</JAVA_OPTS_APPEND>
                                    </env>
                                </resources>
                            </configuration>
                            <executions>
                                <execution>
                                    <goals>
                                        <goal>resource</goal>
                                        <goal>build</goal>
                                        <goal>apply</goal>
                                    </goals>
                                </execution>
                            </executions>
                        </plugin>
  5. 为 openshift 配置集定义 openshift-maven-plugin。

    <jkube.enricher.jkube-service.port>8080</jkube.enricher.jkube-service.port>

    如果您希望 openshift-maven-plugin 使用 Deployemnt 而不是 DeploygmentConfig,请按照额外的步骤操作。

  6. 在 pom.xml 文件中添加 jkube.build.switchToDeployment 属性。

        <jkube.build.switchToDeployment>true</jkube.build.switchToDeployment>
        <jkube.enricher.jkube-service.port>8080</jkube.enricher.jkube-service.port>
    </properties>
  7. 在 openshift 配置集中定义文件名。

    <profile>
        <id>openshift</id>
        <build>
            <finalName>${project.artifactId}</finalName>
            <defaultGoal>install</defaultGoal>

    如果要在 openshift 和 local 配置集间切换 application.properties,请使用以下步骤。

  8. 使用 application.properties 创建 application-openshift.properties 文件和 application-local.properties 文件。application-openshift.properties 文件供 Openshift 配置集使用,local 配置集使用 application-local.properties 文件。
  9. 按如下方式编辑 application.properties 文件:
spring.profiles.active=@spring.profiles.active@
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

关于红帽文档

Legal Notice

Theme

© 2026 Red Hat
返回顶部