如何命名存储库和服务接口？

Posted 2021-03-28

如何命名存储库和服务接口及其实现类？

例如，我有一个名为Question的模型。您将命名存储库（接口和实现）和服务（接口/实现）。

阅读这些帖子后：Java Interfaces/Implementation naming convention和Interface naming in Java我重新考虑了我已经做过的事:)

答案

我认为在DDD中命名大致有两种方法：

1）基于刻板印象。这是您在其名称中包含类构造型的位置。例如：

QuestionsRepository, TaxCalculatingService etc

2）基于域。在这种方法中，您只使用域语言，并省略类名中的任何构造型。例如：

Questions (or AllQuestions), TaxCalculator etc.

实现类将命名为SqlQuestions或InMemoryQuestions。

我尝试了两种，但我现在更喜欢第二种选择，因为它似乎更符合DDD思维模式。它似乎更具可读性，并具有更好的信噪比。以下是PhilCalçado对great article存储库的引用：

存储库作为对象列表的概念并不难理解，但这些类最终会使用与列表无关的方法。

在指导许多团队采用无所不在的语言和相关模式之后，我发现让人们记住存储库不是类似DAO的类的最佳方式始于你如何命名它们。

几年前Rodrigo Yoshima在命名存储库时告诉我他的约定。而不是下面显示的更常见的命名样式：

class OrderRepository {
   List<Order> getOrdersFor(Account a){...}
}

他提倡这个：

class AllOrders {
   List<Order> belongingTo(Account a){...}
}

它看起来像一个小小的变化，但它有很大的帮助......

整篇文章非常值得阅读和书签。

另一答案

我个人使用FooService，FooServiceImpl，FooRepository和FooRepositoryImpl。

你可能会说Impl后缀是噪音，但是

• 通常只有一个实现，所以没有FirstFooService和SecondFooService
• 除了在单元测试中，具体的FooXxxImpl类型在代码中没有使用：注入依赖项，它们的类型是接口