[译文] 应用领域驱动设计, 第四章 - 基础设施

Posted 2020-11-29 xixixiao

原文: Applied Domain-Driven Design (DDD), Part 4 - Infrastructure

If you come from database centric development (where database is the heart of the application) then this is going to be hard for you. In domain-driven design database and general data sources are not important, your application is persistence ignorant.

如果你之前都是以 数据库 为中心的开发模式 (数据库是应用程序的核心), 那么这篇文章将对你来说有点不太友好. 在领域驱动设计中, 数据库和通用的数据源并不那么重要, 程序对持久化一无所知.

Put your infrastructure interfaces in to Domain Model Layer. Your domain will use them to get data, it doesn‘t need to care how, it just knows there is an interface exposed and it will use it. This simplifies things and allows you to focus on your actual Domain rather worrying about what database you will be using, where data is coming from, etc.

领域通过使用领域模型层中引用的基础设施接口读取数据, 领域仅仅只需要关心这有基础设施公开的接口可以使用, 并不需要关心这些接口是如何实现的. 这就简化了大量的事情, 让开发者更加专注于真实的领域, 而不是去关心使用的数据库是什么, 数据来自何处等等这些问题.

基础设施契约 Infrastructure Contracts

public interface IEmailDispatcher
{
    void Dispatch(MailMessage mailMessage);
}

public interface INewsletterSubscriber
{
    void Subscribe(Customer customer);
}

译者注: 这两枚接口分别演示了与邮箱服务器和消息队列通信. 作者的意思是基础设施并不仅仅是只存放数据库的操作类, 还可以放入一些 IO 读写, 网络访问之类的操作.

// this lives in the core library and you can inherit from it and extend it
// e.g. ICustomerRepository : IRepository<Customer> then you can add some
// custom methods to your new interface. This can be useful if you want to 
// uselize some of rich features of the ORM that you are using (should be a very rare case)
//
// 它位于核心类库中, 你可以继承自它并扩展; 例如: ICustomerRepository : IRepository<Customer>
// 然后就能向新接口中添加一些自定义的方法. 如果你想用些正在使用的 ORM 框架的额外特性,
// 这还是蛮有用. (应该是十分罕见的情形).
public interface IRepository<TEntity>
    where TEntity : IDomainEntity
{
    TEntity FindById(Guid id);
    TEntity FindOne(ISpecification<TEntity> spec);
    IEnumerable<TEntity> Find(ISpecification<TEntity> spec);
    void Add(TEntity entity);
    void Remove(TEntity entity);
}

实现基础设施 (位于基础设施层) Infrastructure Implementation (lives in the Infrastructure Layer)

public class NHibernateRepository<TEntity> : IRepository<TEntity>
        where TEntity : IDomainEntity
    {
        public TEntity FindById(Guid id)
        {
            throw new NotImplementedException();
        }

        public TEntity FindOne(ISpecification<TEntity> spec)
        {
            throw new NotImplementedException();
        }

        public IEnumerable<TEntity> Find(ISpecification<TEntity> spec)
        {
            throw new NotImplementedException();
        }

        public void Add(TEntity entity)
        {
            throw new NotImplementedException();
        }

        public void Remove(TEntity entity)
        {
            throw new NotImplementedException();
        }
    }

    public class SmtpEmailDispatcher : IEmailDispatcher
    {
        public void Dispatch(MailMessage mailMessage)
        {
            throw new NotImplementedException();
        }
    }

    public class WSNewsletterSubscriber : INewsletterSubscriber
    {
        public void Subscribe(Customer customer)
        {
            throw new NotImplementedException();
        }
    }

使用范例 Example usage

public class CustomerCreatedHandle : Handles<CustomerCreated>
{
    readonly INewsletterSubscriber newsletterSubscriber;
    readonly IEmailDispatcher emailDispatcher;

    public CustomerCreatedHandle(INewsletterSubscriber newsletterSubscriber, IEmailDispatcher emailDispatcher)
    {
        this.newsletterSubscriber = newsletterSubscriber;
        this.emailDispatcher = emailDispatcher;
    }

    public void Handle(CustomerCreated args)
    {
        // example #1 calling an interface email dispatcher this can have
        // differnet kind of implementation depending on context, e.g
        // smtp = SmtpEmailDispatcher (current),
        // exchange = ExchangeEmailDispatcher,
        // msmq = MsmqEmailDispatcher, etc... let infrastructure worry about it
        //
        // 范例 #1: 调用 email 分发器接口. 这个取决于上下文可以有不同种类的实现, 比如:
        // smtp = SmtpEmailDispatcher (current),
        // exchange = ExchangeEmailDispatcher,
        // msmq = MsmqEmailDispatcher, 等等... 让基础设施去关心它吧.
        this.emailDispatcher.Dispatch(new MailMessage());

        // example #2 calling an interface newsletter subscriber
        // this can differnet kind of implementation e.g
        // web service = WSNewsletterSubscriber (current), msmq = MsmqNewsletterSubscriber,
        // Sql = SqlNewsletterSubscriber, etc... let infrastructure worry about it.
        //
        // 范例 #2: 调用通信订阅接口, 这可以有不同的实现方式, 例如:
        // web service = WSNewsletterSubscriber (current),
        // msmq = MsmqNewsletterSubscriber,
        // Sql = SqlNewsletterSubscriber, 等等... 让基础设施去关心它.
        this.newsletterSubscriber.Subscribe(args.Customer);
    }
}

总结 Summary

• Infrastructure contains implementation classes that actually talks to the infrastructure IO, Sql, Msmq, etc.

• 基础设施包含了实际与 IO, 数据库, 消息队列等通信的实现类.

• Domain is the heart of the application not the Infrastructure (this can be hard to grasp if you come from DBA background).

• 领域才是应用程序的核心而非基础设施 (这对于有 DBA 背景的开发者将有点难以理解).

• Infrastructure is not important in Domain-design design, it facilitates the application development doesn‘t lead it.

• 基础设施在领域驱动设计中并不重要, 它促进了应用程序的开发, 而非引导程序的开发.

• Infrastructure should not contain any domain logic, all domain logic should be in the domain. (i guarantee that when you first start out, you will put logic in there without knowing it)

• 基础设施不应该包含任何领域逻辑, 所有的领域逻辑应该位于领域中. (我保证, 当你第一次开发基础设施的时候, 你会在不经意间把逻辑放在基础设施里)

技巧 Tips

When it comes to repositories try and just use a generic repository and stay away from custom implementations as much as possible i.e. IRepository = good, ICustomerRepository = bad (it‘s never that simple, but a good general rule to work with).

当涉及到数据仓储时, 尝试只用通用的数据仓储, 并尽可能地远离自定义的实现. 即: IRepository<Customer> 是良好的设计, 而 ICustomerRepository 则是糟糕的设计. (其实肯定没那么简单, 但可作为一个很好的通用规则.)

When you first start out with infrastructure implementations, force your self not to put any if statements in to it. This will help your mind adjust to leaving all logic out of the Infrastructure Layer.

当你第一次实现基础设施时, 强制自己不要在里面放置任何的 if 语句. 这会有助于你调整思维逻辑, 把所有的业务逻辑排除在基础设施之外.

Take your time and try and understand what persistence ignorance really means, also try and research polyglot persistence this will expand your understanding.

花点时间去尝试理解 对持久化一无所知 的真正含义, 也试着研究一下多语种持久化, 这将扩展你的理解.

一些有用的链接 Useful links

• Onion architecture (i really don‘t like the name) showcases well how you need to start thinking about infrastructure layer - Jeffrey Palermo

• 洋葱架构 (说实话我真不喜欢这个名字) 展示了你应该如何开始思考基础设施层 - Jeffrey Palermo

• Polyglot Persistence - Martin Fowler

• 多语种持久性 - Martin Fowler

*Note: Code in this article is not production ready and is used for prototyping purposes only. If you have suggestions or feedback please do comment.

*注意: 本文中的代码尚未准备好投入生产, 仅用于原型设计. 如果有建议和反馈, 请发表评论.