Tutorial de servicios web SOAP: ¿Qué es el protocolo SOAP? EJEMPLO

¿Qué es SOAP?

SOAP es un protocolo basado en XML para acceder a servicios web a través de HTTP. Tiene algunas especificaciones que podrían usarse en todas las aplicaciones.

SOAP se conoce como Protocolo simple de acceso a objetos, pero en later times simplemente se redujo a SOAP v1.2. SOAP es un protocolo o, en otras palabras, es una definición de cómo los servicios web se comunican entre sí o con las aplicaciones cliente que los invocan.

SOAP se desarrolló como un lenguaje intermedio para que las aplicaciones creadas en varios lenguajes de programación pudieran comunicarse fácilmente entre sí y evitar el esfuerzo de desarrollo extremo.

Introducción al jabón

En el mundo actual, existe una gran cantidad de aplicaciones que se basan en diferentes lenguajes de programación. Por ejemplo, podría haber una aplicación web diseñada en Java, otra en .Net y otra en PHP.

El intercambio de datos entre aplicaciones es crucial en el mundo interconectado actual. Pero el intercambio de datos entre estos heterogéneosneoLas aplicaciones de EE. UU. serían com.plex. Así será la complexidad del código para realizar este intercambio de datos.

Uno de los métodos utilizados para combatir esta com.plexLa ventaja es utilizar XML (lenguaje de marcado extensible) como lenguaje intermedio para el intercambio de datos entre aplicaciones.

Todos los lenguajes de programación pueden comprender el lenguaje de marcado XML. Por lo tanto, se utilizó XML como medio subyacente para el intercambio de datos.

Pero no existen especificaciones estándar sobre el uso de XML en todos los lenguajes de programación para el intercambio de datos. Ahí es donde entra en juego el software SOAP.

SOAP fue diseñado para funcionar con XML a través de HTTP y tener algún tipo de especificación que podría usarse en todas las aplicaciones. Examinaremos más detallestails sobre el protocolo SOAP en los capítulos siguientes.

Ventajas de SOAP

SOAP es el protocolo utilizado para el intercambio de datos entre aplicaciones. A continuación se detallan algunas de las razones por las que se utiliza SOAP.

  • Al desarrollar servicios web basados ​​en SOAP, es necesario tener algún lenguaje que pueda usarse para que los servicios web se comuniquen con las aplicaciones cliente. SOAP es el medio perfecto que se desarrolló para lograr este propósito. Este protocolo también lo recomienda el consorcio W3C, que es el organismo rector de todos los estándares web.
  • SOAP es un protocolo ligero que se utiliza para el intercambio de datos entre aplicaciones. Tenga en cuenta la palabra clave 'luz.’ Dado que la programación SOAP se basa en el lenguaje XML, que en sí mismo es un lenguaje de intercambio de datos liviano, SOAP como protocolo también cae en la misma categoría.
  • SOAP está diseñado para ser independiente de la plataforma y también para ser independiente del sistema operativo. Por lo tanto, el protocolo SOAP puede funcionar con cualquier aplicación basada en lenguaje de programación tanto en Windows y Linux .
  • Funciona con el protocolo HTTP; SOAP funciona con el protocolo HTTP, que es el protocolo predeterminado utilizado por todas las aplicaciones web. Por lo tanto, no se requiere ningún tipo de personalización para ejecutar los servicios web creados en el protocolo SOAP para funcionar en la World Wide Web.

Bloques de construcción de jabón

La especificación SOAP define algo conocido como "mensaje SOAP”que es lo que se envía al servicio web y a la aplicación cliente.

El siguiente diagrama de SOAP archiLa tecnología muestra los diversos componentes básicos de un mensaje SOAP.

Bloques de construcción de jabón
Bloques de construcción de mensajes SOAP

El mensaje SOAP no es más que un simple documento XML que tiene los siguientes componentes.

  • Un elemento de sobre que identifica el documento XML como un mensaje SOAP: esta es la parte que contiene el mensaje SOAP y se utiliza para encapsular todos los mensajes SOAP.tails en el mensaje SOAP. Este es el elemento raíz del mensaje SOAP.
  • Un elemento de encabezado que contiene información de encabezado: el elemento de encabezado puede contener información como credenciales de autenticación que puede utilizar la aplicación que realiza la llamada. También puede contener la definición de com.plex tipos que podrían usarse en el mensaje SOAP. De forma predeterminada, el mensaje SOAP puede contener parámetros que pueden ser de tipos simples, como cadenas y números, pero también pueden ser un mensaje com.plex tipo de objeto.

Un ejemplo simple de servicio SOAP de una complex tipo se muestra a continuación.

Supongamos que queremos enviar un tipo de datos estructurados que tenga una combinación de un “Nombre del tutorial” y una “Descripción del tutorial”, entonces definiríamos la com.plex escriba como se muestra a continuación.

El COMplex el tipo está definido por la etiqueta del elemento <xsd:complexEscribe>. Todos los elementos requeridos de la estructura junto con sus respectivos tipos de datos se definen en el com.plex colección tipo.

<xsd:complexType>     
 <xsd:sequence>       
 	<xsd:element name="Tutorial Name" type="string"/>         
  	<xsd:element name="Tutorial Description"  type="string"/>
  </xsd:sequence>
</xsd:complexType>
  • Un elemento Body que contiene información de llamada y respuesta: este elemento es el que contiene los datos reales que deben enviarse entre el servicio web y la aplicación que realiza la llamada. A continuación se muestra un ejemplo de servicio web SOAP del cuerpo SOAP que realmente funciona en la comunidad.plex tipo definido en la sección del encabezado. Aquí está la respuesta del nombre del tutorial y la descripción del tutorial que se envía a la aplicación que llama a este servicio web.
<soap:Body>
   <GetTutorialInfo>
		<TutorialName>Web Services</TutorialName> 
		<TutorialDescription>All about web services</TutorialDescription> 
   </GetTutorialInfo>
</soap:Body>

Estructura del mensaje SOAP

Una cosa a tener en cuenta es que los mensajes SOAP normalmente los genera automáticamente el servicio web cuando se llama.

Cada vez que una aplicación cliente llama a un método en el servicio web, el servicio web generará automáticamente un mensaje SOAP que tendrá la información necesaria.tails de los datos que serán enviados desde el servicio web a la aplicación cliente.

Como se analizó en el tema anterior de este tutorial SOAP, un mensaje SOAP simple tiene el siguientewing elementos -

  • El elemento envolvente
  • El elemento de encabezado y
  • El elemento del cuerpo
  • El elemento de falla (opcional)

Veamos un ejemplo a continuación de un mensaje SOAP simple y veamos qué elemento realmente funciona.

Estructura del mensaje SOAP

Estructura del mensaje SOAP
  1. Como se ve en el mensaje SOAP anterior, la primera parte del mensaje SOAP es el elemento de sobre que se utiliza para encapsular todo el mensaje SOAP.
  2. El siguiente elemento es el cuerpo SOAP que contiene el details del mensaje real.
  3. Nuestro mensaje contiene un servicio web que tiene el nombre de “Guru99WebService”.
  4. El “Guru99Webservice” acepta un parámetro del tipo ‘int’ y tiene el nombre de TutorialID.

Ahora, el mensaje SOAP anterior se pasará entre el servicio web y la aplicación cliente.

Puede ver lo útil que es la información anterior para la aplicación cliente. El mensaje SOAP le dice a la aplicación cliente cuál es el nombre del servicio web, y también qué parámetros espera y también cuál es el tipo de cada parámetro que toma el servicio web.

Elemento de sobre SOAP

La primera parte del bloque de construcción es el sobre SOAP.

El sobre SOAP se utiliza para encapsular todos los elementos necesarios.tails de los mensajes SOAP, que se intercambian entre el servicio web y la aplicación cliente.

El elemento de sobre SOAP se utiliza para indicar el principio y el final de un mensaje SOAP. Esto permite que la aplicación cliente que llama al servicio web sepa cuándo finaliza el mensaje SOAP.

El following Los puntos se pueden anotar en el elemento del sobre SOAP.

  • Cada mensaje SOAP debe tener un elemento envolvente raíz. Es absolutamente obligatorio que el mensaje SOAP tenga un elemento de sobre.
  • Cada elemento de sobre debe tener al menos un elemento de cuerpo de jabón.
  • Si un elemento Sobre contiene un elemento de encabezado, no debe contener más de uno y debe aparecer como el primer elemento secundario del Sobre, antes del elemento cuerpo.
  • El sobre cambia cuando cambian las versiones de SOAP.
  • Un procesador SOAP compatible con v1.1 genera un error al recibir un mensaje que contiene el espacio de nombres del sobre v1.2.
  • Un procesador SOAP compatible con v1.2 genera un error de no coincidencia de versión si recibe un mensaje que no incluye el espacio de nombres del sobre v1.2.

A continuación se muestra un ejemplo de API SOAP de la versión 1.2 del elemento envolvente SOAP.

<?xml version="1.0"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://www.w3.org/2001/12/soap-envelope" SOAP-ENV:encodingStyle=" http://www.w3.org/2001/12/soap-encoding">
          <soap:Body>
        <Guru99WebService xmlns="http://tempuri.org/">
                  <TutorialID>int</TutorialID>
                </Guru99WebService>
          </soap:Body>
</SOAP-ENV:Envelope>

El mensaje de error

Cuando se realiza una solicitud a un servicio web SOAP, la respuesta devuelta puede ser de dos formas, que son una respuesta exitosa o una respuesta de error. Cuando se genera un éxito, la respuesta del servidor siempre será un mensaje SOAP. Pero si se generan errores SOAP, se devuelven como errores "HTTP 2".

El mensaje de error SOAP consta de lo siguientewing elementos.

  1. – Este es el código que designa el código del error. El código de falla puede ser cualquiera de los valores siguientes
    1. SOAP-ENV: VersionMismatch: esto ocurre cuando se encuentra un espacio de nombres no válido para el elemento SOAP Sobre.
    2. SOAP-ENV:MustUnderstand: no se entendió un elemento secundario inmediato del elemento Header, con el atributo mustUnderstand establecido en "1".
    3. SOAP-ENV:Cliente: el mensaje tenía un formato incorrecto o contenía información incorrecta.
    4. SOAP-ENV:Servidor: hubo un problema con el servidor, por lo que el mensaje no pudo continuar.
  2. – Este es el mensaje de texto que brinda una descripción detallada del error.
  3. (Opcional)– Esta es una cadena de texto que indica quién causó la falla.
  4. (Opcional) – Este es el elemento para los mensajes de error específicos de la aplicación. Por lo tanto, la aplicación podría tener un mensaje de error específico para diferentes escenarios de lógica empresarial.

Ejemplo de mensaje de error

A continuación se proporciona un ejemplo de un mensaje de error. El error se genera si el escenario en el que el cliente intenta utilizar un método llamado TutorialID en la clase GetTutorial.

El siguiente mensaje de error se genera en caso de que el método no exista en la clase definida.

<?xml version='1.0' encoding='UTF-8'?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance" xmlns:xsd="http://www.w3.org/1999/XMLSchema">
      <SOAP-ENV:Body>
         <SOAP-ENV:Fault>
         <faultcode xsi:type="xsd:string">SOAP-ENV:Client</faultcode>
        <faultstring xsi:type="xsd:string">
            Failed to locate method (GetTutorialID) in class (GetTutorial)
         </faultstring>
    </SOAP-ENV:Fault>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Salida:

Cuando ejecute el código anterior, mostrará un error como "Error al localizar el método (GetTutorialID) en la clase (GetTutorial)"

Modelo de comunicación SOAP

Toda la comunicación mediante SOAP se realiza a través del protocolo HTTP. Antes de SOAP, muchos servicios web utilizó el estilo estándar RPC (llamada a procedimiento remoto) para la comunicación. Este era el tipo de comunicación más simple, pero tenía muchas limitaciones.

Ahora, en este tutorial de SOAP API, consideremos el siguiente diagrama para ver cómo funciona esta comunicación. En este ejemplo, supongamos que el servidor aloja un servicio web que proporciona 2 métodos como

  • Obtener empleado – Esto haría que todos los empleados details
  • Establecer empleado – Esto fijaría el valor del details como departamento de empleados, salario, etc. en consecuencia.

En la comunicación normal de estilo RPC, el cliente simplemente llamaría a los métodos en su solicitud y enviaría los parámetros requeridos al servidor, y el servidor luego enviaría la respuesta deseada.

Modelo de comunicación SOAP

El modelo de comunicación anterior tiene las siguientes limitaciones graves.

  1. No es independiente del idioma – El servidor que aloja los métodos estaría en un lenguaje de programación particular y normalmente las llamadas al servidor estarían solo en ese lenguaje de programación.
  2. No es el protocolo estándar – Cuando se realiza una llamada al procedimiento remoto, la llamada no se realiza mediante el protocolo estándar. Esto era un problema ya que la mayoría de las comunicaciones a través de la web debían realizarse a través del protocolo HTTP.
  3. Los cortafuegos – Dado que las llamadas RPC no pasan por el protocolo normal, es necesario abrir puertos separados en el servidor para permitir que el cliente se comunique con el servidor. Normalmente, todos los cortafuegos bloquearían este tipo de tráfico y, por lo general, se requería mucha configuración para garantizar que este tipo de comunicación entre el cliente y el servidor funcionara.

Para superar todas las limitaciones citadas anteriormente, SOAP utilizaría el siguiente modelo de comunicación

Modelo de comunicación SOAP

  1. El cliente formateará la información relativa a la llamada al procedimiento y cualquier argumento en un mensaje SOAP y lo enviará al servidor como parte de una solicitud HTTP. Este proceso de encapsular los datos en un mensaje SOAP se conocía como Clasificación.
  2. Luego, el servidor desenvolvería el mensaje enviado por el cliente, vería lo que solicitó el cliente y luego enviaría la respuesta adecuada al cliente como un mensaje SOAP. La práctica de desenvolver una solicitud enviada por el cliente se conoce como Ordenación.

Ejemplo práctico de SOAP

Ahora, en este tutorial de SoapUI, veamos un ejemplo práctico de SOAP.

Probablemente una de las mejores formas de ver cómo se generan los mensajes SOAP es ver un servicio web en acción.

En este tema se analizará el uso de Microsoft.Net framework para construir un servicio web ASMX. Este tipo de servicio web admite tanto la versión 1.1 como la versión 1.2 de SOAP.

Los servicios web ASMX generan automáticamente el Lenguaje de definición de servicios web (WSDL) documento. La aplicación cliente que realiza la llamada requiere este documento WSDL para que sepa qué es capaz de hacer el servicio web.

En nuestro ejemplo, vamos a crear un servicio web simple, que se utilizará para devolver una cadena a la aplicación que llama al servicio web.

Este servicio web estará alojado en un asp.net Aplicación web. Luego invocaremos el servicio web y veremos el resultado que devuelve el servicio web.

Visual Studio También nos mostrará cuál es el mensaje SOAP que se pasa entre el servicio web y la aplicación que llama.

El primer requisito previo para configurar nuestra aplicación de servicio web, que se puede realizar siguiendowing los siguientes pasos.

Por favor asegúrese de tener Visual Studio 2013 instalado en su sistema para este ejemplo.

Paso 1) El primer paso es crear una aplicación web ASP.Net vacía. De Visual Studio 2013, haga clic en la opción de menú Archivo->Nuevo proyecto.

Ejemplo de mensaje SOAP

Una vez que haga clic en la opción Nuevo proyecto, Visual Studio Luego te dará otro cuadro de diálogo. box para elegir el tipo de proyecto y dar la información necesariatails del proyecto. Esto se explica en el siguiente paso.

Paso 2) En este paso,

  1. Asegúrese de elegir primero el C# plantilla web de la aplicación web ASP.NET. El proyecto tiene que ser de este tipo para poder crear un proyecto de servicios SOAP. Al elegir esta opción, Visual Studio Luego llevará a cabo los pasos necesarios para agregar los archivos requeridos por cualquier aplicación basada en web.
  2. Dale un nombre a tu proyecto que en nuestro caso se ha dado como webservice.asmx. Luego asegúrese de proporcionar una ubicación donde se almacenarán los archivos del proyecto.

Ejemplo de mensaje SOAP

Una vez hecho esto, verá el archivo del proyecto creado en su explorador de soluciones en Visual Studio 2013.

Ejemplo de mensaje SOAP

Paso 3) En este paso,

Vamos a agregar un archivo de servicio web a nuestro proyecto.

  1. Primero haga clic derecho en el archivo del proyecto como se muestra a continuación

Ejemplo de mensaje SOAP

  1. Una vez que haga clic derecho en el archivo del proyecto, tendrá la oportunidad de elegir la opción “Agregar->Servicio web (ASMX) para agregar un archivo de servicio web. Simplemente proporcione un nombre de Servicio Tutorial para el archivo de nombre del servicio web.

Ejemplo de mensaje SOAP

Paso 4) Agrega el siguientewing código a su archivo asmx del Servicio Tutorial.

Ejemplo de mensaje SOAP

Explicación del código:

  1. Esta línea de código proporciona un nombre para su archivo de servicio web. Este es un paso importante porque permite que la aplicación cliente llame al servicio web mediante el nombre del servicio web.
  2. Normalmente se utiliza un archivo de clase para encapsular la funcionalidad de un servicio web. Entonces, el archivo de clase tendrá la definición de todos los métodos web que proporcionarán alguna funcionalidad a la aplicación cliente.
  3. Aquí [WebMethod] se conoce como un atributo que describe una función. El paso siguiente crea una función llamada "Guru99WebService", pero con la inclusión de este paso de agregar un atributo [WebMethod] se garantiza que este método pueda ser invocado por una aplicación cliente. Si este atributo no está implementado, una aplicación cliente nunca podrá llamar al método.
  4. Aquí estamos definiendo una función llamada "Guru99WebService" que se utilizará para devolver una cadena a la aplicación cliente que llama. Esta función es un servicio web al que puede llamar cualquier aplicación cliente.
  5. Estamos utilizando la declaración de devolución para devolver la cadena "Este es un servicio web de Guru99" a la aplicación cliente.

Si el código se ejecuta correctamente, lo siguientewing El resultado se mostrará cuando ejecute su código en el navegador.

Salida:

Ejemplo de mensaje SOAP

  • El resultado muestra claramente que el nombre de nuestro servicio web es "Servicio web Guru99", que es el resultado de darle un nombre a nuestro servicio web.
  • También podemos ver que podemos invocar el servicio web. Si hacemos clic en el botón Invocar, obtendremos la siguiente respuesta en el navegador web.

Ejemplo de mensaje SOAP

La salida anterior,

  • Muestra claramente que al invocar el método web, se devuelve la cadena "Este es un servicio web de Guru99".
  • Visual Studio También le permite ver la solicitud y la respuesta del mensaje SOAP que se genera cuando se llama al servicio web anterior.

La solicitud SOAP que se genera cuando se llama al servicio web se muestra a continuación.

Ejemplo de mensaje SOAP

Explicación del código:

  1. La primera parte del mensaje SOAP es el elemento del sobre, que es lo que se analizó en los capítulos anteriores. Este es el elemento encapsulador que está presente en cada mensaje SOAP.
  2. El cuerpo SOAP es el siguiente elemento y contiene el contenido real.tails del mensaje SOAP.
  3. La tercera parte es el elemento que especifica que queremos llamar al servicio llamado "Guru99WebService".

Ejemplo de mensaje SOAP

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  
    <soap:Body>
      
        <Guru99WebServiceResponse xmlns="http://tempuri.org/">
          
            <Guru99WebServiceResult>string</Guru99WebServiceResult>
          
        </Guru99WebServiceResponse>
    </soap:Body>
</soap:Envelope>

Explicación del código:

  1. La primera parte del mensaje SOAP es el elemento del sobre, que es lo que se analizó en los capítulos anteriores. Este es el elemento encapsulador que está presente en cada mensaje SOAP.
  2. El cuerpo SOAP es el siguiente elemento y contiene el contenido real.tails del mensaje SOAP.
  3. La parte interesante que verás ahora es el atributo 'cadena'. Esto le dice a la aplicación cliente que el servicio web al que se llama devuelve un objeto del tipo cadena. Esto es muy útil porque si la aplicación cliente que otraswise No sabría lo que devuelve el servicio web.

Resumen

  • SOAP es un protocolo que se utiliza para intercambiar datos entre aplicaciones que se basan en diferentes lenguajes de programación.
  • SOAP se basa en la especificación XML y funciona con el protocolo HTTP. Esto lo hace perfecto para su uso dentro de aplicaciones web.
  • Los componentes básicos de SOAP constan de un mensaje SOAP. Cada mensaje SOAP consta de un elemento de sobre, un encabezado y un elemento de cuerpo.
  • El elemento sobre es el elemento obligatorio en el mensaje SOAP y se utiliza para encapsular todos los datos del mensaje SOAP.
  • El elemento de encabezado se puede utilizar para contener información como información de autenticación o la definición de com.plex tipos de datos
  • El elemento del cuerpo es el elemento principal que contiene la definición de los métodos web junto con cualquier información de parámetro si es necesario.