# DLZ-java库

**Repository Path**: careyzhan/dlz-java-library

## Basic Information

- **Project Name**: DLZ-java库
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-12
- **Last Updated**: 2026-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

电商平台API - Spring Boot版本

这是从Node.js Express项目迁移到Spring Boot + MyBatis-Plus的电商平台后端API。



技术栈

Spring Boot 3.2.0

Java 17

MyBatis-Plus 3.5.4

MySQL/H2/PostgreSQL

JWT认证

Spring Security

Maven

项目结构

src/

├── main/

│   ├── java/com/ecommerce/api/

│   │   ├── controller/     # REST控制器

│   │   ├── service/        # 业务服务层

│   │   ├── repository/     # 数据访问层

│   │   ├── entity/         # 实体类

│   │   ├── dto/           # 数据传输对象

│   │   ├── config/        # 配置类

│   │   ├── exception/     # 异常处理

│   │   ├── security/      # 安全配置

│   │   ├── util/          # 工具类

│   │   └── EcommerceApiApplication.java

│   └── resources/

│       ├── application.yml     # 主配置文件

│       ├── application-dev.yml # 开发环境配置

│       ├── application-prod.yml # 生产环境配置

│       └── db/

│           ├── schema.sql      # 数据库表结构

│           └── data.sql        # 初始数据

└── test/

    └── java/com/ecommerce/api/

快速开始

1\. 环境要求

Java 17+

Maven 3.6+

2\. 运行项目

\# 使用H2内存数据库（开发测试）

mvn spring-boot:run



\# 使用MySQL数据库

mvn spring-boot:run -Dspring.profiles.active=dev



\# 使用PostgreSQL数据库

mvn spring-boot:run -Dspring.profiles.active=prod

3\. 访问地址

API文档: http://localhost:8080

健康检查: http://localhost:8080/health

H2控制台: http://localhost:8080/h2-console (仅开发环境)

API接口

认证相关

POST /api/v1/users/register - 用户注册

POST /api/v1/users/login - 用户登录

GET /api/v1/users/profile - 获取用户信息

PUT /api/v1/users/profile - 更新用户信息

健康检查

GET /health - 基础健康检查

GET / - API根路径信息

数据库配置

开发环境 (application-dev.yml)

spring:

  datasource:

    url: jdbc:mysql://localhost:3306/ecommerce\_dev

    username: root

    password: root

生产环境 (application-prod.yml)

spring:

  datasource:

    url: ${DATABASE\_URL}

    username: ${DATABASE\_USERNAME}

    password: ${DATABASE\_PASSWORD}

环境变量

生产环境需要设置以下环境变量：



DATABASE\_URL - 数据库连接URL

DATABASE\_USERNAME - 数据库用户名

DATABASE\_PASSWORD - 数据库密码

JWT\_SECRET - JWT密钥

已完成功能

✅ 项目基础架构搭建 ✅ 用户注册/登录功能 ✅ JWT Token认证 ✅ 数据库表结构迁移 ✅ MyBatis-Plus集成 ✅ 异常处理机制 ✅ CORS跨域配置 ✅ 健康检查接口



待完善功能

⏳ 商品管理模块 ⏳ 分类管理模块 ⏳ 购物车功能 ⏳ 订单管理模块 ⏳ 动态内容管理 ⏳ 文件上传功能 ⏳ 权限控制系统 ⏳ 单元测试覆盖



迁移说明

此项目是从原Node.js Express项目迁移而来，主要变化：



框架变更: Express → Spring Boot

ORM变更: Knex.js → MyBatis-Plus

数据库: 支持多种数据库(H2/MySQL/PostgreSQL)

认证: JWT Token机制保持一致

API结构: 保持RESTful风格统一

开发指南

添加新实体

在entity包下创建实体类

在repository包下创建对应的Mapper接口

在service包下创建业务服务类

在controller包下创建REST控制器

数据库迁移

修改src/main/resources/db/schema.sql

更新相应的实体类

重启应用使更改生效

测试

\# 运行所有测试

mvn test



\# 运行特定测试类

mvn -Dtest=EcommerceApiApplicationTests test