天天看点

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

Jco 服务器端编程的作用是为了实现从 SAP 系统中调用外部 Java 程序提供的服务,将 Java 作为服务器。Jco Client 端编程是 Java 调用 ABAP,正好相反。但 Jco 服务器端编程是在 SAP 设计的框架下实现 ABAP 调用 Java,并不是并不是完全自由式的 ABAP 调用 Java。具体来说,要满足两个条件:

  • SAP 提供网关服务,建立 SAP 与 Java 服务器的通讯
  • SAP 调用的 Java 服务需要首先在 ABAP 中定义函数原型

我们解释一下这两个条件。

SAP 与 Java 服务器建立通讯

1. SAP 提供网关服务

建立通讯通道由 SAP 提供网关服务,Java 服务器基于网关 (Gateway host)、网关服务号码(Gateway service number ) 以及 Program Id 与 SAP 系统连接。

  • Gateway Host: SAP 网关的服务器名和 IP 地址
  • Gateway Service Number: 与 SAP 系统关联的网关服务号码,从 sapgw00 开始。在 SAP 侧和 Jco Java 服务器侧都要配置
  • Program ID: 在 SAP 系统中通过事务码 SM59 配置,在 Java 程序中和 ABAP 程序中都要用到该标识

为了便于理解,我们对上面所说的内容进行比较详细的讲解。什么是 SAP 网关呢? 按 SAP 官方文档的说法:

The SAP Gateway carries out RFC services within the SAP world, which are based on TCP/IP. These services enable SAP Systems and external programs to communicate with one another.

RFC services can be used either in the ABAP program or for the external programs using the interfaces. RFC can be used between processes of an instance or a system, or between systems.

(from: SAP Gateway - SAP Documentation)

也就是说,SAP 网关负责执行 SAP 系统与外部系统的 RFC 服务,基于 TCP/IP 协议。SAP 提供的网关服务,在 SAP 系统中通过事务码 SMGW 进行查看。在命令栏中输入 SMGW 进入如下界面 。

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

然后点击菜单 Goto -> Parameters -> Display 查看:

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

可以看到,SAP 系统的 Gateway hostname 为 sapecc6,service number 为 sapgw00,这是 SAP 侧的配置。刚才说过,Java 服务器端也要配置,因为接下来我的 Java 程序 在 Windows 系统中编写,所以按照 Windows 系统的配置方式,我们可以查看到在C:\WINDOWS\system32\drivers\etc\services 文件同时有如下设置:

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

接下来,通过事务码 SM59 配置连接类型为 TCP/IP 的外部连接。我在 SAP 系统中配置名为 JCOSERVER01 的 TCP/IP 连接(Type 为 T 表示 TCP/IP 类型的连接)。

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

双击 JCOSERVER01,查看相关的配置,对重要的配置项我在截图中作出了标记。在这里,设定的 Program Id 为 JCO_TEST。

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

2. SAP 与 Java 服务器连接

配置完成后,如果 Java 服务器启动,可以进行连接测试。在 SM59 界面中点击左上角的 Connection Test 按钮。如果 Java 服务器没有启动,系统显示 Prgoram XXX not registered,如下图。

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

如果 Java 服务器启动,显示界面如下。后面我们会再详细讲解 Java 端的设置。

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

ABAP 提供函数原型

ABAP 并不能调用 Java 任意的方法,必须先在 ABAP 中定义函数原型(包括函数名、参数等),并且 Java 要对这个函数进行注册。我们以一个 SAP 系统已有的函数 STFC_CONNECTION 为例。这个函数并没有什么实际的功能,函数只是提供参数,实现调用的时候,发送一个消息,返回一个消息。我们来看看 SAP 系统中的函数定义:

入参:

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

出参:

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

对 SAP 有函数原型的函数,在 JCo Server 中进行注册:

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

SAP 的函数不一定要有实现,但一定要有原型。

Jco server programming 详解

jar 包和项目文件结构

在PC 上安装 JCo 3.0,然后将 sapjco3.dll 和 sapjco3.jar 文件放在同一个文件夹下,假设用 IDEA 作为 IDE ,选中文件夹,右键 Add as library。项目文件结构:

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

jco3 在 maven central repository 上已有 package,所以是支持 Maven 项目的开发的。repositrory 地址:https://mvnrepository.com/artifact/com.sap/jco3-64/3.0.8。

Java 配置文件

Java 配置文件包括 JCo 连接 SAP 的配置和 java 作为 server 的配置。JCo 连接 SAP 的配置放在 ECC.jcodestination 文件中,配置项如下:

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

Java Server 的配置放在 SERVER.jcoserver 文件中:

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

实现 JCo Server

下面的代码实现一个简单的 JCo Server,在 Server 中注册了 STFC_CONNECTION 函数。

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

JCo server 处理 ABAP 发送的消息

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

ABAP 调用 Java 服务

在 ABAP 中编写如下代码:

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

程序运行测试

运行 Java 程序,启动 Java Server, 在控制台中的信息如下:

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

然后再运行 ABAP 程序,Java 服务器显示收到消息:

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

SAP 系统也打印出从 Java 返回的消息:

SAP接口编程 之JCo3.0系列(06) - Jco服务器端编程

源码

stonewm/sap_interface_jco3: SAP Interface JCo3.0 demo

参考

SAP Gateway - SAP Documentation

SAP Gateway options

SAP JCo Server Programming - SAP Help Portal