Skip to content

Java和SpringBoot基础配置说明

使用SpringBoot创建项目后,根据自己需要,删除不必要的文件,然后把application.properties文件重命名为application.yml,再依次进行下面的配置操作。

一、application.yml文件常用基础配置

yaml
# 路径为src/main/resources/application.yml
# 服务器配置部分
server:
    # 服务器端口
    port: 8080
    # servlet相关配置
    servlet:
      # 上下文路径,“/”表示根路径
      context-path: /

# spring boot 配置部分
spring:
    # 应用名称
    application:
      # 名称,用于服务发现,监控等场景
      name: colour-springboot
    # 数据源配置
    datasource:
      # 数据库驱动,使用MySQL 8.0+驱动
      driver-class-name: com.mysql.cj.jdbc.Driver
      # 数据库连接地址
      # jdbc:mysql:// -JDBC连接协议
      # localhost - 数据库地址
      # 3306 - 数据库端口
      # colour-springboot - 数据库名称
      # useUnicode=true - 使用Unicode字符集
      # characterEncoding=utf-8 - 字符编码
      # serverTimezone=Asia/Shanghai - 设置时区为上海时间
      url: jdbc:mysql://localhost:3306/colour-springboot?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
      # 数据库用户名
      username: root
      # 数据库密码
      password: 123456

# mybatis 配置部分
mybatis:
    # 配置mapper.xml映射文件所在位置,表示在resources/mapper目录下
    mapper-locations: classpath*:mapper/*.xml
    # 类型映射别名,Mybatis会自动为该包下的所有实体类注册别名,简化xml配置
    type-aliases-package: com.colour.domain

二、数据库创建

IDEA右侧点击Database工具按钮,连接已有数据库,如图:

image-20260204203700691

连接成功后创建数据库colour-springboot,然后鼠标右键点击数据属性,在配置页面URL补全创建的数据库名,这样每次启动项目后会自动连接到对应的数据库,如下图所示:

image-20260204204147632

三、包命名和配置

  • config:存放配置类,集中管理应用配置
  • controller:处理http请求,调用服务层并且响应数据
  • domain:存放实体类,对应数据库表结构
  • mapper:数据访问层,定义数据库操作结构
  • service:业务逻辑层,存放处理核心业务逻辑类
  • service.impl:存放服务接口的集体实现类
  • utils:存放工具类,提供通用的功能方法

四、创建基础实体类

java
// 路径com/colour/domain/BaseEntity.java
package com.colour.domain;

import lombok.Data;

import java.util.Date;

/**
 * 基础实体类
 */
@Data
public class BaseEntity {
	private Long id;//主键ID
	private Date createTime;//创建时间
	private Date updateTime;//修改时间
}

为什么要创建基础实体类:

  • 提取公共字段idcreateTimeupdateTime到基类中
  • 避免在每个实体类中重复定义这些字段
  • 使用Lombok@Data注解自动生成gettersetter等方法

五、mybatis配置

1.创建mybatis配置类

java
// 路径com/colour/config/MybatisConfig.java
package com.colour.config;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.context.annotation.Configuration;

/**
 * mybatis配置类
 * 用于配置和初始化 mybatis 框架在 spring 环境中的相关配置
 * 使用 @Configuration 注解标识这是一个 spring 配置类
 * 使用 @MapperScan 注解自动扫描和注册 mapper 接口
 */
@Configuration
@MapperScan("com.colour.mapper")
public class MybatisConfig {

	
}

2.创建mapper.xml映射文件

src/main/resources目录下创建mapper目录,在该目录下可创建mapper.xml映射文件。

六、最终目录结构

上述所有基础配置完成后的目录结构如下图所示:

image-20260204203222108