在学习js时遇到egg.js,就做了详细的研究,它是阿里推出的基于koa的node开发框架,为企业级框架和应用而生。如何搭建后台服务api ,还需要后面的学习。本文章主要是介绍egg.js搭建后台服务api ,需要的可以参考下。
写在前面的话因为平常开发都是前后端分离的模式,就想着使用egg创建后台服务,写一套api接口配合其他的项目。该项目的技术栈用到了egg.js、mongodb、mongoose。这篇文章记录一下我写注册登录模块和用户中心模块的过程,目的是及时归纳学习过程,锻炼文档能力,和大家进行分享交流,共同进步。
项目地址: egg-api
项目持续更新中,喜欢的请点心,关注,star ,fork,这些是我长期坚持下去的动力 (。_ 。) ✎_
以下是正文需求分析对于注册登陆模块,需求分析如下:
注册成为新用户,对输入的数据进行校验
登陆进入系统,需要对输入的数据进行校验,基于token鉴权认证
登出功能
登陆进去可以在用户中心模块查看个人信息
在用户中心模块修改个人信息
数据分析设计显式数据:
username: string 用户名
userpass: string 账号密码
useremail: string 用户邮箱
telphone: string 手机号
avatar: string 头像
age: number 年龄
sex: string 性别
city: string 城市
隐式数据:
userrole: number 用户角色(1.普通用户、 2.管理员、 3.超级管理员,默认用户为普通用户,超级管理员在创建数据库的时候创建)
usercreate: date 用户创建时间
lastlogintime: date 上次登录时间
laseloginplace: string 上次登录地址
api分析设计下文接口说明中的api指接口名,params指传入的数据,code指响应结果标识码,msg指响应结果信息说明,data指响应成功返回的数据
注册接口api: /api/v1/signup (post)params: { username: string, // 用户名,具有唯一性 userpass: string, // 用户密码 useremail: string, // 用户邮箱}code: 1、注册成功 0:输入信息不完善或有误 -1:注册失败,该用户名已存在msg: 响应返回的信息说明data: { _id: _id, username: 用户名, token: 生成的token,}
登录接口api: /api/v1/signin (post,请求头带token)params: { username: string, // 用户名 userpass: string, // 用户密码}code: 1、登录成功 0:输入信息不完善或有误 -1:用户不存在msg: 响应返回的信息说明data: { _id: _id, username: 用户名, lastlogintime: 上次登录时间, lastloginplace: 上次登录地点,}
登出接口api: /api/v1/signout (get)code: 1、登出成功,前端退出系统并清空tokenmsg: 登出响应返回信息说明data: {}
查看个人信息接口api: /api/v1/user/username (post,请求头带token)params: { username: string,}code: 1、查询成功 0、输入信息不完善 -1、查询失败msg: 查找个人信息返回信息说明data: { username: 用户名, useremail: 用户邮箱, age: 年龄, city: 城市, ......}
更改个人信息接口api: /api/v1/user/username (put,token)params: { ...... // 更改的信息}code: 1、更新成功 0、输入信息不完善或有误 -1、更新失败msg: 更新个人信息返回信息说明data: { username: 用户名, ......}
编码实现注:编码实现说明只提供部分,完整内容请移步egg-api
假设你已经初始化好了一个项目,项目的目录结构约定和官方的一致。因为我们要使用mongodb数据库,所以要先安装egg-mongoose,并在配置文件里写入:
// config/plugin.jsexports.mongoose = { enable: true, package: 'egg-mongoose',};// config/config.default.jsconfig.mongoose = { url: 'mongodb://127.0.0.1/apiexample', options: {},};
在model文件夹定义我们的schema文件:
const userschema = new schema({ username: { type: string, unique: true, required: true, },});
路由定义:
router.post('/api/v1/signup', controller.user.signup);
controller编写:用于解析用户的输入,处理后返回相应的结果。我们可以把获取到的数据放到render中进行渲染,然后把渲染后的结果发给游览器,或者,也可以把数据直接赋值给ctx.body,然后以json方式返回。
class usercontroller extends controller { // 登录 async signin() { const { ctx } = this; const rule = { username: { type: 'string', required: true, message: '必填项' }, userpass: { type: 'string', required: true, message: '必填项' }, }; const signinmsg = ctx.request.body; await ctx.validate(rule, signinmsg); signinmsg.userpass = ctx.helper.encrypt(signinmsg.userpass); const result = await ctx.service.user.signin(signinmsg); ctx.body = result; }}
service编写:用于编写业务逻辑层,可以复用。复杂数据的处理,比如要展现的信息需要从数据库获取,或者是第三方服务的调用。
class userservice extends service { // 更新用户信息 async updateuser(usermsg) { const { ctx } = this; const res = {}; const result = await ctx.model.user.findbyidandupdate(usermsg._id, usermsg); res.code = 1; res.msg = '用户信息已更改'; res.data = result; return res; }}
一个简单的node应用结构就是这样,如此便实现了用egg.js负责接口服务。apache php mysql
相关文章:
nodejs如何搭建web服务器
服务器-企业网站后台搭建问题
相关视频:
高性能linux服务器搭建视频教程
以上就是技术文章:使用egg.js搭建后台服务api (收藏系列)的详细内容。