前段時間開發聯通彩e接口，期間遇到很多問題，在朋友的幫助和自己的摸索中總算完成了接口的開發。 在sp聯盟論壇上也見到許多同行各種各樣的問題，因此將開發細節整理成文，希望能給與我當初一樣 困擾的人以幫助。 第一次接觸彩e,感覺有點無從下手，接口指南幾百頁之多，我在開發的時候不知道聯通提供測試的接入 平臺以供調試，而是對着接口規範編寫代碼，然後模擬接口規則生成數據，這些都是在單元測試中完成 的，到接入uni-wise測試環境時，問題多多。
概述
本文以java語言爲例，講述彩e接口開發的點滴。參考的接口指南爲《中國聯通增值業務綜合管理及接入平臺SP接口規範v1.2》， 文中代碼均經過測試，且與uni-wise平臺能正常運行。彩e與sp接口包括:sso接口、預定接口、取消接口、彩e push接口，取 消push接口，查詢push接口、wap push接口。文中除了wap push接口，其餘的將會一一介紹。 彩e接口的開發其實就是sp與聯通uni-wise平臺之間的通信，uni-wise平臺是以web方式工作，因此與sp的交互大部分通 過http+xml協議傳輸。 筆者在開發的過程中也曾用C#寫過彩e的部分接口代碼，如有此需求，我也將整理成文。
SSO 是 Single sign on的縮寫，即單點登錄，彩e接口中實現的功能是，用戶在uni-wise平臺或sp平臺只需登錄一次，即可 訪問相關資源。通過cookies機制實現。
1.1. 傳輸安全
出於安全考慮，網絡的傳輸中經常對傳輸數據做加密和編碼處理，彩e接口開發中的一個關鍵點也是對加密解密的代碼編寫。 其中涉及以下幾種：
1、md5加密，該加密算法是單向加密，即加密的數據不能再通過解密還原。相關類包含在java.security.MessageDigest包中。
2、3-DES加密，該加密算法是可逆的，解密方可以通過與加密方約定的密鑰匙進行解密。相關類包含在javax.crypto.*包中。
3、base64編碼，是用於傳輸8bit字節代碼最常用的編碼方式。相關類在sun.misc.BASE64Decoder 和sun.misc.BASE64Encoder 中。
4、URLEncoder編碼，是一種字符編碼，保證被傳送的參數由遵循規範的文本組成。相關類在java.net.URLEncoder包中。
1.2. 生成請求票根
當用戶從SP平臺向uni-wise發起登錄請求時，SP平臺需要生成一個合法的票根，以http協議傳輸給uni-wise平臺。 生成請求票根的規則是：SPTicketRequestValue = URLEncoding{UNICODE(SPCode +“$”)+ Base64 [Encrypt （UNICODE(Seed + “$”)+ Digest)]}
1、生成Seed: returnUrl + "$" + timeStamp;returnUrl爲登錄成功後接收uni-wise的響應票根鏈接。timeStamp爲生成的 時間戳。
例 1.1. TimeStamp實現代碼
public String getTimeStamp()
{
Calendar cal=Calendar.getInstance();
SimpleDateFormat formatter = new SimpleDateFormat("yyyyMMddHHmmss.SSS");
String timeStamp=formatter.format(cal.getTime());
return timeStamp;
}
2、生成Digest :Base64{Hash[UNICODE(SPCode +"$"+ Seed + "$" + SPKey)]},其中Hash算法採用md5
例 1.2. Digest的實現代碼
public String getDigest(String strSrc)
{
//String strSrc = spCode + "$" + getSeed() + "$" + spKey;
BASE64Encoder base64en = new BASE64Encoder();
String digest="";
try
{
byte[] srcMD5 = md5Encrypt(strSrc);
digest = base64en.encode(srcMD5); (1)
}
catch(Exception e){
e.printStackTrace();
}
return digest;
}
private byte[] md5Encrypt(String strSrc)
{
byte[] returnByte = null;
try
{
MessageDigest md5 = MessageDigest.getInstance("MD5"); (2)
returnByte = md5.digest(strSrc.getBytes("GBK"));
}
catch(Exception e)
{
e.printStackTrace();
}
return returnByte;
}
(1) 用base64編碼
(2) 指定加密方式爲md5
（未完待續）
