Spring Boot微服务架构（三）：Spring Initializr创建CRM项目

news2025/5/25 20:57:44

使用Spring Initializr创建CRM项目

在这里插入图片描述

一、创建项目前的准备

访问Spring Initializr网站：
- 打开浏览器访问 https://start.spring.io/
- 或者直接使用IDE（如IntelliJ IDEA或Eclipse）内置的Spring Initializr功能
项目基本信息配置：
- Project：选择Maven或Gradle（推荐Maven）
- Language：选择Java
- Spring Boot：选择稳定版本（如3.1.x或2.7.x）
- Project Metadata：
  - Group：com.yourcompany（替换为你的公司/组织名）
  - Artifact：crm（项目名称）
  - Name：crm（项目名称）
  - Description：CRM系统微服务架构（项目描述）
  - Package name：com.yourcompany.crm（包名）
  - Packaging：Jar（默认）
  - Java：选择你的Java版本（如17）

二、添加核心依赖

在"Dependencies"选项卡中添加以下依赖（按需选择）：

基础依赖：
- Spring Web（用于构建Web应用）
- Spring Data JPA（用于数据库操作）
- MySQL Driver（数据库驱动，根据实际数据库选择）
- Lombok（简化代码，可选但推荐）
微服务相关依赖（如果需要微服务架构）：
- Spring Cloud Starter（微服务基础）
- Spring Cloud Netflix Eureka Client（服务注册与发现）
- Spring Cloud Gateway（API网关，可选）
- Spring Cloud Config（分布式配置中心，可选）
其他常用依赖：
- Spring Boot Actuator（监控和管理）
- Spring Security（安全认证，可选）
- Validation（数据校验）
- Thymeleaf（前端模板引擎，可选）

在这里插入图片描述

三、生成项目

点击"Generate"按钮下载项目压缩包
解压到本地目录
使用IDE（如IntelliJ IDEA或Eclipse）导入项目：
- 在IDE中选择"Open"或"Import Project"
- 选择解压后的项目目录
- 选择Maven或Gradle作为构建工具

四、项目结构说明

生成的项目通常包含以下目录结构：

crm/
├── src/
│   ├── main/
│   │   ├── java/com/yourcompany/crm/       # Java源代码
│   │   └── resources/                      # 资源文件
│   └── test/                               # 测试代码
├── pom.xml                                 # Maven构建文件
└── README.md                               # 项目说明文档

五、配置数据库连接（以MySQL为例）

修改src/main/resources/application.properties文件：

# 数据库配置
spring.datasource.url=jdbc:mysql://localhost:3306/crm_db?useSSL=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=yourpassword
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# JPA配置
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect

创建数据库：
- 登录MySQL，执行CREATE DATABASE crm_db;

六、创建第一个实体类和Repository

在src/main/java/com/yourcompany/crm/下创建包model和repository
创建实体类（以客户为例）：

package com.yourcompany.crm.model;

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;
import lombok.Data;

@Entity
@Data
public class Customer {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private String email;
    private String phone;
}

创建Repository接口：

package com.yourcompany.crm.repository;

import com.yourcompany.crm.model.Customer;
import org.springframework.data.jpa.repository.JpaRepository;

public interface CustomerRepository extends JpaRepository<Customer, Long> {
}

七、创建第一个Controller

在src/main/java/com/yourcompany/crm/下创建包controller
创建Controller类：

package com.yourcompany.crm.controller;

import com.yourcompany.crm.model.Customer;
import com.yourcompany.crm.repository.CustomerRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;

@RestController
@RequestMapping("/customers")
public class CustomerController {

    @Autowired
    private CustomerRepository customerRepository;

    @GetMapping
    public List<Customer> getAllCustomers() {
        return customerRepository.findAll();
    }
}

八、运行项目

在IDE中运行主应用类（通常位于src/main/java/com/yourcompany/crm/下，名为CrmApplication.java）
访问测试接口：
- 打开浏览器或使用Postman访问http://localhost:8080/customers
- 应该返回空列表（因为还没有数据）

九、扩展建议

添加更多实体和功能：
- 按照类似方式创建销售、产品等其他实体
添加服务层：
- 在src/main/java/com/yourcompany/crm/下创建service包
- 创建服务类处理业务逻辑

添加API文档：

添加Swagger依赖：

<dependency>
    <groupId>org.springdoc</groupId>
    <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
    <version>2.1.0</version>
</dependency>