在开始本文之前，我想先说这么一句：RESTful 真的很好，但它只是一种软件架构风格，过度纠结如何遵守规范只是徒增烦恼，也违背了使用它的初衷。 就像 Elasticsearch 的 API 会在 GET 请求中直接传 JSON，但这是它的业务需要，因为普通的 Query Par…

写这篇文章的主要目的其实是希望把自己多年关于RESTful API的设计经验总结梳理一下，顺便跟大家做个分享，独乐乐，不如众乐乐么。 为了更好的把设计上的一些问题和注意的点说明白，这篇文章从始至终都会围绕着同一个例子来说明。当然，这个例子是一个yy的REST架构的软件系统。我们…

单元测试应该测试一个工作单元的行为：给定一个输入，最终的期望结果可以是上面的任何一种。 它们应该与正在测试的代码具有相同的质量级别。它们也能通过重构来增强代码自身的可维护性与可读性。 良好单元测试的关键在于编写可测试的代码。下面是一些有用的设计原则： 下文所有的测试用例都以 J…

测试是保证代码质量的重要环节，web项目的单元测试虽然不能完全完成功能测试，但是却能保证底层单一模块的工作质量，并且在代码重构的时候保证对外接口不会发生变化。 Mocha 是一个灵活的测试框架，但它只是一个结构，你需要引入其他插件来实现一些测试功能，比如断言库、覆盖统计等。 M…

最近的业务涉及到了很多数据的计算，数据库提供了一些基础数据，基于这些数据和公式运算才可以得出最终的目标数据。 基础数据可能来源于不同的数据表不同字段。 公式只是基本的四则运算但是数量较多，而且后续可能会有所增减。 这些问题导致代码越来越长，可读性降低，而且后续修改成本越来越大。…

别走，别走，别走啊😭.............................................