写给新手的WebAPI实践综述.doc

写给新手的WebAPI实践 此篇是写给新手的Demo，用于参考和借鉴，用于发散思路。老鸟可以忽略了。 自己经常有这种情况，遇到一个新东西或难题，在了解和解决之前总是说“等搞定了一定要写篇文章记录下来”，但是当掌握了之后，就感觉好简单呀不值得写下来了。其实这篇也一样，决定写下来是想在春节前最后再干一件正经事儿，不能天天回去打Dota了！ 目录： 请求响应的设计 请求的Content-Type和模型绑定 自定义ApiResult和ApiControllerBase 权限验证 模型生成 文档生成 一、请求响应的设计 RESTFul风格响亮很久了，但是我没用过，以后也不打算用。当系统稍微复杂时，为了符合RESTFul要吃力地创建一些不直观的名词，这不是我的风格。所以此文设计的不是RESTFul风格，是只最常用的POST和GET请求。 请求部分就是调用API的参数，抽象出一个接口如下： public interface IRequest { ResultObject Validate(); } 这里面只定义了一个Validate()方法，用于验证请求参数的有效性，返回值是响应里的东西，下面会讲到。 对于请求对象，传递到业务逻辑层，甚至是数据访问层都可以，因为它本身就是用来传输数据的，俗话叫DTO(Data Tran