Mostrando las entradas con la etiqueta C#. Mostrar todas las entradas
Mostrando las entradas con la etiqueta C#. Mostrar todas las entradas

viernes, 15 de junio de 2018

Api Rest : Consumiendo un Api Rest CRUD en C# - Parte 3

Para continuar con el ejemplo tomaremos la información generada en el artículo: Api Rest : Consumiendo un Api Rest en C# - Parte 2

Lo siguiente será consumir los métodos CRUD (Post, Put, Delete) de nuestra Api.

Nuevo registro

Editamos el archivo UsuariosController y tecleamos el código Create.

En el directorio Usuarios crearemos una nueva vista.

El template de la vista será Create y llamaremos el models Usuarios.

Editamos la vista Create y personalizamos algunos parámetros.

Dentro de la vista Index verificaremos que se llame la vista Create en el ActionLink de Nuevo usuario.

Ejecutaremos el archivo Index y presionaremos el link Nuevo usuario.

Verificamos que la URL llama la vista Create, tecleamos los datos solicitados y presionamos el botón Grabar.

En la vista principal visualizaremos el nuevo registro.

Modificar registro

Editamos el archivo Index  y tecleamos el siguiente código en el ActionLink Edit.


Editamos el archivo UsuariosController y tecleamos el siguiente código que realizara la visualización del registro seleccionado con el método GET.

A continuación teclearemos el código que realizar el PUT (actualización de la información), para esto llamaremos el evento [HttpPost] que llamara la acción Edit, utilizaremos HttpClient para enviar la solicitud HTTP PUT a la Api con la modificación del registro con PutAsJsonAsync.

Dentro del directorio Usuarios creamos una nueva vista.

El nombre y tecmplate de la vista será Edit y llamaremos el Model Usuarios.

Editaremos la vista Edit y personalizaremos algunos parámetros.

Ejecutamos el archivo Index, seleccionamos el link Edita del registro que vamos a modificar.

Verificamos que la URL aparezca el número de registro seleccionados, modificamos los datos y presionamos el botón Grabar.

Verificaremos que los cambios se hayan realizado.

Eliminar registro

Editamos el archivo Index y tecleamos el siguiente código en el ActionLink Delete.

Editamos el archivo UsuariosController y tecleamos el siguiente código que realizara la visualización del registro seleccionado con el método GET.

A continuación teclearemos el código que realizar el Delete, para esto llamaremos el evento [HttpPost] que llamara la acción Delete, utilizaremos HttpClient para enviar la solicitud HTTP PUT a la Api y así eliminar el registro con DeleteAsync.

Creamos una nueva vista en el directorio Usuarios.

El nombre y template será Delete, el Models será Usuarios.

Editamos la vista Delete y personalizamos algunos parámetros.

Ejecutamos el archivo Index, presionamos el link Eliminar del registro seleccionado.

Verificamos que la URL contenga el número de registro seleccionado y presionamos el botón Eliminar.

Por último verificaremos que el registro seleccionado se haya eliminado.
 
Puedes revisar el demo en línea: Consume Web Api

martes, 12 de junio de 2018

Api Rest : Consumiendo un Api Rest en C# - Parte 2

Para continuar con el ejemplo tomaremos la información generada en el artículo: Api Rest : Creación de un Api Rest CRUD en C# - Parte 1

Lo siguiente será consumir la información de nuestra Api, para esto crearemos un nuevo proyecto Web en C#.

El template será Empty y el tipo MVC.

Agregaremos 2 paquetes.

Buscamos e instalamos el paquete System.Net.Http.

Buscamos e instalamos el paquete Microsoft.AspNet.WebApi.Client.

Seleccionamos la carpeta Models para agregar una clase.

Tecleamos el nombre de la clase.

Dentro de la clase teclearemos todos los campos de nuestra tabla de la cual mostraremos la información.

Seleccionamos la carpeta Controller y agregamos un controlador.

El tipo de nuestro controlador será MVC 5 Controller - Empty.

Tecleamos el nombre de nuestro controlador.

Dentro de nuestro controlador llamamos la referencia de la carpeta Models. así como la ruta donde se encuentra nuestra Api, para que el ejemplo funcione correctamente la Api debe estar publicada, en caso de realizar el ejemplo local todos estos archivos deben estar en el mismo proyecto donde creamos la Api.

Tecleamos el siguiente código donde se indica que si el Apí tiene registros en Res, se indica "api/usuarios" que es donde se llaman todos los registros.

Dentro de la carpeta View seleccionamos la carpeta Usuarios y creamos una View.

La configuración de la View quedara de la siguiente manera.

Dentro del View realizamos los siguientes cambios.


Ejecutamos el archivo Index y visualizamos el resultado.
 
 

lunes, 11 de junio de 2018

Api Rest : Creación de un Api Rest CRUD en C# - Parte 1

 Qué es un Rest?
Es una arquitectura que se apoya en el estándar HTTP, permite crear aplicaciones y servicios que pueden ser usadas por cualquier dispositivo o cliente que utilice HTTP, algunas alternativas son SOAP y XML.
Los datos obtenidos pueden se XML o Json que suele ser más rápido.

Las operaciones más importantes  en cualquier sistema Rest (CRUD)  son:
  • GET (Leer y consultar los registros)
  • POST (Crear nuevos registros)
  • PUT (Editar y modificar los registros)
  • DELETE (Eliminar los registros)

Las ventajas de usar protocolo Rest es separar totalmente la interfaz de usuario del servidor y el almacenamiento de datos, esto contribuye a una mejora en la  portabilidad de la plataforma y un aumento en la escalabilidad, así como aumentar la seguridad del mismo.

Para el ejemplo necesitaremos instalar:
También necesitaremos una base de datos con al menos una tabla que será llamada para realizar la creación, consulta, modificación y eliminación de datos.

 Crearemos un proyecto Web con C#.

Seleccionaremos el template Web Api, así como las casillas MVC y Web Api.


Una vez creado el proyecto anexaremos un nuevo proyecto donde realizaremos la conexión a la base de datos.
Botón derechos sobre el proyecto, Add, New project

El nuevo proyecto será de tipo Visual C# y Class Library (.NET Framework), tecleamos el nombre y seleccionamos la ubicación.

Borramos Class1.cs ya no será necesaria.

Adicionamos una nuevo Ítem en el nuevo proyecto.

El tipo será Visual C#, Data, ADO.NET Entity Data Model, tecleamos el nombre y lo adicionamos.

Seleccionamos EF Designer Form database, Next.

Buscamos nueva base de datos, marcamos la casilla para ue guarde la conexión de la base de datos en el archivo app.Config, tecleamos el nombre y presionamos Next.




Seleccionamos Entity Framework 6.x.

Seleccionamos la base de datos de la cual utilizaremos los datos., marcamos las casillas Pluralize or singularize generated object names, Include foreign key columns in the model, por ultimo tecleamos el nombre.


Una vez finalizado se visualizara el diagrama con la tabla de la base de datos donde se indica que nuestro campo primario es  int_id.

Ingresaremos al archivo app.Config, seleccionamos y copiamos la cadena de conexión a la base de datos.

Editamos el archivo web.Config de nuestro proyecto principal y copiamos la cadena de conexión.

En nuestro proyecto principal agregamos una Referencia.

Seleccionamos el nuevo proyecto que creamos donde se encuentra la configuración de la base de datos.

La nueva referencia se adicionara en el apartado References.

En nuestro proyecto principal agregamos un Controller.

Seleccionaremos el tipo Web Api 2 Controller-Empty.

En caso de visualizar el siguiente error.

Seleccionar Build/Rebulid Solution.

Reintenta crear de nuevo el Controller y adicionarlo.

Agregaremos la referencia de la conexión de la base datos y teclearemos la siguiente línea.

Los datos los tomaremos de la referencia donde realizamos la conexión a la base de datos.

Ahora debemos agregar el paquete EntityFramework, seleccionamos nuestro proyecto principal, Manager NuGet Packages…

Buscamos el paquete EntityFramework y lo instalamos.

Se agregaran 2 referencia EntityFramework y EntityFramework.SqlServer.

Agregaremos el siguiente código que realizara la consulta de todos los registros de la tabla.

El nombre de la tabla la podemos obtener consultando la referencia de nuestra conexión a la base de datos.

Ejecutaremos nuestra aplicación y seleccionaremos el apartado API.


Podemos visualizar que solo esta activo el método GET para realizar una consulta de todos los registros de la tabla.
 
Al editar el método GET podemos visualizar el nombre de los campos que podremos utilizar. 

 

Para poder consultar todos los registros de la tabla, debemos teclear en el navegador adelante del localhost/api/usuarios, se visualizan todos los registros de la tabla en formato XML.

Teclearemos el método GET por registro donde la búsqueda se realizara por el campo int_id.

Teclearemos el método POST para la creación de nuevos registros.

Teclearemos el métodos PUT para la modificación de registros, en caso de visualizar el siguiente error solo agregaremos la referencia System.Data.Entity.
 
Agregamos el método DELETE.
 
Ejecutamos de nuevo nuestra aplicación, en el apartado Api podemos visualizar todos los métodos activos.
La salida de la información esta en formato XML para generarla en formato Json debemos editar el archivo WebApiConfig.cs que se ubica en el proyecto principal.
Teclearemos el siguiente código que realizar la salida en formato Json y remueve la salida en formato XML.

Si realizar la consulta de todos los registros la salida será en formato Json.
Para la prueba final debemos ejecutar Postman

METODO GET (Todos los registros)
Seleccionamos el método GET, tecleamos la URL y presionamos SEND, en la parte inferior (Body) se visualizan todos los registros de la tabla.
METODO GET (Consulta por registro)
Seleccionamos el método GET, tecleamos la URL agregando al final el no. de registro a consultar, presionamos SEND, en la parte inferior (Body) se visualiza solo el registro seleccionado.

METODO POST (Agregar un nuevo registro)
Seleccionaremos el método POST, Body, Raw y teclearemos los nuevo datos en formato Json, al presionar SEND el nuevo registro se visualizara en la parte inferior.

Para consultar que el registro se haya anexado correctamente se realizar la consulta con el método GET.

METODO PUT (Modificación e un registro)
Seleccionaremos el método PUT, teclearemos la URL indicando el no. de registro a modificar, teclearemos los datos a cambiar en formato Json, al presionar SEND nos enviara un resultado 200.

Para consultar los cambios volveremos a ejecutar un método GET.

METODO DELETE (Eliminar registros)
Seleccionaremos el método DELETE, teclearemos la URL indicando el no. de registros a eliminar, al presionar SEND nos dará un resultado 200 y nos indicara e la parte inferior los datos que fuerón eliminados.

Para verificar que el registro haya sedo eliminado realizaremos de nuevo el método GET.

 Ahora nuestro Api Rest puede ser utilizado en cualquier aplicación por el método HTTP.

Próximo artículo Api Rest : Consumiendo un Api Rest en C# - Parte 2 .

Puedes consultar el Api: Consultar Api en Json

Comparte