导入swagger3的步骤：
pom.xml（只需要子模块配置）配置：
<!--springdoc 集成了 swagger3--><dependency><groupId>org.springdoc</groupId><artifactId>springdoc-openapi-starter-webmvc-ui</artifactId><version>2.5.0</version></dependency>application.yaml文件配置：
# swagger3的地址
springdoc:swagger-ui:path: /swagger-ui.htmlapi-docs:path: /v3/api-docs编写类：
package com.zheng.config;import io.swagger.v3.oas.models.ExternalDocumentation;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Contact;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.info.License;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;/*** swagger配置类* 配置 公司 版本 标题等信息*/
@Configuration // 配置类的标识
public class SwaggerConfig {@Beanpublic OpenAPI openAPI(){return new OpenAPI().info(new Info().title("swagger").contact(new Contact()).description("郑欣怡ii").version("v1.0.0").license(new License().name("Apache 2.0").url("http://springdoc.org"))).externalDocs(new ExternalDocumentation().description("外部文档").url("https://springshop.wiki.github.org/docs"));}
}
实体类
实体类中添加@Schema（参数description）用于标识实体类和属性的名称。
package com.zheng.entity;import io.swagger.v3.oas.annotations.media.Schema;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.ToString;/*** 实体层与数据库表 tb_question 进行映射* */
@Data // 为属性生成get/set方法
@NoArgsConstructor //生成无参构造函数
@AllArgsConstructor //生成全参构造函数
@ToString // 生成toString()方法
@Schema(description = "Question实体类")
public class Question {private Integer id;@Schema(description = "专家")private String expertName; // 专家@Schema(description = "问题人")private String questioner; // 问题人@Schema(description = "手机号")private String phone; // 手机号@Schema(description = "作物详细信息")private String plantName; // 作物详细信息@Schema(description = "问题标题")private String title; // 问题标题@Schema(description = "问题")private String question;// 问题@Schema(description = "回答")private String answer; // 回答@Schema(description = "状态")private Integer status; // 状态}控制层
需要为控制类加注解@Tag（填入参数name和description）用于在页面中显示控制层的名字和描述。用@Operation参数description显示方法的描述即可。
除此之外，swagger中除了传统的get和post请求之外，为了方便对于数据库的操作，于是又增加了put和delete请求，并规定get请求用于查询，post请求用于添加，put请求用于修改，delete请求用于删除。
package com.zheng.controller;import com.zheng.entity.Question;
import com.zheng.service.QuestionService;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;import java.util.List;/*** Controller整合Swagger*/
@RestController
@RequestMapping("/question")
@Tag(name="question",description = "tb_question控制层") // swagger标签
public class QuestionController {@Autowiredprivate QuestionService questionService;@Operation(description = "question查询全部") // swagger 标签@GetMapping("/findAll")public List<Question> findAll() {return questionService.findAll();}/*** findById?id=10* @param id* @return*/@Operation(description = "question根据主键查询") // swagger 标签@GetMapping("findById")public Question findById(@RequestParam("id") int id) {return questionService.findById(id);}@Operation(description = "根据专家名字查询")@GetMapping("/findByExpertName/{expertName}")public List<Question> findByExpertName(@PathVariable("expertName") String expertName) {return questionService.findByExpertName(expertName);}@PostMapping("/save")@Operation(description = "添加question")public int save(Question question) {return questionService.save(question);}@PutMapping("/update") // 修改只能用put请求，删除只能用delete请求@Operation(description = "修改question")public int update(Question question) {return questionService.update(question);}/*** /delete/10* @param id* @return*/@DeleteMapping("/delete/{qid}")@Operation(description = "按照编号删除question")public int delete(@PathVariable("qid") int id) {return questionService.delete(id);}
}
除此之外，其他的类都没有变化。
添加、修改、删除、联表查询
需要在Mapper.xml中配置：
注意sql语句中需要的参数需要用#{参数名}代替，列名和表明最好加``反引号，防止被mysql看作关键字。
联表查询中，针对一对多的情况，需要在“一”的实体类中加入List<>属性来加入“多”的那一类的对象数组，这样就能在查询得到结果的时候能够显示多表的情况，于是在“多”的那一类中的mapper、service层中写入的东西就和其他查询的格式一致，最后的控制层也和其他查询一致，那么只需要再修改xml中的配置，更新resultMap即可。
需要在xml的resultMap中加入collection用于应对一对多的情况（用于增加多个其他类的对象），注意参数是property（属性名）和ofType（对象的类型），里面的内容和普通result一致，都需要id和result来限定列和属性的对应关系。注意如果遇到两个表的某一列的列名一致的情况，需要根据你的sql语句中为两列中的某列的重命名来修改对应的column，这就再次体现了resultMap标识的是sql语句执行后返回的类型。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.zheng.mapper.BankMapper"><resultMap id="bankMap" type="Bank"><id property="bankId" column="bid" /><result property="bankName" column="bank_name"/><result property="" column=""/><result property="bankPhone" column="bank_phone"/><result property="introduce" column="introduce"/><result property="money" column="money"/><result property="rate" column="rate"/><result property="repayment" column="repayment"/><collection property="bankUserList" ofType="BankUser"><id property="userName" column="user_name"/><result property="role" column="role"/><result property="bankId" column="bank_id"/><result property="realName" column="real_name"/><result property="password" column="password"/><result property="phone" column="phone"/><result property="createTime" column="create_time"/><result property="updateTime" column="update_time"/></collection></resultMap><select id="findById" parameterType="Integer" resultMap="bankMap">SELECT * FROM tb_bank WHERE bank_id = #{bankId}</select><select id="findAndBankUser" resultMap="bankMap">SELECT bu.*, b.bank_id bid, b.bank_name, b.introduce, b.bank_phone, b.money, b.rate, b.repaymentFROM tb_bank AS b INNER JOIN tb_bank_user AS bu ON b.bank_id = bu.bank_id</select>
</mapper>配置nodejs
注意多次配置后需要重启电脑，vscode下载后会出来一长串警告，不会几秒就下载完只出来添加了多少文件。
vscode终端中执行：
npm config set registry https://registry.npmmirror.com
npm install -g @vue/cli
装好后测试，vscode终端中执行：
vue create vue-demo
