README.md

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文件