Доступ к веб-каналам OData из веб-браузера (краткое руководство по службам WCF Data Services)
На первом этапе мы извлечем документ с определением службы из общедоступной службы данных Northwind, расположенной на веб-сайте OData.org. Затем мы проверим доступ к конкретным ресурсам Northwind с использованием Протокол Open Data Protocol (OData) для отправки запросов HTTP GET через веб-браузер к доступным ресурсам. При необходимости также можно отключить чтение канала в веб-браузере.
Запрос сервисного документа по умолчанию и документа метаданных с помощью Internet Explorer
В обозревателе Internet Explorer выберите в меню Сервис команду Свойства обозревателя, щелкните вкладку Содержание, нажмите кнопку Параметры и снимите флажок Включить показ ленты чтения веб-каналов.
При этом чтение каналов будет отключено. Если не выключить эту функцию, то веб-браузер будет рассматривать документ в формате AtomPub в качестве канала XML, а не отображать необработанные XML-данные.
Примечание
Если браузер не может отобразить канал в виде необработанных XML-данных, его все равно можно просмотреть в виде исходного кода страницы.
В Visual Studio нажмите клавишу F5 для запуска отладки приложения.
Откройте веб-браузер на локальном компьютере. В адресной строке введите следующий URI:
http://services.odata.org/Northwind/Northwind.svc/
При этом будет возвращен сервисный документ по умолчанию, в котором содержится список наборов сущностей, предоставляемых службой данных.
В адресной строке введите следующий URI:
http://services.odata.org/Northwind/Northwind.svc/$metadata
В результате возвращаются метаданные службы данных, в которых описывается модель связей между сущностями, предоставленная службой данных.
Доступ к ресурсам набора сущностей из веб-браузера
В адресной строке веб-браузера введите следующий URI:
http://services.odata.org/Northwind/Northwind.svc/Customers
При этом будет возвращен набор всех клиентов из образца базы данных Northwind.
В адресной строке веб-браузера введите следующий URI:
http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')
При этом возвращается экземпляр сущности для конкретного клиента ALFKI.
В адресной строке веб-браузера введите следующий URI:
http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/Orders
При этом произойдет переход по связи между клиентами и заказами для возвращения набора всех заказов для конкретного клиента ALFKI.
В адресной строке веб-браузера введите следующий URI:
http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/Orders?$filter=OrderID eq 10643
При этом будут отфильтрованы заказы, принадлежащие конкретному клиенту ALFKI, в результате чего будет возвращен только конкретный заказ на основе переданного значения OrderID.
Следующие шаги
Мы успешно получили доступ к образцу службы данных Northwind из веб-браузера, отправив через браузер запросы HTTP GET к указанным ресурсам. Веб-браузер предоставляет простой способ проведения экспериментов с синтаксисом адресации запросов и просмотра результатов. Однако к производственной службе данных таким способом обычно не обращаются. Как правило, приложения взаимодействуют со службой данных через код приложения или языки скриптов. Далее мы создадим клиентское приложение, в котором используются клиентские библиотеки для доступа к ресурсам службы данных, как если бы они представляли собой объекты общей языковой среды выполнения (CLR):
Использование каналов OData в консольном приложении