基于TODO的开发方法

以前买了一本书，叫《架构探险—从零开始写Java Web框架 》（__不推荐购买～__），一本标题党书籍！可是我很推崇做者写代码的方式，就是基于TODO的方式进行开发！

我的认为以基于TODO的方式进行开发，至少有以下几点优点：

• 有助于理解需求
• 有助于梳理业务流程
• 有助于任务拆解和代码封装
• TODO即注释
• 更易于进入心流体验

__同时还能避免以下两种状况__：

下面我以Blog的建立流程为例，来演示基于TODO的开发方式，并说明为什么基于TODO的开发方式有如上优点！

后端的开发框架请见Web开发框架推导！

流程演示

后端开发流程

基于上面的开发框架，总体流程就是Controller->Service->Mapper->Database！
就Blog建立流程来讲，咱们会有BlogController->BlogService->BlogMapper->Database的流程！
那咱们的开发流程以下：

__Step1__:

@RestController
public class BlogController{
    //todo 建立blog流程
    //todo 接收参数
    //todo 验证字段
    //todo 构建Model
    //todo 委托BlogService
    //todo 返回blog主键
    //todo 处理可能异常    
}

@Service
public class BlogService{
    //todo 建立blog
    //todo 设置建立信息
    //todo 委托blogMapper执行
    //todo 返回主键
}

__Step2__:

@RestController
public class BlogController{
    //建立blog流程
    @PostMapping("/blog")
    public Long create(BlogDto blog){
        //todo 接收参数
        //todo 验证字段
        //todo 构建Model
        //todo 委托BlogService
        //todo 返回blog主键
        //todo 处理可能异常    
        return null;
    }
}

__Step3__:

@RestController
public class BlogController{
    //建立blog流程
    //接收参数
    @PostMapping("/blog")
    public Long create(@RequestBody @Validated BlogDto blog, BindingResult result){
        //验证字段
        if (bindResult.hasErrors()) {
            throw new BindingException(bindResult.getFieldError().getDefaultMessage());
        }
        //todo 构建Model
        //todo 委托BlogService
        //todo 返回blog主键
        //todo 处理可能异常    
        return null;
    }
}

__Step4__:

@RestController
public class BlogController{
    //建立blog流程
    //接收参数
    @PostMapping("/blog")
    public ResponseEntity create(@RequestBody @Validated BlogDto blogDto, BindingResult result){
        //验证字段
        if (bindResult.hasErrors()) {
            throw new BindingException(bindResult.getFieldError().getDefaultMessage());
        }
        //构建Model
        Blog blog = BeanUtils.copyProperties(blogDto,Blog.class);
        //todo 委托BlogService
        //todo 返回blog主键
        //todo 处理可能异常    
        return ResponseEntity.ok("");
    }
}

__Step5__:

@RestController
public class BlogController{

    @Autowired
    private BlogService blogService;

    //建立blog流程
    //接收参数
    @PostMapping("/blog")
    public ResponseEntity create(@RequestBody @Validated BlogDto blogDto, BindingResult result){
        //验证字段
        if (bindResult.hasErrors()) {
            throw new BindingException(bindResult.getFieldError().getDefaultMessage());
        }
        //构建Model
        Blog blog = BeanUtils.copyProperties(blogDto,Blog.class);
        //委托BlogService
        Long recId = blogService.create(blog);
        //todo 返回blog主键
        //todo 处理可能异常    
        return ResponseEntity.ok("");
    }
}

@Service
public class BlogService{
    //建立blog
    public Long create(Blog blog){
        //todo 设置建立信息
        //todo 委托blogMapper执行
        //todo 返回主键
        return null;
    }
}

__Step6__:

@RestController
public class BlogController{

    @Autowired
    private BlogService blogService;

    //建立blog流程
    //接收参数
    @PostMapping("/blog")
    public ResponseEntity create(@RequestBody @Validated BlogDto blogDto, BindingResult result){
        //验证字段
        if (bindResult.hasErrors()) {
            throw new BindingException(bindResult.getFieldError().getDefaultMessage());
        }
        //构建Model
        Blog blog = BeanUtils.copyProperties(blogDto,Blog.class);
        //委托BlogService
        Long recId = blogService.create(blog);
        //返回blog主键
        return ResponseEntity.ok(recId);
        //todo 处理可能异常    
    }
}

__Step7__:

@RestController
public class BlogController{

    @Autowired
    private BlogService blogService;

    //建立blog流程
    //接收参数
    @PostMapping("/blog")
    public ResponseEntity create(@RequestBody @Validated BlogDto blogDto, BindingResult result){
        try{
            //验证字段
            if (bindResult.hasErrors()) {
                throw new BindingException(bindResult.getFieldError().getDefaultMessage());
            }
            //构建Model
            Blog blog = BeanUtils.copyProperties(blogDto,Blog.class);
            //委托BlogService
            Long recId = blogService.create(blog);
            //返回blog主键
            return ResponseEntity.ok(recId);
        }catch (BusinessException e) {
            //处理可能异常  
            logger.error("Create Blog Error!", e);
            return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
                    .body("Create Blog Error!" + e.getMessage());
        } catch (Exception e) {
            logger.error("Create Blog Error!", e);
            return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
                    .body("Create Blog Error!" + e.getMessage());
        }
    }
}

__Step8__:

@Service
public class BlogService{
    //建立blog
    public Long create(Blog blog){
        //设置建立信息
        Long userId = UserContext.getUser().getUserId();
        blog.setCreateId(userId);
        blog.setUpdateId(userId);
        blog.setCreateTime(new Date());
        blog.setUpdateTime(new Date());
        //todo 委托blogMapper执行
        //todo 返回主键
        return null;
    }
}

__Step9__:

@Service
public class BlogService{

    @Autowired
    private BlogMapper blogMapper;

    //建立blog
    public Long create(Blog blog){
        //设置建立信息
        Long userId = UserContext.getUser().getUserId();
        blog.setCreateId(userId);
        blog.setUpdateId(userId);
        blog.setCreateTime(new Date());
        blog.setUpdateTime(new Date());
        //委托blogMapper执行
        blogMapper.insert(blog);
        //todo 返回主键
        return null;
    }
}

__Step10__:

@Service
public class BlogService{

    @Autowired
    private BlogMapper blogMapper;

    //建立blog
    public Long create(Blog blog){
        //设置建立信息
        Long userId = UserContext.getUser().getUserId();
        blog.setCreateId(userId);
        blog.setUpdateId(userId);
        blog.setCreateTime(new Date());
        blog.setUpdateTime(new Date());
        //委托blogMapper执行
        blogMapper.insert(blog)
        //返回主键
        return blog.getRecId();
    }
}

前端开发流程

前端的开发除了须要处理代码逻辑，还须要处理页面流程！依然能够以TODO的方式来处理，借助于a标签和按钮，能够把页面流给串起来！
接着上面的Blog的CRUD逻辑，这里仅列出示例，再也不演示流程，开发流程和上面的流程一致！

__list.html__:

<!-- todo 新增Blog-->
<a href="new.html">新增</a>

<!--TODO 搜索-->
<!--TODO 列表显示，操做-->
<table>
    <tr>
        <td>
            <a href="view.html">查看</a>
            <a href="edit.html">编辑</a>
            <a href="delete.html">删除</a>
        </td>
    </tr>
</table>
<!--TODO 翻页-->

__new.html__:

<!--todo  表单字段-->
<!--todo  验证规则-->
<!--todo 保存逻辑-->
<a href="list.html">保存按钮</a>
<!--todo 取消逻辑-->
<a href="list.html">取消按钮</a>

__view.html__:

<!--todo  展现字段-->
<!--todo 返回逻辑，按场景返回？-->
<a href="list.html">返回按钮</a>

__edit.html__:

<!--todo  表单字段-->
<!--todo  字段赋值-->
<!--todo  验证规则-->
<!--todo 保存逻辑-->
<a href="list.html">保存按钮</a>
<!--todo 取消逻辑-->
<a href="list.html">取消按钮</a>

优点

首先问一个问题，对于你接收到的信息，你是以什么样的标准来评判你理解了或学会了？就是__用你本身的话再说一遍__！
基于TODO的开发方法就是以此为基础：

• 首先基于需求，以TODO文字的形式将业务流程写下来。写下来之后，能够和需求去确认，修正误差，既__有助于理解需求__也__有助于梳理业务流程__
• 同时，能够看出，每一个TODO的工做量都比较小，实际上也起到了__任务拆解和代码封装__的做用。既然任务拆解了，编写的代码也就相应的被拆解为一个个的功能代码了。固然对于逻辑较复杂的代码，仍是须要使用重构手段，来进一步的对代码进行封装
• 代码编写完后，不须要将TODO彻底删除，只须要把TODO字样去除，__TODO就变成了注释__了！
• 因为每一个TODO的实现时间都较短（主要看拆解得如何），你开发的每一个小功能，实际上都是在解决一个TODO，就像游戏里的打怪同样，能获得__准即时反馈__，心理获得知足！这是__进入心流体验__的一个必要条件！

__关于心流体验__：

• 心流英文叫"flow"，我第一次见到这个词是在《人件》这本书上！这是两年前写的读书笔记《个人管理实践---《人件》读后感》！
• 心流的解释有不少，有兴趣的能够去搜索一下
• 相信不少人都经历过，好比你作某件事时很专一（写代码、玩游戏等等），当作完后，你觉得没多长时间，可是回过神来一看，好几个小时已通过去了！

写在最后

本文只是演示了一种我的比较推崇的写代码的方式，并解释了为何推崇这种方式！固然，__仅供参考__！毕竟__适合本身的才是最好的__！

---

公众号：ivaneye