Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/feiniaojin/ddd-archetype
Maven Atchetype,implements the layered application architecture of Domain Driven Design(DDD)
https://github.com/feiniaojin/ddd-archetype
ddd domain-driven-design maven-archetype spring-boot
Last synced: 18 days ago
JSON representation
Maven Atchetype,implements the layered application architecture of Domain Driven Design(DDD)
- Host: GitHub
- URL: https://github.com/feiniaojin/ddd-archetype
- Owner: feiniaojin
- License: mit
- Created: 2022-07-12T06:28:29.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-05T01:57:58.000Z (7 months ago)
- Last Synced: 2024-10-13T02:43:21.036Z (about 1 month ago)
- Topics: ddd, domain-driven-design, maven-archetype, spring-boot
- Language: Java
- Homepage: https://doc.feiniaojin.com
- Size: 65.4 KB
- Stars: 52
- Watchers: 3
- Forks: 17
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 1. ddd-archetype介绍
本项目是作者《悟道领域驱动设计》书中采用的应用架构的脚手架。《悟道领域驱动设计（Thinking in Domain Driven Design）》一书是作者多年实战领域驱动设计的总结，力求用最平实、最通俗、最容易理解的方式将DDD分享给各位朋友。
项目地址：https://github.com/feiniaojin/Thinking-in-DDD
在线阅读：http://ddd.feiniaojin.com/
关于该应用架构，详细见[第2章 应用架构](https://ddd.feiniaojin.com/2.html)。我们在落地DDD应用架构时，通常将项目分为多个Maven Module，如下图。
[](https://gingoimg.oss-cn-beijing.aliyuncs.com/ddd/ddd-%E6%9E%B6%E6%9E%84.png)
如果每个项目都手工创建一次，是比较繁琐的工作，也不利项目结构的统一。Maven
Archetype是一个Maven插件，它允许开发人员通过指定一组参数来创建项目的基础结构，可以帮助开发人员快速创建项目的基础结构，大大减少开发人员在创建项目时所需的时间和精力，并且可以确保项目结构的一致性和可重用性，从而提高代码质量和可维护性。
ddd-archetype是一个Maven Archetype的原型工程，我们将其克隆到本地之后，可以安装为Maven Archetype，帮助我们快速创建DDD项目脚手架。
欢迎star！
# 2. ddd-archetype的安装使用
## 2.1 安装过程
以下将以IDEA为例展示ddd-archetype的安装使用过程，主要过程是：
`克隆项目`-->`archetype:create-from-project`-->`install`-->`archetype:crawl`
### 2.1.1 克隆项目
将项目克隆到本地：
```shell
git clone https://github.com/feiniaojin/ddd-archetype.git
```
直接使用主分支即可，然后使用IDEA打开该项目
[](https://imgse.com/i/p9olKXQ)
### 2.1.2 archetype:create-from-project
配置打开IDEA的`run/debug configurations`窗口，如下：
[](https://imgse.com/i/p9ol17n)
选择`add new configurations`，弹出以下窗口：
[](https://imgse.com/i/p9olGt0)
其中，上图中1～4各个标识的值为：
标识`1` - 选择"+"号；
标识`2` - 选择"Maven";
标识`3` - 命令为：
```shell
archetype:create-from-project -Darchetype.properties=archetype.properties
```
> 注意，在IDEA中添加的命令默认不需要加mvn
标识`4` - 选择`ddd-archetype`的根目录
以上配置完成后，点击执行该命令。
### 2.1.3 install
上一步执行完成且无报错之后，配置`install`命令。
[](https://imgse.com/i/p9oltpT)
其中，上图中1～2各个标识的值为：
标识`1` - 值为`install`；
标识`2` - 值为上一步运行的结果，路径为：
```
ddd-archetype/target/generated-sources/archetype
```
`install`配置完成之后，点击执行。
### 2.1.4 archetype:crawl
`install`执行完成且无报错，接着配置`archetype:crawl`命令。
[](https://imgse.com/i/p9olN1U)
其中，标识1中的值为：
```shell
archetype:crawl
```
配置完成，点击执行即可。
## 2.2 使用ddd-archetype初始化项目
- 创建项目时，点击`manage catalogs`：
[](https://imgse.com/i/p9olaX4)
- 将本地的maven私服中的`archetype-catalog.xml`加入到catalogs中：
[](https://imgse.com/i/p9ol0B9)
添加成功，如下：
[](https://imgse.com/i/p9olrA1)
- 创建项目时，选择本地archetype-catalog，并且选择`ddd-archetype`，填入项目信息并创建项目：
[](https://imgse.com/i/p9olstx)
- 项目创建完成后：
[](https://imgse.com/i/p9TtUh9)
# 3. 成功案例
作者已使用该脚手架完成许多项目的开发，其中开源出来的案例见[随书示例代码](https://ddd.feiniaojin.com/samples.html)。
# 4. DDD学习交流群
欢迎加入DDD交流群。微信扫以下二维码添加作者微信，标注“DDD”，好友申请通过后拉您进群。
