{"id":28680738,"url":"https://github.com/dayatang/dddlib","last_synced_at":"2025-06-14T02:03:47.274Z","repository":{"id":8056399,"uuid":"9467906","full_name":"dayatang/dddlib","owner":"dayatang","description":"A DDD (Domain Driven Design) Library, derived from the idea of Eric Evans' book:  'Domain-Driven Design: Tackling Complexity in the Heart of Software'","archived":false,"fork":false,"pushed_at":"2023-08-01T03:45:34.000Z","size":52772,"stargazers_count":644,"open_issues_count":10,"forks_count":279,"subscribers_count":72,"default_branch":"master","last_synced_at":"2024-03-18T03:10:46.781Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dayatang.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-04-16T08:25:41.000Z","updated_at":"2024-02-28T01:07:14.000Z","dependencies_parsed_at":"2022-09-04T00:41:56.391Z","dependency_job_id":null,"html_url":"https://github.com/dayatang/dddlib","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/dayatang/dddlib","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dayatang%2Fdddlib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dayatang%2Fdddlib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dayatang%2Fdddlib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dayatang%2Fdddlib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dayatang","download_url":"https://codeload.github.com/dayatang/dddlib/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dayatang%2Fdddlib/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259747197,"owners_count":22905308,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-14T02:01:12.056Z","updated_at":"2025-06-14T02:03:47.262Z","avatar_url":"https://github.com/dayatang.png","language":"Java","funding_links":[],"categories":["开发框架"],"sub_categories":[],"readme":"DDDLib\n======\n\n[DDDLib](http://www.dayatang.org/dddlib/)是一个领域驱动设计（Domain Driven Design，简称DDD）类库，它的目的是：\n* 为基于DDD的开发范式提供基本的接口和抽象，实现一致性。\n* 支持业务代码和技术代码分离。使领域层代码纯粹表达业务概念和业务规则，将具体技术隔离出去。\n* 隔离业务代码对对IoC容器和持久化框架等等基础设施的依赖。可以自由切换IoC容器（Spring、Guice、TapestryIoC等）和持久化框架（JPA，Hibernate等）的实现。\n* 减轻开发人员的工作负担，降低开发人员的“概念重量”。绝大多数开发人员只需要了解dddlib-domain模块，而且只需要了解dddlib-domain中的几个类：Entity、EntityRepository、InstanceFactory和四种查询对象。\n* 提供程序设计中经常用到的工具，例如Excel导入导出、系统配置、规则引擎封装，等等。\n\n## 模块结构\n\nDDDLib是一个多模块Maven项目，一共有十多个模块，可以粗略划分为核心模块、IoC模块、持久化模块和外围模块三大类。用户项目编码时需要直接依赖核心模块，在部署时选定一个IoC模块和一个持久化模块，如果有必要时可以选用一些外围模块。对于项目中的大部分开发人员，都只需要了解核心模块dddlib-domain，甚至只是dddlib-domain中的少数的几个接口和类，所以可以大大降低“概念重量”。\n\n### 核心模块\n* dddlib-domain：整个DDDLib的核心。在用户项目中作为编译时依赖存在，就是说，用户项目在编码时要实现、继承或使用dddlib-domain中的接口和类。\n\n### IoC模块\n* dddlib-ioc-spring：实现对Spring Ioc容器的封装，为用户项目提供依赖注入能力。在用户项目中作为可选的运行时依赖存在，用户项目在编码时不需要实现、继承或使用dddlib-ioc-spring中的接口和类。\n\n* dddlib-ioc-guice：实现Google Guice IoC容器的封装，为用户项目提供依赖注入能力。在用户项目中作为可选的运行时依赖存在，用户项目在编码时不需要实现、继承或使用dddlib-ioc-spring中的接口和类。\n\n* dddlib-ioc-tapestry：实现TapestryIoC容器的封装，为用户项目提供依赖注入能力。在用户项目中作为可选的运行时依赖存在，用户项目在编码时不需要实现、继承或使用dddlib-ioc-tapestry中的接口和类。\n\n### 持久化模块\n\ndddlib-persistence是持久化模块。它包含下面三个子模块：\n\n* dddlib-persistence-jpa：使用JPA作为后端的持久化实现技术，为用户项目提供持久化能力。在用户项目中作为可选的运行时依赖存在，用户项目在编码时不需要实现、继承或使用dddlib-persistence-jpa中的接口和类。\n\n* dddlib-persistence-hibernate：使用Hibernate作为后端持久化技术，为用户项目提供持久化能力。在用户项目中作为可选的运行时依赖存在，用户项目在编码时不需要实现、继承或使用dddlib-persistence-hibernate中的接口和类。\n\n* dddlib-persistence-test：一个测试模块，为其余的持久化模块提供测试支持。\n\n下面的模块与持久化有关，但作为顶级的模块存在：\n\n\n* dddlib-query-channel：查询通道模块，为分页查询提供扩展的功能。如果用户项目需要使用此功能，必须把该模块添加为编译时依赖。\n\n### 外围模块\n* dddlib-utils：通用工具类模块。提供各种方便的工具类来操作JavaBean、数组、集合、日期、日志等等。其中最重要的一个类是断言类Assert。可以使用Assert进行防御式编程，提高系统的健壮性和可靠性。本模块为dddlib-domain所依赖，因此用户项目对该模块有编译时依赖。\n\n* dddlib-configuration：为从各种来源读取键值型配置信息提供统一的接口和实现类。目前提供了能够从以下各种来源读取配置信息的实现类：文件系统文件、类路径文件、数据库、远程url等等。除了URL形式的实现是只读的之外，其他实现都是可读写的，能够把修改后的配置数据写回其来源中。\n\n* dddlib-cache：缓存模块。为用户系统提供告诉缓存支持。目前采用memcached实现，将来将划分为一个公共的API模块和几个实现模块，不同的实现模块采用不同的缓存技术实现，如memcached、redis、ehcache等。\n\n* dddlib-datasource-monitor：数据源监控模块。可以监控数据源的运行状态。\n\n* dddlib-datasource-router：数据源路由模块。主要为SaaS应用服务，将不同的租户的数据库访问路由到不同的服务器或数据库。本模块特别为MySQL进行了优化，除了实现数据库路由之外还实现了读写分离。\n\n* dddlib-datasource-saas：新版本的SaaS数据源，将不同的租户的数据库访问路由到其专有的数据库。可以采用多种路由策略（例如例如不同的租户的数据库拥有不同ip、不同端口、不同的数据库名称、不同的实例、不同的jndi，等等）。支持各种各样的数据库服务器以及各种各样的数据库连接池。\n\n* dddlib-db：为数据库访问提供专门的工具类，包括BTM事务管理器、DBUnit、MySQL和Oracle数据库管理器等等。本模块主要为数据库集成测试提供支持。\n\n* dddlib-excel：为读写Excel文件内容提供支持。采用Apache POI技术实现，支持.xls和.xlsx两种格式的Excel文件。\n\n* dddlib-i18n：为国际化和本地化提供支持。\n\n* dddlib-observer：在实体层面实现观察者模式实现。当一个实体发生某些事件时向注册的观察者实体发送通知。\n\n* dddlib-rule-engine：为有状态和无状态规则服务提供接口和实现。实现是基于规则引擎规范jsr94的。\n\n## 使用范例\ngithub上的项目[hrm-demo](https://github.com/dayatang/hrm-demo)是一个使用DDDLib的范例项目。这个项目尚在开发中。\n\n=========\n各个子模块的详细说明请参阅具体模块的README.md文件","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdayatang%2Fdddlib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdayatang%2Fdddlib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdayatang%2Fdddlib/lists"}