solución de documentos de interfaz torna v1.29.4

La solución de documentos de interfaz Torna tiene como objetivo hacer que la gestión de documentos de interfaz sea más cómoda y rápida. Torna utiliza la colaboración en equipo para gestionar y mantener documentos de interfaz e incorpora diferentes formas de documentos en el mantenimiento unificado.

Torna compensa las deficiencias de las herramientas tradicionales de generación de documentos (como swagger), enriqueciendo y mejorando algunas funciones prácticas manteniendo las funciones originales.

Resuelva los puntos débiles de la gestión de documentos

1. Insatisfecho con el método de visualización de la página de vista previa del documento Swagger y la página de depuración

2. No me gustan las anotaciones intrusivas como la arrogancia.

3. Espero utilizar comentarios de javadoc para generar documentos y realizar la depuración de la interfaz.

4. Espero que todos los documentos de interfaz del proyecto de la empresa puedan gestionarse de manera uniforme.

5. Espero proporcionar varios documentos del proyecto a terceros para que los vean.

6. Espero que la enumeración de diccionarios en el proyecto se pueda gestionar de manera uniforme.

Pasos de uso

Método 1: descargue el zip y ejecútelo localmente

Preparación

Entorno Java, requisito mínimo Java8

MySQL, requiere 5.6.5 y posteriores, ver antes de 5.6.5: admite MySQL bajo

1. Descarga esto y descomprime el zip.

2. Importe la base de datos y ejecute mysql.sql

3. Abra el archivo de configuración application.properties y modifique la configuración de conexión de la base de datos.

4. Ejecute sh startup.sh para iniciar (Windows ejecuta startup.bat)

5. Visita: http://ip:7700

Iniciar sesión en la cuenta

Nombre de usuario: administrador, contraseña: 123456

6. Actualizaciones posteriores

No hay instrucciones especiales, simplemente sobrescriba el archivo torna.jar y la carpeta dist, y luego reinicie

Método 2: ejecución de la ventana acoplable

1. Importe la base de datos y ejecute mysql.sql

2. Descarga la imagen pública

docker tire tanghc2020/torna:1.18.1

3. Cree un archivo vacío application.properties en /etc/torna/ para almacenar la configuración y ejecutar el comando.

mkdir /etc/torna && touch /etc/torna/application.properties

4. Editar archivo de configuración

vim /etc/torna/application.properties

5. Ingrese la siguiente configuración

# Puerto del servidor server.port=7700# Dirección MySQL mysql.host=:3306# Nombre de la base de datos mysql.schema=torna# Cuenta de la base de datos, asegúrese de que se puedan ejecutar declaraciones DDL mysql.username=mysql.password=

Modificar la dirección y cuenta MySQL correspondiente

6. Ejecute el comando acoplable

docker run --name torna --restart=always -p 7700:7700 -e JAVA_OPTS="-server -Xms512m -Xmx512m" -v /etc/torna/application.properties:/torna/config/application.properties -d tanghc2020/torna:1.18.1

7. Acceda a http://ip:7700 con el navegador. La IP corresponde a la IP de la máquina host de Docker y a la IP del contenedor que no es de Docker.

Combinación recomendada

smart-doc + Torna realiza la automatización de todo el proceso documental

Si usa lenguaje Java, se recomienda usar smart-doc + Torna

smart-doc + Torna forma una solución de gestión y generación de documentos líder en la industria. Smart-doc se utiliza para extraer código fuente y comentarios de Java para generar documentos API sin intrusión y enviar automáticamente los documentos a la plataforma de gestión de documentos de interfaz de nivel empresarial Torna. .

Con esta combinación, puede enviar la información de la interfaz a la plataforma Torna simplemente escribiendo anotaciones Java, logrando así la vista previa y la depuración de la interfaz.

Si está utilizando un lenguaje que no sea Java, puede usar la página del formulario para editar el contenido anterior. Una vez completado, también puede obtener una vista previa y depurar la interfaz.