资讯专栏INFORMATION COLUMN

egg学习笔记-1

wmui / 1357人阅读

摘要:入门笔记请按照官方文档初始化一个工程项目,按照如下步骤学习即可,如有不懂的请参考官方文档。需要禁止此特性。定义为字符串且必须,最小长度为个字符。下面将定义统一错误处理的中间件进行错误处理。在目录中创建目录,对的内置对象进行扩展即可。

入门笔记

请按照官方文档初始化一个simple工程项目,按照如下步骤学习即可,如有不懂的请参考官方文档。

禁止csrf验证

根据如下步骤进行控制的创建,在执行Post操作的时候会出现invalid csrf token错误。需要禁止此特性。

创建路由
/**
 * @param {Egg.Application} app - egg application
 */
module.exports = app => {
  const {
    router,
    controller,
  } = app;
  router.get("/", controller.home.index);
  // 新建资源路由
  router.resources("SystemUser", "/system/user", controller.system.user);
};

控制器controller.system.user,对应的是controller目录下的system目录里面的user.js文件

创建对应的控制器
const Controller = require("egg").Controller;

class SystemUserController extends Controller {
  async index() {
    const {
      ctx,
    } = this;
    ctx.body = "hello ! this is SystemUserController";
  }
}
module.exports = SystemUserController;  

访问地址:localhost:7001/system/user

创建可以提交数据的控制器方法
const Controller = require("egg").Controller;

class SystemUserController extends Controller {
  async index() {
    const {
      ctx,
    } = this;
    ctx.body = "hello ! this is SystemUserController";
  }

  async create() {
    const ctx = this.ctx;
    const user = ctx.request.body;
    ctx.body = user;
  }
}

module.exports = SystemUserController;

POST方法访问网址:localhost:7001/system/user 会提示invalid csrf token错误。

关闭csrf验证
  // configconfig.default.js
  // 关闭csrf验证
  config.security = {
    csrf: {
      enable: false,
    },
  };
开启验证

在上面的例子中,我们通过表单提交了任何数据,都会回显到界面上,如果是数据需要存储或者做其他业务处理,则需要对用户输入的数据进行验证。
egg提供了egg-validate插件进行表单验证

安装插件
cnpm install egg-validate --save
配置启用插件
/** @type Egg.EggPlugin */
module.exports = {
  // had enabled by egg
  // static: {
  //   enable: true,
  // }
  validate: {
    enable: true,
    package: "egg-validate",
  },

};
使用验证组件

首先创建一个规则,这里我们定义username是字符串而且是必须的,最大长度为8个字符。
定义password为字符串且必须,最小长度为6个字符。
ctx.validate(createRule, ctx.request.body);
通过上述语句进行参数检查
更多规则请参考:https://github.com/node-modul...

const Controller = require("egg").Controller;

// 定义本接口的请求参数的验证规则
const createRule = {
  username: {
    type: "string",
    required: true,
    max: 8,
  },
  password: {
    type: "string",
    required: true,
    min: 6,
  },
};

class SystemUserController extends Controller {
  async index() {
    const {
      ctx,
    } = this;
    ctx.body = "hello ! this is SystemUserController";
  }

  async create() {
    const ctx = this.ctx;
    // 验证输入参数是否符合预期格式
    ctx.validate(createRule, ctx.request.body);
    const user = ctx.request.body;
    ctx.body = user;
  }
}

module.exports = SystemUserController;
测试

使用POSTMAN提交任意字段,则会提示Validation Failed (code: invalid_param)
如何查看具体错误信息呢。下面将定义统一错误处理的中间件进行错误处理。

统一错误处理中间件

在项目的app目录中创建middleware目录,此目录中可以创建中间件。

创建错误处理中间件
"use strict";
module.exports = () => {
  return async function errorHandler(ctx, next) {
    try {
      await next();
    } catch (err) {
      // 控制台输出
      console.error("MiddleWare errorHandler", err);
      // 所有的异常都在 app 上触发一个 error 事件,框架会记录一条错误日志
      ctx.app.emit("error", err, ctx);
      // status 如果没有,则统一为500
      const status = err.status || 500;
      // 如果是500错误,且是生产环境,则统一显示“Internal Server Error”
      const error = status === 500 && ctx.app.config.env === "prod" ? "Internal Server Error" : err;
      // 改变上下文状态代码
      ctx.status = status;
      // 从 error 对象上读出各个属性,设置到响应中
      ctx.body = {
        error,
      };
    }
  };
};
启用中间件

文件configconfig.default.js中

  // add your middleware config here
  config.middleware = [];

将其修改为包含你创建的中间件

  // add your middleware config here
  // errorHandler 统一错误处理
  config.middleware = [ "errorHandler" ];

  // errorHandler 只在/api上生效
  config.errorHandler = {
    match: "/api",
  };

如上所示,可以设置错误处理中间件在什么URL上面起作用。这里我们使用/api

测试路由

先使用原来的路由访问:localhost:7001/system/user
错误提示依旧
变更路由:打开文件:approuter.js

  // router.resources("SystemUser", "/system/user", controller.system.user);
  router.resources("SystemUser", "/api/v1/system/user", controller.system.user);

再次访问:localhost:7001/api/v1/system/user
提示信息会变成:

{"error":{"message":"Validation Failed","code":"invalid_param","errors":[{"message":"required","field":"username","code":"missing_field"},{"message":"required","field":"password","code":"missing_field"}]}}
格式化接口返回的数据结构

在上面显示错误信息中,可以看到规范的Json数据,如果开发接口,我们就需要定义统一的数据结构,以便客户端进行解析。
在API开发中,可以定义接口的标准返回格式。通过框架扩展方式定义返回数据格式是一个非常方便的方法。
在app目录中创建extend目录,对egg的内置对象Helper进行扩展即可。

创建Helper扩展

文件:app/extend/helper.js

"use strict";

module.exports = {
  /**
   * 调用正常情况的返回数据封装
   * @param {Object} ctx - context
   * @param {*} msg  - message
   * @param {*} data - 数据
   */
  success(ctx, msg, data) {
    ctx.body = {
      code: 0,
      msg,
      data,
    };
    ctx.status = 200;
  },

  /**
   * 处理失败,处理传入的失败原因
   * @param {*} ctx - context
   * @param {Object} res - 返回的状态数据
   */

  fail(ctx, res) {
    ctx.body = {
      code: res.code,
      msg: res.msg,
      data: res.data,
    };
    ctx.status = 200;
  },
};
改造统一错误处理
// 从 error 对象上读出各个属性,设置到响应中
// ctx.body = {
//   error,
// };
// 格式化返回错误信息
ctx.helper.fail(ctx, {
  code: status,
  msg: error.message,
  data: error.errors,
});
测试

再次访问:localhost:7001/api/v1/system/user
提示信息会变成:

{
    "code": 422,
    "msg": "Validation Failed",
    "data": [
        {
            "message": "required",
            "field": "username",
            "code": "missing_field"
        },
        {
            "message": "required",
            "field": "password",
            "code": "missing_field"
        }
    ]
}
将控制器user中的返回改为标准格式
async create() {
  const ctx = this.ctx;
  // 验证输入参数是否符合预期格式
  ctx.validate(createRule, ctx.request.body);
  const user = ctx.request.body;
  // ctx.body = user;
  this.ctx.helper.success(this.ctx, "ok", user);
}

提交满足要求的数据,测试正确的返回数据
username testuser
password 1234567890
提交后将返回标准的数据格式

{
    "code": 0,
    "msg": "ok",
    "data": {
        "username": "testuser",
        "password": "1234567890"
    }
}

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/102143.html

相关文章

  • 《JSON必知必会》学习笔记(一)

    摘要:基于对象字面量,但是独立于任何编程语言,真正重要的是表示法本身,所以在学习之前不必先学习。键必须是字符串,值可以是合法的数据类型字符串数字对象数组布尔值或。布尔类型中的布尔值仅可使用小写形式或,其他任何写法都会报错。 什么是JSON JSON全称是Javascript Object Notation(对象表示法),是一种在不同平台间传递数据的文本格式(数据交换格式)。常见的数据交换格式...

    rickchen 评论0 收藏0
  • 《JSON必知必会》学习笔记(一)

    摘要:基于对象字面量,但是独立于任何编程语言,真正重要的是表示法本身,所以在学习之前不必先学习。键必须是字符串,值可以是合法的数据类型字符串数字对象数组布尔值或。布尔类型中的布尔值仅可使用小写形式或,其他任何写法都会报错。 什么是JSON JSON全称是Javascript Object Notation(对象表示法),是一种在不同平台间传递数据的文本格式(数据交换格式)。常见的数据交换格式...

    imccl 评论0 收藏0
  • head first python(第二章)–学习笔记

    摘要:第二章学习流程图函数转换为模块函数转换为模块后,就可以灵活的使用模块,方便代码分类,避免代码堆积在一个文件上。使用命令打包代码,生成发布包打包后会生成目录和文件发布后会多了目录和文件,这个是发布的生成的包和相关配置文件。 head first python(第二章)--学习流程图showImg(http://source1.godblessyuan.com/blog_head_firs...

    import. 评论0 收藏0
  • Egg学习_Setp1_初始化项目添加数据库

    摘要:前言本系列文章是学习过程的一个记录初步目标是写一个个人博客会尽可能多使用中提供的各种功能本文全部使用请确保版本足够支持文中有不正确地方请指正地址文档初始化项目使用脚手架初始化项目选择初始化项目的类型项目目录结构自定义启动时 前言 本系列文章是Egg学习过程的一个记录,初步目标是写一个个人博客,会尽可能多使用Egg中提供的各种功能.本文全部使用 async 请确保Node版本足够支持.文...

    Karrdy 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<