Files
xiaozhi-esp32-server/main/manager-api
剑雨 36d1370720 添加了请求参数验证
--TimbreController.java 验证参数
--TimbreDataDTO.java
--TimbreDataDTO.java 定义参数验证
--validation.properties
--validation_en_US.properties
--validation_zh_CN.properties
--validation_zh_TW.properties 定义参数验证失败后的错误说明
2025-03-21 17:26:16 +08:00
..
2025-03-21 17:26:16 +08:00
2025-03-07 21:19:41 +08:00

本文档是开发类文档,如需部署小智服务端,点击这里查看部署教程

项目介绍

manager-api 该项目基于SpringBoot框架开发。

开发使用代码编辑器,导入项目时,选择manager-api文件夹作为项目目录

参照manager前后端接口协议开发

开发环境

JDK 21 Maven 3.8+ MySQL 8.0+ Vue 3.x

创建数据库

如果本机已经安装了MySQL,可以直接在数据库中创建名为xiaozhi_esp32_server的数据库。

CREATE DATABASE xiaozhi_esp32_server CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

如果还没有MySQL,你可以通过docker安装mysql

docker run --name xiaozhi-esp32-server-db \
-e MYSQL_ROOT_PASSWORD=123456 \
-p 3306:3306 \
-e MYSQL_DATABASE=xiaozhi_esp32_server \
-e MYSQL_INITDB_ARGS="--character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci" \
-d mysql:latest

确认项目数据库连接信息

src/main/resources/application-dev.yml中配置数据库连接信息

spring:
  datasource:
    username: root
    password: 123456

测试启动

本项目为SpringBoot项目,启动方式为: 打开Application.java运行Main方法启动

路径地址:
src/main/java/xiaozhi/AdminApplication.java

打包编译

执行以下命令生产jar包

mvn install

把jar包放在服务器上,执行

nohup java -jar xiaozhi-esp32-api.jar --spring.profiles.active=dev >/dev/null &

接口文档

启动后打开:http://localhost:8002/xiaozhi-esp32-api/doc.html