Wiki

Has cargado una revisión vieja del documento! Si la guardas crearás una versión nueva con estos datos.

====== Migración SICOF ERP - Proceso: Guía de Documentación de Microservicios ======
La siguiente sección define las configuraciones que se deben tener presente en el desarrollo de los microservicios de la fábrica de desarrollo para la documentación de los microservicios.

=== Consideraciones Previas ===
  * Los microservicios deben aplicar las configuraciones definidas en la mayoria de los casos a todas las clases que definan la lógica del negocio como Entidades, Controladores, Configuraciones etc.
  * Si un microservicio requiere configuraciones especiales, estas deben ser validadas con los lideres de desarrollo (Pablo Quintana, Daberson Henao, Carlos Torres, Gersain Castañeda).

=== Información Importante ===
Se ha definido para el proces ode documentación de los microservcios el estandar  OpenAPI Specification (OAS) 3.0.3.  e((https://github.com/OAI/OpenAPI-Specification)) la cual define una descripción de interfaz estándar, independiente del lenguaje de programación para las API REST, que permite que tanto humanos como computadoras descubran y comprendan las capacidades de un servicio sin requerir acceso al código fuente, documentación adicional o inspección del tráfico de red. Cuando se define adecuadamente a través de OpenAPI, un consumidor puede comprender e interactuar con el servicio remoto con una cantidad mínima de lógica de implementación. Similar a lo que han hecho las descripciones de interfaz para la programación de nivel inferior, la especificación OpenAPI elimina las conjeturas al llamar a un servicio.

===== Documentación de Soporte =====
En la siguiente web se relacionan la forma de implementación de la especificación OAS((https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.3.md)) con la tecnología Sprintboot 
[[https://springdoc.org/|Documentación springdoc]]

===== Configuraciones del Microservicio =====
Todo microservicio que implemente documentación OAS((https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.3.md)) debe incluir en su archivo de configuración Maven **POM**((https://www.tutorialspoint.com/maven/maven_pom.htm)) la dependencia del proyecto del Dominio de clases y entidades Comunes el cual se describe a continuación:

<code xml>
<dependency>
  <groupId>co.ada.models</groupId>
  <artifactId>ModelsClassesADA</artifactId>
  <version>0.0.1-SNAPSHOT</version>
</dependency>
</code>

El desarrollador debe utilizar la versión más reciente del proyecto la cual puede ser consultada en la sección [[ada:howto:sicoferp:factory:migracionsicoferp:process:backend:apiversion | Versionamiento de APIs]]

===== Como implementar documentación OAS con el Dominio de Clases de Entidades Comunes  =====
Para usar el Dominio de Clases de Entidades Comunes en el proceso de documentación siga los siguientes pasos:

=== Paso 1 ===
Registre la dependencia actualizada del Dominio de Clases de Entidades Comunes.

=== Paso 2 ===
Cree un paquete llamado config
 
=== Paso 3 ===
Cree la clase de configuración como se muestra continuación.

<code java>
package co.ada.test.microservicio.pruebamodel.config;

import org.springframework.context.annotation.Configuration;

import co.ada.doc.config.SpringOpenApiConfigBase;

@Configuration
public class MySpringOpenApiConfig extends SpringOpenApiConfigBase {}
</code>

=== Paso 4 ===
Configure en el bootstrap.yml del proyecto los parametros de documentación del microservicio. Apoyese del siguiente modelo de referencia extraido del proyecto modelo.

<code yaml>
openapi-document:
   info:
      title: "Prueba Model ADA API"
      description: "Ejemplo de Microservicio utilizando el Dominio de clases y entidades comunes"
      termsOfService: ""
      contact:
         name: "Carlos Torres"
         url: "http://ada.co"
         email: "carlos.torres@ada.co"
      license:
         name: "ADA 1.0"
         url: ""
      version: "0.0.1" 
   servers:
      public:       
         url: "http://zuul-mig.adacsc.co/api/prueba"
         description: "Development integration public server"         
   externalDocs:
      description: ""
      url: ""</code>

=== Paso 5 ===
Documente las clases del microservicio con la especificación OAS((https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.3.md)). Apoyese del proyecto modelo el cual tiene un ejemplo de configuración.

<code java>
package co.ada.test.microservice.prueba.dbconnect;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.boot.orm.jpa.EntityManagerFactoryBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;
import org.springframework.orm.jpa.JpaTransactionManager;
import org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean;
import org.springframework.transaction.annotation.EnableTransactionManagement;

import co.ada.db.config.DataSourceConfigBase;
import co.ada.db.config.IDataSourceConfig;

@Configuration
@EnableJpaRepositories(
		basePackages = "co.ada.test.microservice.prueba.repo",//Ver Nota 1
		transactionManagerRef = "transcationManager",
		entityManagerFactoryRef = "entityManager")
@EnableTransactionManagement
public class MyDataSourceConfig extends DataSourceConfigBase {

@Bean(name = "entityManager")
	public LocalContainerEntityManagerFactoryBean entityManagerFactoryBean(EntityManagerFactoryBuilder builder) {
		return builder.dataSource(dataSource()).packages("co.ada.models.microservicio.usuario").build();//Ver Nota 2
	}

@Bean(name = "transcationManager")
	public JpaTransactionManager transactionManager(@Autowired @Qualifier("entityManager") LocalContainerEntityManagerFactoryBean entityManagerFactoryBean) {
		return new JpaTransactionManager(entityManagerFactoryBean.getObject());
	}
}
</code>

[[ada:howto:sicoferp:factory:migracionsicoferp:process:backend|←Volver atrás]]

Resumen de la edición

Wiki

Herramientas de usuario

Herramientas del sitio

Herramientas de la página