Интерфейс REST SharePoint Foundation
Дата последнего изменения: 9 марта 2015 г.
Применимо к: SharePoint Foundation 2010
Доступно на сайте SharePoint Online
Новый интерфейс передачи представлений состояний REST (Representational State Transfer) в Microsoft SharePoint Foundation 2010 обеспечивает доступ к спискам и библиотекам в формате реляционной службы данных. Основным понятием интерфейса REST является ресурс. В SharePoint Foundation списки и элементы представлены как ресурсы HTTP, которые могут быть адресованы с использованием удаленных URL-адресов.
Операции в интерфейсе REST SharePoint Foundation состоят из стандартного набора операций для веб-служб REST. Операции чтения, создания, обновления и удаления сопоставляются непосредственно с HTTP-командами GET, POST, PUT, и DELETE, что позволяет исключить необходимость использования промежуточных уровней между клиентом и сервером, а также обеспечивает эффективное взаимодействие за счет простоты подключения приложений других платформ к SharePoint Foundation. Возможности взаимодействия являются одним из преимуществ интерфейса REST SharePoint Foundation, который, кроме того, также предоставляет эффективные возможности разработки за счет интеграции со службами данных ADO.NET, на базе которых он построен.
В интерфейсе REST используются гибкие соглашения URL о запросе данных, которые позволяют осуществлять фильтрацию, сортировку и выбор информации из списков SharePoint Foundation непосредственно в браузере. Также поддерживается извлечение сведений из списков SharePoint Foundation с использованием нескольких представлений, включая поддержку стандартов JavaScript Object Notation (JSON), Atom и AtomPub. Стандартные представления списков SharePoint Foundation позволяют обеспечить доступ к данным списков для соответствующих стандартам клиентов, начиная с простых программ чтения каналов Atom и заканчивая расширенными клиентами, которые используются для анализа больших объемов данных в Microsoft Excel. Кроме того, интерфейс REST SharePoint Foundation поддерживает расширенные функции служб данных ADO.NET, в том числе пакетное выполнение нескольких операций, параллельное управление с использованием HTTP ETags, разбиение на страницы крупных наборов данных, а также доступ к потокам документов в библиотеках документов SharePoint.
В следующей таблице приводятся примеры URL-адресов, реализующих интерфейс REST.
URL-адрес |
Описание |
|---|---|
http://myserver/_vti_bin/ListData.svc |
При вводе URL-адреса службы REST возвращается стандартный документ службы Atom, в котором описывается сбор сведений, доступных на сайте SharePoint Foundation. |
http://myserver/_vti_bin/ListData.svc/Projects |
При вводе имени после URL-адреса службы возвращаются данные списка SharePoint Foundation в формате XML в виде стандартного канала Atom, который содержит записи для каждого элемента списка и свойства каждого элемента, а также свойства навигации, представленные в виде ссылок Atom. Свойства навигации представляют отношения с другими списками SharePoint Foundation, сформированными с использованием столбцов подстановки. |
http://myserver/_vti_bin/ListData.svc/$metadata |
Интерфейс SharePoint Foundation возвращает XML-код модели данных сущности, в котором описываются типы сущностей для каждого списка на веб-сайте. |
http://lsspf4719/sites/TestWebs/_vti_bin/listdata.svc/Employees(2) |
Возвращает заданный идентификатором (2) элемент списка в виде канала Atom с одной записью, соответствующей запрашиваемому элементу. |
http://lsspf4719/sites/TestWebs/_vti_bin/listdata.svc/Employees?$orderby=Name |
Сортировка канала Atom по имени. |
http://lsspf4719/sites/TestWebs/_vti_bin/listdata.svc/Employees?$filter=Project/Title eq 'My Project Title' |
Использует свойство навигации для фильтрации списка по заголовку связанного проекта. |
Используя новые возможности хранения данных SharePoint Foundation, запросы REST позволяют реализовать гибкий механизм работы с данными списка SharePoint Foundation в формате XML, что обеспечивает возможность извлечения данных списка любыми приложениями, отправляющими URL-адреса REST в SharePoint Foundation. Например, в интерфейсе REST используется новая функция соединения списков, благодаря чему при получении в SharePoint Foundation запроса служб данных ADO.NET, в котором реализуется функция соединения, этот запрос преобразуется в собственный запрос CAML.
См. также
Концепции
Запрос SharePoint Foundation с помощью служб данных ADO.NET