有问必答

最近有好多读者私信我，为什么选择GoFrame做电商项目的开发?

原因很简单：

因为我司是用GoFrame做电商业务开发的，而且我司同事基本都是PHP转Go的。GoFrame可以说是非常适合PHPer转Gopher的开发框架。

在入职我司之前，我有使用Gin和go-micro框架，目前也正在学习go-zero。

不管是开发语言还是开发框架，都服务于我们所做的业务，抛开业务去聊语言或者框架都是没有意义的。

使用GoFrame做开源项目的另一个原因是：想体验一下V2版本的新特性，自己的项目怎么做自己能完全说了算，没有历史包袱。

前言

让开发者更好的做到“模块内部高内聚，模块之间松耦合”，是我认为GoFrame V2设计的精髓。

用GoFrame开发商业项目已经很长时间，发现GoFrame的版本更新比较快，社区也非常的活跃。

因为历史原因，我之前一直用V1.16版本做商业项目的开发，虽然个人有比较强的意愿升级到V2。

但是考虑到项目稳定性及开发成本等等原因，商业项目并未升级。这可能也是很多小伙伴面临的问题。

受到鼓励

正好前段时间，分享了自己的开源项目【Go WEB进阶实战】基于GoFrame搭建的电商前后台API系统
受到了大家的关注和支持，GoFrame的作者也在点赞转发，更受鼓励。

更重要的是：收到了社区里很多小伙伴的建议，最多的建议就是建议我使用V2版本，因为提供了很多新特性，可以更好的实现需求，稳定且高效。

决定升级

所以，我决定把我开源的项目从V1.16.x版本，升级到最新的V2.2.0版本，踩一下升级的坑，享受一下升级后的快乐。

欢迎小伙伴们加入到我的开源项目中：电商前后台系统API，目前V1版本已经收尾，包括电商项目的常用功能，开发了120多个接口。

一起参与

V2版本在开发过程中，目前已经开发了30多个接口，计划这个月内开发完毕，也开源出去。欢迎小伙伴们参与共建，也欢迎阅读我的源码，多提宝贵建议：

V2版本GitHub地址

因为内容比较长且硬核，所以我决定分两篇文章分享：

1. 这篇文章重点：介绍GoFrame V2的新特性，和V1相比有哪些优势？最大的变化是什么？

2. 下一篇文章会分享一下：我从V1升级到V2的踩坑之旅，相信对很多小伙伴都有帮助。

这个经历实属不易，希望小伙伴们可以点赞、关注、转发一波。

适合看的人群

1. 掌握Go基础后，想用成熟框架开发项目的伙伴，建议读完我的文章之后，直接使用GoFrame最新的V2版本实战开发
2. 目前在用V1版本，有意愿但是没有大量精力学习V2新特性的伙伴，担心升级问题太高不敢贸然升级的伙伴们。
3. 想提高自己学习新知识效率的小伙伴，欢迎复刻我的这种实践方式。

站在开发者的角度

不管你是哪种人群，都建议先花时间仔细阅读官方文档，尤其是 框架介绍这部分。

区别于官方文档，这篇文章会结合我自己的经验，站在框架使用者的角度，帮大家更快更好的理解Goframe V2版的设计思路，基于V2版本如何更好的进行商业项目的开发。

踩的坑

在我升级版本的过程中发现：一定要先了解清楚V2的新特性，然后再从V1升级到V2，否则升级到一半会出现无从下手的问题：

1. 因为通过V2版本的CLI工具生成的dao、model，和V1版本是不一致的：废弃了gmvc模块等，也引入了新的模块。

2. V2版本支持gf gen service的方式生成service层，统一我们接口逻辑的实现方式，引入了logic层和service层的概念

结合自己的升级经历，分享给大家学习GoFrame V2必知必会的知识点：

必知必会

1. 项目工程结构发生了变化，且需要按照V2的标准来，因为gf工具生成代码的目录结构发生了改变，更重要的：V2官方建议的目录结构也是我们践行"高内聚低耦合"比较好的工程目录结构。

2. gf gen dao除了会像V1一样生成dao层和model层，还会另外生成do层和entity层

3. V2版本的目录结构实践了业务模型和数据模型解耦的思想（也是我认为非常赞的地方）

4. V2相比于V1会出现方法或者模块废弃的情况，比如废弃了gmvc耦合模块，未来不再进一步支持。同时也为我们提供了更好的实现方式。

5. V2有点编写“微服务”的意思了，需要服务注册：controller调用一个或多个service实现具体的业务逻辑；但是复杂的业务逻辑又不是在service中实现的，为了解耦，V2版本引入了logic目录，用于编写和复用复杂的业务逻辑。在logic中注册服务，在service中通过接口方式规范logic层要实现的方法。

重中之重

下面再介绍一下我花了很长时间才消化的知识点：

dao代码生成（很重要）

gf gen dao

在业务项目中，官方推荐使用dao/do/entity的方式操作数据库，这些文件都是通过开发工具自动生成的，由开发工具统一维护。

区别于V1版本，V2版本引入了do的概念，为什么这么设计？

在这里我只说结论，文章最后会附上官方链接：

1. dao层用于数据访问，这是一层抽象对象，用于和底层数据库交互，仅包含最基础的 CURD 方法

2. model层是结构模型，是数据结构管理模块，管理数据实体对象，以及输入与输出数据结构定义。

   2.1 model中的do是领域对象，用于dao数据操作中业务模型与实例模型转换，由工具维护，用户不能修改。

   2.2 model中的entity是数据模型，数据模型是模型与数据集合的一对一关系，由工具维护，用户不能修改。

后面我会带着大家用实例讲解

服务接口生成（更重要）

gf gen service

服务接口是非常重要的知识点，也是我认为在cli工具支持方面和V1版本最大的区别：

为了降低业务项目内部模块间的耦合，框架将模块间的依赖抽象为了接口，由internal/service包维护。internal/service可以由开发者自定义维护接口，也可以通过internal/logic业务封装的代码按照一定规则自动生成接口代码文件。

实践出真知

看10遍文档，都不如一次动手实践。建议大家和我一起操练起来，欢迎复刻：

我的思路是这样：

1. 下载官方的示例项目，学习一下官方是怎么写的。

2. 给自己提需求，参考官方的实现方式，实现自己的业务场景。

3. 我会带着大家实现经典的电商场景：添加和查询商品信息。

1. 下载运行官方示例的GitHub

官方示例GitHub

1.1 下载部署好项目之后，启动：非常顺滑的就启动成功了：

1.2 请求接口，验证试一下DB是否连接正常。

1.3 查询数据库，也是有值的。

验证环境无误，下面开始带着大家参考官方示例实现自己的需求，进而更好的理解V2版本新特性和工程实践。

2. 基于V2编写商品管理

我们按照官方建议的工程方式去实践，看看会不会踩坑：

2.1 创建goods表如下：

2.2 通过gf gen dao生成dao和model

初次尝试，失败，原因是没有修改hack目录下的config.yaml配置文件。

注意：和V1不同，官方说hack目录的作用是工具脚本，存放项目开发工具、脚本等内容。例如，CLI工具的配置，各种shell/bat脚本等文件。所以我们就不要像V1一样把cli工具的配置文件也写到manifest/config目录中了。

2.3 搞定