/****************************************************************
* 軟件:Java簽名協議擴展 (Java Signature Protocol Extension, JSPE)
* 版本:V1.0
* 軟件功能:實現SSL簽名協議
* 模塊:公共接口SSLsignature_reply_callback
*-----------------------------------------------------------------
*                                 版權所有:中山大學軟件研究所 2002
*                          Programmed by 佛山張峰嶺 fszfl@21cn.com
*                                              2002.4 - 2002.5
*****************************************************************/
package com.zsusoft.zfl;
/**
* 這個接口定義當SSLsignature_reply對象接收到簽名請求時會調用的幾個回調函數，
* 由于SSLsignature_reply在一個獨立的線程中執行，用戶可以在這里加入對簽名前檢查，
* 提供簽名回應中的附加數據(Attach Data),簽名后處理等自己的處理邏輯。 
**/
public interface SSLsignature_reply_callback{
     /**
     *  表示接收到合法的簽名請求后檢查簽名請求中的數據,同時也可以在應用證書中加上對對方數字證書的檢查
     *  用戶可以在這個地方加入執行簽名前的一些前期處理，返回false表示拒絕簽名
     *  S_request是簽名請求數據
     *  partner_cert是從SSLsession中獲取的對方的證書
     **/
     public boolean Check_Signature_Request(Signature_request S_request,javax.security.cert.Certificate partner_cert);
     /**
     * 用戶加上簽名返回時的附加數據
     *  S_request是簽名請求數據
     **/
     public String Put_Attach_Data(Signature_request S_request);
     /**
     * 執行了數字簽名后的處理
     * sslsignature_record保存本次簽名的全部信息
     **/
     public void DoneSignature(SSLsignature_record sslsignature_record);
     /**
     * 捕捉到簽名過程中出錯
     * Desc:提示信息
     * e :例外情況
     **/
     public void CatchError(String Desc, Exception e);
}