Conexión de Comandos POST: Exploración Profunda por Tim Corey

Introducción a los comandos POST

Tim comienza revisando las actualizaciones de la interfaz de la lección anterior, señalando que el sistema actualmente solo admite solicitudes GET. Él explica que esta lección se enfoca en habilitar las solicitudes POST para que los usuarios puedan enviar datos a un servidor, como salida JSON o datos de formularios.

Él enfatiza que separar el código de la interfaz de usuario del código de la biblioteca es clave. La interfaz de usuario debe gestionar elementos como menús desplegables, formularios HTML y campos de entrada, mientras que la biblioteca se encarga de la creación de solicitudes HTTP, el formateo del contenido y el envío de datos al servidor.

Tim también señala que este proyecto puede servir como un ejemplo de portafolio, pero es importante que los desarrolladores se aseguren de que su portafolio sea único. Él hace referencia a su Dev Pass en timcorey.com como una forma de profundizar en la comprensión de C# y los métodos de solicitudes HTTP.

Entendiendo la configuración actual

En Visual Studio, Tim demuestra la configuración actual del proyecto. La interfaz de usuario permite seleccionar un método de solicitud (GET o POST) e ingresar una URL. Actualmente, al hacer clic en "Ir" solo se ejecuta una solicitud GET, mostrando la respuesta en una ventana de resultados.

Un problema menor que señala es que todo el texto en la ventana de resultados está resaltado después de una solicitud GET, lo cual no es ideal para mostrar información. Tim soluciona esto enfocándose en el elemento de pestaña en lugar del cuadro de texto. Esto previene la selección automática de texto y mejora la experiencia del usuario.

Leyendo el menú desplegable y determinando la acción HTTP

Para implementar comandos POST, Tim primero explica cómo leer la selección del menú desplegable para determinar el método de solicitud HTTP. Él crea una variable para almacenar el método de solicitud analizado y usa TryParse para convertir el valor de cadena del menú desplegable en una acción HTTP.

Si el método seleccionado es inválido, el sistema muestra un mensaje de error ("Verbo HTTP inválido") y no intenta la solicitud. Una vez validado, el método de solicitud se puede usar para determinar si realizar una solicitud GET, POST u otros métodos HTTP como DELETE o PATCH.

Preparando el backend para manejar solicitudes POST

El siguiente paso es actualizar la biblioteca para manejar solicitudes POST. Tim explica que los comandos POST difieren de las solicitudes GET porque generalmente requieren un cuerpo de solicitud para enviar datos al recurso objetivo. Estos datos podrían ser JSON, datos binarios o datos de formularios.

Tim enfatiza la separación de las responsabilidades de la interfaz de usuario del código de la biblioteca. La interfaz de usuario pasa el contenido del cuerpo como una cadena, y la biblioteca lo convierte al tipo de contenido HTTP correcto para la solicitud. Este diseño asegura que operaciones genéricas como el formateo del contenido se manejen en la biblioteca, no en la interfaz de usuario.

Creando una sobrecarga para solicitudes POST

Tim crea una sobrecarga para CallApiAsync que acepta tres parámetros:

1. URL – la dirección del recurso objetivo

2. Acción – el método de solicitud HTTP (GET, POST, etc.)

3. Contenido – el cuerpo de la solicitud como una cadena

Esto permite a los desarrolladores pasar salida JSON, datos de formularios u otros datos codificados desde la interfaz de usuario directamente a la biblioteca. Al manejar solicitudes POST de esta manera, la misma biblioteca también puede admitir futuros métodos HTTP, como PUT, PATCH o DELETE.

Convirtiendo contenido de cadena a contenido HTTP

Tim muestra cómo convertir el contenido de cadena de la interfaz de usuario en StringContent, que hereda de contenido HTTP. Él establece la codificación a UTF8 y el tipo de contenido a application/json, lo cual es adecuado para enviar datos estructurados a un servidor.

Este paso asegura que el cuerpo de la solicitud esté correctamente formateado antes de enviarse. Tim destaca que esta separación de responsabilidades permite a los desarrolladores usar comandos POST sin preocuparse por los encabezados HTTP, la codificación o la conversión de contenido en la interfaz de usuario.

Actualizando la interfaz y probando solicitudes POST

Una vez que la biblioteca está lista, Tim actualiza la interfaz de usuario para llamar al nuevo método sobrecargado. Él prueba solicitudes POST usando JSONPlaceholder, formateando manualmente el cuerpo de la solicitud:

{
  "title": "Este es mi título",
  "body": "Este es mi texto del cuerpo",
  "userId": 3
}

Tim explica que una solicitud POST envía estos datos al recurso objetivo, y la respuesta indica éxito. Inicialmente, ocurre un error porque el enumerador de acción HTTP no incluye POST. Agregar POST resuelve esto, permitiendo al sistema enviar comandos POST con éxito.

Manejando solicitudes POST en la biblioteca

Tim demuestra cómo manejar comandos POST en la biblioteca utilizando una declaración switch en el método de solicitud HTTP. Para GET, el sistema usa GetAsync; para POST, usa PostAsync con el cuerpo de la solicitud formateado.

Probar el comando POST devuelve una respuesta con un ID (101 en JSONPlaceholder), confirmando que la solicitud funcionó. Tim señala que aunque esta API de prueba no almacena datos en una base de datos, es útil para validar la funcionalidad de las solicitudes POST.

Puntos clave y trabajo futuro

Tim resume la lección:

• El menú desplegable ahora admite métodos GET y POST.

• La interfaz de usuario pasa el cuerpo de la solicitud a la biblioteca.

• La biblioteca convierte la cadena en contenido HTTP y ejecuta la solicitud HTTP correcta.

• Los comandos POST devuelven respuestas válidas, que se pueden mostrar en la ventana de resultados.

Él anima a los estudiantes a implementar comandos PUT, PATCH y DELETE en futuras lecciones, destacando que el marco existente hace que agregar nuevos métodos HTTP sea sencillo.

Tim también aconseja evitar la sobreingeniería o la adición de código no utilizado, ya que esto podría resultar en funciones desconectadas o elementos huérfanos.

Conclusión

El video de Tim Corey proporciona un enfoque claro y práctico para los comandos POST en un proyecto de clonación de Postman. Al separar las responsabilidades de la interfaz de usuario del código de la biblioteca, convertir datos de cadenas en contenido HTTP y manejar las respuestas de manera efectiva, los desarrolladores adquieren experiencia práctica con los métodos de solicitudes HTTP.

Esta lección no solo demuestra cómo enviar datos a un servidor, sino que también prepara el terreno para manejar otros métodos HTTP, encabezados y solicitudes más complejas, convirtiéndolo en un ejemplo práctico sólido para aprender interacciones HTTP en C#.