/dddlib

A DDD (Domain Driven Design) Library, derived from the idea of Eric Evans' book: 'Domain-Driven Design: Tackling Complexity in the Heart of Software'

Primary LanguageJavaApache License 2.0Apache-2.0

DDDLib

DDDLib是一个领域驱动设计(Domain Driven Design,简称DDD)类库,它的目的是:

  • 为基于DDD的开发范式提供基本的接口和抽象,实现一致性。
  • 支持业务代码和技术代码分离。使领域层代码纯粹表达业务概念和业务规则,将具体技术隔离出去。
  • 隔离业务代码对对IoC容器和持久化框架等等基础设施的依赖。可以自由切换IoC容器(Spring、Guice、TapestryIoC等)和持久化框架(JPA,Hibernate等)的实现。
  • 减轻开发人员的工作负担,降低开发人员的“概念重量”。绝大多数开发人员只需要了解dddlib-domain模块,而且只需要了解dddlib-domain中的几个类:Entity、EntityRepository、InstanceFactory和四种查询对象。
  • 提供程序设计中经常用到的工具,例如Excel导入导出、系统配置、规则引擎封装,等等。

模块结构

DDDLib是一个多模块Maven项目,一共有十多个模块,可以粗略划分为核心模块、IoC模块、持久化模块和外围模块三大类。用户项目编码时需要直接依赖核心模块,在部署时选定一个IoC模块和一个持久化模块,如果有必要时可以选用一些外围模块。对于项目中的大部分开发人员,都只需要了解核心模块dddlib-domain,甚至只是dddlib-domain中的少数的几个接口和类,所以可以大大降低“概念重量”。

核心模块

  • dddlib-domain:整个DDDLib的核心。在用户项目中作为编译时依赖存在,就是说,用户项目在编码时要实现、继承或使用dddlib-domain中的接口和类。

IoC模块

  • dddlib-ioc-spring:实现对Spring Ioc容器的封装,为用户项目提供依赖注入能力。在用户项目中作为可选的运行时依赖存在,用户项目在编码时不需要实现、继承或使用dddlib-ioc-spring中的接口和类。

  • dddlib-ioc-guice:实现Google Guice IoC容器的封装,为用户项目提供依赖注入能力。在用户项目中作为可选的运行时依赖存在,用户项目在编码时不需要实现、继承或使用dddlib-ioc-spring中的接口和类。

  • dddlib-ioc-tapestry:实现TapestryIoC容器的封装,为用户项目提供依赖注入能力。在用户项目中作为可选的运行时依赖存在,用户项目在编码时不需要实现、继承或使用dddlib-ioc-tapestry中的接口和类。

持久化模块

dddlib-persistence是持久化模块。它包含下面三个子模块:

  • dddlib-persistence-jpa:使用JPA作为后端的持久化实现技术,为用户项目提供持久化能力。在用户项目中作为可选的运行时依赖存在,用户项目在编码时不需要实现、继承或使用dddlib-persistence-jpa中的接口和类。

  • dddlib-persistence-hibernate:使用Hibernate作为后端持久化技术,为用户项目提供持久化能力。在用户项目中作为可选的运行时依赖存在,用户项目在编码时不需要实现、继承或使用dddlib-persistence-hibernate中的接口和类。

  • dddlib-persistence-test:一个测试模块,为其余的持久化模块提供测试支持。

下面的模块与持久化有关,但作为顶级的模块存在:

  • dddlib-query-channel:查询通道模块,为分页查询提供扩展的功能。如果用户项目需要使用此功能,必须把该模块添加为编译时依赖。

外围模块

  • dddlib-utils:通用工具类模块。提供各种方便的工具类来操作JavaBean、数组、集合、日期、日志等等。其中最重要的一个类是断言类Assert。可以使用Assert进行防御式编程,提高系统的健壮性和可靠性。本模块为dddlib-domain所依赖,因此用户项目对该模块有编译时依赖。

  • dddlib-configuration:为从各种来源读取键值型配置信息提供统一的接口和实现类。目前提供了能够从以下各种来源读取配置信息的实现类:文件系统文件、类路径文件、数据库、远程url等等。除了URL形式的实现是只读的之外,其他实现都是可读写的,能够把修改后的配置数据写回其来源中。

  • dddlib-cache:缓存模块。为用户系统提供告诉缓存支持。目前采用memcached实现,将来将划分为一个公共的API模块和几个实现模块,不同的实现模块采用不同的缓存技术实现,如memcached、redis、ehcache等。

  • dddlib-datasource-monitor:数据源监控模块。可以监控数据源的运行状态。

  • dddlib-datasource-router:数据源路由模块。主要为SaaS应用服务,将不同的租户的数据库访问路由到不同的服务器或数据库。本模块特别为MySQL进行了优化,除了实现数据库路由之外还实现了读写分离。

  • dddlib-datasource-saas:新版本的SaaS数据源,将不同的租户的数据库访问路由到其专有的数据库。可以采用多种路由策略(例如例如不同的租户的数据库拥有不同ip、不同端口、不同的数据库名称、不同的实例、不同的jndi,等等)。支持各种各样的数据库服务器以及各种各样的数据库连接池。

  • dddlib-db:为数据库访问提供专门的工具类,包括BTM事务管理器、DBUnit、MySQL和Oracle数据库管理器等等。本模块主要为数据库集成测试提供支持。

  • dddlib-excel:为读写Excel文件内容提供支持。采用Apache POI技术实现,支持.xls和.xlsx两种格式的Excel文件。

  • dddlib-i18n:为国际化和本地化提供支持。

  • dddlib-observer:在实体层面实现观察者模式实现。当一个实体发生某些事件时向注册的观察者实体发送通知。

  • dddlib-rule-engine:为有状态和无状态规则服务提供接口和实现。实现是基于规则引擎规范jsr94的。

使用范例

github上的项目hrm-demo是一个使用DDDLib的范例项目。这个项目尚在开发中。

========= 各个子模块的详细说明请参阅具体模块的README.md文件