SAP接口编程之 JCo3.0系列：JCoDestination_jcodestination线程安全-优快云博客

JCo3.0是Java语言与ABAP语言双向通讯的中间件。与之前1.0/2.0相比，是重新设计的产品。API和架构设计与NCo3.0比较类似，前面也说过，NCo3.0的设计参考了JCo3.0。从本篇开始，系统介绍JCo3.0编程的技术要点。

JCo3.0安装

从https://service.sap.com/connectors 可以下载JCo3.0，注意下载的时候根据操作系统和JVM版本（32位还是64）选择不同的版本。安装就是解压，将文件解压到目标文件夹。以Windows系统为例，主要的文件包括：

sapjco3.dll
sapjco3.jar

SAP强烈推荐将这两个文件放在同一文件夹下。测试安装是否成功，可以在命令窗口下，进入安装文件夹，运行下面的命令：

java -jar sapjco3.jar

如果安装成功，应该显示如下界面：

jco3安装成功的显示界面

JCoDestination

JCoDestination代表后台SAP系统，程序员不用关心与SAP的连接，jco3.0运行时环境负责管理连接和释放连接。我们先以一个简单的例子看看jco3.0 JCoDestination类的一些要点。

我使用的编程环境是Eclipse，环境准备如下：

新建一个Java项目，项目名为JCo3Demo。
将sapjco3.jar加入到项目的build path中。注意前面所说的sapjco3.jar和sapjco3.dll要放在同一个文件夹下。
在Eclipse Java项目文件夹下，新建一个文本文件，文件名命名为ECC.jocdestination, 文件的内容如下（SAP系统的连接参数的设置）：

#SAP Logon parameters!
#Tue Dec 08 16:41:30 CST 2015
jco.client.lang=EN
jco.client.client=001
jco.client.passwd=xxxxxx
jco.client.user=STONE
jco.client.sysnr=00
jco.client.ashost=192.168.65.100

对照SAP GUI，不难理解：

SAP GUI

环境准备好了，先来一段最简单的代码：

package jco3.demo1;

import java.util.Properties;
import org.junit.Test;
import com.sap.conn.jco.JCoDestination;
import com.sap.conn.jco.JCoDestinationManager;
import com.sap.conn.jco.JCoException;

public class JCoDestinationDemo
{
    public JCoDestination getDestination() throws JCoException
    {
        /**
         * Get instance of JCoDestination from file: ECC.jcodestination
         * which should be located in the installation folder of project
         */

        JCoDestination dest = JCoDestinationManager.getDestination("ECC");
        return dest;
    }

    @Test
    public void pingDestination() throws JCoException
    {     
        JCoDestination dest = this.getDestination();
        dest.ping();
    }    
}

代码说明：

getDestination()方法中，JCoDestinationManager.getDestination("ECC")从ECC.jcodestination文件中获取连接参数，创建JCoDestination对象的实例。
这里有一个重要的约定，JCoDestinationManager.getDestination("ECC")方法，会从Eclipse Java项目的根目录，查找ECC.jcodestination文件（文件路径和扩展名不能改变）是否存在，如果存在，从文件的内容中获取连接参数。这是DestinationDataProvider接口的一个默认实现，在开发和测试的时候还是很方便的，但如果在真实项目中使用，安全性和灵活性就不够。后面会介