中國(guó)電信qchat業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè).doc

中國(guó)中國(guó)電電信信 qchat 業(yè)務(wù)終業(yè)務(wù)終端參數(shù)配置接口技端參數(shù)配置接口技術(shù)術(shù)要求要求 群群組組數(shù)據(jù)分冊(cè)數(shù)據(jù)分冊(cè) （征求意（征求意見見稿）稿） 中國(guó)中國(guó)電電信股份有限公司廣州研究院信股份有限公司廣州研究院 二零壹零年三月二零壹零年三月 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 2 頁(yè) 目錄目錄 目錄目錄2 1 1范圍范圍4 1.1文檔更改歷史4 2縮略語(yǔ)縮略語(yǔ)5 3群組管理服務(wù)器群組管理服務(wù)器 httphttp 服務(wù)服務(wù)6 3.1支持的 http 方法6 3.2支持的 http 頭6 3.2.1適用于所有操作的頭6 3.2.2put 和 post 必須攜帶的頭6 3.2.3get 多播群組 gsk 必須攜帶的頭：q-cnonce7 3.2.4用于條件操作 http 頭7 3.3群組管理服務(wù)器 xcap 請(qǐng)求 url.8 3.4群組管理服務(wù)器器后向兼容對(duì)客戶端 xml 解析的要求10 4群組管理服務(wù)器群組管理服務(wù)器 httphttp 接口規(guī)范接口規(guī)范11 4.1概述11 4.2正常響應(yīng)11 4.2.1正常響應(yīng)描述11 4.3錯(cuò)誤響應(yīng)12 4.3.1錯(cuò)誤響應(yīng)描述12 4.4操作共享群組（shared group）文檔16 4.4.1data schema.16 4.4.2使用場(chǎng)景24 4.5多播共享群組的多播信息（multicast information）管理51 4.5.1data schema.51 4.5.2使用場(chǎng)景53 4.6組關(guān)聯(lián)（group association） 管理.64 4.6.1data schema.64 4.6.2使用場(chǎng)景65 4.7組查詢接口68 4.7.1data schema.68 4.7.2使用場(chǎng)景69 5群組管理服務(wù)器短消息（群組管理服務(wù)器短消息（sms）接口規(guī)范）接口規(guī)范.73 5.1glms 不同類型通知的短消息負(fù)荷.73 5.1.1組關(guān)聯(lián)更新通知73 5.1.2給組主管理人的“自動(dòng)退出”通知75 6典型的端到端用例典型的端到端用例76 6.1.1向共享群組里加組成員76 7群組服務(wù)器客戶端的配置信息群組服務(wù)器客戶端的配置信息79 7.1配置信息79 7.2主副地址切換建議79 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 3 頁(yè) 8對(duì)手機(jī)端和用戶管理平臺(tái)群組操作能力的建議對(duì)手機(jī)端和用戶管理平臺(tái)群組操作能力的建議80 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 4 頁(yè) 1 1范圍范圍 群組管理服務(wù)器(glms) 是基于 oma xdms 的體系要求實(shí)現(xiàn)的群組管理和 xml 文檔 管理服務(wù)器. 它提供對(duì)用戶的 xml 文檔如共享群組文檔的管理. 文檔的管理操作包 括讀取/增加/修改/刪除. 這些操作是通過(guò) xcap 接口完成的。群組管理服務(wù)器 (glms) 還提供群組的搜索能力?？蛻舳丝梢蕴峁┲T如組主管理人，組成員等信息來(lái)搜索 對(duì)應(yīng)的共享群組。 本文定義與群組管理服務(wù)器(glms)進(jìn)行通信時(shí)的接口規(guī)范。 本文用 glms 表示群組管理服務(wù)器。 1.1文檔更改歷史文檔更改歷史 時(shí)間時(shí)間說(shuō)明說(shuō)明 2009.2.16以下為更改的主要內(nèi)容： 3.3 : 增加對(duì) fqdn 使用的解釋 5.1 : 短消息負(fù)荷更改 5.1.1 : 終端獲取 xui 的方法更改 7.1 : 服務(wù)器故障轉(zhuǎn)移定時(shí)參數(shù)取值修改 7.2 : 增加了主副地址切換的方法建議 另外更改了一些拼寫錯(cuò)誤。 200.3 : 定義 q-cnonce 攜帶的 cnonce 格式 3.2.3, , 6.1.1: 增加 glms 在響應(yīng)消息中返回 q-cnonce 的內(nèi)容和示例，去掉 gsk time 需要加密的內(nèi)容 4.6.1, .2, 6.1.1, 組關(guān)聯(lián)中增加可選的 premium-flag 指示該 用戶是否為特別用戶 4.5.1 data schema 中 gsk-old, gsk-new 改為 256 bit，gsk-time 改為 32 bit. 并據(jù)此改動(dòng) , 6.1.1 中相應(yīng)數(shù)據(jù)的格式 200.1 data schema 中的修改為 4.5.1 data schema 中的修改為 2009.7.14 5.1、5.1.1、5.1.2：修改 glms 采用 smgp 協(xié)議要求及流程說(shuō)明。 2009.8.5 5.1、5.1.1、5.1.2：修改 glms 發(fā)送的為 ，以及針對(duì)的樣例“qchat”修改為 “ptt”。 2009.8.5 修改組關(guān)聯(lián)更新流程圖。 2009.8.5 修改組成員退出提示要求。 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 5 頁(yè) 時(shí)間時(shí)間說(shuō)明說(shuō)明 2009.8.31 1回退 2009.6.25 在 4.4.1 和 4.5.1 中做的對(duì) schema 的修改。即 schema 中“conference-id”仍然保持為minoccurs=“0“ 24.6.1 中 group-association 的 data schema 中加入“conference- id”元素。 34.6.1 中 group-association 的 data schema 中加入“xs:any”元 素以備將來(lái)擴(kuò)展別的元素 .2 和 6.1.1 中查詢用戶組關(guān)聯(lián)的返回消息示例中，加入 conference-id”元素。 5文檔 uri 示例中 改為 6. 文檔示例中用戶域名和群組域名改為 , 和 2009.11.18 更正圖 5-1 中的協(xié)議標(biāo)識(shí)。 2009.11.23 修改文檔中所有“”為 “”。 2010.3.1 修改文檔中所有“”為“”。 2010.3.25 修改文檔中所有“”為 “sh.glms.vnet.mobi:9444”。 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 6 頁(yè) 2縮略語(yǔ)縮略語(yǔ) 縮略語(yǔ)縮略語(yǔ)定義定義 3gpp3rd generation partnership project auidapplication usage id fqdnfully qualified domain name glmsgroup and list management server httphypertext transfer protocol ietfinternet engineering task force omaopen mobile alliance smppshort message peer-to-peer protocol smscshort message service center uri uniform resource identifier urluniform resource locator xcapxml configuration access protocol xdmxml document management xdmcxml document management client xdmsxml document management server xmlextensible markup language xuixcap user identity 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 7 頁(yè) 3群組管理服務(wù)器群組管理服務(wù)器 httphttp 服務(wù)服務(wù) 3.1支持的支持的 httphttp 方法方法 glms 支持以下 http 操作: http get （獲取群組信息） http put (根據(jù)不同的上下文，put 操作支持增加或修改群組內(nèi)容) http delete （刪除群組信息） http post （搜索群組信息） 3.23.2支持的支持的 httphttp 頭頭 3.2.1適用于所有操作的頭 用于認(rèn)證的頭: clientid “clientid” 在每個(gè)http請(qǐng)求中都必須攜帶. “clientid” 可以被 wap 網(wǎng)關(guān)或用戶群組管理平臺(tái)加入，并隨請(qǐng)求消息送到 glms。clientid 應(yīng)該攜帶明文的用戶 id 信息。glms 信任“clientid”所包含的用戶 id 就是請(qǐng)求發(fā)起者的 用戶 id。 注意：運(yùn)營(yíng)商也可以選用其它的 http 頭作為用于認(rèn)證的頭，如：3gpp-accerted- identify. 但所有的發(fā)送到 glms 的請(qǐng)求必須使用相同的頭。 用于識(shí)別客戶端協(xié)議版本的頭: glmsclientversion “glmsclientversion” 在每個(gè)http請(qǐng)求中都必須攜帶. glms 客戶端用“glmsclientversion”表示它所實(shí)現(xiàn)的 glms 協(xié)議版本。對(duì)應(yīng)于本規(guī)范，版本號(hào) 應(yīng)為“11.01” 注意：運(yùn)營(yíng)商也可以選用其它的 http 頭作為用于版本標(biāo)識(shí)的頭，如：glms-group- version. 但所有的發(fā)送到 glms 的請(qǐng)求必須使用相同的頭。 3.2.2 put 和 post 必須攜帶的頭 對(duì) xcap put 操作 , 下列 http 頭必須攜帶：“content type” 和 “content length”. content type content-type 頭域指定所包含的消息體的媒體類型。其格式為: content-type = “content-type“ “:“ media-type 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 8 頁(yè) glms 中有效的 content type 為: content-type: text/plain content-type: application/xcap-error+xml content-type: application/vnd.oma.poc.groups+xml content-type: application/xcap-el+xml content-type: application/xcap-att+xml content-type: application/group-association+xml content-type: application/vnd.oma.search+xml 參見接口定義確定在何種情況下使用何種 content type. content length content-length 頭域指定消息體的長(zhǎng)度 （8 位字節(jié)數(shù)）。其格式為： content-length = “content-length“ “:“ 1*digit 例如: content-length: 3495 3.2.3get 多播群組 gsk 必須攜帶的頭：q-cnonce 當(dāng)客戶端想要發(fā)送 xcap get 請(qǐng)求來(lái)獲取多播群組的包括 gsk 在內(nèi)的多播信息時(shí)，必須攜帶 q- cnonce 頭。該 http 頭包含 ptt 客戶端產(chǎn)生的 cnonce 值。glms 會(huì)利用該 cnonce 產(chǎn)生用于加密 gsk 的密鑰：pek。返回的 gsk 是加密后的格式。 q-cnonce 中攜帶的 cnonce 必須是 128 bit, 以 16 進(jìn)制格式傳送（0-9，a-e 為有效字符），如： q-cnonce: 102e3a4d516b7085910a1e2c3d40526a 在返回的響應(yīng)消息中，glms 會(huì)將請(qǐng)求中攜帶的 cononce 用 q-cnonce 頭帶回，以備終端使用。 具體參見 。 3.2.4用于條件操作 http 頭 http 定義了幾個(gè)可以被客戶端用來(lái)做條件請(qǐng)求的頭域：if-none-match 和 if-match。 客戶 端可以根據(jù)所請(qǐng)求資源的實(shí)體標(biāo)簽（entity tag）來(lái)做條件請(qǐng)求. 這些條件請(qǐng)求的頭域在請(qǐng) 求消息里是可選用的. 條件請(qǐng)求的頭域可以解決并發(fā)請(qǐng)求的沖突問(wèn)題。 if-match 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 9 頁(yè) if-match 請(qǐng)求頭域被 http 方法(put/delete)用來(lái)做有條件操作. 對(duì)一個(gè)或多個(gè)從 群組服務(wù)器獲得的實(shí)體，xds 客戶端可以在請(qǐng)求的if-match頭中包含某個(gè)實(shí)體的 entity tag 以確認(rèn)它所具有的那個(gè)實(shí)體是最新的. if-match 頭可以被用在以下場(chǎng)景中: 條件 put xdm 客戶端想增加或修改服務(wù)器 xdm 文檔中的某個(gè)元素（element），并且希望服務(wù)器所 具有的文檔版本和客戶端當(dāng)前所具有的那個(gè)文檔相同時(shí)才能修改?？蛻舳丝梢栽谡?qǐng)求中包 含 if-match 頭, 并將客戶端所具有的實(shí)體標(biāo)簽（entity tag）值寫在里面. 如果文檔已經(jīng)改變，群組服務(wù)器會(huì)拒絕這個(gè)請(qǐng)求返回 412 （條件失?。? 在這種情況下， 客戶端需要重新用 get 請(qǐng)求從服務(wù)器獲取這個(gè)文檔并保存服務(wù)器在 200 ok 中返回的新的 實(shí)體標(biāo)簽（entity tag）。 客戶端可以把新的實(shí)體標(biāo)簽（entity tag）放在 if-matc 頭中重新請(qǐng) 求修改文檔。 如果操作成功， 響應(yīng)消息的 etag 頭會(huì)包含剛被修改過(guò)的資源的新的實(shí)體標(biāo)簽（entity tag）。 條件 delete xdm 客戶端也可以在 delete 請(qǐng)求中包含 if-match 頭來(lái)做條件刪除. delete 請(qǐng)求的 200 ok 響應(yīng)會(huì)包含一個(gè) etag 頭域, 帶有所刪除元素所在的整個(gè)文檔的實(shí)體標(biāo)簽（entity tag） if-none-match if-none-match 請(qǐng)求頭域可以和 get 請(qǐng)求方法一起使用做條件請(qǐng)求. if-none-match 頭中可以 包含客戶端以前從服務(wù)器所獲取的資源實(shí)體的實(shí)體標(biāo)簽（entity tag）。 if-none-match 頭可以被用在以下場(chǎng)景中: 條件 get 當(dāng) xdm 客戶端本地存有一個(gè)文檔的版本，它可以做條件 get 來(lái)判斷服務(wù)器對(duì)統(tǒng)一文檔是 否有更新。如果本地文檔仍然是最新的，客戶端就不會(huì)重新下載文檔，以此節(jié)省網(wǎng)絡(luò)的使 用。為了達(dá)到這個(gè)目的，客戶端在 get 請(qǐng)求中攜帶 if-none-match 頭域，其中包含客戶端當(dāng) 前文檔的實(shí)體標(biāo)簽（entity tag）. 群組服務(wù)器如果發(fā)現(xiàn)服務(wù)器文檔標(biāo)簽和客戶端不同，會(huì)響 應(yīng) 200 ok. 如果服務(wù)器文檔標(biāo)簽和客戶端相同, 服務(wù)器會(huì)響應(yīng) 304. 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 10 頁(yè) 3.33.3群組管理服務(wù)器群組管理服務(wù)器 xcap 請(qǐng)求請(qǐng)求 urlurl 1. xcap 根節(jié)點(diǎn) （xcap root） xcap 根定義了所有可被請(qǐng)求的資源所在的位置. xcap 根用 http uri 表示, 被稱為 xcap 根 rui。對(duì)群組服務(wù) xcap 根 被定義為/glms fqdn/glms-services. 注：在具體構(gòu)造 http 請(qǐng)求時(shí)，glms fqdn 應(yīng)該為 glms 服務(wù)器的地址，并且在發(fā)出 http 請(qǐng)求時(shí)放在 host http 頭中，而不是在 request-uri 中。另外，由于 glms 有主 副地址，glms fqdn 可能是兩個(gè)。（關(guān)于主副地址，請(qǐng)參見第 7 章） 2. 文檔選擇器 （document selector） 在文檔根節(jié)點(diǎn)下的每一個(gè) xml 文檔使用文檔選擇器唯一標(biāo)識(shí)，文檔選擇器類似于由多個(gè) 路徑標(biāo)識(shí)符組成的一個(gè)完整路徑，使用“/”作為路徑分隔符. 第一個(gè)路徑部分必須是 xcap auid。對(duì)群組服務(wù)器而言，有以下三種 xcap auid: org.openmobilealliance.groups: 用來(lái)進(jìn)行群組的操作用來(lái)進(jìn)行群組的操作 multicast-info: 用來(lái)操作群組的多播信息用來(lái)操作群組的多播信息 group-association：用來(lái)獲取個(gè)人所在的群組信息：用來(lái)獲取個(gè)人所在的群組信息 在每個(gè) auid 下有兩個(gè)子 xcap 分支. 一個(gè)成為 “用戶樹”（“user”tree）, 保存某個(gè)用 戶的所有文檔。 另一個(gè)分支是“全局樹”（“global”tree）, 保存適用于所有用戶的文檔. auid 之后的路徑部分必須是“global“ 或 “users“. 在“用戶樹”下是零個(gè)或多個(gè)子樹，每個(gè)子 樹包含某個(gè)用戶的文檔。每個(gè)用戶對(duì)服務(wù)器而言都有一個(gè)用戶名，被稱為 xcap 用戶表示 （xcap user identifier: xui). 文檔選擇器余下的部分 (“global“ 或 xui 以后的路徑指向具體的文檔名. 3. 節(jié)點(diǎn)選擇器 （node selector） 節(jié)點(diǎn)選擇器指定 xml 文檔中具體被操作的節(jié)點(diǎn). 節(jié)點(diǎn)選擇器指向 xml 元素或元素屬性. 4. 產(chǎn)生 glms 請(qǐng)求 url 訪問(wèn)群組管理服務(wù)器的某個(gè)用戶的 xml 文檔, 使用以下的 url 格式: http:/fqdn of glms server/service name/auid/users/xui of user/group document name 訪問(wèn) glms 的全局的 xml 文檔, 使用以下的 url 格式: http:/fqdn of glms server/service name/auid/global/index 訪問(wèn) glms 文檔的 xml 元素，使用以下的 url 格式: document selector/node selector 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 11 頁(yè) 文檔選擇器（document selector） 部分可以是用戶特定的文檔或全局文檔。節(jié)點(diǎn)選擇器 （node selector ）部分是 xml 文檔中的元素. 更多詳情參見本規(guī)范的具體例子. 3.4群組管理服務(wù)器器后向兼容對(duì)客戶端群組管理服務(wù)器器后向兼容對(duì)客戶端 xmlxml 解析的要求解析的要求 這里的群組管理服務(wù)器客戶端指所有與 glms 進(jìn)行 http/xcap 通信客戶端應(yīng)用程序。 glms 會(huì)不斷加入新的功能. 群組管理的 xml schema 在將來(lái)可能會(huì)擴(kuò)展。glms 升級(jí)到新 的版本而客戶端有可能仍然是舊的版本。為了使glms 后向兼容，glms 客戶端的實(shí)現(xiàn)必須 要遵循以下建議: oglms 客戶端必須忽略服務(wù)器返回的合法的 xml 文檔中不能識(shí)別的 xml 元素 或 屬性，而不是報(bào)錯(cuò)退出對(duì)文檔的處理. 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 12 頁(yè) 4群組管理服務(wù)器群組管理服務(wù)器 httphttp 接口規(guī)范接口規(guī)范 4.1概述概述 glms 為客戶端應(yīng)用提供 xcap 接口來(lái)管理服務(wù)器存儲(chǔ)的群組 xml 文檔. 客戶端應(yīng)用可以 讀取/更新/刪除 xml 文檔及其 xml 元素和屬性. 本章給出群組管理服務(wù)器 xcap 接口規(guī)范。 4.2正常響應(yīng)正常響應(yīng) 如果客戶端的請(qǐng)求被成功處理，glms支持成功的 2xx 狀態(tài)碼： 狀態(tài)碼狀態(tài)碼描述描述 200ok 201created 202accepted 4.2.1正常響應(yīng)描述正常響應(yīng)描述 200 (ok) 響應(yīng) 當(dāng) xcap get/put/delete 請(qǐng)求被成功處理時(shí)返回. 示例消息: http/1.1 200 ok etag: “bcbcbc“ content-length: 0 . . . 201 (created) 響應(yīng) 當(dāng) xcap put 請(qǐng)求被執(zhí)行并其請(qǐng)求的 resrouce 已經(jīng)產(chǎn)生. 示例消息: http/1.1 201 created etag: “ababab“ . . . content-length: 0 202 (accepted) 響應(yīng) 當(dāng) xcap put 請(qǐng)求正在執(zhí)行但處理并沒(méi)有全部完成 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 13 頁(yè) 示例消息: http/1.1 202 accepted . . . content-length: 0 4.3錯(cuò)誤錯(cuò)誤響應(yīng)響應(yīng) xcap 使用與http協(xié)議相同定義的錯(cuò)誤響應(yīng)狀態(tài)碼。glms支持3類錯(cuò)誤狀態(tài)碼：3xx, 4xx, 和 5xx. 3xx 是重定向狀態(tài)碼，指示客戶端為滿足請(qǐng)求去采取其它的行動(dòng)。4xx 是客戶端錯(cuò) 誤碼，指出客戶端請(qǐng)求可能包含的錯(cuò)誤. 5xx 是服務(wù)器錯(cuò)誤碼，指示服務(wù)器知道自己遇到問(wèn) 題而不能處理當(dāng)前的請(qǐng)求。 狀態(tài)碼狀態(tài)碼描述描述 304not modified 400bad request 403forbidden 404not found 405method not allowed 409conflict 412precondition failed 415unsupported media type 500internal server error 503service unavailable error 4.3.1錯(cuò)誤響應(yīng)描述錯(cuò)誤響應(yīng)描述 304 (not modified) 響應(yīng) 在條件 get 中使用. 客戶端在 if-none-match 頭中包含的 etag 與服務(wù)器所具有的該文檔 etag 相同 響應(yīng)消息示例: http/1.1 304 not modified content-type: text/plain; charset=iso-8859-1 content-length: 0 403 (forbidden) 響應(yīng) 可以對(duì) xcap get/put/delete 操作響應(yīng). glms 不能處理該請(qǐng)求，盡管理解該請(qǐng)求。 glms 可能攜帶請(qǐng)求被拒絕的原因在 403 響應(yīng)的“reason-phrase”中。 響應(yīng)消息示例: http/1.1 403 forbidden. the request is not allowed since the associated feature is locked. content-type: text/plain; charset=iso-8859-1 content-length: 0 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 14 頁(yè) 400 (bad request) 響應(yīng) 可以對(duì) xcap get/put/delete 操作響應(yīng)。由于語(yǔ)法錯(cuò)誤 glms 不能理解該請(qǐng)求. 響應(yīng)消息示例: http/1.1 400 bad request content-type: text/plain; charset=iso-8859-1 content-length: 0 404 (not found) 響應(yīng) 可以對(duì) xcap get/put/delete 操作響應(yīng). glms 不能找到被請(qǐng)求的資源。 響應(yīng)消息示例: http/1.1 404 not found content-type: text/plain; charset=iso-8859-1 content-length: 0 405 (method not allowed) 響應(yīng) 可以對(duì) xcap get/put/delete 和 http post 操作響應(yīng). glms 理解請(qǐng)求的方法但是不 支持該操作 響應(yīng)消息示例: http/1.1 405 method not allowed content-type: text/plain; charset=iso-8859-1 content-length: 0 409 (conflict) 響應(yīng) 可以對(duì) xcap get/put/delete 操作響應(yīng)。請(qǐng)求因?qū)Ξ?dāng)前資源的沖突而不能完成。 409 響應(yīng)可攜帶 xml 消息體來(lái)指定沖突的具體原因。 以下是 409 響應(yīng)中所包含的“xcap-error” data schema. “xcap-error” 可以用來(lái)給出具體沖突原因。 客戶端應(yīng)該支持以下 schema： 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 15 頁(yè) 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 16 頁(yè) 響應(yīng)消息示例: http/1.1 409 conflict content-type: application/xcap-error+xml content-length: xxxxx 412 (precondition failed) 響應(yīng) 可以對(duì) xcap get/put/delete 操作響應(yīng)。 客戶端可以攜帶 if-match 頭域來(lái)包含客戶端 所具有的 etag. 如果文檔在服務(wù)器中已改變，412 就會(huì)被返回. 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 17 頁(yè) 響應(yīng)消息示例: http/1.1 412 precondition failed content-type: text/plain; charset=iso-8859-1 content-length: 0 415 (unsupported media type) 響應(yīng) 可以對(duì) xcap get/put/delete 操作響應(yīng)。 群組服務(wù)器不接受請(qǐng)求消息中的內(nèi)容編碼。 響應(yīng)消息示例: http/1.1 415 unsupported media type content-type: text/plain; charset=iso-8859-1 content-length: 0 500 (internal server error) 響應(yīng) 可以對(duì) xcap get/put/delete 操作響應(yīng). 群組服務(wù)器遇到不可預(yù)料的情況不能完成請(qǐng)求. 響應(yīng)消息示例: http/1.1 500 internal server error content-type: text/plain; charset=iso-8859-1 content-length: 0 0503 (service unavailable) 響應(yīng) 可以對(duì) xcap get/put/delete 操作響應(yīng). 群組服務(wù)器因過(guò)載或維護(hù)等原因暫時(shí)不能處理 請(qǐng)求. 響應(yīng)消息示例: http/1.1 503 service unavailable content-type: text/plain; charset=iso-8859-1 content-length: 0 4.4操作共享群組（操作共享群組（sharedshared groupgroup）文檔）文檔 4.4.1data schema glms 擴(kuò)展了共享群組（shared group） schema 以支持 qchat 群組。 . 1. shared group schema 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 19 頁(yè) 2. shared-group-lucent.xsd 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 20 頁(yè) 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 21 頁(yè) 3. resource-lists.xsd 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 22 頁(yè) 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 23 頁(yè) 4. xml.xsd see /xml/1998/namespace.html and /tr/rec-xml for information about this namespace. this schema document describes the xml namespace, in a form suitable for import by other schema documents. note that local names in this namespace are intended to be defined only by the world wide web consortium or its subgroups. the following names are currently defined in this namespace and should not be used with conflicting semantics by any working group, specification, or document instance: base (as an attribute name): denotes an attribute whose value provides a uri to be used as the base for interpreting any relative uris in the scope of the element on which it appears; its value is inherited. this name is reserved by virtue of its definition in the xml base specification. id (as an attribute name): denotes an attribute whose value should be interpreted as if declared to be of type id. the xml:id specification is not yet a w3c recommendation, but this attribute is included here to facilitate experimentation with the mechanisms it proposes. note that it is _not_ included in the specialattrs attribute group. lang (as an attribute name): denotes an attribute whose value is a language code for the natural language of the content of any element; its value is inherited. this name is reserved by virtue of its definition in the xml specification. space (as an attribute name): denotes an attribute whose value is a keyword indicating what whitespace processing discipline is intended for the content of the element; its value is inherited. this name is reserved by virtue of its definition in the xml specification. father (in any context at all): denotes jon bosak, the chair of the original xml working group. this name is reserved by the following decision of the w3c xml plenary and xml coordination groups: 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 24 頁(yè) in appreciation for his vision, leadership and dedication the w3c xml plenary on this 10th day of february, 2000 reserves for jon bosak in perpetuity the xml name xml:father this schema defines attributes and an attribute group suitable for use by schemas wishing to allow xml:base, xml:lang, xml:space or xml:id attributes on elements they define. to enable this, such a schema must import this schema for the xml namespace, e.g. as follows: schema . . . . . . import namespace=“/xml/1998/namespace“ schemalocation=“/2001/xml.xsd“/ subsequently, qualified reference to any of the attributes or the group defined below will have the desired effect, e.g. type . . . . . . attributegroup ref=“xml:specialattrs“/ will define a type which will schema-validate an instance element with any of those attributes in keeping with the xml schema wgs standard versioning policy, this schema document will persist at /2005/08/xml.xsd. at the date of issue it can also be found at /2001/xml.xsd. the schema document at that uri may however change in the future, in order to remain compatible with the latest version of xml schema itself, or with the xml namespace itself. in other words, if the xml schema or xml namespaces change, the version of this document at /2001/xml.xsd will change accordingly; the version at /2005/08/xml.xsd will not change. attempting to install the relevant iso 2- and 3-letter codes as the enumerated possible values is probably never going to be a realistic possibility. see 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 25 頁(yè) rfc 3066 at /rfc/rfc3066.txt and the iana registry at /assignments/lang-tag-apps.htm for further information. the union allows for the un-declaration of xml:lang with the empty string. see /tr/xmlbase/ for information about this attribute. see /tr/xml-id/ for information about this attribute. 5. shared-group-oma.xsd 4.4.2使用場(chǎng)景使用場(chǎng)景 場(chǎng)景總結(jié) 創(chuàng)建多播共享群組文檔 從“用戶樹”下獲取共享群組文檔 從“全局樹”下獲取共享群組文檔 刪除共享群組文檔 添加/修改共享群組的顯示名稱 添加/修改共享群組的主題 添加/修改共享群組的主管理人 改變共享群組的 vocoder 類型 增加組成員 修改組成員信息 刪除組成員 添加/修改共享群組成員的顯示名稱 修改組成員的通話優(yōu)先級(jí) 修改組成員的成員狀態(tài) 組成員選擇退出共享群組 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 27 頁(yè) 創(chuàng)建多播共享群組文檔創(chuàng)建多播共享群組文檔 .1.概述 該操作用來(lái)創(chuàng)建用戶或企業(yè)的多播共享群組文檔. 用戶會(huì)被無(wú)條件加入到組中。 成功的 xcap put 操作會(huì)返回 201 created 響應(yīng). 失敗的操作會(huì)返回 403 (forbidden), 404 (not found) 或 409 (conflict). .2.用例 xdm clienta glms 1. xcap put 2.a 201 created 2.b 403/404/409 xdm clientb 3. group change notification 4. retrieve group association 圖 4-1 xdm client 創(chuàng)建一個(gè)共享群組 1.xdm 客戶端創(chuàng)建一個(gè)共享群組。它發(fā)起一個(gè) xcap put 請(qǐng)求 request message specification: put http:/fqdn of glms server/service name/org.openmobilealliance.groups/users/xui of user or company/group document name http/1.1 . . . clientid: requestors xui content-type: application/vnd.oma.poc.groups+xml content-length: xxxxx group document content 請(qǐng)求消息示例: put http:/sh.glms.vnet.mobi:9444/glms- services/org.openmobilealliance.groups/users/4600013311111111111ptt.189.cn/myconferencegroup.p tt.189.cn http/1.1 . . . clientid: systemadmptt.189.cn 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 28 頁(yè) content-type: application/vnd.oma.poc.groups+xml content-length: xxxxx friends forced-membership oe1 2 my conference group owner 2.a glms 接受請(qǐng)求返回 201 created. 2.b glms 拒絕請(qǐng)求返回 403/404/409 錯(cuò)誤響應(yīng)，并包含詳細(xì)的錯(cuò)誤信息 response message specification: http/1.1 201 created . . . etag: etag number content-length: 0 響應(yīng)消息示例: http/1.1 201 created . . . etag: “ababab“ content-length: 0 1.如果創(chuàng)建的群組中包含組成員，glms 通知成員他們被加入到新的群組中。 2.組成員的客戶端軟件從 glms 中獲取群組信息。這是通過(guò)對(duì) group association 的 xcap get 請(qǐng)求獲得的. 中國(guó)電信 qchat 業(yè)務(wù)終端參數(shù)配置接口技術(shù)要求-群組數(shù)據(jù)分冊(cè) 第 29 頁(yè) 從從“用戶樹用戶樹”下獲取共享群組文檔下獲取共享群組文檔 .1.概述 該操作用來(lái)從“用戶樹”下獲取用戶或企業(yè)的共享群組文檔. xcap get 請(qǐng)求的響應(yīng)消息 包含詳細(xì)的共享群組信息. 不同的請(qǐng)求者根據(jù)不同的權(quán)限會(huì)得到不同的請(qǐng)求結(jié)果： 1.全部群組信息包括群組名，主題，狀態(tài)，成員，成員通話優(yōu)先級(jí)，組創(chuàng)建信息等 2.部分群組信息包括群組名，主題，成員（沒(méi)有通話優(yōu)先級(jí)）, 組狀態(tài) 3.部分群組信息包括群組名，主題，成員（有通話優(yōu)先級(jí)）, 組狀態(tài) 成功的 xcap get 操作會(huì)返回 200 ok 響應(yīng)，并包含群組信息. 失敗的操作會(huì)返回 304 (not modified ), 403 (forbidden) 或 404 (not found)等。 .2.用例 xdm clientglms 1. xcap get 2.a 200 ok 2.b 304/403/404 圖 4-2 xdm client 得到某一群組文檔 1.xdm 客戶端要得到一個(gè)用戶或企業(yè)的某一群組文檔。它發(fā)起 xcap get 請(qǐng)求 request message specification: get http:/fqdn of glms server/service name/org.openmobilealliance.groups/users/xui of user or company/group document name http/1.1 . . . if-none-match: etag number clientid: requestor