/nestjs-mysql-api

使用nestjs+mysql提供restful api

Primary LanguageTypeScript

一、项目初始化

  • 1、下载原代码及安装依赖包

  • 2、根目录下创建一个.env的文件

    // 端口号
PORT = 4000;

// mysql数据库配置
DB_TYPE = mysql;
DB_HOST = localhost;
DB_USERNAME = root;
DB_PASSWORD = root;
DB_DATABASE = test;
DB_PORT = 3306;
DB_SYNCHRONIZE = false;
DB_LOGGING = true;

// jwt加盐
SECRET = abc;
// 前缀
PREFIX = api / v1;

  • 3、创建数据库及创建表

    -- 创建用户表
CREATE TABLE `user`(
  id int(11) PRIMARY KEY auto_increment COMMENT '主键id',
  uuid VARCHAR(150) UNIQUE NOT NULL COMMENT 'uuid主键',
  name VARCHAR(100) UNIQUE NOT NULL COMMENT '姓名',
  password VARCHAR(255) NOT NULL COMMENT '密码',
  email VARCHAR(100) COMMENT '邮箱',
  mobile VARCHAR(11) COMMENT '手机号码',
  gender TINYINT DEFAULT 0 COMMENT '性别',
  create_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  update_at TIMESTAMP ON UPDATE CURRENT_TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT '更新时间'
)
-- 用户扩展表
CREATE TABLE `user_extend`(
  id int(11) PRIMARY KEY auto_increment COMMENT '主键id',
  birthday timestamp COMMENT '生日',
  company VARCHAR(100) COMMENT '公司名称',
  position VARCHAR(100) COMMENT '职位',
  address VARCHAR(100) COMMENT '公司地址',
  avatar VARCHAR(200) COMMENT '头像url',
  user_id int(11) COMMENT '关联用户的id'
)

-- 创建角色表
CREATE TABLE `role`(
  id int(11) PRIMARY KEY auto_increment comment '主键id',
  name varchar(10) UNIQUE not null comment '角色名称',
  description varchar(100) DEFAULT NULL COMMENT '描素',
  is_active tinyint(4) NOT NULL DEFAULT '1' COMMENT '是否可用',
  create_at timestamp default current_timestamp comment '创建时间',
  update_at timestamp on update current_timestamp default current_timestamp comment '更新时间'
)

-- 创建用户与角色的关联表
create table `role_user`(
  role_id int(11) comment '角色id',
  user_id int(11) comment '用户id',
  PRIMARY key(role_id, user_id)
)

-- 创建资源表
create table `resource`(
  id int(11) primary key auto_increment comment '主键id',
  uuid VARCHAR(150) UNIQUE NOT NULL COMMENT 'uuid主键',
  name VARCHAR(100) UNIQUE NOT NULL COMMENT '资源名称',
  parent_id int(11) not null default 0 comment '父资源id',
  create_at timestamp default current_timestamp comment '创建时间',
  update_at timestamp on update current_timestamp default current_timestamp comment '更新时间'
)

-- 创建资源和角色的关联表
create table `role_resource`(
  role_id int(11) comment '角色id',
  resource_id int(11) comment '资源id',
  primary key(role_id, resource_id)
)

  • 4、运行代码

    npm run start:dev
# or
npm run webpack
npm run start1

二、主要实现功能

  • 使用nestjs-config和dotenv保存敏感数据及在项目中直接使用ConfigService参考文档
  • 使用typeorm-model-generator由数据库表迁移生成*.entity.ts文件参考我的文章
  • 使用node-auth0模块进行密码加密处理(见src/core/user/user.entity.ts)
  • 使用jwt对用户登录授权(见src/shared/guard/auth.guard.ts)
  • 封装了统一成功、失败数据返回格式,并在全局使用(见src/shared/interceptor/transform.interceptor.ts和src/shared/filters/http-exception.filter.ts)
  • 封装了用户提交数据错误提示(见src/shared/pipe/validation.pipe.ts)
  • 日志拦截器,用于记录各个请求访问时间(见src/shared/interceptor/logging.interceptor.ts)
  • 核心模块curl封装了httpModule模块的网络请求
  • 使用@nestjs/swagger swagger-ui-express生成API文档(见src/main.ts)
  • 安全方面
  • src/core中添加上传附近模块官网地址
  • 使用webpack热更新官方文档
  • 新增分页拦截器(src/shared/interceptor/paginate.interceptor.ts和src/core/user/user.service.ts)

三、技术解答

本项目还在持续集成新功能进来,最后会加上前端做一个cms系统的api,后期会拉分支使用graphql提供api

  • 1、有关于nestjs的技术问题可以直接加我微信备注:nest 开发

  • 2、如果你觉得本项目对你帮助很大,给一个赞