JCO 自定義DestinationDataProvider

要讓JAVA程式能訪問SAP系統，一般透過SAP JCO介面進行通訊，在獲取到SAP的連線時需求提供一些連線引數，這些引數在最新的JCO 3.0中需要被儲存到一個帶有副檔名.jcoDestination的檔案中，這個檔案同時被儲存在應用程式的安裝目錄中。因為這隻中一個純文字檔案，所有的連線引數並沒有被加密，這樣對於公用程式可能有安全問題。要使用登陸連線更加安全可以實現自定義的DestinationDataProvider實現：
此介面只有簡單的三個方法：
interface DestinationDataProvider {
    Properties     getDestinationProperties(java.lang.String destinationName);
    void     setDestinationDataEventListener(DestinationDataEventListener eventListener);
    boolean     supportsEvents();
}

getDestinationProperties 當Java程式獲取到SAP的連線時，jco會從這裡讀取連線屬性，你可以程式設計動態的設定這些屬性
setDestinationDataEventListener 設定一個連線事件監聽器，實現一個監聽器，當JCO連線SAP以獲得通知
supportsEvents           返回是否被實現的DestinationDataProvider有事件監聽器

實現一個自定義Provider:
public class CustomDestinationDataProvider implements DestinationDataProvider {
    
    private Map providers = new HashMap();

     public Properties getDestinationProperties(String destName) {
        if (destName == null)
            throw new NullPointerException("請指定目的名稱");
        if (providers.size() == 0)
            throw new IllegalStateException("請加入一個目的連線引數屬性給提供者");
        return providers.get(destName);
    }
   
    // 沒有實現事件處理
    @Override
    public boolean supportEvents() {
        return false;
    }

    @Override
    public void setDestinationDataEventListener(DestinationDataEventListener listener) {
        throw new UnsupportedOperationException();
    }

    public void addDestinationProperties(String destName, Properties provider) {
        providers.put(destName, provider);
    }
}

測試連線：
public class TestCustomDestinationDataProvider {

    public static void main(String[] args) {
        Properties connectProperties = new Properties();
        connectProperties.setProperty(DestinationDataProvider.JCO_ASHOST, "hostname");
        connectProperties.setProperty(DestinationDataProvider.JCO_SYSNR,  "00");
        connectProperties.setProperty(DestinationDataProvider.JCO_CLIENT, "400");
        connectProperties.setProperty(DestinationDataProvider.JCO_USER,   "username");
        connectProperties.setProperty(DestinationDataProvider.JCO_PASSWD, "password");
        connectProperties.setProperty(DestinationDataProvider.JCO_LANG,   "en");

        CustomDestinationDataProvider provider = new CustomDestinationDataProvider();
        provider.addDestinationProperties("SAP_CONN", connectProperties);
        Environment.registerDestinationDataProvider(provider);

        try {
            JCoDestination dest = JCoDestinationManager.getDestination("SAP_CONN");
            dest.ping();
                System.out.println("連線成功");
        } catch (JCoException ex) {
                System.out.println(ex);
                System.out.println("連線失敗");
        }
    }
}