【DDD】业务建模实践 —— 发布帖子

本文是基于上一篇‘业务建模小招数’的实践，主要讲解‘发表帖子’场景的业务建模，包括：业务建模、业务模型、示例代码；示例代码会使用java编写，文末附有github地址。相比于《领域驱动设计》原书中的航运系统例子，社交服务系统的业务场景对于大家更加熟悉，相信更好理解。本文是【DDD】系列文章的第一篇，可参考：通过业务系统的重构实践DDD

Round-I

业务建模

　　在大家的常识中，每个人都有自己的观点，并可以发表自己的观点，在社区中便表现为：发布帖子。那么谁发布帖子呢？ 很明显是帖子作者，于是我们便可以得到如下描述：帖子作者发布帖子。从上述描述中，我们很容易得到如下几个实体及其行为：帖子作者（PostAuthor）、帖子（Post），而PostAuthor拥有‘发布帖子’的业务行为，我们记着：posting()。

　　我们再细化现有的模型中的实体。作为实体，必须有一个唯一业务标识，我们为PostAuthor添加一个‘作者编号‘（authorId），为Post添加一个‘帖子编号’（postId）；PostAuthor可能还存在其他一些属性，我们暂且不管，因为对于我们现在的业务场景无关紧要；再看Post实体，很明显帖子有‘帖子标题’（postTitle）、‘帖子正文’（postContent）、‘帖子发布时间’（postingTime）等等。同时，从业务上要求：帖子发帖时间即为帖子发布动作发生的时间点，帖子的作者是不能为空的，帖子的内容不能为空，帖子的标题可以为空。

此外，为了减少垃圾帖对社区的负面影响，对于‘帖子内容‘强制要求帖子内容长度必须不少于16个汉字，字母和数字等同于汉字处理。

　　总结可以得到‘发布帖子’场景的业务模型描述：

  • 帖子作者发布帖子，帖子标题可以为空，帖子内容不能为空，且不少于16个汉字。

　　鉴于PostAuthor和Post关系紧密，我们姑且将其和Post放到同一个模块，但是Post看上去并不是PostAuthor的根实体，有点怪怪的感觉，暂且不追究。

业务模型

　　综上，于是我们得到如下的业务模型：

　　

代码示例

　　据此写出简单的示例代码：

 1 /**
 2  * 帖子实体
 3  * @author DAOQIDELV
 4  * @CreateDate 2017年9月16日
 5  *
 6  */
 7 public class Post {
 8
 9     /**
10     * 帖子id
11     */
12     private long id;
13     /**
14      *帖子作者
15      */
16     private long authorId;
17     /**
18      * 帖子标题
19      */
20     private String title;
21     /**
22      * 帖子源内容
23      */
24     private String sourceContent;
25     /**
26      * 发帖时间
27      */
28     private Timestamp postingTime;
29
30     public Post(long authorId, String title, String sourceContent) {
31         this.setAuthorId(authorId);
32         this.setTitle(title);
33         this.setSourceContent(sourceContent);
34         this.postingTime = new Timestamp(System.currentTimeMillis());
35     }
36
37     /**
38      * @param authorId the authorId to set
39      */
40     public void setAuthorId(long authorId) {
41         Assert.isTrue(authorId > 0, "Post‘s authorId must greater than ZERO.");
42         this.authorId = authorId;
43     }
44
45     /**
46      * @param sourceContent the sourceContent to set
47      */
48     public void setSourceContent(String sourceContent) {
49         Assert.isTrue(!StringUtils.isEmpty(sourceContent), "Post‘s sourceContent must NOT be empty.");
50         this.sourceContent = sourceContent;
51     }
52
53         //ignore some setter/getter
54
55 }

Post.java

 1 /**
 2  * 帖子作者
 3  * @author DAOQIDELV
 4  * @CreateDate 2017年9月16日
 5  *
 6  */
 7 public class PostAuthor {
 8
 9     private long id;
10
11     public PostAuthor(long id) {
12         this.id = id;
13     }
14     /**
15      * 发布帖子
16      * @param title
17      * @param sourceContent
18      * @return Post 发布得到的帖子
19      */
20     public Post posting(String title, String sourceContent) throws BusinessException {
21         if(sourceContent.length() < 16) {
22             throw new BusinessException(ExceptionCode.POST_SOURCE_CONTENT_AT_LEAST_SIXTEEN_WORDS);
23         }
24         Post post = new Post(this.id, title, sourceContent);
25         return post;
26     }
27
28        //ignore some setter/getter
29 }

PostAuthor.java

构造方法

　　在代码示例中，我们为Post实体提供了一个私有的构造函数，其中只完成了postingTime的初始化，我们的目的是为了限制创建一个空内容的帖子，因为这在实际的业务场景中是不存在的，因此模型也不应当提供这样的构造函数；

　　另外，还提供了一个包含（authorId,title,sourceContent）的public构造函数，从当前的情形来看是够用了，如果后续有业务场景需要更多的属性传入构造函数，则我们可以重载实现，但是通常来讲，构造函数的入参最好不要超过五个，否则不利于代码阅读，当然特殊业务场景下除外；

　　最后，在构造函数中，我们并没有直接使用“this.title = title;”的写法，而是使用了这种写法："this.setTitle(title);"，好处在于我们希望Post实体成为一个“自治的实体”，简单来讲就是可以自我检查 / 自我维护的实体，使用setter的方式，让我们可以再setter方法中加入一些规则判定，使得外部传入的参数满足一定的规格，具体可以参考下一节中的解释。这种处理方式被Martin Fowler称之为“自封装性”，参考了《实现领域驱动设计》P184。

setter方法

　　接上一节中提到的“自治实体”，我们希望setter方法提供一种校验机制，确保外部传入的参数满足实体的一定规格，也就是具体的业务逻辑。比如说Post实体中的setSourceContent(String sourceContent)方法，业务规则要求：帖子的正文不能为空，因此在Post.setSourceContent(sourceContent)中加入了Assert断言，确保这一规则被强制实现。

　　参考自Eric Evans的《领域驱动设计》P154。

posting方法

　　PostAuthor实体现在有了一个业务方法：posting()，它接受具体帖子信息属性，最后返回一个Post实体，很明显PostAuthor现在作为一个Post实体的factory存在。

　　posting方法对外声明会throw出一个BusinessException异常，BusinessException异常是自定义的业务异常大类，该异常会统一交由框架统一异常处理，这样确保domain领域的干净。posting方法中判定“帖子内容小于16个字”时，便会向上层抛出异常码为2000的BusinessException，

Round-II

业务建模

　　我们继续往下探寻业务实体。在讨论中，我们发现发布帖子时，通常需要选择关联哪些话题，且一次性可以关联多个话题，最多可以关联五个话题，且话题不能重复加入。我们尝试用一句话将上述模型表述出来：

  • 帖子可以加入不多于五个话题，且话题不能重复加入。

　　这样就引入了一个新的实体：话题（Topic），话题持有唯一业务标识，话题应当拥有这些常见的属性：话题名称（title）、话题简介（description）、话题创建者（authorId）、话题创建时间（creatingTime）等；其中，话题名称、话题内容和话题创建者均不能为空。由于这些属性和‘创建话题’的case相关，在这里我们不做过多讨论。

　　那么Post和Topic的关系是什么呢？肯定不是“聚合”的关系，因为即使Topic消失了，但是Post还在；也不会是“组合”关系，Topic并不是由许多的Post组合而成的；正如业务建模中的描述：Post关联多个话题，所以Post和Topic之间是1：N的关联关系。那么我们是否应当让Post持有多个Topic呢？显然太重了，Topic是一个实体，实体的状态/属性值是会发生改变的，Topic状态发生改变就会引起Post实体内容改变，因此，我们可以有如下两种处理方式：

  1. 引入一个值对象TopicId，让Post关联多个TopicId，这个值对象只有一个属性值：topicId，表征Topic的唯一标识值；这是《实现领域驱动设计》中的实现方式；
  2. 引入一个值对象TopicPost，表征“话题相关的帖子”，这个值对象可以有更多的属性值。

　　对比下来，方案2扩展性会更好，且表达能力更强，同时TopicPost这个值对象还可以应用到Topic实体中，在Topic相关的业务case中，会有找到一个Topic下关联的帖子列表的场景，这时候会发现TopicPost便大有用处了。

　　那么TopicPost和Post之间还是关联关系吗？显然不是。一个Post被删除，那么与其相关的TopicPost值对象也就不复存在了，因此Post持有多个TopicPost，他们是组合关系。

　　那么TopicPost是属于Topic模块（module）还是属于Post模块，很简单，它以“Topic”打头，因此我们将TopicPost放入Topic模块中。

　　再来看业务行为，我们将“帖子加入话题”这个业务行为命名为joinTopics(String topics)，字面上‘帖子’是主语，显然joinTopics是Post的业务方法，在这个业务方法中，我们实现业务规则：帖子可以加入的话题数不能多于五个。

　　上述关于TopicPost值对象引入的讨论非常典型，在两个实体存在关联关系时，可以参考建模。

业务模型

　　综合上面的讨论，我们得到最新的业务模型如下：

示例代码

　　PostAuthor.java没有变化，更改Post.java，新增Topic.java和TopicPost.java：

 1 public class Post {
 2       ......
 3     /**
 4      * 将帖子关联话题
 5      * @param topicIds 话题集合
 6      */
 7     public void joinTopics(String topicIds) throws BusinessException{
 8         if(StringUtils.isEmpty(topicIds)) {
 9             return;
10         }
11         String[] topicIdArray = topicIds.split(CommonConstants.COMMA);
12         for(int i=0; i<topicIdArray.length; i++) {
13             TopicPost topicPost = new TopicPost(Long.valueOf(topicIdArray[i]), this.getId());
14             this.topics.add(topicPost);
15             if(topicSize() > MAX_JOINED_TOPICS_NUM) {
16                 throw new BusinessException(ExceptionCode.ONE_POST_MOST_JOIN_INTO_FIVE_TOPICS);
17             }
18         }
19     }
20
21     /**
22      * 获取本帖子加入的话题数，参考jdk collection的api设计
23      * @return 本帖子加入的话题数
24      */
25     public int topicSize() {
26         return this.topics.size();
27     }
28       ......
29 }

Post.java

 1 /**
 2  * @author DAOQIDELV
 3  * @CreateDate 2017年9月16日
 4  *
 5  */
 6 public class Topic {
 7     /**
 8      * 话题id
 9      */
10     private long id;
11     /**
12      * 话题标题
13      */
14     private String title;
15     /**
16      * 话题描述
17      */
18     private String description;
19     /**
20      * 话题创建时间
21      */
22     private Timestamp createTime;
23     /**
24      * 话题下的帖子列表
25      */
26     private Set<TopicPost> posts;
27
28         ......
29 }

Topic.java

 1 /**
 2  * @author DAOQIDELV
 3  * @CreateDate 2017年9月16日
 4  *
 5  */
 6 public class TopicPost {
 7
 8     private long postId;
 9
10     private long topicId;
11
12     public TopicPost(long topicId, long postId) {
13         this.setPostId(postId);
14         this.setTopicId(topicId);
15     }
16
17     @Override
18     public boolean equals(Object anObject) {
19         if (this == anObject) {
20             return true;
21         }
22         if(anObject instanceof TopicPost) {
23             if(this.postId == ((TopicPost)anObject).getPostId()
24                     && this.topicId == ((TopicPost)anObject).getTopicId()) {
25                 return true;
26             }
27         }
28         return false;
29     }
30
31     @Override
32     public int hashCode() {
33         return Long.hashCode(this.postId+this.topicId);
34     }
35
36 }

TopicPost.java

组合关系集合化处理

　　如前面业务建模分析，Post持有多个TopicPost，他们是组合关系。代码中Post持有一个TopicPost类型的Set，最初这个topics属性没有被初始化，导致在每次用到它的时候都要去判空，代码冗余度高，可读性差，后面参考java集合的api设计，将topics这个Set直接在声明时就完成初始化，后续使用就没有后顾之忧了。这一个模式可以参考Martin Fowler的《重构》P208。

　　‘帖子加入话题’的场景只涉及到了topics集合的元素添加，所以，这里暂且定义了两个api：joinTopics(), topicSize()，至于topics的查询、删除操作在后续的建模场景中会逐一涉及到。

改写TopicPost的equals和hashCode方法

　　一个帖子不能重复加入某个话题，因此我们使用了HashSet这种数据结构，HashSet中的元素是不能重复的，所以在向HashSet中add元素时，HashSet会判定元素是否相等（== || equals），默认的Object方法equals实现既是比较两个对象是否相等（==），这会带来一个问题：两个在业务上表征同一个帖子加入同一个话题的TopicPost对象会被认为是不相等的两个对象，因此我们需要重写TopicPost的equals和hashCode方法，使之和业务模型保持一致。

　　equals()的实现参考了java.lang.String的写法；hashCode()的重写最佳实践参考了《重构》P185：读取equals()使用的所有字段的hash码，然后对他们进行按位异或操作。hashCode()的目标是保证在对该对象进行集合类api操作时，能保证较好的散列性，因此只要能达到这个目标就行，鉴于TopicPost中equals方法是用到的topicId和postId均为Long型，也可以简单地这么实现：Long.hashCode(this.postId + this.topicId)。

Round-III

业务建模

　　为确保社区帖子的质量，以及满足国家法律法规的要求，我们需要对帖子标题和内容进行敏感词、广告语、色情、暴力等内容过滤，这些内容过滤即需要调用第三方服务完成，又需要经过社区系统自己积累的敏感词和广告词过滤，对于帖子标题和帖子正文，只要其中一项被过滤服务发现异常，则该帖子就需要被列入待审核队列，等待运营人员审核完成后才能对外发布。我们尝试使用一句话来描述上述case：

  • 　　帖子标题和内容通过内容过滤后方能发布，如果未能通过内容过滤，则需要经过运营审核之后才能发布。

　　可以看到上面场景中出现了一个新的短语“内容过滤”，它不是一个实体，看上去像是一个业务行为，是对帖子的标题和内容进行内容过滤，那么我们是不是直接放置到Post实体上呢？ 由于这个内容过滤的行为比较复杂，且涉及到第三方过滤服务的调用，且对帖子标题和帖子内容的过滤逻辑类似，因此我们有必要将“内容过滤”从帖子实体中抽离出来，变成一个领域服务，我们将之命名为：ContentFilter。

　　考虑到存在多场景多规则的过滤，且只要一个命中一个过滤规则，就可以认为该帖子审核不通过，因此可以使用‘责任链模式’来设计。关于责任链模式的实现和优缺点这里不再赘述，可参考网上资料，或直接看代码即可。

　　另外，我们发现上面的case描述中，还出现了‘内容过滤未通过’的字样，表明Post需要有一个属性来表征内容过滤的结果，考虑到可见case中存在帖子被用户删除等状态，我们记为“帖子状态”（staus），字典定义为：00 -- 已发布；01 -- 待运营审核；99 -- 已删除。

　　上面虽然已经创建了一个领域服务专门来承担‘内容过滤’的职责，但是这个业务行为仍然应当属于Post实体，因此我们为Post增加一个filt()业务行为，在这个业务行为中，会去调用“过滤标题”（filtTitle()） 和 “过滤正文”（filtMainBody()）l两个业务方法完成。而filtTitle()和filtMainBody()则会将具体的内容过滤工作委托给上面提到的责任链模式实现的领域服务ContentFilter。

　　由于ContentFilter这一领域服务采用责任链模式实现，类较多，如果放置到post module下面，不利于阅读，且考虑到后续的评论等场景可能使用到这个服务，故将其单独建立module，取名为：domain.service.contentfilter。

业务模型

　　综上，我们可以得到如下业务模型：

示例代码

主要在Post实体增加了status属性，并增加业务行为方法filt()，增加了PostStatus这样一个枚举类，增加了责任链模式实现的contentFilter 领域服务组件，代码摘要如下：

 1 public class Post {
 2     ......
 3     /**
 4      * 帖子状态
 5      * NOTE：使用enum实现，限定status的字典值
 6      * @see com.dqdl.eco.domain.model.post.PostStatus
 7      */
 8     private PostStatus status;
 9
10     /**
11      * 过滤帖子内容，内容过滤通过，则置status为‘00’，否则置为‘01’
12      * @param titleFilter 标题用内容过滤器
13      * @param mainBodyfilter 正文用内容过滤器
14      */
15     public void filt(PostTitleContentFilterChain titleFilter, PostMainBodyContentFilterChain mainBodyfilter) {
16         if(!this.filtTitle(titleFilter)) {
17             this.setStatus(PostStatus.WAIT_VERIFY);
18         } else if(!this.filtContent(mainBodyfilter)) {
19             this.setStatus(PostStatus.WAIT_VERIFY);
20         } else {
21             this.setStatus(PostStatus.HAS_POSTED);
22         }
23     }
24
25     /**
26      * 过滤标题
27      * @param filter
28      * @return
29      */
30     private boolean filtTitle(PostTitleContentFilterChain filter) {
31         if(StringUtils.isEmpty(this.getTitle())) {
32             return true;
33         }
34         return filter.filtTitle(this);
35     }
36
37     /**
38      * 过滤正文
39      * @param filter
40      * @return
41      */
42     private boolean filtContent(PostMainBodyContentFilterChain filter) {
43         return filter.filtMainBody(this);
44     }
45     ......
46
47 }

Post.java

 1 /**
 2  * @author DAOQIDELV
 3  * @CreateDate 2017年9月17日
 4  * 帖子状态枚举类
 5  */
 6 public enum PostStatus {
 7     /**
 8      * 已发布
 9      */
10     HAS_POSTED("00","已发布"),
11
12     /**
13      * 等待运营审核
14      */
15     WAIT_VERIFY("01", "等待运营审核"),
16
17     /**
18      * 已删除
19      */
20     HAS_DELETED("99", "已删除");
21
22     private String code;
23
24     private String description;
25
26     PostStatus(String code, String description) {
27         this.code = code;
28         this.description = description;
29     }
30
31     /**
32      * @return the code
33      */
34     public String getCode() {
35         return code;
36     }
37
38     /**
39      * @return the description
40      */
41     public String getDescription() {
42         return description;
43     }
44
45
46     /* (non-Javadoc)
47      * @see java.lang.Enum#toString()
48      */
49     @Override
50     public String toString() {
51         StringBuffer sb = new StringBuffer();
52         sb.append(super.toString())
53             .append(": code=").append(this.getCode())
54             .append(", decsription=").append(this.getDescription());
55         return sb.toString();
56     }
57 }

PostStatus.java

　　PostStatus使用枚举类的好处在于：‘状态’的字典值是有限的，且要求状态值必须是合法的值，因此使用枚举类能够达到上述强制限定的目的。

　　Post对外公布的只有filt()这样一个业务行为方法，filtTitle()和filtMainBody()这两个业务行为方法设置为private，通常我们并没有需求只过滤‘帖子标题’或者’帖子正文‘，所以没有必要将这两个方法单独放出去。

 1 /**
 2  * @author DAOQIDELV
 3  * @CreateDate 2017年9月17日
 4  * 帖子正文内容过滤器 责任链。正文可能有图片，故包含图片过滤
 5  */
 6 public class PostMainBodyContentFilterChain {
 7
 8     private Set<ContentFilter> contentFilters;
 9
10     public PostMainBodyContentFilterChain() {
11         TextContentFilter localTextContentFilter = new LocalTextContentFilter();
12         TextContentFilter remoteTextContentFilter = new RemoteTextContentFilter();
13         ImageContentFilter imageContentFilter = new ImageContentFilter();
14         contentFilters.add(localTextContentFilter); //优先校验本地的敏感词
15         contentFilters.add(remoteTextContentFilter);
16         contentFilters.add(imageContentFilter);
17     }
18
19     /**
20      * 过滤标题
21      * @param post
22      * @return
23      *  true —— 通过
24      *  false —— 未通过
25      */
26     public boolean filtMainBody(Post post) {
27         for(Iterator<ContentFilter> it = contentFilters.iterator(); it.hasNext();) {
28             if(!it.next().filtContent(post.getSourceContent())) {
29                 return false;
30             }
31         }
32         return true;
33     }
34
35 }

PostMainBodyContentFilterChain.java

 1 /**
 2  * @author DAOQIDELV
 3  * @CreateDate 2017年9月17日
 4  * 帖子标题内容过滤器 责任链。标题没有图片，故不涉及图片过滤
 5  */
 6 public class PostTitleContentFilterChain {
 7
 8     private Set<ContentFilter> contentFilters;
 9
10     public PostTitleContentFilterChain() {
11         TextContentFilter localTextContentFilter = new LocalTextContentFilter();
12         TextContentFilter remoteTextContentFilter = new RemoteTextContentFilter();
13         contentFilters.add(localTextContentFilter); //优先校验本地的敏感词
14         contentFilters.add(remoteTextContentFilter);
15     }
16
17     /**
18      * 过滤标题
19      * @param post
20      * @return
21      *  true —— 通过
22      *  false —— 未通过
23      */
24     public boolean filtTitle(Post post) {
25         for(Iterator<ContentFilter> it = contentFilters.iterator(); it.hasNext();) {
26             if(!it.next().filtContent(post.getTitle())) {
27                 return false;
28             }
29         }
30         return true;
31     }
32
33 }

PostTitleContentFilterChain.java

 1 /**
 2  * @author DAOQIDELV
 3  * @CreateDate 2017年9月17日
 4  * 内容过滤器抽象类
 5  */
 6 public abstract class ContentFilter {
 7
 8     private ContentFilter nextContentFilter;
 9
10     public abstract boolean filtContent(Object content);
11
12     /**
13      * @return the nextContentFilter
14      */
15     public ContentFilter getNextContentFilter() {
16         return nextContentFilter;
17     }
18
19     /**
20      * @param nextContentFilter the nextContentFilter to set
21      */
22     public void setNextContentFilter(ContentFilter nextContentFilter) {
23         this.nextContentFilter = nextContentFilter;
24     }
25 }

ContentFilter.java

 1 /**
 2  * @author DAOQIDELV
 3  * @CreateDate 2017年9月17日
 4  * 图片过滤器
 5  */
 6 public class ImageContentFilter extends ContentFilter {
 7
 8     /* (non-Javadoc)
 9      * @see com.dqdl.eco.domain.model.post.ContentFilter#filtContent(com.dqdl.eco.domain.model.post.Post)
10      */
11     @Override
12     public boolean filtContent(Object content) {
13         // TODO 调用第三方的图片过滤服务实现，已经超过了domain的范畴，此处略去。后续单列文章讲解如何和第三方服务交互。
14         return true;
15     }
16 }

ImageContentFilter.java

 1 /**
 2  * @author DAOQIDELV
 3  * @CreateDate 2017年9月17日
 4  * 文本过滤器抽象类
 5  */
 6 public abstract class TextContentFilter extends ContentFilter {
 7
 8     /* (non-Javadoc)
 9      * @see com.dqdl.eco.domain.model.post.ContentFilter#filtContent(com.dqdl.eco.domain.model.post.Post)
10      */
11     @Override
12     public abstract boolean filtContent(Object content);
13
14 }

TextContentFilter.java

 1 /**
 2  * @author DAOQIDELV
 3  * @CreateDate 2017年9月17日
 4  * 本地文本过滤器
 5  */
 6 public class LocalTextContentFilter extends TextContentFilter {
 7     /**
 8      * 本地敏感词集合
 9      */
10     private Set<String> sensitiveWords = new HashSet<String>();
11
12     public  LocalTextContentFilter() {
13         sensitiveWords.add("NND");
14         sensitiveWords.add("奶奶个熊");
15     }
16
17
18     /* (non-Javadoc)
19      * @see com.dqdl.eco.domain.model.post.TextContentFilter#filtContent(com.dqdl.eco.domain.model.post.Post)
20      */
21     @Override
22     public boolean filtContent(Object content) {
23         Assert.isTrue(content instanceof String, "LocalTextContentFilter filtContent‘s paramter must be String.");
24         for(String sensitiveWord : sensitiveWords) {
25             if(((String)content).contains(sensitiveWord)) {
26                 return false;
27             }
28         }
29         return true;
30     }
31
32 }

LocalTextContentFilter.java

 1 /**
 2  * @author DAOQIDELV
 3  * @CreateDate 2017年9月17日
 4  * 远程文本过滤器，需要调用第三方服务实现
 5  */
 6 public class RemoteTextContentFilter extends TextContentFilter {
 7
 8     /* (non-Javadoc)
 9      * @see com.dqdl.eco.domain.model.post.TextContentFilter#filtContent(com.dqdl.eco.domain.model.post.Post)
10      */
11     @Override
12     public boolean filtContent(Object content) {
13         // TODO 调用第三方的图片过滤服务实现，已经超过了domain的范畴，此处略去。后续单列文章讲解如何和第三方服务交互。
14         return true;
15     }
16
17 }

RemoteTextContentFilter.java

　　注意到：在Post.filt(PostTitleContentFilterChain titleFilter, PostMainBodyContentFilterChain mainBodyfilter)中，将PostTitleContentFilterChain和PostMainBodyContentFilterChain 显式传入该方法，为什么不直接在Post定义这两个FilterChain的实例变量呢？原因在于后续我们会将domain service作为@Compenent组件交给Spring ioc容器来管理，但是domain entity却不会交给Spring管理，因此无法完成@AutoWire，所以使用方法参数传入的方式表征了Post对两个FilterChain的依赖关系。

　　上述实例代码中，ContentFilter这一领域服务组件，并没有全部实现，对于依赖与第三方过滤服务的部分直接返回了true，这涉及到如何与第三方服务交互的问题，我们会在后续的blog中专题介绍。

Summarize

最终模型

汇总上面建模过程中对模型的描述，我们得到如下：

  • 帖子作者发布帖子，帖子标题可以为空，帖子内容不能为空，且不少于16个汉字；
  • 帖子可以加入不多于五个话题，且话题不能重复加入；
  • 帖子标题和内容通过内容过滤后方能发布，如果未能通过内容过滤，则需要经过运营审核之后才能发布。

业务模型图可以参考Round-III中的模型图。

建模经验

尝试用一句完整的话说描述业务场景

　　仔细观察，我们发现最终得到的业务模型描述其实和产品经理的PRD契合度非常高，但是产品经理的PRD描述很多适合缺少主语，或者语言分散，需要我们通过建模，将语言重新组织，找到业务实体，找到业务行为，找到业务规则，并反映在模型上。反过来想，我们的业务模型对于产品经理/业务专家来讲也不会陌生，因为我们都是使用统一的业务模型语言进行描述，大家都能懂才对。

小步快走，逐步迭代

　　’发布帖子‘这个业务场景我们经历了三轮迭代，最终得到了一个较完整的业务模型，每一轮迭代，我们都将焦点聚集在一个case，落实模型之后，再继续往前推进。文章描述起来比较啰嗦，实际建模过程中，可能很快就能完成三轮迭代，得到较满意的模型，但是实际的建模过程应当是和文章描述一样的。

有用的模式

  1. 具有关联关系的实体，可以为这种关联关系引入一个值对象，从而降低实体间的耦合，比如：在Post和Topic之间引入了TopicPost值对象；
  2. 实体 / 值对象 之间存在组合 / 聚合关系，在设计对外的api时，可以参考jdk中集合的api设计，达到高内聚的目标，这在《重构》这本书中被称为“封装集合（Encapsulate Collection）”，比如：Post实体中的topics话题集便参考Set对外提供api；
  3. 配合第2点的实现，通常需要重写equals()和hashCode()方法，最佳实践可以参考示例代码；
  4. 极力推荐使用合适的设计模式，提高代码的扩展性和可维护性，比如：contentFilter领域服务组件便采用了“责任链模式”来实现；
  5. 当实体依赖于领域服务时，可以讲领域服务作为实体业务方法的参数传入，尤其是当领域服务被ioc容器管理时。比如：contentFilter领域服务组件作为Post的filt()方法的参数传入。

源码

　　此业务建模的demo已上传至github，欢迎下载和讨论，但拒绝被用于任何商业用途。

　　github地址：https://github.com/daoqidelv/community-ddd-demo/tree/posting

　　branch：posting

时间： 2024-10-05 05:58:41

【DDD】业务建模实践 —— 发布帖子的相关文章

【DDD】业务建模实践 —— 删除帖子

本文是基于上一篇‘业务建模战术’的实践,主要讲解‘删除帖子’场景的业务建模,包括:业务建模.业务模型.示例代码:示例代码会使用java编写,文末附有github地址.相比于<领域驱动设计>原书中的航运系统例子,社交服务系统的业务场景对于大家更加熟悉,相信更好理解.本文是[DDD]系列文章的第一篇,可参考:通过业务系统的重构实践DDD 业务建模 这里的‘删除帖子’场景是指帖子作者主动删除帖子,至于管理员通过后台管理端下线帖子,我们认为该行为不同于‘删帖’,需要单独处理. 我们来分析下“删除帖子”

EA业务建模实践之业务用例图

本文重点是业务建模实践,以及建模工具EA初级使用过程日志. 先前写了些文档,从不同角度描述了业务建模,但是条理性和规范性仍无法让人一目了然.春节期间当我再次读了<软件方法>前几章,产生了共鸣:误解随处都在,通过UML规范沟通环境,是辛勤汗水的教训. 按书中观点及回答问题如下: 业务建模:描述组织内部各系统(人肉系统.机械系统.电脑系统......)如何协作,使得组织可以为其他组织提供有价值的服务.新系统只不过是组织为了对外提供更好的服务,对自己的内部重新设计而购买的一个零件.组织引进一个软件系

【DDD】领域驱动设计实践 —— 业务建模小招数

本文结合团队在ECO(社区服务系统)业务建模过程中的实践经验,总结得到一些DDD业务建模的小招数,不一定是完美的,但是对我们团队来说很有效用,希望能帮到其他人.后面会陆续将项目中业务建模的一些经典例子放上来,分享给大家. ECO系统是线上旧系统,它的建模过程有别于新系统的业务建模.由于背着历史包袱,ECO的建模过程不是那么纯粹,很容易受到旧代码的影响,陷入代码的细节中,初期举步维艰,靠着小步快跑的方式得到了一些雏形和方法论,后面越来越顺,效果还是不错的. 本文为[DDD]系列文章中的其中一篇,其

软件项目需求开发过程实践之业务建模用例图

本次软件工程项目是重建办公业务流程管理平台,需要在继承原370个流程基础上,还需要提供快速流程开发能力,并要求体现出流程管理的规范性,以及流程的执行力.效率.效益,最终为企业管理创新提供流程再造的能力. 在项目前期及需求分析阶段,开发人员致力于"降低成本",以最小的代价完成项目,其可预见性的软件产品是经过系统平台升级的,并经过改良的第二个办公业务流程管理平台.按客户验收要求,"只能打60分,是不能给予验收". 在软件开发中,需求工作致力于解决"产品好卖&q

UML建模实践——选“对”企业架构建模视角很关键

1.关于企业架构 根据开放群组的业务领导层IT架构指引:"有效的企业架构(Enterprise Architecture,EA)对企业的生存和成功具有决定性的作用,是企业通过IT获得竞争优势的不可缺少的手段." 企业架构如同战略规划,可以辅助企业完成业务及IT战略规划.在业务战略方面,可使用TOGAF及其架构开发方法(Architecture Development Method,ADM)来定义企业的愿景/使命.目标/目的/驱动力.组织架构.职能和角色.在IT战略方面,TOGAF及AD

对业务建模

这不是什么新鲜话题,但是最近在维护一个之前同事遗留下来的项目,有了一些感想.其实我很久都不做具体的业务了.很长一段的时间主要在负责基础设施以及业务工具方面的开发,所以我做的事情,往往并不需要和具体的业务打交道,其实这样挺困难的,关键在于我并非设计者,设计者是其他的专职设计师,他学历高,工作时间也长,但是可惜的是,他在web系统的架构以及设计上并没有多少的经验,所以其实事情也挺难做的. 而现在接手的这个项目是一个很纯粹的业务系统,没有太多的自主设计,用的是标准javaEE的那一套,从技术上面来说是

业务建模

ON/OFF机制 1.配置标准端对端业务 一般分为4个步骤: (1)定义应用 应用( Application)具体描述应用的动作,比如说 http 应用,规定了每次取得页面的大小和时间间隔:对于 ftp 应用,规定上传和下载的流量,文件的大小和产生的事件间隔. 打开应用配置器物件的属性对话框,可以看到OPNET 已经为我们定义了 9 种应用 以Database应用为例配置业务参数 Transaction Mix 代表查询数据量占整个输入交易量的比例,一般是查询一半,其他交易占一半: Transa

业务建模 之 闲话&#39;闭包&#39;与&#39;原型继承&#39;

[引言]在业务建模中,我们经常遇到这样一种情况:“原型”对象负责实现业务的基本诉求(包括:有哪些属性,有哪些函数以及它们之间的关系),以“原型”对象为基础创建的“子对象”则实现一些个性化的业务特性,从而方便的实现业务扩展.最常见的搞法是: 1. 定义一个‘构造函数’,在其中实现属性的初始化,例如:var Person = function( ){};    //函数体中可以进行一些变量的初始化. 2. 再设置该函数的prototype成员,例如:Person.prototype = { goto

直播开始：&#39;云榨汁机&#39;诞生记--聊聊JavaScript中的&#39;业务建模&#39;

闭包是JavaScript中的一个重要特性,在之前的博文中,我们说闭包是一个'看似简单,其实很有内涵'的特性.当我们用JavaScript来实现相对复杂的业务建模时,我们可以如何利用'闭包'这个特性呢?JavaScript中的'原型继承',又可以解决业务建模中的哪些问题呢?今天我们就通过一家'榨汁机工厂'生产设计'榨汁机'的故事,来聊一聊'闭包'和'原型继承'在业务建模中的作用.现在直播开始: 1> 工厂默认选用A型刀头方案制造榨汁机 例子当中我们主要涉及到2个函数:1.榨汁机的生产工厂(Jui