JeecgBoot 开源项目指南

JeecgBoot 开源项目指南

jeecg-boot项目地址:https://gitcode.com/gh_mirrors/jee/jeecg-boot

1. 项目目录结构及介绍

JeecgBoot 的目录结构遵循标准的 Maven 项目布局：

.
├── pom.xml             # Maven 主配置文件
├── src
│   ├── main
│   │   ├── java       # Java 源代码目录
│   │   └── resources  # 资源文件目录，包括配置文件等
│   └── test           # 测试代码目录
└── ...

• pom.xml: Maven 项目的主配置文件，定义了项目依赖和构建过程。
• src/main/java: 包含核心 Java 业务代码和控制器。
• src/main/resources: 存放配置文件、静态资源等非 Java 文件。

2. 项目的启动文件介绍

在 JeecgBoot 中，主要的启动类通常位于 java 目录下的顶级包内，如 com.jeecg.JeecgApplication。这个类使用 @SpringBootApplication 注解来标识它作为Spring Boot 应用的入口点。

package com.jeecg;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;

@SpringBootApplication
public class JeecgApplication extends SpringBootServletInitializer {

    public static void main(String[] args) {
        SpringApplication.run(JeecgApplication.class, args);
    }

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(JeecgApplication.class);
    }
}

main 方法是应用程序的起点，通过 SpringApplication.run() 启动 Spring Boot。

如果你需要部署到传统的应用服务器，如 Tomcat，那么 SpringBootServletInitializer 的扩展用于适应这种环境。

3. 项目的配置文件介绍

JeecgBoot 使用 application.yml 或 application.properties 文件来管理应用程序的配置。默认情况下，Spring Boot 将查找 src/main/resources 目录下的这些文件。

3.1 application.yml

YAML 格式的配置文件提供了更直观的层次结构：

server:
  port: 8080
spring:
  profiles:
    active: dev
  datasource:
    url: ...
    username: ...
    password: ...
  jpa:
    show-sql: true
  thymeleaf:
    mode: HTML
...

• server.port: 服务器监听的端口号
• spring.profiles.active: 激活的配置文件 profile，默认为 dev（开发环境）
• spring.datasource: 数据源配置，包括数据库 URL、用户名和密码
• spring.jpa.show-sql: 是否显示 SQL 查询日志
• spring.thymeleaf.mode: Thymeleaf 渲染引擎的工作模式

3.2 application.properties

属性文件格式如下：

server.port=8080
spring.profiles.active=dev
spring.datasource.url=jdbc:mysql://localhost:3306/yourdb?useUnicode=true&characterEncoding=utf8
spring.datasource.username=root
spring.datasource.password=root
spring.jpa.show-sql=true
spring.thymeleaf.mode=HTML

配置项同 YAML 格式，只是用键值对的形式表示。

记得根据你的实际环境修改配置文件中的数据库连接等敏感信息。完成配置后，你可以通过 mvn spring-boot:run 或者直接运行 JeecgApplication 类来启动项目。

希望这个指南对你了解和使用 JeecgBoot 有所帮助。如有其他疑问，欢迎进一步探索该项目的官方文档或在 Github 上提出问题。

jeecg-boot项目地址:https://gitcode.com/gh_mirrors/jee/jeecg-boot