Este artículo tiene varios problemas. Ayúdenos a mejorarlo o a discutir estos problemas en la página de discusión . ( Aprenda cómo y cuándo eliminar estos mensajes )
|
JSON-WSP es un protocolo de servicio web que utiliza JSON para la descripción del servicio, solicitudes y respuestas. [1] Está inspirado en JSON-RPC , pero la falta de una especificación de descripción del servicio con documentación en JSON-RPC motivó el diseño de JSON-WSP.
El formato de descripción tiene el mismo propósito para JSON-WSP que el que tiene WSDL para SOAP o IDL para CORBA , es decir, describir los tipos y métodos utilizados en un servicio determinado. También describe las relaciones entre tipos (es decir, los tipos anidados) y define qué tipos se esperan como argumentos de método y qué tipos puede esperar el usuario recibir como valores de retorno de método. Finalmente, la descripción abre la posibilidad de agregar documentación sobre los niveles de servicio, método, parámetro y retorno.
La comunicación entre los clientes y un servidor JSON-WSP se realiza mediante solicitudes y respuestas HTTP POST [2] , con los objetos JSON como datos con el tipo de contenido application/json. [3]
JSON-WSP consta de cuatro especificaciones de objetos JSON:
Especificación | Descripción |
---|---|
descripción | Especificación de descripción de servicio (como WSDL ). Esta especificación describe métodos, parámetros de método, tipos y tipos de retorno. También admite documentación de usuario sobre niveles de servicio, método y parámetro. |
pedido | Especificación para solicitudes JSON. Contiene información sobre qué método se invocará y todos los argumentos para la llamada al método. Los argumentos de la solicitud deben obedecer la definición de parámetros del mismo método descrito en la descripción JSON-WSP correspondiente. |
respuesta | Especificación para respuestas JSON. El objeto de respuesta contiene el resultado de una invocación de un método de servicio. El tipo de retorno debe obedecer al tipo de retorno definido del mismo método en la descripción JSON-WSP correspondiente. |
falla | Especificación para respuestas de fallas JSON. El objeto de falla contiene un código de falla y una cadena de falla. La información de falla especifica si la falla ocurrió en el lado del cliente o del servidor. Según el marco de servicio del lado del servidor, se puede extraer información más detallada, es decir, el nombre del archivo y el número de línea donde ocurrió la falla. |