web

Parte 5 – Agregar Swagger a GestaProject.WebAPI

Parte 5 – Agregar Swagger a GestaProject.WebAPI

 

 

 

 

 

 

 

Parte​​ 5​​ ​​ Agregar Swagger a GestaProject.WebAPI.

 

En el proyecto de GestaProject.WebAPI, necesitamos agregar algunas librerías y hacer unas pocas configuraciones en el código.

 

Swashbuckle.AspNetCore​​ ver. 4.0.1

Swashbuckle.AspNetCore.Swagger​​ ver. 4.0.1

Swashbuckle.AspNetCore.SwaggerGen​​ ver. 4.0.1

Swashbuckle.AspNetCore.SwaggerUI​​ ver. 4.0.1

 

Parar instalar esos paquetes, damos click derecho en el projecto GestaProject.WebAPI y seleccionamos Management Nuget Packages.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Buscamos los paquetes y los instalamos.

 

Nota: es muy importante que instales la versión 4.0.1

 

Ahora tenemos que editar el archivo Startup.cs del proyecto.​​ 

 

En​​ ConfigureServices, agregamos las siguientes líneas:

 

services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2)

                .AddJsonOptions(options => options.SerializerSettings.ContractResolver = new DefaultContractResolver());

​​ 

            services.AddSwaggerGen(options =>

            {

                options.SwaggerDoc("v1"new Swashbuckle.AspNetCore.Swagger.Info { Title = "GestaProject Web API", Version = "v1" });

            });

 

 

 

 

 

 

En​​ Configure​​ agregamos las siguientes líneas:

 

app.UseSwagger();

​​ 

            app.UseSwaggerUI(c =>

            {

                c.SwaggerEndpoint("/swagger/v1/swagger.json""GestaProject Web API v1");

            });

 

Quedando algo así:

 

 

 

En​​ ValuesController, haremos un cambio:

 

 

 

 

 

Y por​​ último​​ cambiamos la opción de Lanch browser del proyecto.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Y si todo, les sale bien, ejecutan la solución y verán la siguiente vista.

 

Read More

Parte 4 – Crear solución y proyectos

Parte 4 – Crear solución y proyectos

 

 

 

 

 

 

Parte​​ 4​​ ​​ Crear​​ solución y proyectos.

 

Vamos a crear los siguientes proyectos:

 

GestaProject.WebUI: que es la interfaz gráfica de la aplicación.

GestaProject.WebAPI: que es la aplicación que contendrá los microservicios.

GestaProject.Data: que es la capa de datos.

GestaProject.Business: es la capa de la lógica del negocio o proyecto.

 

Abrir la carpeta GestaProject\dev-source en tu repositorio de archivos.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Desde Visual Studio crear una solución en blanco. La solución se llamará​​ GestaProject​​ y guardarlo en la ruta​​ C:\Projects\GestaProject\dev-source.

 

Así es como debe de quedar la estructura inicial de los archivos.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Ahora vamos a crear un nuevo proyecto que será la interfaz web de la aplicación. Para eso agregamos otro proyecto en la solución.​​ Este​​ proyecto se​​ llamará​​ GestaProject.WebUI

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Seleccionar .NET Core y ASP .NET Core 2.2​​ click en Web Application (Model-View-Controller).

 

Después​​ de agregar GestaProject.WebUI,​​ revisamos la estructura de los archivos y​​ que la aplicación funciones sin problemas.

 

 

 

 

 

 

 

 

 

 

 

 

 

Para la aplicación de los microservicios, vamos a crear el proyecto GestaProject.WebAPI, así como lo hicimos con GestaProject.WebUI, pero seleccionaremos API como template.

 

 

 

 

 

 

 

 

 

En las propiedades de la solución GestaProject, seleccionaremos Multiple startup projects y debe de quedar como se muestra en la siguiente imagen.

 

Al proyecto GestaProject.WebAPI le asigaremos el puerto 60000 y a GestaProject.WebUI el puerto 60010.

 

 

 

 

 

Ejecutamos el proyecto y nos saldrán las siguientes páginas.

 

 

 

 

 

 

 

 

 

 

Para la capa de datos y la capa de negocio agregaremos dos librerías de clases, las llamaremos GestaProject.Data y GestaProject.Business

 

 

Te muestro la estructura final en Visual Studio y en el explorar de Windows; el cual debe tener el proyecto.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Read More

Parte 3 – Crear proyecto y carpetas en Team Foundation (TFVC)

Parte 3 – Crear proyecto y carpetas en Team Foundation (TFVC)

 

 

 

 

 

 

Parte​​ 3​​ ​​ Crear proyecto y carpetas en Team Foundation (TFVC).

 

Si usas TFS en Azure DevOps, deberás crear un nuevo proyecto llamado “GestaProject”.

 

 

Para el control de versión de código, elegiremos Team Foundation Version Control y como metodología Scrum.

 

Desde Visual Studio nos conectamos a TFS y seleccionamos la carpeta de​​ “GestaProject”​​ y mapeamos al proyecto en nuestro disco duro.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Dentro de esta vamos a crear 3 folder para después convertirlos a Branch:

 

  • dev-source.

  • qua-source.

  • pro-source.

 

 

 

 

 

 

 

Y hacemos check in de​​ las carpetas en TFS.

 

 

 

 

Read More