Java 如何調用 SPL 腳本

集算器提供了 JDBC 驅動，很容易嵌入到 Java 程序調用，方法和在 Java 中執行 SQL 和存儲過程相似。

Java 應用程序中部署集算器 JDBC

首先將 JDBC 部署到 java 應用項目中，簡單來講就是，將啓動 JAVA 應用程序時加載集算器所需的 jar 包及配置文件放到項目中。須要注意的是，集算器 JDBC 所要求的 JDK 版本不得低於 1.6。

1. 加載驅動 jar

集算器 JDBC 相似一個不帶物理表的數據庫 JDBC 驅動，能夠把它簡單的當作是一個只有存儲過程的數據庫。另外，集算器 JDBC 是個徹底嵌入式計算引擎，已經在 JDBC 中完成了全部運算，不象數據庫那樣 JDBC 只是個接口，實際運算在獨立的數據庫服務器完成。

若是在 web 應用項目下，能夠把這些 jar 包放在 WEB-INF/lib 目錄下。集算器 JDBC 須要三個基礎 jar 包，均可以在 [安裝目錄]\esProc\lib 目錄下找到：

dm.jar  //集算器計算引擎及JDBC驅動包
icu4j_3_4_5.jar  //處理國際化 
jdom.jar  //解析配置文件

除了以上的必需 jar，還有一些爲完成特定功能的 jar 包：
好比數據庫做爲數據源，那麼還須要相應數據庫的驅動 jar 包；
要讀寫 Office 文件，則須要加入 poi*.jar 和 xmlbeans.jar;
要使用繪製圖形功能，則須要加入 SVG 圖形處理相關的 jar 包，包括 batik*.jar、js.jar、pdf-transcoder.jar、xalan-2.6.0.jar、xercesImpl.jar、xml-apis.jar、xml-apis-ext.jar。

2. 部署 raqsoftConfig.xml

集算器還有個重要的配置文件 raqsoftConfig.xml，能夠在 [安裝目錄]\esProc\config 下找到，需複製後放置在應用項目的類路徑下，配置文件的名稱不可改變。
在 raqsoftConfig.xml 文件中，配置了受權信息、集算器主路徑、dfx 文件尋址路徑等各種信息。咱們先看下最基本的配置，即集算器受權文件配置：

<?xml version="1.0" encoding=" UTF-8"?>
< Config Version="2">
<Runtime>
<Esproc>
    <!--集算器受權文件配置，能夠是絕對路徑，也能夠是相對路徑，使用相對路徑時是相對於類路徑-->
    <license>esproc.xml</license>
    <!--試用受權文件可從潤乾公司官網中下載-->
</Esproc>
</Runtime>
</Config>

Java 調用

Java 程序中調用 SPL 腳本 ，與 java 中調用 SQL 和存儲過程相似，下面來看下具體是怎樣實現的：

執行 SPL 語句

好比建立一個數據表，並添加兩個字段 baseNum、square2，分別將 100 之內的天然數及其的平方值組成 100 條記錄插入到數據表中，最後將表中的數據做爲結果集返回。

Java 代碼以下：

public  void runSPL() throws ClassNotFoundException, SQLException{
        Connection con = null;
        PreparedStatement st;
        ResultSet set ;
    //創建鏈接
    Class._forName_("com.esproc.jdbc.InternalDriver");
    con= DriverManager._getConnection_("jdbc:esproc:local://");
    //直接執行SPL語句，返回結果集
    st = (PreparedStatement)con.createStatement();
    ResultSet rs = st.executeQuery("=100.new(~:baseNum,~*~:square2)");
    //簡單處理結果集，將結果集中的字段名與數據輸出 
      ResultSetMetaData rsmd = rs.getMetaData();
      int colCount = rsmd.getColumnCount();
    for ( int  c = 1; c <= colCount;c++) {
    String title = rsmd.getColumnName(c);
    if( c > 1 ) {
        System._out_.print("\t");
    }
    else {
        System._out_.print("\n");
    }
        System._out_.print(title);
  }
    while (rs.next()) {
     for(int c = 1; c<= colCount; c++) {
       if ( c > 1 ) {
            System._out_.print("\t");
  }
       else {
            System._out_.print("\n");
  }
     Object o = rs.getObject(c);
     System._out_.print(o_.toString());
  }
  }
   //關閉鏈接
   if (con!=null) {
        con.close();
   }

執行結果：

在 SPL 中訪問本地文件

經過 SPL 還能夠訪問本地的文件，其中包括 Txt、Excel、Json、Csv、Ctx 等多種類型的文件，訪問時能夠經過絕對路徑查文件位置，也能夠經過相對路徑查找，使用相對路徑時，則是相對於配置文件中的主目錄，因此，首先咱們來配置下主目錄：
在 raqsoftConfig.xml 文件的節點 < Esproc ></ Esproc > 中添加如下節點：

<!--集算器主路徑，該路徑爲單一的絕對路徑-->
<mainPath>D:\mainFile</mainPath>

咱們把要調用的文件 employee.txt 放到主目錄下面，在 JAVA 中調用時，創建鏈接、輸出結果等部分的代碼與上例是徹底相同的，調用 SPL 語句部分以下：

ResultSet rs=st.executeQuery("=file(\"D:\mainFile\employee.txt\").import@t()");

這裏支持絕對路徑與相對路徑的使用，在 Java 中使用反斜槓 \ 表示轉義符。

執行結果：

對於這種簡單運算，還可使用簡單 SQL 語法：

ResultSet rs=st.executeQuery("$()select * from employee.txt");

其中 $() 表示訪問本地文件系統，兩種寫法的結果集相同。

帶參數的 SPL 語句

參數是 SQL 語句的一個重要組成部分，一樣，SPL 語句中也支持參數的使用，例如，像上例中，要查詢 employee.txt 文件中的數據，可是要求只查詢工資在 12000 到 20000 之間的記錄，並根據工資升序排序：

調用部分代碼以下：

PreparedStatement pst = con.prepareStatement("$()select * from employee.txt where SALARY > ? and SALARY< ? order by SALARY");
//設置參數
 pst.setObject(1,12000);
 pst.setObject(2,20000);
 ResultSet rs = pst.executeQuery();

其中用？表示參數，而後經過 setObject() 爲上面的參數一一賦值。

執行結果：

有數據源的 SPL 語句

集算器 JDBC 既然是個數據計算引擎，那麼數據來源的重要途徑之一就是數據庫了，JAVA 中如何來調用帶數據源的 SPL 語句呢？往下看：
JAVA 調用帶數據源的 SPL 語句以前，須要先在應用項目中添加對應的數據庫驅動，而後在配置文件 raqsoftConfig.xml 中配置數據源信息。
例如：調用的 SPL 語句中使用的數據源名稱爲 demo，數據庫類型爲 HSQL，那麼配置以下：
首先，將 HSQL 的數據集驅動 hsqldb.jar 加載到應用項目中；
其次，在 raqsoftConfig.Xml 的 < Runtime ></ Runtime > 節點中配置數據源信息：

<DBList>
<DB name="demo"> <!--數據源名稱-->
<property name="url" value="jdbc:hsqldb:hsql://127.0.0.1/demo" /> <!-- url鏈接-->
<property name="driver" value="org.hsqldb.jdbcDriver" /> <!--數據庫驅動-->
<property name="type" value="13" /> <!--數據庫類型-->
<property name="user" value="sa" /> <!--用戶名-->
<property name="password" value=""/> <!--密碼-->
<property name="batchSize" value="1000" />
<property name="autoConnect" value="true" /><!--是否自動鏈接，若是設定爲true，則能夠直接以$開頭的SQL語句來訪問數據庫，若是爲false，則不會自動鏈接，使用前必須用connect(db)語句建立數據庫鏈接-->
<property name="useSchema" value="false" />
<property name="addTilde" value="false" />
<property name="dbCharset" value="UTF-8" />
<property name="clientCharset" value="UTF-8" />
<property name="needTransContent" value="false" />
<property name="needTransSentence" value="false" />
<property name="caseSentence" value="false" />
</DB>
</DBList>

如今咱們經過 SPL 從 demo 數據源中查詢 SALES 表，過濾出 SELLERID 爲 3 的員工，在 2014 年 11 月 11 號到 2014 年 12 月 12 號期間的全部訂單信息：

調用部分代碼以下：

PreparedStatement pst = con.prepareStatement("$(demo)select * from SALES  where  SELLERID = ? and  ORDERDATE>? and ORDERDATE<?");
//設置參數
 pst.setObject(1,"3");
 pst.setObject(2,java.sql.Date.valueOf("2014-11-11"));
 pst.setObject(3,java.sql.Date.valueOf("2014-12-12"));
//獲取結果集
 ResultSet rs = pst.executeQuery();

結果集輸出以下：

執行 SPL 腳本

JAVA 集成集算器 JDBC 後，除了能夠直接執行單句的 SPL 語句，還能夠調用更復雜的 SPL 腳本（後綴爲 dfx 的文件）。
好比下面的 dfx 文件：

         

SPL 腳本思路：
循環遍歷 CITIES 表記錄，經過 CITIES. STATES 過濾 STATES 表，若 STATES. ABBR 首字母爲參數 arg1，則將 STATES 表中的 NAME 值賦給 CITIES. STATE，並將 CITIES 表中的這條記錄拼接到 B1 格中，最終返回 B1 格的結果集。
在這個網格文件中，須要從數據源 demo 中獲取數據，同時使用了參數 arg1：

數據源配置方法能夠參考上面的示例，網格文件保存爲 city.dfx，dfx 文件能夠存放在應用項目類路徑或 raqsoftConfig.xml 中配置的主目錄下，當 dfx 文件比較多的時候，爲了便於統一維護和管理，咱們還能夠將 dfx 文件放到 dfx 尋址路徑中，尋址路徑的配置方式以下：
在 raqsoftConfig.xml 文件的 < Esproc></ Esproc> 節點中，添加如下內容：

<dfxPathList>
   <!--配置dfx文件尋址路徑，該路徑爲絕對路徑，能夠設置多個路徑，以「;」隔開-->  
   <dfxPath>D:\dfxFile</dfxPath>
</dfxPathList>

調用部分代碼以下：

//經過call調用存儲過程，其中city是dfx的文件名，?表示參數，多個參數間用逗號間隔
  st =con.prepareCall("call city(?)");
  st.setObject(1, "A");
  //獲取結果集
  ResultSet rs = st.executeQuery();

經過 call 調用 dfx 文件除了上面的寫法，還能夠在調用 dfx 時直接傳參，以下：

 st=con.prepareStatement("call city(\"A\")");
  //獲取結果集
  ResultSet rs = st.executeQuery();

執行結果：

在 Java 中調用 dfx 文件時，也能夠省略 call 直接使用 dfx (…)，該用法一樣有兩種寫法，以下：

 //dfx名稱與參數間以空格做爲分隔，多個參數間經過逗號分隔
  st =con.prepareCall("city ?");
  //設置參數
  st.setObject(1,"A");

或：

st =con.prepareCall("city \"A\"");

以上幾種調用方法最終獲取的結果集均相同。
上述內容就是 Java 調用 SPL 腳本的經常使用方式了，想了解更多用法的小夥伴兒能夠去官網上的在線教程中查看