REST的定義與作用

在SharePoint 2010中，基本上有如下幾種數據訪問方式： 服務器端對象模型

LINQ to SharePoint

Web Service

客戶端對象模型

ADO.NET Data Service (REST協議)

ADO.NET Data Service (強類型)

REST是SharePoint中一種數據訪問方式，這種方式只支持列表數據訪問接口，位于_vti_bin目錄下的的listdata.svc。

REST的特點及原理

REST協議的一個特點，就是可以把我們需要的操作都濃縮在一個URL中(比如通過：_vti_bin/listdata.svc/Test(3)就可以獲取到Test這個列表中ID為3的那個條目的信息，當然也可以通過一些特殊的寫法實現簡單的查詢、排序功能)，并可以通過GET、POST、PUT、DELETE、MERGE這幾種HTTP訪問方式，來實現列表數據的增、刪、查、改。

通過REST協議訪問數據的原理如下圖所示:

圖 01

通過這種方式訪問的時候，客戶端使用JSON的格式把需要的數據通過某種HTTP方法發送至包含listdata.svc的Url地址上(如果是Get方法的話，就沒有發送的數據)，然后返回數據的時候，可以返回Xml格式(Atom協議)，當然也可以返回JSON格式(如果不特別聲明的話，默認使用Atom協議，也就是Xml格式)。

和客戶端對象模型相同的是，我們通過Url，可以定義所需要返回的那些字段值，從而減少客戶端和服務器端的數據傳遞大小。

REST數據訪問常用語法

這里主要介紹GET方式訪問數據的語法，即Url語法。

例如：

獲取Test表所有數據

獲取前n條數據 $top

http://localhost/_vti_bin/ListData.svc/Test?$top=n?????? //獲取Test表中的前n條數據?? n為大于0的正整數

根據某字段排序? $orderby 支持多字段排序，字段間以逗號隔開

http://localhost/_vti_bin/ListData.svc/Test?$orderby=PublishDate asc??????????? //按PublishDate字段升序 支持asc/desc

按條件曬選 $filterhttp://localhost/_vti_bin/ListData.svc/Test?$filter=Id le 10???????????????? //曬選Id小雨等于10的項目

REST支持的運算符

數字：Lt、Le、Gt、Ge、Eq、Ne

字符串：startsWith、substringof、Eq、Ne

日期時間：day()、month()、year()、hour()、minute()、second()

實現比較復雜的查詢

http://localhost/_vti_bin/ListData.svc/Test

$select=*

&$orderby=PublishDate,Id desc

&$top=10

&$filter=Id Ge 3

//選擇Test表所有可用字段Id大于等于3的項目中的前10條記錄，并按照PublishDate字段、Id字段降序排列

REST語法注意事項

利用$select選擇指定列的數據、$orderby按某字段排序、$filter曬選數據時，若字段為系統內置字段，則字段名稱為當前語言環境下的字段名稱。例如中文「標題」字段，不能寫為Title。必須為「標題」。

用戶自己添加的英文字段，字段名稱首字母必須為大寫。例如，新建字段命名為name，此字段作為url一部分時必須寫為Name。

另外，若用中文當做Url的一部分，會發生異常，此時要先把中文字段編碼，然后把編碼后的字段名稱變量拼接到Url中

例如：var createDate = encodeURIComponent('標題');

var url = '/_vti_bin/ListData.svc/Test?$select=*

&$orderby=' createDate ' asc

&$top=10&

$filter=Name ne 'bear''; 利用$filter曬選數據時，只能有一個曬選條件。

復雜查詢時，拼接Url時，須按照$select->$orderby->$top->$filter的順序。

REST的使用方法

本節只介紹Jquery ajax以get方式異步請求。如果不指定數據的請求格式，則REST默認返回數據格式為XML格式。若要返回格式為json，則指定ajax請求的dataType:’json’或contentType:’application/json’即可。

調用代碼如下：

var createDate = encodeURIComponent('標題');

var url = '/_vti_bin/ListData.svc/Test?$select=*

&$orderby=' createDate ' asc

&$top=10&

$filter=Name ne 'bear'';

$.ajax({

type: 'get',

dataType: 'json',

url: url,

success: function (data) {

//result = data.d.results;? //查詢所有列表項

result = data.d; //帶條件查詢 或$top=n

},

error: function (a, b, c) {

alert(a b c);

},

complete: function () {

callback(result);

}

});

注：當查詢所有列表項為全部是result = data.d.results;

帶$filter或者$top時，result = data.d

REST方式的弊端與妥協方式

問題：由于$filter只支持單個條件，所以對于復雜的查詢要求可能無法直接達到要求。

妥協方式：先根據Url按某條件篩選，然后在ajax請求完成后對結果進行進一步加工處理

總結

以上是生活随笔為你收集整理的php 访问 sharepoint列表,SharePoint—用REST方式访问列表的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。