文档列表
📄️ 错误处理-错误码接口
全面介绍`GoFrame`框架`gcode`错误码组件的接口化设计和高扩展性。详细讲解`Code`接口的三个核心方法:`Code()`返回错误码的整数值、`Message()`返回错误描述、`Detail()`返回错误详细信息。框架提供默认实现,开发者可通过`New`方法创建错误码,也可自定义实现`Code`接口满足复杂业务需求。
📄️ 错误处理-错误码使用
全面讲解`GoFrame`框架`gerror`组件中带错误码的`error`对象创建和操作方法。包括创建方法:`NewCode/NewCodef`用于创建带错误码和堆栈信息的错误对象;包裹方法:`WrapCode/WrapCodef`用于包裹现有错误并添加错误码;高级方法:`NewCodeSkip/WrapCodeSkip`可忽略部分堆栈信息;`Code`方法用于递归获取错误对象中的错误码。提供详细代码示例帮助开发者掌握错误码的实际应用。
📄️ 错误处理-错误码扩展
详细讲解`GoFrame`框架`gcode`组件的错误码扩展功能,通过`Detail`参数实现复杂业务场景下的错误码自定义。示例展示如何定义包含用户信息的`BizCode`结构体,使用`gcode.WithCode`方法创建带扩展数据的错误码。在中间件中获取错误码详情进行日志记录,并将错误信息返回给客户端,实现灵活的错误处理和日志管理。
📄️ 错误处理-错误码实现
详细讲解`GoFrame`框架中如何自定义实现复杂的业务错误码。通过实现`gcode.Code`接口,定义包含`code`、`message`和自定义`detail`的错误码结构体`BizCode`。示例展示了如何定义业务错误码(如`CodeNotFound`、`CodeInternal`)并在中间件中使用,将HTTP状态码和自定义错误信息结合返回给客户端,实现灵活的错误处理机制。
📄️ 错误处理-内置错误码
介绍`GoFrame`框架`gcode`组件预定义的常见内置错误码,开发者可直接引用使用。提供错误码定义文件的GitHub链接供查阅。特别强调错误码使用规范:框架预留了小于1000的整型错误码,业务自定义错误码应定义为大于1000的整数,以避免与框架预留错误码冲突,确保错误处理的稳定性和兼容性。