springboot2.7.10集成swagger3.0

本文展示了如何在Java项目中添加Springfox依赖以生成SwaggerAPI文档。首先,引入了Springfox-boot-starter的依赖,然后创建了一个配置类SwaggerConfig,定义了Docketbean来指定API的包路径和信息。配置还包括了作者Contact信息以及ApiInfo,最后提供了访问SwaggerUI的URL。

添加依赖

<!--swagger依赖-->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-boot-starter</artifactId>
            <version>3.0.0</version>
        </dependency>

增加配置类

package com.zeitor.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;

import java.util.ArrayList;

/**
 * @Author 逐鹿艾缇
 * @Description 配置类
 * @Date 2023/3/29 9:14
 * @Version 1.0
 */

@Configuration
public class SwaggerConfig {
    //配置了Swagger的Docket的bean实例
    @Bean
    public Docket docket() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage(" com.zeitor.controller"))
                .build();
    }

    //作者信息
    Contact contact = new Contact("zeit", "zeitor.cn", "936618343@qq.com");

    //配置Swagger 信息 = ApiInfo
    private ApiInfo apiInfo() {
        return new ApiInfo("智能人模的Api文档",
                "好好看文档",
                "1.0",
                "zeitor.cn",
                contact,
                "Apache 2.0",
                "http://www.apache.org/licenses/LICENSE-2.0",
                new ArrayList<>());
    }
}


验证:localhost:{port}/{context-path}/swagger-ui/index.html
在这里插入图片描述

以下是Spring Boot 2.7.10使用JPA连接MySQL 5.7的配置和使用方法: ### 1. 添加依赖 在`pom.xml`文件中添加Spring Boot JPA和MySQL驱动的依赖: ```xml <dependencies> <!-- Spring Boot JPA --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-jpa</artifactId> </dependency> <!-- MySQL 驱动 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> </dependency> </dependencies> ``` ### 2. 配置数据库连接信息 在`application.properties`或`application.yml`中配置数据库连接信息。 #### `application.properties`示例: ```properties spring.datasource.url=jdbc:mysql://localhost:3306/your_database_name?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC spring.datasource.username=your_username spring.datasource.password=your_password spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver spring.jpa.hibernate.ddl-auto=update spring.jpa.show-sql=true ``` #### `application.yml`示例: ```yaml spring: datasource: url: jdbc:mysql://localhost:3306/your_database_name?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC username: your_username password: your_password driver-class-name: com.mysql.cj.jdbc.Driver jpa: hibernate: ddl-auto: update show-sql: true ``` 其中,`spring.jpa.hibernate.ddl-auto`用于指定Hibernate如何处理数据库表结构。`update`表示如果表不存在则创建,存在则更新。`spring.jpa.show-sql`用于在控制台显示执行的SQL语句。 ### 3. 创建实体类 创建一个简单的实体类,例如`User`: ```java import javax.persistence.Entity; import javax.persistence.GeneratedValue; import javax.persistence.GenerationType; import javax.persistence.Id; @Entity public class User { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; private String name; private int age; // 构造函数、Getter和Setter方法 public User() {} public User(String name, int age) { this.name = name; this.age = age; } public Long getId() { return id; } public void setId(Long id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } } ``` ### 4. 创建Repository接口 创建一个继承自`JpaRepository`的接口,用于对实体类进行数据库操作: ```java import org.springframework.data.jpa.repository.JpaRepository; public interface UserRepository extends JpaRepository<User, Long> { } ``` ### 5. 使用Repository进行数据库操作 在服务类或控制器中使用`UserRepository`进行数据库操作: ```java import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import java.util.List; @Service public class UserService { @Autowired private UserRepository userRepository; public List<User> getAllUsers() { return userRepository.findAll(); } public User saveUser(User user) { return userRepository.save(user); } } ``` ### 6. 控制器示例 创建一个简单的控制器来测试上述功能: ```java import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.*; import java.util.List; @RestController @RequestMapping("/users") public class UserController { @Autowired private UserService userService; @GetMapping public List<User> getAllUsers() { return userService.getAllUsers(); } @PostMapping public User saveUser(@RequestBody User user) { return userService.saveUser(user); } } ``` ### 常见问题解决方案 - **时区问题**:如果出现时区相关的错误,可在数据库连接URL中添加`serverTimezone=UTC`参数。 - **依赖冲突**:确保`mysql-connector-java`的版本与MySQL 5.7兼容。 - **表结构更新问题**:如果`spring.jpa.hibernate.ddl-auto`设置为`update`但表结构未更新,可尝试将其设置为`create-drop`(开发环境),它会在应用启动时创建表,关闭时删除表。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值