SAP Java Connector(JCo) (转)

JCo是一个高性能的，基于JNI的中间件，它实现了SAP的RFC（Remote Function Call）协议。

1、JCo的安装

从 http://service.sap.com/connectors 下载JCo，解压后将librfc32.dll和sapjcorfc.dll拷贝到WINNT/SYSTEM32下，将sapjco.jar加入项目的classpath中。

2、与SAP的连接

JCo支持两种连接方式，direct connections和connection pools。

direct connections：

import com.sap.mw.jco.*；

public TutorialConnect1() {
JCO.Client mConnection;
try {
mConnection = JCO.createClient("001", // SAP client
"", // userid
"****", // password
null, // language
"", // server host name
"00"); // system number mConnection.connect();
mConnection.disconnect();
} catch (Exception ex) {
}
}

connection pools：

static final String POOL_NAME = "Pool";
public TutorialConnect2() {
JCO.Client mConnection;
try {
JCO.Pool pool = JCO.getClientPoolManager().getPool(POOL_NAME);
if (pool == null) {
OrderedProperties properties = OrderedProperties.load("/logon.properties");
JCO.addClientPool(POOL_NAME, // pool name
5, // maximum number of connections
logonProperties); // properties
}
mConnection = JCO.getClient(POOL_NAME);
} catch (Exception ex) {
} finally { //返回连接到连接池，否则会导致无可用连接
JCO.releaseClient(mConnection);
}
}

logon.properties文件的定义：

jco.client.client=001
jco.client.user=userid
jco.client.passwd=****
jco.client.ashost=hostname
jco.client.sysnr=00

3、对SAP进行操作

SAP中有JCO.Repository对象，包含着SAP的RFM的运行环境元数据。

JCO.Repository mRepository;
mRepository = new JCO.Repository("ARAsoft", mConnection);
构造器中包含两个参数，第一个是一个任意名称，第二个是连接池或JCO.Client对象。

IFunctionTemplate对象包含着某个特定的RFM元数据，JCO.Function则代表着一个包含所有参数的RFM。它们之间的关系类似Java中Class和Object的关系。

IFunctionTemplate ft = mRepository.getFunctionTemplate("BAPI_SALESORDER_GETLIST");
//ft为空表示没有在SAP发现对应的RFM
if (ft == null) return null;
JCO.Function function = ft.getFunction();

JCO.ParameterList对象包含做Function的输入、输出和表参数。

client = JCO.getClient(SID); //从Pool中取得Client
JCO.ParameterList input = function.getImportParameterList();
//设置参数，参数名为第二个参数，参数值为第一个参数，
input.setValue("0000001200", "CUSTOMER_NUMBER" );
input.setValue( "1000", "SALES_ORGANIZATION");
client.execute(function);