// 獲取RFC返回的字段值

11 JCoParameterList exportParam = function.getExportParameterList();

12 String exParamA = exportParam.getString("field_A");

13 String exParamB = exportParam.getString("field_B");

14 // 遍歷RFC返回的表對象

15 JCoTable tb = function.getTableParameterList().getTable("table_name");

16 for (int i = 0; i < tb.getNumRows(); i++) {

17 tb.setRow(i);

18 System.out.println(tb.getString("field01"));

19 System.out.println(tb.getString("field02"));

20 }

21 }

SAP的R/3系統(tǒng)與Java平臺一樣有著許多類似的技術(shù)理念，以及同樣廣泛的企業(yè)級用戶，但是它們完全是兩個不同的世界。當(dāng)用戶面臨流程或者數(shù)據(jù)整合方面的需求的時候，就迫切需要一種高效的方式，在R/3系統(tǒng)和Java平臺之間實時地交換數(shù)據(jù)。基于這樣的需求，SAP提供了一套高效的基于RFC的ABAP和Java進程間通訊組件：SAP Java Connector(JCo)。

本文將介紹JCo組件的架構(gòu)，配置，基本使用方法以及調(diào)試，同時還將討論如何對RFC方式調(diào)用的ABAP函數(shù)進行遠程調(diào)試。

JCo庫提供了可以直接在Java程序中使用的API。該API通過JNI調(diào)用部署在客戶端的SAP的RFC庫。該RFC庫是用C語言實現(xiàn)的，并且與JCo庫相互獨立發(fā)布。但是，在下載的JCo庫壓縮包中也會提供。

該組件支持Inbound(在Java代碼中調(diào)用ABAP函數(shù))和Outbound(在ABAP代碼中調(diào)用Java)兩種模式。本文只專注于介紹Inbound模式中，如何在Java代碼遠程調(diào)用ABAP函數(shù)。

安裝與配置

最新版本的JCo庫可以在如下網(wǎng)址下載(請選擇適合你的軟件和硬件平臺的版本，本文的示例都基于32位Windows操作系統(tǒng))：

http://service.sap.com/connectors

你可能需要提供SAP Service MarketPlace的用戶帳號。解壓縮以后，將名為librfc32.dll的文件復(fù)制到目錄 system32下面。如果該文件已經(jīng)存在，則覆蓋它。這個文件就是SAP的RFC協(xié)議實現(xiàn)，可以在http://service.sap.com/connectors下載其最新版本。

然后，確保CLASSPATH環(huán)境變量中包含文件sapjco.jar所在的目錄。因為這個JAR包中含有在Java程序中需要直接調(diào)用的類和接口。

下載的壓縮包中還包含了JavaDoc，文檔以及示例程序供參考。

建立連接

在執(zhí)行任何操作之前，必須先建立到SAP系統(tǒng)的連接。本文示例使用的用戶名是“DDIC”，登錄密碼是“minisap”

類JCO是Jco庫中最主要的一個入口，它提供了許多靜態(tài)方法。其中有一系列重載的createClient方法可以用來創(chuàng)建與SAP系統(tǒng)的連接信息。這些信息都保存在返回的JCO.Client類的實例中。常用的兩種方式如下：

直接輸入?yún)?shù)：

JCO.Client myConnection = JCO.createClient("000", "DDIC", "minisap", "EN", "10.0.0.11", "00");

使用Java Properties：

Properties logonProperties = new Properties(); logonProperties.put("jco.client.ashost","10.0.0.11"); logonProperties.put("jco.client.client","000"); logonProperties.put("jco.client.passwd","minisap"); logonProperties.put("jco.client.sysnr","00"); logonProperties.put("jco.client.user","DDIC");

JCO.Client myConnection = JCO.createClient( logonProperties ).

第一種方式比較簡單，所有的參數(shù)都直接寫在代碼中。相比之下，第二種方式使用Java Properties，它好處在于，除了硬編碼這種方式之外，用戶也可以將連接信息保存在一個單獨的.properties文件中。這樣即使連接信息改變也無需改變代碼，只需要修改.properties文件中的數(shù)據(jù)即可。關(guān)于.properties文件的用法，請參考相關(guān)的Java語言教程。

JCO.Client提供方法connect方法來建立從當(dāng)前Java進程到SAP服務(wù)器的連接。

this.myConnection.connect();

可以使用isAlive方法來獲取一個連接的狀態(tài)，還可以使用disconnect方法來關(guān)閉一個連接：

if ( myConnection != null && myConnection.isAlive())

很多情況下，頻繁創(chuàng)建新的連接可能導(dǎo)致嚴(yán)重的性能問題。典型的情況就是在Web應(yīng)用程序中，如果每個session創(chuàng)建一個連接，那么用戶數(shù)量很多的時候系對系統(tǒng)來說就是一場災(zāi)難。JCo庫支持以連接池的形式重用已創(chuàng)建的連接。只需要調(diào)用JCO類的靜態(tài)方法addClientPool即可創(chuàng)建一個連接池，并且可以在參數(shù)中指定連接池的名字和允許同時激活的最大連接數(shù)。

如下代碼演示了如何創(chuàng)建一個名為“Sample_Pool”的JCo連接池：

public static final String POOL_NAME = "Sample_Pool";

public static final int max_connection = 2;

……

JCO.Pool pool = JCO.getClientPoolManager().getPool(POOL_NAME);

if (pool == null) {

Properties logonProperties = new Properties();

logonProperties.put("jco.client.ashost","10.0.0.11"); logonProperties.put("jco.client.client","000"); logonProperties.put("jco.client.passwd","minisap"); logonProperties.put("jco.client.sysnr","00"); logonProperties.put("jco.client.user","DDIC");

JCO.addClientPool( POOL_NAME, // pool name

max_connection, // max num of connections,

logonProperties); // properties

}

創(chuàng)建好連接池之后，可以通過如下代碼來從連接池中獲取一個連接：

mConnection = JCO.getClient(POOL_NAME);

在連接使用完畢之后，不要忘記使用releaseClient方法釋放當(dāng)前連接：

JCO.releaseClient( myConnection ).

如果需要移除連接池，則可以使用如下代碼：

JCO.removeClientPool(POOL_NAME);

移除連接池將導(dǎo)致其中所有的活動連接被強行關(guān)閉，所以必須在確保連接池中所有的連接都不再被使用的時候才能執(zhí)行該操作。

調(diào)用Function Modules

為了演示如何使用JCo庫來調(diào)用遠程的ABAP函數(shù)，本文示例中使用NetWeaver ABAP試用版系統(tǒng)中的一個樣例函數(shù)BAPI_FLIGHT_GETLIST。

JCo庫使用RFC的方式來調(diào)用ABAP中的函數(shù)，所以被調(diào)用的函數(shù)必須已經(jīng)勾選“Remote-enabled”屬性。

調(diào)用一個函數(shù)之前，需要知道函數(shù)的元數(shù)據(jù)，比如函數(shù)名字，輸入輸出參數(shù)等等。在JCo庫中，必須通過類JCO.Repository來獲取所有的ABAP函數(shù)的元數(shù)據(jù)，所以第一步是創(chuàng)建一個JCO.Repository類的對象：

JCO.Repository myRepository = new JCO.Repository("Repository", myConnection);

JCO.Repository類的構(gòu)造函數(shù)有兩個參數(shù)，第一個是可以任意指定的名字，第二個是當(dāng)前使用的連接。此處也可以直接指定一個連接池的名字，JCo庫將自動從該連接池中獲取連接。

此時，必須保證該連接使用的用戶名在目標(biāo)SAP服務(wù)器上有足夠的權(quán)限。

獲得JCO.Repository類的實例之后，就可以通過該實例來獲得函數(shù)的信息。如下代碼演示了如何獲取函數(shù)BAPI_FLIGHT_GETLIST的信息以及如何設(shè)置簡單類型的參數(shù)：

String strFunc = "BAPI_FLIGHT_GETLIST";

IFunctionTemplate ft = myRepository.getFunctionTemplate(strFunc.toUpperCase());

JCO.Function funGetList = ft.getFunction();

// set up scalar parameter

JCO.ParameterList input = funGetList.getImportParameterList();

input.setValue(10, "MAX_ROWS");

JCO.Function對象提供了對應(yīng)的方法來獲取ABAP函數(shù)的參數(shù)列表。例如，上例中的getImportParameterList方法返回該函數(shù)的Import參數(shù)列表。

在上面的示例代碼中，僅僅設(shè)置了一個最簡單的int類型的參數(shù)。事實上，setValue方法有許多重載形式，允許設(shè)置各種復(fù)雜類型的參數(shù)，比如structure類型和table類型的參數(shù)。而且，除了通過參數(shù)名字引用要設(shè)置的參數(shù)之外，還可以通過參數(shù)的索引來引用一個參數(shù)。

在設(shè)置structure和table類型的參數(shù)之前，需要通過JCO.Function對象的方法獲取相應(yīng)的JCO.Structure和JCO.Table對象，然后才可以使用對每個字段進行賦值。

在我們使用的函數(shù)BAPI_FLIGHT_GETLIST中，Import參數(shù)中的DESTINATION_FROM是一個structure，其中包含一個CITY字段。如下代碼演示了如何將CITY字段賦值為“NEW YORK”：

// set up structure parameter

JCO.Structure sFrom = input.getStructure("DESTINATION_FROM");

sFrom.setValue("NEW YORK", "CITY");

input.setValue(sFrom, "DESTINATION_FROM");

類似地，可以使用JCO.Function對象的getTableParameterList方法拿到Table參數(shù)列表。下面的代碼演示了如何拿到一個名為DATE_RANGE的Table參數(shù)并且為它創(chuàng)建兩行：

// set up table parameter

JCO.Table tDateRange = funGetList.getTableParameterList()

.getTable("DATE_RANGE");

tDateRange.appendRow();

tDateRange.setRow(0);

tDateRange.setValue("I", "SIGN");

tDateRange.setValue("EQ", "OPTION");

tDateRange.setValue("20070606", "LOW");

tDateRange.appendRow();

tDateRange.setRow(1);

tDateRange.setValue("I", "SIGN");

tDateRange.setValue("EQ", "OPTION");

tDateRange.setValue("20070704", "LOW");

參數(shù)設(shè)置完畢之后，可以通過JCO.Client對象的execute方法執(zhí)行遠程調(diào)用：

myConnection.execute(funGetList);

獲得輸出參數(shù)的方法與輸入?yún)?shù)完全一樣。下面的代碼演示了如何獲取一個包含返回值的Table參數(shù)，并且輸出它的內(nèi)容：

// get table results

JCO.Table flights = funGetList.getTableParameterList().getTable(

"FLIGHT_LIST");

for (int i = 0; i < flights.getNumRows(); i++) {

flights.setRow(i);

System.out.println("Airline ["

+ flights.getString("AIRLINE")

+ "] from city "

+ flights.getString("CITYFROM")

+ " to city "

+ flights.getString("CITYTO")

+ ", departure time is "

+ flights.getDate("FLIGHTDATE"));

}

JCO.Structure和JCO.Table都繼承自類JCO.Record。JCO.Record對每種類型的參數(shù)都提供了對應(yīng)的get和set方法，并且在運行時自動進行Java數(shù)據(jù)類型和ABAP數(shù)據(jù)類型之間的轉(zhuǎn)換。限于篇幅，本文不再詳敘，請參考JCo庫的JavaDoc文檔。

在使用JCo庫的過程中，主要有兩種類型的異常需要處理：

JCO.AbapException

如果ABAP函數(shù)執(zhí)行過程中出現(xiàn)異常，則在Java進程中會觸發(fā)該異常。

JCO.ConversionException

當(dāng)執(zhí)行參數(shù)的get和set方法時，如果在Java類型和ABAP類型之間轉(zhuǎn)換失敗，則會觸發(fā)該異常。

作為一種最佳實踐，建議使用try-catch封裝使用JCo庫進行參數(shù)設(shè)置和函數(shù)調(diào)用的代碼，處理上述兩種異常，并且在finally代碼塊中，釋放當(dāng)前所使用的連接。

遠程調(diào)試

一般的情況下，在SAP服務(wù)器上通過事務(wù)代碼SE37可以測試ABAP函數(shù)。在保證ABAP函數(shù)的正確性之后，Java客戶端只需要檢查輸入輸出參數(shù)是否正確即可。這時可以利用JCo庫為了方便調(diào)試而提供的了一個很強大的功能，把所有繼承自JCO.Record的類的對象格式化輸出到一個指定的HTML文檔中。通過這種方式，我們可以檢查輸入輸出參數(shù)是否正確。比如如下代碼輸出前面得到的FLIGHT_LIST參數(shù)的內(nèi)容：

JCO.Table flights = funGetList.getTableParameterList().getTable(

"FLIGHT_LIST");

flights.writeHTML("c:flight_list.html");

更進一步地，通過啟動ABAP的遠程調(diào)試功能，可以像調(diào)試普通程序一樣調(diào)試遠程調(diào)用的ABAP函數(shù)。

要實現(xiàn)遠程調(diào)試，首先需要在Java代碼中，通過調(diào)用JCO.Client類或者JCO.Pool類的setAbapDebug方法激活JCo的ABAP調(diào)試功能。如下代碼演示了如何激活一個連接池的ABAP調(diào)試功能：

JCO.Pool pool = JCO.getClientPoolManager().getPool(POOL_NAME);

pool.setAbapDebug(true);

如果一個連接池的ABAP調(diào)試功能被激活，那么其中的所有連接的ABAP調(diào)試功能都會被激活。使用這樣一個連接來調(diào)用ABAP函數(shù)的時候，SAP系統(tǒng)會自動彈出一個調(diào)試器窗口(如下圖所示)。當(dāng)然，前提是客戶端機器上已經(jīng)安裝了SAPGUI。

這時候調(diào)試器僅僅停留在RFC調(diào)用的入口處，而并未進入所調(diào)用的ABAP函數(shù)。

為了讓調(diào)試器直接進入ABAP函數(shù)，需要在事務(wù)代碼SE37中為該函數(shù)設(shè)置一個外部斷點(External BreakPoint)。

設(shè)置好外部斷點之后，還必須通過事務(wù)代碼SRDEBUG激活遠程調(diào)試功能。

如果之前沒有直接在代碼上設(shè)置過外部斷點的話，也可以直接在SRDEBUG中設(shè)置斷點所在的Function Module。 要注意的是，在調(diào)試結(jié)束之前，不要關(guān)閉SRDEBUG的窗口，否則系統(tǒng)將會立即關(guān)閉遠程調(diào)試功能。

此時，再執(zhí)行Java代碼，將會發(fā)現(xiàn)系統(tǒng)自動打開的DEBUG窗口自動停留在我們所設(shè)置的外部斷點的位置，而Java進程在調(diào)試結(jié)束之前將會被掛起。

在ABAP調(diào)試器中，可以檢查通過RFC協(xié)議傳過來的參數(shù)，以及ABAP程序運行的結(jié)果。通過這種方式，可以更清晰地跟蹤整個執(zhí)行過程。

調(diào)試結(jié)束的時候，不要忘記關(guān)閉SRDEBUG的窗口和清除外部斷點。

更多資源

限于篇幅，本文只能介紹關(guān)于JCo庫的基本使用方法。更進一步的技術(shù)細節(jié)，可以查看JCo庫的下載文件中自帶的文檔。

開發(fā)者還可以在如下連接的SAP的在線幫助文檔中找到豐富的文檔資料和示例程序：

http://help.sap.com/saphelp_nw70/helpdata/EN/6f/1bd5c6a85b11d6b28500508b5d5211/frameset.htm

報錯信息

RFC接口調(diào)用SAP如果有異常會通過com.sap.mw.jco.JCO$Exception: 拋出異常

在開發(fā)中遇到的異常有如下

用戶名密碼可能是錯誤或者用戶無權(quán)限,確認用戶,必要時聯(lián)系SAP負責(zé)人,檢查用戶

(103) RFC_ERROR_LOGON_FAILURE: ##.#####,####

(103) RFC_ERROR_LOGON_FAILURE: Name or password is incorrect (repeat logon)

call信息沒有填寫完整,檢查配置文件各個SAP配置信息是否完整

(101) RFC_ERROR_PROGRAM: Missing R3NAME=... or ASHOST=... in connect_param in RfcOpenEx

ip地址失敗：

com.sap.mw.jco.JCO$Exception: (102) RFC_ERROR_COMMUNICATION: Connect to SAP gateway failed

組權(quán)限訪問 server文件沒更新.

(102) RFC_ERROR_COMMUNICATION:Connect to message server failed

C:\WINNT\system32\drivers\etc

端口號錯誤報錯信息：

(103) RFC_ERROR_LOGON_FAILURE: ## 502 ########

超時:

(103) RFC_ERROR_LOGON_FAILURE: Timeout

執(zhí)行函數(shù),函數(shù)的問題

(104) RFC_ERROR_SYSTEM_FAILURE: Error in module RSQL of the database interface.執(zhí)行函數(shù)

(104) RFC_ERROR_SYSTEM_FAILURE: An error occurred when receiving a complex parameter.

(106) JCO_ERROR_RESOURCE: Trying to access row values in a table which does not have any rows yet

返回的表沒有值.那個表連第一行都沒有,取不到

(106) JCO_ERROR_RESOURCE: Trying to access row values in a table which does not have any rows yet

語法錯誤

(104) RFC_ERROR_SYSTEM_FAILURE: Syntax error in program SAPMV50A

找不到行

(106) JCO_ERROR_RESOURCE: Trying to access row values in a table which does not ha:ve any rows yet

輸入?yún)?shù)不能插入SAP函數(shù)輸入字段中.

(122) JCO_ERROR_CONVERSION: Integer '4234243' has to many digits at field PO_ITEM

總結(jié)

以上是生活随笔為你收集整理的rfcv函数实现_JAVA_用_JCO连接_SAP，实现调用SAP_的_RFC_函数(整理)(附一篇看起来比较全面的说明)(JCO报错信息)...的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。