什么是整洁架构?
在《Clean Architecture: A Craftsman’s Guide to Software Structure and Design》一书中,著名作家 Robert “Uncle Bob” Martin 提出了一种具有一些重要特性的体系结构,如框架、数据库和接口的可测试性和独立性。
整洁架构的约束条件是:
- 独立的框架。该体系结构并不依赖于某些带有特性的软件库的存在。这允许您使用这些框架作为工具,而不是将您的系统束缚在有限的约束中。
- 可测试的。业务规则可以在没有 UI、数据库、Web 服务器或任何其他外部元素的情况下进行测试。
- 独立的 UI 。UI 可以很容易地更改,而不会改变系统的其他部分。例如,可以用控制台 UI 替换 Web UI,而不需要更改业务规则。
- 独立的数据库。您可以将 Oracle 或 SQL Server 替换为 Mongo、BigTable、CouchDB 或其他数据库。您的业务规则不绑定到数据库。
- 独立的任意外部代理。事实上,你的业务规则根本就不用了解外部的构成。
了解更多请查看 : https://8thlight.com/blog/uncle-bob/2012/08/13/the-clean-architecture.html
因此,基于这些约束,每一层都必须是独立的和可测试的。
从 Uncle Bob 的架构中,我们可以将代码分成 4 层:
- 实体: 封装企业范围的业务规则。Go 中的实体是一组数据结构和函数。
- 用例: 这个层中的软件包含应用程序特定的业务规则。它封装并实现了系统的所有用例。
- 控制器: 该层中的软件是一组适配器,它将数据从最方便的用例和实体转换为最方便的外部代理,例如数据库或 Web。
- 框架和驱动程序: 这个层通常由框架和工具(如数据库、Web 框架等)组成。
使用 Golang 构建整洁架构
让我们以 user 包为例:
ls -ln pkg/user
-rw-r — r — 1 501 20 5078 Feb 16 09:58 entity.go
-rw-r — r — 1 501 20 3747 Feb 16 10:03 mongodb.go
-rw-r — r — 1 501 20 509 Feb 16 09:59 repository.go
-rw-r — r — 1 501 20 2403 Feb 16 10:30 service.go
在 entity.go 文件中,我们有自己的实体 :
//User data
type User struct {
ID entity.ID `json:"id" bson:"_id,omitempty"`
Picture string `json:"picture" bson:"picture,omitempty"`
Email string `json:"email" bson:"email"`
Password string `json:"password" bson:"password,omitempty"`
Type Type `json:"type" bson:"type"`
Company []*Company `json:"company" bson:"company,omitempty"`
CreatedAt time.Time `json:"created_at" bson:"created_at"`
ValidatedAt time.Time `json:"validated_at" bson:"validated_at,omitempty"`
}
在 repository.go 文件中我们定义存储库的接口,用于保存存储实体。在这种情况下,存储库意味着 Uncle Bob 架构中的框架和驱动层。它的内容是:
package user
import "github.com/thecodenation/stamp/pkg/entity"
//Repository repository interface
type Repository interface {
Find(id entity.ID) (*User, error)
FindByEmail(email string) (*User, error)
FindByChangePasswordHash(hash string) (*User, error)
FindByValidationHash(hash string) (*User, error)
FindAll() ([]*User, error)
Update(user *User) error
Store(user *User) (entity.ID, error)
AddCompany(id entity.ID, company *Company) error
AddInvite(userID entity.ID, companyID entity.ID) error
}
该接口可以在任何类型的存储层中实现,如 MongoDB、MySQL 等。在我们的例子中,我们使用 MongoDB 来实现,就像在 mongodb.go 中看到的那样:
package user
import (
"errors"
"os"
"github.com/juju/mgosession"
"github.com/thecodenation/stamp/pkg/entity"
mgo "gopkg.in/mgo.v2"
"gopkg.in/mgo.v2/bson"
)
type repo struct {
pool *mgosession.Pool
}
//NewMongoRepository create new repository
func NewMongoRepository(p *mgosession.Pool) Repository {
return &repo{
pool: p,
}
}
func (r *repo) Find(id entity.ID) (*User, error) {
result := User{}
session := r.pool.Session(nil)
coll := session.DB(os.Getenv("MONGODB_DATABASE")).C("user")
err := coll.Find(bson.M{"_id": id}).One(&result)
if err != nil {
return nil, err
}
return &result, nil
}
func (r *repo) FindByEmail(email string) (*User, error) {
}
func (r *repo) FindByChangePasswordHash(hash string) (*User, error) {
}
func (r *repo) FindAll() ([]*User, error) {
}
func (r *repo) Update(user *User) error {
}
func (r *repo) Store(user *User) (entity.ID, error) {
}
func (r *repo) AddCompany(id entity.ID, company *Company) error {
}
func (r *repo) AddInvite(userID entity.ID, companyID entity.ID) error {
}
func (r *repo) FindByValidationHash(hash string) (*User, error) {
}
service.go 文件表示 Uncle Bob 定义的用例层。在文件中,我们有 Service 接口和它的实现。Service 接口是:
//Service service interface
type Service interface {
Register(user *User) (entity.ID, error)
ForgotPassword(user *User) error
ChangePassword(user *User, password string) error
Validate(user *User) error
Auth(user *User, password string) error
IsValid(user *User) bool
GetRepo() Repository
}
最后一层,我们架构中的 Controller 是在 api 的内容中实现的:
cd api ; tree
.
|____handler
| |____company.go
| |____user.go
| |____address.go
| |____skill.go
| |____invite.go
| |____position.go
|____rice-box.go
|____main.go
在以下代码中,从 api/main.go 中我们可以看看如何使用这些服务:
session, err := mgo.Dial(os.Getenv("MONGODB_HOST"))
if err != nil {
elog.Error(err)
}
mPool := mgosession.NewPool(nil, session, 1)
queueService, err := queue.NewAWSService()
if err != nil {
elog.Error(err)
}
userRepo := user.NewMongoRepository(mPool)
userService := user.NewService(userRepo, queueService)
现在我们可以轻松地创建包测试,比如:
package user
import (
"testing"
"time"
"github.com/thecodenation/stamp/pkg/entity"
"github.com/thecodenation/stamp/pkg/queue"
)
func TestIsValidUser(t *testing.T) {
u := User{
ID: entity.NewID(),
FirstName: "Bill",
LastName: "Gates",
}
userRepo := NewInmemRepository()
queueService, _ := queue.NewInmemService()
userService := NewService(userRepo, queueService)
if userService.IsValid(&u) == true {
t.Errorf("got %v want %v",
true, false)
}
u.ValidatedAt = time.Now()
if userService.IsValid(&u) == false {
t.Errorf("got %v want %v",
false, true)
}
}
使用整洁的体系结构,我们可以将数据库从 MongoDB 更改为 Neo4j ,而不会破坏应用程序的其他部分。这样,我们可以在不损失质量和速度的情况下开发我们的软件。
引用
- https://hackernoon.com/golang-clean-archithecture-efd6d7c43047
- https://8thlight.com/blog/uncle-bob/2012/08/13/the-clean-architecture.html