2024年Java最全当 Swagger 遇上 Torna,瞬间高大上了(1),满满的干货

最后

面试是跳槽涨薪最直接有效的方式,马上金九银十来了,各位做好面试造飞机,工作拧螺丝的准备了吗?

掌握了这些知识点,面试时在候选人中又可以夺目不少,暴击9999点。机会都是留给有准备的人,只有充足的准备,才可能让自己可以在候选人中脱颖而出。

本文已被CODING开源项目:【一线大厂Java面试题解析+核心总结学习笔记+最新讲解视频+实战项目源码】收录

需要这份系统化的资料的朋友,可以点击这里获取

SpringBoot实战电商项目mall(50k+star)地址:github.com/macrozheng/…

Torna简介

=======

Torna是一套企业级接口文档解决方案,可以配合Swagger使用。它具有如下功能:

  • 文档管理:支持接口文档增删改查、接口调试、字典管理及导入导出功能;

  • 权限管理:支持接口文档的权限管理,同时有访客、开发者、管理员三种角色;

  • 双模式:独创的双模式,管理模式可以用来编辑文档内容,浏览模式纯粹查阅文档,界面无其它元素干扰。

当 Swagger 遇上 Torna,瞬间高大上了

Torna项目架构

=========

Torna是一个前后端分离项目,后端使用SpringBoot+MyBatis来实现,前端使用Vue+ElementUI来实现,技术栈非常主流!它不仅可以搭建API文档网站,还是个非常好的学习项目,让我们先来看看它的项目架构。

  • 首先我们需要下载Torna的源码,下载地址:gitee.com/durcframewo…

当 Swagger 遇上 Torna,瞬间高大上了

  • 下载成功后,将代码导入到IDEA中,项目结构如下;

当 Swagger 遇上 Torna,瞬间高大上了

  • 我们再来看下server模块的结构,一个非常标准的SpringBoot项目;

当 Swagger 遇上 Torna,瞬间高大上了

  • 再来看下front模块的结构,一个非常标准的Vue项目,值得学习!

当 Swagger 遇上 Torna,瞬间高大上了

安装

==

接下来我们把Torna运行起来,体验一下它的功能,这里提供Windows和Linux两种安装方式。

Windows

=======

下面我们来介绍Torna在Windows下的安装方法,如果你想深入学习Torna的话可以采用此种方式。

后端运行

====

  • 首先创建一个数据库torna,然后导入项目中的mysql.sql脚本,导入成功后,表结构如下;

当 Swagger 遇上 Torna,瞬间高大上了

  • 修改项目的配置文件server/boot/src/main/resources/application.properties,修改对应的数据库连接配置;

Server port

server.port=7700

MySQL host

mysql.host=localhost:3306

Schema name

mysql.schema=torna

Insure the account can run CREATE/ALTER sql.

mysql.username=root

mysql.password=root

  • 然后运行项目启动类TornaApplication的main方法,控制台打印如下信息表示启动成功。

当 Swagger 遇上 Torna,瞬间高大上了

前端运行

====

  • 进入前端项目目录front,运行npm install命令安装依赖;

当 Swagger 遇上 Torna,瞬间高大上了

  • 此时如果遇到node-sass无法安装的情况,可以直接使用如下命令安装;

npm i node-sass --sass_binary_site=https://npm.taobao.org/mirrors/node-sass/

  • 依赖系统安装完成后,可以通过npm run dev命令启动项目,启动成功后访问地址:http://localhost:9530/

当 Swagger 遇上 Torna,瞬间高大上了

  • 通过体验账号密码admin@torna.cn:123456可以访问Torna服务,界面还是不错的!

当 Swagger 遇上 Torna,瞬间高大上了

Linux

=====

在Linux下使用Docker安装Torna是非常简单的,如果你只想用Torna来做API文档服务的话可以采用这种方式。

  • 首先我们需要下载Torna的Docker镜像;

docker pull tanghc2020/torna:latest

  • 下载完成后将配置文件application.properties拷贝配置文件到/mydata/torna/config目录下,并修改数据库配置;

Server port

server.port=7700

MySQL host

mysql.host=192.168.3.101:3306

Schema name

mysql.schema=torna

Insure the account can run CREATE/ALTER sql.

mysql.username=root

mysql.password=root

  • 然后通过如下命令运行Torna服务;

docker run -p 7700:7700 --name torna \

-v /mydata/torna/config:/torna/config \

-d tanghc2020/torna:latest

  • 由于镜像中直接包含了前端和后端项目,所以可以直接使用,访问地址:http://192.168.3.101:7700

当 Swagger 遇上 Torna,瞬间高大上了

使用

==

Torna支持从多种工具导入接口文档,包括Swagger、smart-doc、OpenAPI、Postman等,接下来我们来体验下它的功能!

结合Swagger使用

===========

Torna能大大增强Swagger的功能,并且界面足够美观,下面我们来体验下!

  • 在使用之前,我们需要在Torna中进行配置才行,首先我们来配置一个开放用户,新建一个macro的账号,记住AppKey和Secret;

当 Swagger 遇上 Torna,瞬间高大上了

  • 然后创建一个项目mall-tiny-trona;

当 Swagger 遇上 Torna,瞬间高大上了

  • 接下来创建一个模块,打开OpenAPI标签,获取请求路径和token;

当 Swagger 遇上 Torna,瞬间高大上了

  • 之后在使用Swagger的项目中集成Torna插件,非常简单,添加如下依赖即可;

cn.torna

swagger-plugin

总结

在清楚了各个大厂的面试重点之后,就能很好的提高你刷题以及面试准备的效率,接下来小编也为大家准备了最新的互联网大厂资料。

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

本文已被CODING开源项目:【一线大厂Java面试题解析+核心总结学习笔记+最新讲解视频+实战项目源码】收录

需要这份系统化的资料的朋友,可以点击这里获取

外链图片转存中…(img-bBqEJnHl-1714888647970)]

[外链图片转存中…(img-FOR5jcMG-1714888647971)]

[外链图片转存中…(img-YyBWuSCK-1714888647971)]

[外链图片转存中…(img-0lJlnvSg-1714888647971)]

本文已被CODING开源项目:【一线大厂Java面试题解析+核心总结学习笔记+最新讲解视频+实战项目源码】收录

需要这份系统化的资料的朋友,可以点击这里获取

  • 7
    点赞
  • 9
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值