專利名稱：一種soap api轉(zhuǎn)換為rest api的公共消息頭承載方法及裝置的制作方法
技術(shù)領(lǐng)域：
本發(fā)明涉及通信技術(shù)領(lǐng)域，尤其涉及一種SOAP API轉(zhuǎn)換為REST API的公共消息 頭承載方法及裝置。
背景技術(shù)：
簡單對象訪問協(xié)議應(yīng)用程序編程接口(SOAP API，Simple Object Access Protocol Application Programming Interface)為基于 Web Service 機(jī)白勺應(yīng)用軟件系 統(tǒng)間實(shí)現(xiàn)互連互通的接口，SOAP API使基于不同操作系統(tǒng)、不同語言開發(fā)出的應(yīng)用軟件方 便實(shí)現(xiàn)互通。整個SOAP API消息包括消息頭(header承載)和消息體(body承載)。消息 頭用于承載公共信息，用于鑒權(quán)認(rèn)證等公共處理；消息體用于承載業(yè)務(wù)相關(guān)信息，用于業(yè)務(wù) 相關(guān)處理。表行化的狀態(tài)轉(zhuǎn)移應(yīng)用程序編程接口(REST API, Representational State Transfer Application Programming Interface)為基于互聯(lián)網(wǎng)的WEB應(yīng)用能力之間常用 的互操作接口，即遵循REST風(fēng)格的API，遵循REST風(fēng)格的API對應(yīng)的系統(tǒng)為REST風(fēng)格的系 統(tǒng)，REST風(fēng)格的系統(tǒng)特點(diǎn)包括對外開放的信息都為資源，資源通過傳統(tǒng)TOB技術(shù)的通用資 源標(biāo)識符(URI，Uniform Resource Identifier)來標(biāo)識；及該對外開放的資源操作只有4 個，包括增加、修改、刪除、獲取，分別對應(yīng)傳統(tǒng)WEB技術(shù)超文本傳輸協(xié)議(HTTP，Hyper Text Transfer Protocol)協(xié)議中 Post (增加),Put (修改)、Delete (刪除),Get (獲取)。隨著互聯(lián)網(wǎng)的快速發(fā)展，預(yù)示著所有能力都可以向互聯(lián)網(wǎng)開放，例如傳統(tǒng)的使用 Web service的應(yīng)用系統(tǒng)開始向互聯(lián)網(wǎng)開放，因此，需要將SOAP API開放為對應(yīng)的REST API (即SOAP API轉(zhuǎn)換為REST API)，SOAP API開放為對應(yīng)的REST API時，對業(yè)務(wù)部分內(nèi) 容都會抽象為一個個資源，SOAP公共消息頭部分需要在新的REST API接口尋找一個公共 的承載點(diǎn)。由于WEB技術(shù)應(yīng)用HTTP協(xié)議，WEB應(yīng)用的HTTP協(xié)議的HTTP消息頭，主要承載 HTTP協(xié)議客戶端和服務(wù)器協(xié)商相關(guān)字段；HTTP消息體，主要承載業(yè)務(wù)消息。因此，在SOAP API轉(zhuǎn)換為REST API時，需要在HTTP中尋找合適位置攜帶SOAP消息頭相關(guān)內(nèi)容?，F(xiàn)有技術(shù)一提供的SOAP API轉(zhuǎn)換為REST API的技術(shù)方案為擴(kuò)展HTTP消息頭字 段，以X開頭增加SOAP消息頭要攜帶的內(nèi)容，如下POST http://www. example, com/sms/1. 0/smsmessaging/outbound/100860001/ requests HTTP/1. 1Authorization:Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ ==Accept: application/xmlContent-Type:application/xml ；charset = UTF-8Host:example· com:80X-Partner-Id:3500001X-Service-Id:35000010001
此擴(kuò)展導(dǎo)致HTTP協(xié)議字段中頭域名非常多，并且很混亂。且HTTP協(xié)議字段的擴(kuò) 展一般和HTTP協(xié)議客戶端和服務(wù)器底層協(xié)商機(jī)制相關(guān)，此擴(kuò)展導(dǎo)致客戶端與服務(wù)器底層 協(xié)商處理速度變慢?，F(xiàn)有技術(shù)二提供的SOAP API轉(zhuǎn)換為REST API的技術(shù)方案為將SOAP消息頭在 HTTP消息體中攜帶。然而，由于HTTP消息體主要承載業(yè)務(wù)消息，在每個業(yè)務(wù)消息的XML文件中包含消 息頭內(nèi)容，導(dǎo)致業(yè)務(wù)消息和消息頭強(qiáng)關(guān)聯(lián)，在文檔和程序的處理上獨(dú)立性不強(qiáng)。另外，在程 序處理時，必須解析整個業(yè)務(wù)消息體才能完成消息頭要求的認(rèn)證，造成處理速度緩慢。因此，現(xiàn)有的SOAP API轉(zhuǎn)換為REST API的技術(shù)，存在冗余以及造成消息處理速度 緩慢的問題。

發(fā)明內(nèi)容
本發(fā)明實(shí)施例提供一種SOAP API轉(zhuǎn)換為REST API的公共消息頭承載方法及裝置。本發(fā)明實(shí)施例是通過以下技術(shù)方案實(shí)現(xiàn)的本發(fā)明實(shí)施例提供一種簡單對象訪問協(xié)議應(yīng)用程序編程接口 SOAP API轉(zhuǎn)換為表 行化的狀態(tài)轉(zhuǎn)移應(yīng)用程序編程接口 REST API的公共消息頭承載方法，包括確定REST API公共消息承載字段；所述公共消息承載字段為位于RESTAPI消息 頭，且符合如下形式的字段一個頭域名+ —個頭域值+多個屬性值對；將SOAP消息頭的相關(guān)內(nèi)容以所述屬性值對的形式承載于所述公共消息承載字段 中。本發(fā)明實(shí)施例提供一種簡單對象訪問協(xié)議應(yīng)用程序編程接口 SOAP API轉(zhuǎn)換為表 行化的狀態(tài)轉(zhuǎn)移應(yīng)用程序編程接口 REST API的裝置，包括確定單元，用于確定REST API公共消息承載字段；所述公共消息承載字段為符合 如下形式的字段一個頭域名+ —個頭域值+多個屬性值對；轉(zhuǎn)換單元，用于將SOAP消息頭的相關(guān)內(nèi)容以所述屬性值對的形式承載于所述公 共消息承載字段中。由上述本發(fā)明實(shí)施例提供的技術(shù)方案可以看出，本發(fā)明實(shí)施例由于將SOAP消息 頭的相關(guān)內(nèi)容承載于REST API公共消息承載字段中，由于所述公共消息承載字段位于REST API消息頭，因此避免了業(yè)務(wù)消息和消息頭強(qiáng)關(guān)聯(lián)，以及在程序處理時，必須解析整個業(yè)務(wù) 消息體才能完成消息頭要求的認(rèn)證，造成的處理速度緩慢等問題；另外，由于所述公共消息 承載字段為符合如下形式的字段一個頭域名+—個頭域值+多個屬性值對，因此可以有效 避免頭域名過多導(dǎo)致的客戶端與服務(wù)器底層協(xié)商緩慢的問題。因此，本發(fā)明實(shí)施例提供的SOAP API轉(zhuǎn)換為REST API的公共消息頭承載方案，保 證了系統(tǒng)的簡潔性和比較好的協(xié)議解析性能。


圖1為本發(fā)明實(shí)施例一種SOAP API轉(zhuǎn)換為REST API的公共消息頭承載方法流程 圖2為本發(fā)明實(shí)施例一種SOAP API轉(zhuǎn)換為REST API的裝置結(jié)構(gòu)示意圖； 圖3為本發(fā)明實(shí)施例一種SOAP API轉(zhuǎn)換為REST API的裝置中確定單元結(jié)構(gòu)示意 圖4為本發(fā)明實(shí)施例另一種SOAP API轉(zhuǎn)換為REST API的裝置中確定單元結(jié)構(gòu)示
具體實(shí)施例方式下面將結(jié)合本發(fā)明實(shí)施例中的附圖，對本發(fā)明實(shí)施例中的技術(shù)方案進(jìn)行清楚、完 整地描述，可以理解的是，所描述的實(shí)施例僅僅是本發(fā)明一部分實(shí)施例，而不是全部的實(shí)施 例?；诒景l(fā)明中的實(shí)施例，本領(lǐng)域普通技術(shù)人員在沒有做出創(chuàng)造性勞動前提下所獲得的 所有其他實(shí)施例，都屬于本發(fā)明保護(hù)的范圍。本發(fā)明一個實(shí)施例提供一種SOAP API轉(zhuǎn)換為REST API的公共消息頭承載方法， 如圖1所示，包括如下步驟步驟10 確定REST API公共消息承載字段；所述公共消息承載字段為位于REST API消息頭，且符合如下形式的字段一個頭域名+ —個頭域值+多個屬性值對；所述公共消息承載字段可以為所述HTTP協(xié)議中的已有的字段，例如認(rèn)證 (Authorization)字段，或者，也可以為REST API中新創(chuàng)建的字段。不論是已有的字段還 是新創(chuàng)建的字段，都符合一個頭域名+ —個頭域值+多個屬性值對的形式，這樣可以有效避 免頭域名過多導(dǎo)致的客戶端與服務(wù)器底層協(xié)商緩慢的問題。其中，所述屬性值對包括屬性名+屬性值。本發(fā)明實(shí)施例對屬性值對的個數(shù)不做限制，可以為兩個，或更多。步驟11 將SOAP消息頭的相關(guān)內(nèi)容以所述屬性值對的形式承載于所述公共消息 承載字段中。其中，需要承載于所述公共消息承載字段中的所述SOAP消息頭的內(nèi)容隨互通的 應(yīng)用系統(tǒng)的不同而不同，本發(fā)明實(shí)施例對此不做限制。本發(fā)明實(shí)施例提供了一種簡潔方便的SOAP API轉(zhuǎn)換為REST API的公共消息頭承 載方案，由于將SOAP消息頭的相關(guān)內(nèi)容承載于REST API公共消息承載字段中，所述公共消 息承載字段位于REST API消息頭，因此避免了業(yè)務(wù)消息和消息頭強(qiáng)關(guān)聯(lián)，以及在程序處理 時，必須解析整個業(yè)務(wù)消息體才能完成消息頭要求的認(rèn)證，造成的處理速度緩慢等問題；另 外，由于所述公共消息承載字段為符合如下形式的字段一個頭域名+—個頭域值+多個屬 性值對，因此可以有效避免頭域名過多導(dǎo)致的客戶端與服務(wù)器底層協(xié)商緩慢的問題。因此，本發(fā)明實(shí)施例提供的SOAP API轉(zhuǎn)換為REST API的方法，保證了系統(tǒng)的簡潔 性和比較好的協(xié)議解析性能。本發(fā)明實(shí)施例提供的一種SOAP API轉(zhuǎn)換為REST API的實(shí)例如下以擴(kuò)展HTTP協(xié)議消息頭的“Authorization”字段為例，通過研究Authorization 字段發(fā)現(xiàn)，Authorization在HTTP協(xié)議中允許擴(kuò)展為不同的認(rèn)證模式，面向不同認(rèn)證模式 時，攜帶的消息屬性值對可以任意擴(kuò)展，在SOAP API轉(zhuǎn)換為REST API實(shí)例中，擴(kuò)展后的協(xié) 議如下，其中帶下劃線的部分為擴(kuò)展后的內(nèi)容，被擴(kuò)展字段為“Authorization”字段，位于 承載協(xié)商相關(guān)字段的HTTP協(xié)議消息頭，擴(kuò)展后的“Authorization”字段包含一個頭域名
CN 102143200 A
說明書3/7頁
0029]
圖；
意圖。
5Authorization，一個頭域值EXAMPLEAUTH realm = ” EXAMPLE，和多個由屬性名+屬性值組 成的屬性值對，如devld =” 3500001”，authType =”01”，authValue = ” QffxhZGRpb jpvcGVuIHNlc2FtZQ ==，，，timeStamp =”0415011502”，appld = ” 350000100020003”，SAN =” 100860001”，OA =” 13912345678”，F(xiàn)A =” 13912345678”，multicastMessaging = “ false"
本實(shí)施例擴(kuò)展后的HTTP協(xié)議如下POST http://www. example, com/sms/1. 0/smsmessaging/outbound/100860001/ requests HTTP/1. 1Accept: application/xmlContent-Type:application/xml ；charset = UTF-8Host:example, com:80Authorization:EXAMPLEAUTH realm =”EXAMPLE”，devld =” 3500001”,authType =，，01，，，authValue = ” QWxhZGRpb ipvcGVuIHNlc2FtZQ == ’，，timeStamp =” 0415011502”，appld = ” 350000100020003”，SAN =” 100860001”，OA =” 13912345678”，F(xiàn)A =” 13912345678”，multicastMessaging =，，false，，,< ？ xml version = " 1.0〃 encoding = " UTF-8 “ ？ >< s m s : outboundSMSMessageRequest xmlns : sms ="urn:oma:xml: rest:sms:1" ><address>tel:+1350000001</address><address>tel:+1350000999</address><senderAddress>tel:+1351111999</senderAddress>
<senderName>senderName</senderName><receiptRequest><notifyURL>http : / / appl ication. example, com/notifications/ DeliveryInfoNotification</notifyURL></receiptRequest><outboundSMSTextMessage><messag>Text Message</message>
</outboundSMSTextMessage><c1ientCorrelator>67893</cIientCorrelator></sms:outboundSMSMessageRequest>為進(jìn)一步理解本發(fā)明，下面以具體應(yīng)用場景為例進(jìn)行說明。本發(fā)明實(shí)施例提供的SOAP API轉(zhuǎn)換為REST API的方法一種應(yīng)用場景為電信能 力向互聯(lián)網(wǎng)應(yīng)用開放，如電信運(yùn)營商開放短信能力給互聯(lián)網(wǎng)應(yīng)用使用。開放的REST API公共消息頭攜帶互聯(lián)網(wǎng)應(yīng)用提供者和應(yīng)用標(biāo)識等信息到電信能 力開放網(wǎng)關(guān)，電信能力開放網(wǎng)關(guān)需要對應(yīng)用提供者和應(yīng)用標(biāo)識做鑒權(quán)認(rèn)證。本實(shí)例中將 SOAP消息頭的相關(guān)內(nèi)容存放到HTTP的“Authorization”字段，電信能力開放網(wǎng)關(guān)獲取HTTP 底層Authorization信息就可以完成鑒權(quán)認(rèn)證，不需要解析業(yè)務(wù)消息，提高處理速度，具體 REST API 消息如下，Authorization 為頭域名，EXAMPLEAUTH realm = "EXAMPLE”為頭域值， 下劃線部分為擴(kuò)展的字段，包含SOAP消息頭的相關(guān)內(nèi)容，以多個屬性值對的形式被加入到 Authorization 字段中POST http://www. example, com/sms/1. 0/smsmessaging/outbound/100860001/ requests HTTP/1. 1Accept: application/xmlContent-Type:application/xml ；charset = UTF-8Host:example, com:80Authorization:EXAMPLEAUTH realm =”EXAMPLE，，，devld =” 3500001”，authType =，，01，，，authValue = ” QWxhZGRpb ipvcGVuIHNlc2FtZQ == ’，，timeStamp =” 0415011502”，appld = ” 350000100020003”，SAN =” 100860001”，OA =” 13912345678”，F(xiàn)A =” 13912345678”，multicastMessaRinR =，，false，，,< ？ xml version = " 1.0〃 encoding = " UTF-8" ？ >< s m s : outboundSMSMessageRequest xmlns : sms ="urn:oma:xml: rest:sms:1" ><address>tel:+1350000001</address><address>tel:+1350000999</address><senderAddress>tel:+1351111999</senderAddress><senderName>senderName</senderName><receiptRequest><notifyURL>http : / / appl ication. example, com/notifications/ DeliveryInfoNotification</notifyURL></receiptRequest>
<outboundSMSTextMessage><message>Text Message</message></outboundSMSTextMessage><c1ientCorrelator>67893</cIientCorrelator></sms:outboundSMSMessageRequest>本發(fā)明實(shí)施例提供的SOAP API轉(zhuǎn)換為REST API的方法另一種應(yīng)用場景為電信 能力向終端應(yīng)用開放，如電信位置能力向終端應(yīng)用開放。終端應(yīng)用獲取自己或者他人位置時，需要攜帶公共的消息頭到能力開放網(wǎng)關(guān) 做認(rèn)證使用，可以在REST API的Authorization字段中攜帶。下發(fā)消息示例如下， Authorization為頭域名，EXAMPLEAUTH realm = "EXAMPLE”為頭域值，下劃線部分為擴(kuò)展的 字段，包含所述公共的消息頭的相關(guān)內(nèi)容，以多個屬性值對的形式被加入到Authorization 字段中GET http//www. example, com/1. 0/1erminallocation/13912345678/1ocation HTTP/1. 1Accept: application/xmlContent-Type:application/xml ；charset = UTF-8Host:example, com:80Authorization:EXAMPLEAUTH realm =”EXAMPLE，，，username =，，13912345678，，，authType =，，01，，，authValue = ” QWxhZGRpb ipvcGVuIHNlc2FtZQ == ’，，timeStamp =” 0415011502”< ？ xml version = " 1.0〃 encoding = " UTF-8 “ ？ ><terminalLocation:terminalLocationRequestxmlns: terminalLocation =" urn:oma:xml :rest: terminalLocation: 1" ><address>tel:+1350000001</address></terminalLocation:terminalLocationRequest)本發(fā)明實(shí)施例提供一種SOAP API轉(zhuǎn)換為REST API的裝置，如圖2所示，包括確定單元20，用于確定REST API公共消息承載字段；所述公共消息承載字段為位
于所述REST API消息頭，且符合如下形式的字段一個頭域名+ —個頭域值+多個屬性值 對；所述屬性值對包括屬性名+屬性值。轉(zhuǎn)換單元21，用于將SOAP消息頭的相關(guān)內(nèi)容以所述屬性值對的形式承載于所述 公共消息承載字段中。如圖3中所示，所述確定單元20 —種實(shí)施例進(jìn)一步包括選擇子單元201，用于在REST API消息頭的已有字段中選擇所述公共消息承載字 段，所選擇的字段包括認(rèn)證字段。如圖4中所示，所述確定單元20另一種實(shí)施例進(jìn)一步包括創(chuàng)建子單元202，用于在REST API消息頭中創(chuàng)建所述公共消息承載字段。本發(fā)明實(shí)施例所述SOAP API轉(zhuǎn)換為REST API的裝置，由于將SOAP消息頭的相關(guān)內(nèi)容承載于REST API公共消息承載字段中，所述公共消息承載字段位于REST API消息 頭，因此避免了業(yè)務(wù)消息和消息頭強(qiáng)關(guān)聯(lián)，以及在程序處理時，必須解析整個業(yè)務(wù)消息體才 能完成消息頭要求的認(rèn)證，造成的處理速度緩慢等問題；另外，由于所述公共消息承載字段 為符合如下形式的字段一個頭域名+—個頭域值+多個屬性值對，因此可以有效避免頭域 名過多導(dǎo)致的客戶端與服務(wù)器底層協(xié)商緩慢的問題。因此，本發(fā)明實(shí)施例提供的SOAP API轉(zhuǎn)換為REST API的裝置，保證了系統(tǒng)的簡潔 性和比較好的協(xié)議解析性能。綜上所述，本發(fā)明實(shí)施例由于將SOAP消息頭的相關(guān)內(nèi)容承載于RESTAPI公共消息 承載字段中，所述公共消息承載字段位于REST API消息頭，因此避免了業(yè)務(wù)消息和消息頭 強(qiáng)關(guān)聯(lián)，以及在程序處理時，必須解析整個業(yè)務(wù)消息體才能完成消息頭要求的認(rèn)證，造成的 處理速度緩慢等問題；另外，由于所述公共消息承載字段為符合如下形式的字段一個頭 域名+ —個頭域值+多個屬性值對，因此可以有效避免頭域名過多導(dǎo)致的客戶端與服務(wù)器 底層協(xié)商緩慢的問題。因此，本發(fā)明實(shí)施例提供的SOAP API轉(zhuǎn)換為REST API的公共消息頭承載方案，保 證了系統(tǒng)的簡潔性和比較好的協(xié)議解析性能。本領(lǐng)域普通技術(shù)人員可以理解，實(shí)現(xiàn)上述實(shí)施例方法中的全部或部分步驟是可以 通過程序來指令相關(guān)的硬件完成，所述的程序可以存儲于一計算機(jī)可讀存儲介質(zhì)中，例如 只讀存儲器(簡稱ROM)、隨機(jī)存取存儲器(簡稱RAM)、磁盤、光盤等。以上所述，僅為本發(fā)明較佳的具體實(shí)施方式
，但本發(fā)明的保護(hù)范圍并不局限于此， 任何熟悉本技術(shù)領(lǐng)域的技術(shù)人員在本發(fā)明揭露的技術(shù)范圍內(nèi)，可輕易想到的變化或替換， 都應(yīng)涵蓋在本發(fā)明的保護(hù)范圍之內(nèi)。因此，本發(fā)明的保護(hù)范圍應(yīng)該以權(quán)利要求的保護(hù)范圍 為準(zhǔn)。
權(quán)利要求
1.一種簡單對象訪問協(xié)議應(yīng)用程序編程接口 SOAP API轉(zhuǎn)換為表行化的狀態(tài)轉(zhuǎn)移應(yīng)用 程序編程接口 REST API的公共消息頭承載方法，其特征在于，包括確定REST API公共消息承載字段；所述公共消息承載字段為位于RESTAPI消息頭，且 符合如下形式的字段一個頭域名+ —個頭域值+多個屬性值對；將SOAP消息頭的相關(guān)內(nèi)容以所述屬性值對的形式承載于所述公共消息承載字段中。
2.如權(quán)利要求1所述的方法，其特征在于，所述公共消息承載字段為認(rèn)證字段。
3.如權(quán)利要求1所述的方法，其特征在于，所述公共消息承載字段為新創(chuàng)建的字段。
4.如權(quán)利要求1所述的方法，其特征在于，所述屬性值對包括屬性名+屬性值。
5.一種簡單對象訪問協(xié)議應(yīng)用程序編程接口 SOAP API轉(zhuǎn)換為表行化的狀態(tài)轉(zhuǎn)移應(yīng)用 程序編程接口 REST API的裝置，其特征在于，包括確定單元，用于確定REST API公共消息承載字段；所述公共消息承載字段為符合如下 形式的字段一個頭域名+ —個頭域值+多個屬性值對；轉(zhuǎn)換單元，用于將SOAP消息頭的相關(guān)內(nèi)容以所述屬性值對的形式承載于所述公共消 息承載字段中。
6.如權(quán)利要求5所述的裝置，其特征在于，所述確定單元進(jìn)一步包括選擇子單元，用于在REST API協(xié)議消息頭的已有字段中選擇所述公共消息承載字段， 所選擇的字段包括認(rèn)證字段。
7.如權(quán)利要求5所述的裝置，其特征在于，所述確定單元進(jìn)一步包括創(chuàng)建子單元，用于在REST API協(xié)議消息頭中創(chuàng)建所述公共消息承載字段。
8.如權(quán)利要求5、6或7所述的裝置，其特征在于，所述屬性值對包括屬性名+屬性值。
全文摘要
一種通信技術(shù)領(lǐng)域中SOAP API轉(zhuǎn)換為REST API時公共消息頭承載方法，包括確定RESTAPI公共消息承載字段；所述公共消息承載字段為位于REST API消息頭，且符合如下形式的字段一個頭域名+一個頭域值+多個屬性值對；將SOAP消息頭的相關(guān)內(nèi)容以所述屬性值對的形式承載于所述公共消息承載字段中。本發(fā)明實(shí)施例還提供一種SOAP API轉(zhuǎn)換為REST API的裝置。本發(fā)明實(shí)施例避免了現(xiàn)有的轉(zhuǎn)換方案中，業(yè)務(wù)消息和消息頭強(qiáng)關(guān)聯(lián)，以及在程序處理時，必須解析整個業(yè)務(wù)消息體才能完成消息頭要求的認(rèn)證，造成的處理速度緩慢等問題；同時，還有效避免頭域名過多導(dǎo)致的客戶端與服務(wù)器底層協(xié)商緩慢的問題。
文檔編號H04L29/08GK102143200SQ20101051629
公開日2011年8月3日 申請日期2010年10月20日 優(yōu)先權(quán)日2010年10月20日
發(fā)明者呂軍濤 申請人:華為技術(shù)有限公司