 | Эта статья поднимает множество проблем. Пожалуйста, помогите улучшить его или обсудите эти проблемы на странице обсуждения . ( Узнайте, как и когда удалить эти сообщения-шаблоны ) ( Узнайте, как и когда удалить этот шаблон сообщения )
|
JSON-WSP - это протокол веб-службы , который использует JSON для описания службы, запросов и ответов. [1] Он основан на JSON-RPC , но отсутствие спецификации описания сервиса с документацией в JSON-RPC спровоцировало разработку JSON-WSP.
Формат описания имеет ту же цель для JSON-WSP, что и WSDL для SOAP или IDL для CORBA , а именно для описания типов и методов, используемых в данной службе. Он также описывает отношения между типами (т.е. вложенные типы) и определяет, какие типы ожидаются в качестве аргументов метода и какие типы пользователь может ожидать в качестве возвращаемых значений метода. Наконец, описание открывает возможность добавления документации по уровням обслуживания, метода, параметра и возврата.
Связь между клиентами и сервером JSON-WSP осуществляется с помощью запросов и ответов HTTP POST [2] с объектами JSON в виде данных с типом содержимого application / json. [3]
Технические характеристики [ править ]
JSON-WSP состоит из четырех спецификаций объекта JSON:
| Технические характеристики | Описание |
|---|---|
| описание | Спецификация описания службы (например, WSDL ). В этой спецификации описаны методы, параметры методов, типы и возвращаемые типы. Он также поддерживает пользовательскую документацию на уровне услуг, методов и параметров. |
| запрос | Спецификация для запросов JSON. Он содержит информацию о том, какой метод должен быть вызван, и все аргументы для вызова метода. Аргументы в запросе должны соответствовать определению параметра того же метода, что описано в соответствующем описании JSON-WSP. |
| отклик | Спецификация для ответов в формате JSON. Объект ответа содержит результат вызова метода службы. Тип возврата должен соответствовать определенному типу возврата того же метода в соответствующем описании JSON-WSP. |
| вина | Спецификация ответов об ошибках JSON. Объект ошибки содержит код ошибки и строку ошибки. Информация об ошибке указывает, произошла ли ошибка на стороне клиента или на стороне сервера. В зависимости от инфраструктуры службы на стороне сервера может быть извлечена более подробная информация, например имя файла и номер строки, в которой произошла ошибка. |
Ссылки [ править ]
- ^ «ECMAScript - 2017 Language Specification» (PDF) . Ecma-international.org . Архивировано из оригинального (PDF) 12 апреля 2015 года . Проверено 28 января 2018 .
- ^ Рой, Филдинг; Джулиан, Решке. «Протокол передачи гипертекста (HTTP / 1.1): семантика и содержание» . Tools.ietf.org . Проверено 28 января 2018 . CS1 maint: обескураженный параметр ( ссылка )
- ^ "Архивная копия" . Архивировано из оригинала на 2011-07-17 . Проверено 14 февраля 2011 .CS1 maint: заархивированная копия как заголовок ( ссылка )
