1、配置紫金橋WebService
首先運行想支持WebService功能的工程，然后在紫金橋安裝目錄下找到RealDbWebServic.exe程序，運行它，可以看到如下圖所示的運行界面。 程序運行后上方是菜單，中間詳細的列出了支持的各個函數被調用的次數，以及響應超時的次數。 顯示的信息的第一行為WebService在哪個端口提供服務，第二行為響應的詢問的次數，超時的次數，以及發生嚴重錯誤的次數。這里的超時是指的和Db數據庫通訊時的超時次數，嚴重錯誤是指的和Db數據庫通訊時發生的嚴重錯誤次數。 選擇菜單，可以看到有文件和幫助兩個子菜單，其中幫助菜單用來顯示當前程序的版本號。文件菜單又有“屬性設置”和“退出”兩個選項，其中退出選項用來退出當前的WebService服務，屬性設置用來更改Web服務所在的端口號。選擇屬性設置菜單，如下圖所示： 會彈出如下圖所示的設置端口號對話框： 可以在這里輸入新的端口號，值得注意的是，更改端口號之后，并不能馬上生效，只有當RealDbWebServic程序重啟后，所做的更改才會生效。
2、紫金橋WebService發布的方法
1）取得實時數據 bool GetRealData(string[] names, out string[] datas); 調用此函數可以獲得相應的位號的實時數據，其中names是輸入參數，為字符串數組，每一個字符串為位號的名稱比如“A1.PV”，注意這里需要包括參數名稱。 datas為輸出參數，為字符串數組，它包含的字符串個數和輸入參數names包括的字符串個數相同。 如果函數返回true，那么就可以通過datas來獲得相應位號的實時數據。 2）設置實時數據 bool SetRealData(string[] names, string[] datas); 調用此函數可以修改實時數據庫中相應位號的實時數據，names和datas都是輸入參數，意義請參見GetRealData。 如果函數返回true，那么實時數據庫中的相應位號的實時數據被成功修改。 3）取批量歷史數據 bool GetHisData(string name, DtTime startTime, double secondSpace, int nDataCount, out HisData[] datas); 其中name是需要取批量歷史數據的位號，比如“A1.PV”；startTime是取歷史的起始時間；secondSpace是讀取歷史數據的間隔，單位秒；nDataCount是讀取的歷史數據個數；datas為輸出數組參數，返回讀取的所有歷史數據。 其中HisData的定位如下： public class DtTime { public DateTime time; public short millsec; } public class HisData { public DtTime time; public double data; } HisData由兩個成員構成，一個為數據的時間time，一個為數據data 數據的時間DtTime也由兩個成員構成，一個為DateTime類型，一個為時間的毫秒數。 4）取一段時間范圍內的所有歷史數據 bool GetAllHisData(string name, DtTime startTime, int secondSpan, out HisData[] datas); 其中name是需要取批量歷史數據的位號，比如“A1.PV”；startTime是取歷史的起始時間；secondSpan是讀取歷史數據的時間跨度，單位秒；datas為輸出數組參數，返回讀取的所有歷史數據。HisData的定義請參見GetHisData。 5）插入批量歷史數據 bool InsertHisData(string name, HisData[] datas); 其中name是需要取批量歷史數據的位號，比如“A1.PV”；datas為輸入數組參數，傳入需要插入的所有歷史數據。HisData的定義請參見GetHisData。 6）取得實時報警信息 bool GetRealAlarm(int areaNo, int unitNo, out AlarmData[] alarms); areaNo為獲取的實時報警的區域號，-1代表所有區域；unitNo為獲取的實時報警的單元號，-1表示所有單元。alarms返回當前的符號條件的所有實時報警。AlarmData的定義如下： public class AlarmData { public string name; public string desc; public int type; public int prio; public int ack; public DtTime time; public double data; public double limit; public string eu; public int area; } 其中參數的意義如下： name表示位號名稱。 desc表示點說明。 type為報警的類型意義為0低低報，1低報，2高報，3高高報，4變化率，5偏差報警。 prio是報警的優先級，0恢復，1低級，2高級，3緊急 ack表示報警的確認狀態，0沒有確認，1確認，2恢復 time是報警的時間，DtTime的定義請參考GetHisData。 data是報警時刻的數據。 limit是報警發生時的限值。 eu是位號的工程單位。 area是位號所在的區域號。 7）取得歷史報警信息 bool GetHisAlarm(int areaNo, int unitNo, int day, out AlarmData[] alarms); areaNo為獲取的實時報警的區域號，-1代表所有區域；unitNo為獲取的實時報警的單元號，-1表示所有單元。day表示獲取哪一天的報警歷史，0表示是當天，-1表示前一天，其他類推。alarms返回當前的符號條件的所有歷史報警信息。AlarmData的定義請參考GetRealAlarm。 8）進行Sql查詢 bool SqlQuery(string sql, out string[] types, out string[][] result); 參數sql是所查詢的sql命令，types返回result中每一列的類型，字符型為“string”，整型為“int”，浮點類型為“real”。result是一個二維數組，返回查詢的結果。
3、在C#下調用紫金橋WebService
使用C#調用紫金橋WebService的步驟主要有兩步： 1）根據WSDL文件產生調用WebService的接口 打開VS進入C#開發環境，選擇菜單“工具/Visual Studio Command Prompt”進入命令行模式： 在命令行鍵入： wsdl /l:CS /o:x:/realDb.cs x:/realdb.wsdl 上面的X:為紫金橋提供的realdb.wsdl文件所在的目錄，也是輸出realDb.cs的目錄，可以根據具體情況靈活處理。 執行命令后，就會生成realDb.cs文件，可以在C#項目中使用。 2）在C#下編寫代碼調用接口訪問WebService 把realDb.cs加入到C#項目中，并調用相應的接口函數即可調用相應的WebService功能。注意在realDb.cs的前面有如下的代碼： this.Url = "http://localhost:1997"; 這里是說當前WebService所在的機器為本機，端口號為1997，這里可以根據需要修改成合適的地址。 取實時數據的示例代碼： string[] names = new string[4]; names[0] = "A1.PV"; names[1] = "A2.PV"; names[2] = "A3.PV"; names[3] = "A4.DESC"; string[] datas; Service s = new Service(); s.GetRealData(names, out datas); int nCount = datas.GetUpperBound(0) + 1; realData.Text = ""; for (int i = 0; i < nCount; ++i) { realData.Text += datas[i] + " "; } 設置實時數據的示例代碼： string[] names = new string[4]; names[0] = "A1.PV"; names[1] = "A2.PV"; names[2] = "A3.PV"; names[3] = "A4.DESC"; string[] datas = new string[4]; datas[0] = "1"; datas[1] = "2"; datas[2] = "3"; datas[3] = "設置成功"; Service s = new Service(); s.SetRealData(names, datas); 取歷史數據的示例代碼： Service s = new Service(); DtTime dt = new DtTime(); dt.time = new System.DateTime(2013, 11, 29, 15, 36, 0); dt.millsec = 0; HisData[] datas; s.GetHisData("A1.PV", dt, 1, 4, out datas); int nCount = datas.GetUpperBound(0) + 1; his_data_edit.Text = ""; for (int i = 0; i < nCount; ++i) { his_data_edit.Text += datas[i].time.time.ToString() + " " + datas[i].data.ToString() + "\r\n"; } 插入歷史數據的示例代碼： Service s = new Service(); DtTime dt = new DtTime(); HisData[] datas = new HisData[4]; datas[0] = new HisData(); datas[0].time = new DtTime(); datas[0].time.time = new System.DateTime(2013, 11, 29, 15, 36, 0); datas[0].data = 1; datas[1] = new HisData(); datas[1].time = new DtTime(); datas[1].time.time = new System.DateTime(2013, 11, 29, 15, 36, 1); datas[1].data = 12; datas[2] = new HisData(); datas[2].time = new DtTime(); datas[2].time.time = new System.DateTime(2013, 11, 29, 15, 36, 2); datas[2].data = 123; datas[3] = new HisData(); datas[3].time = new DtTime(); datas[3].time.time = new System.DateTime(2013, 11, 29, 15, 36, 3); datas[3].data = 1234; s.InsertHisData("A1.PV", datas); 取得實時報警的示例代碼如下： Service s = new Service(); AlarmData[] alarms; s.GetRealAlarm(-1, -1, out alarms); int nCount = alarms.GetUpperBound(0) + 1; alarm_edit.Text = ""; for (int i = 0; i < nCount; ++i) { alarm_edit.Text += alarms[i].time.time.ToString() + " " + alarms[i].data.ToString() + " " + alarms[i].name + " " + alarms[i].desc + " " + alarms[i].eu + " " + alarms[i].data.ToString() + " " + alarms[i].limit.ToString() + "\r\n"; }
4、在Java下調用紫金橋WebService
在Java下可以使用Axis2來調用紫金橋的WebService，Axis2是Apache下的一個重量級WebService框架，準確說它是一個Web Services / SOAP / WSDL 的引擎，是WebService框架的集大成者，它能不但能制作和發布WebService，而且可以生成Java和其他語言版WebService客戶端和服務端代碼。 Axis2的下載地址為： http://apache.dataguru.cn//axis/axis2/java/core/1.6.2/axis2-1.6.2-bin.zip 下面著重介紹在Java下如何通過Axis2 調用紫金橋Web Service。 使用Axis2調用紫金橋WebService的步驟主要有兩步： 1）根據WSDL文件產生調用WebService的接口 Axis2提供了一個wsdl2java.bat命令，可以根據WSDL文件自動產生調用WebService的接口代碼。在紫金橋安裝目錄下可以找到realdb.wsdl文件，通過wsdl2java.bat命令即可利用此文件生成相應的調用WebService的接口代碼。 wsdl2java.bat命令可以在 /bin目錄中找到。在使用wsdl2java.bat命令之前需要設置AXIS2_HOME環境變量，該變量值是。
注意事項：
Realdb.wsdl中的soap:address location和soap12:address location默認為localhost，端口號默認為1997。
如果想讓其他網絡機器可以訪問Web Service，需將localhost替換成本機IP，如本機IP為 192.168.0.1 替換后如下所示：
替換完畢后，重新運行wsdl2java即可重新生成調用WebService的接口代碼。
