在spring boot中使用sapjco3，並用docker部署到Linux服務器

一、在windows中的配置

二、linux的配置

三、spring boot項目構建

sapjco3包含很多個操作系統版本，不同的操作系統需要使用不同的配置文件和配置方式，不過sapjco3.jar是可以通用的。

一、在windows中的配置

windows中需要的文件主要包括：

sapjco3.dll

sapjco3.pdb

sapjco3.jar

1、sapjco3.dll文件

32位系統 

將 sapjco3.dll 加入到c:/windows/system32/目錄 或者 將 sapjco3.dll 加入到 JDK/bin 目錄下；

64位系統

將 sapjco3.dll 加入到c:/windows/SysWOW64/目錄 或者 將 sapjco3.dll 加入到 JDK/bin 目錄下；

64位機可以直接將sapjco3.dll放在"C:\Windows\System32"目錄下，這樣以后不必針對具體的應用來配置它；

上面的配置是為了將它放在系統環境變量path可以找到的地方，所以也可以直接把sapjco3.dll文件所在的位置，配置到系統環境變量path下面；

2、sapjco3.pdb文件

在springboot中使用sapjco3可以不用配置sapjco3.pdb，如果在kettle中需要調用sap的接口，則需要把sapjco3.pdb放在kettle的根目錄"${KETTLE_HOME}/"下面；

3、sapjco3.jar文件

這個文件就是java調用sap的主要api，包含許多方法，如連接sap、獲取接口參數、設置接口參數和獲取返回參數等；

這里推薦將sapjco3.jar放在項目的lib目錄下面，然后在項目打包的時候，將本地依賴的jar包打包到項目jar中；

也可以將sapjco3.jar放在${JAVA_HOME}/lib目錄下或者放在其他目錄並將該目錄下的sapjco3.jar添加到系統環境變量CLASSPATH下面；

也可以在pom.xml中引入sapjco3.jar依賴，這樣項目打包的時候會將sapjco3.0.14.jar打包到項目jar里面，但是這樣sapjco3.jar文件是帶有版本后綴的，在項目部署的時候，會啟動失敗，報錯：It is not allowed to rename or repackage the original archive “sapjco3.jar”。需要手動進入jar包，將sapjco3.0.14.jar名稱修改為sapjco3.jar；

 

<!-- https://mvnrepository.com/artifact/com.sap.conn.jco/sapjco3 -->
<dependency>
        <groupId>com.sap.conn.jco</groupId>
        <artifactId>sapjco3</artifactId>
        <version>3.0.14</version>
        <scope>test</scope>
</dependency>

 

還有一種方式是使用maven的install命令將sapjco3.jar安裝到本地倉庫，然后在項目中引入依賴，但是切記jar包不能后綴版本號；

 

 

---

 二、linux的配置

linux需要的文件包括：

libsapjco3.so

sapjco3.jar

其中jar包sapjco3.jar與windows版的可以通用；重點是將libsapjco3.so文件配置到linux的jre/lib運行時環境中或者項目可以加載到libsapjco3.so的其他位置；

1、Linux系統：

1)將壓縮文件解壓到某個目錄下面，比如/home/appuser/sapjco3/ 下面：

tar -zxvf sapjco3-linuxx86_64-3.0.17.tgz -C /home/appuser/sapjco3

2)配置環境變量

vim /etc/profile

在配置文件內加上下面的內容：

export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/home/appuser/sapjco3

export CLASSPATH=.:${JAVA_HOME}/lib:${LD_LIBRARY_PATH}/sapjco3.jar

或者

先將文件libsapjco3.so復制到${JAVA_HOME}/jre/lib/amd64/server文件夾下

export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${JAVA_HOME}/jre/lib/amd63/server

export CLASSPATH=.:${JAVA_HOME}/lib:${LD_LIBRARY_PATH}/sapjco3.jar

上面配置的重點是libsapjco3.so的位置，對於sapjco3.jar，可以配置到環境變量${CLASSPATH}中，也可以打包在項目中；

官方的推薦如下：

 2、docker：

在docker中可以使用 -v 宿主機目錄:容器目錄 的方式將libsapjco3.so和sapjco3.jar進行映射：

docker run -d \

--restart=always \

--name springboot-sapjco3 \

-v "$PWD/sapringboot-sapjco3":/usr/app \

-v /home/appuser/sapjco3/libsapjco3.so:/usr/lib/libsapjco3.so \

--workdir="/usr/app" \

-p 8080:8080 \

java:8u111 \

java -jar sprringboot-sapjco3.jar

這樣就將宿主機的libsapjco3.so映射到了容器的/usr/lib下面；

如果項目中沒有打包sapjco3.jar文件，也可以在docker run 的 -v 命令中將該文件映射到jdk的lib目錄下：

-v /hemo/appuser/sapjco3/sapjco3.jar:/usr/lib/jvm/java-8-openjdk-amd64/lib/sapjco3.jar

三、spring boot項目構建

1、項目結構與配置文件

將sapjco3.jar放在項目resource/lib下面；

CONNECT_SAP_CONFIG.jcoDestination文件是連接SAP的配置文件，必需放在項目的根目錄下面，其內容如下：

#for tests only !
jco.client.lang=en
jco.client.client=710
jco.client.user=admin
jco.client.passwd=admin
jco.client.sysnr=00
jco.client.ashost=192.168.1.11

配置pom.xml，引入自定義jar包，並在項目打包時將自定義jar包打包進項目的jar：

<dependencies>
        <!--maven打包時，將resources/lib/sapjco3.jar一並打包-->
        <dependency>
            <groupId>com.sap</groupId>
            <artifactId>sapjco3</artifactId>
            <version>1.0</version>
            <scope>system</scope>
          <systemPath>${project.basedir}/src/main/resources/lib/sapjco3.jar</systemPath>
        </dependency>
        <!--其他依賴-->
        <dependency>
              ......
        </dependency>
<dependencies>
<build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <executable>true</executable>
                    <includeSystemScope>true</includeSystemScope>
                </configuration>
                <dependencies>
                    <dependency>
                        <groupId>org.springframework</groupId>
                        <artifactId>springloaded</artifactId>
                        <version>1.2.5.RELEASE</version>
                    </dependency>
                </dependencies>
            </plugin>
        </plugins>
</build>

2.獲取sap連接對象

public class JCoDestinationBuilder {
    public static JCoDestination destination = null;
    private static final Logger logger = LogUtils.getPlatformLogger();
    public static JCoDestination build() throws JCoException {
        if (null==destination) {
            synchronized (JCoDestinationBuilder.class) {
                try {
                    if (null == destination)
                        destination = JCoDestinationManager.getDestination("CONNECT_SAP_CONFIG");
                    destination.ping();
                    logger.info("Connect to SAP successfully......");
                } catch (JCoException e) {
                    e.printStackTrace();
                    logger.error("Connect to SAP failed, error msg: " + e.toString());
                }
            }
        }
        //logger.info(String.valueOf(destination.getAttributes()));
        return destination;
    }
}

3.調用sap接口函數

@Service
public class SappiMonitorServiceImpl implements SappiMonitorService {
    @Autowired
    Sm58EntityRepository sm58EntityRepository;
    @Autowired
    MessageService messageService;
    @Autowired
    private Environment environment;
    private static final Logger logger = LogUtils.getPlatformLogger();

    @Override
    public JSONObject monitorSm58(SappiSm58 sappiSm58) throws JCoException {
        if (sappiSm58==null) sappiSm58 = new SappiSm58();
        JCoDestination destination = JCoDestinationBuilder.build();
        JCoFunction function = destination.getRepository().getFunction("ZMONITOR_SM58"); JCoParameterList importlist = function.getImportParameterList(); JCoParameterList exportList = function.getExportParameterList(); JCoParameterList tables = function.getTableParameterList();

        importlist.setValue("I_BEGIN_DATE",sappiSm58.getI_begin_date()); importlist.setValue("I_END_DATE",sappiSm58.getI_end_date()); try {
            function.execute(destination); //logger.warn(function.toXML());
        } catch (JCoException e) {
            e.printStackTrace();
            logger.error("execute()failed......");
        }
        JCoTable t_arfcistate = tables.getTable("T_ARFCISTATE"); for (int i=0;i<t_arfcistate.getNumRows();i++) {
            t_arfcistate.setRow(i);
            Sm58Entity sm58Entity = new Sm58Entity();
            sm58Entity.setArfcipid(t_arfcistate.getString("ARFCIPID"));
            sm58Entity.setArfcpid(t_arfcistate.getString("ARFCPID"));
            sm58Entity.setArfctime(t_arfcistate.getString("ARFCTIME"));
            sm58Entity.setArfctidcnt(t_arfcistate.getString("ARFCTIDCNT"));
            sm58Entity.setArfcdest(t_arfcistate.getString("ARFCDEST"));
            sm58Entity.setArfcluwcnt(t_arfcistate.getString("ARFCLUWCNT"));
            sm58Entity.setArfcstate(t_arfcistate.getString("ARFCSTATE"));
            sm58Entity.setArfcfnam(t_arfcistate.getString("ARFCFNAM"));
            sm58Entity.setArfcreturn(t_arfcistate.getString("ARFCRETURN"));
            sm58Entity.setArfcuzeit(t_arfcistate.getString("ARFCUZEIT"));
            sm58Entity.setArfcdatum(t_arfcistate.getString("ARFCDATUM"));
            sm58Entity.setArfcuser(t_arfcistate.getString("ARFCUSER"));
            sm58Entity.setArfcretrys(t_arfcistate.getLong("ARFCRETRYS"));
            sm58Entity.setArfctcode(t_arfcistate.getString("ARFCTCODE"));
            sm58Entity.setArfcrhost(t_arfcistate.getString("ARFCRHOST"));
            sm58Entity.setArfcmsg(t_arfcistate.getString("ARFCMSG"));
            sm58Entity.setArfcreserv(t_arfcistate.getString("ARFCRESERV"));
            sm58Entity.setHash(t_arfcistate.getString("HASH"));
            sm58EntityRepository.save(sm58Entity);
        }
        String markdown = SappiMonitorServiceImpl.generateMarkdown("monitorSm58",
                exportList.getString("E_ERR_NUM").replaceAll(" ",""));
        //調用MessageService接口
        MarkdownMessage markdownMessage = new MarkdownMessage();
        markdownMessage.setUserid(environment.getProperty("sap.pi.monitor.sm58.touser"));
        markdownMessage.setMarkdown(markdown);
        JSONObject jsonObject = new JSONObject();
        if ("E".equals(exportList.getString("E_STATUS"))) {
            jsonObject = messageService.sendMarkdown(markdownMessage);
            jsonObject.put("errCode","-1");
            jsonObject.put("errMsg","系統運行出現" + exportList.getString("E_ERR_NUM") +"條錯誤");
        } else {
            jsonObject.put("errCode","0");
            jsonObject.put("errMsg","系統運行正常");
        }
        return jsonObject;
    }
}

 

上面代碼中，粗體部分是獲取sap連接對象、接口參數賦值、接口調用和獲取返回結果的主要代碼；

4.編寫相應的Controller代碼

@Api(tags = "SAPPI運行狀態監控", description = "監控SAPPI運行狀態")
@Controller
@RequestMapping("/monitor/sappi")
public class SappiMonitorController {
    @Autowired
    SappiMonitorService sappiMonitorService;

    @ApiOperation(value = "事務代碼:SXI_MONITOR", notes = "請求方式:POST")
    @PostMapping("/sxi_monitor")
    @ResponseBody
    public JSONObject monitorSxi_monitor(@RequestBody(required = false) SappiSxi_monitor sappiSxi_monitor) throws Exception {
        return sappiMonitorService.monitorSxi_monitor(sappiSxi_monitor);
    }

    @ApiOperation(value = "事務代碼:SM58", notes = "請求方式:POST")
    @PostMapping("/sm58")
    @ResponseBody
    public JSONObject monitorSm58(@RequestBody(required = false) SappiSm58 sappiSm58) throws Exception {
        return sappiMonitorService.monitorSm58(sappiSm58);
    }
}

5.運行與測試

上面的代碼中，只貼出了sapjco使用的主要部分，其中數據庫的持久化部分和將sap接口調用結果發送到微信通知的部分都可以刪減掉；

測試時，請求方式改為GET方式即可：

即@PostMapping("/sm58") 改為 @GetMapping("/sm58")

然后在瀏覽器或者用postman直接調用接口：localhost:8080/monitor/sappi/sm58

將會看到如下返回結果：

{
　　"invalidUser": "",
　　"invalidTagList": [],
　　"errCode": "-1",
　　"errMsg": "系統運行出現1 條錯誤",
　　"invalidPartyList": [],
　　"invalidUserList": []
}

 

6、打包與部署

使用maven的package命令將項目打包成jar包，並上傳到linux服務器/home/appuser/springboot-sapjco目錄下面；

使用上面的docker命令部署並運行項目；

 

四、各操作系統sapjco文件下載：

鏈接: https://pan.baidu.com/s/1-1Cxam_9Q6o0z_NqqOGvoA 提取碼: v7c8

或者掃碼保存：