单体架构：Spring Boot_凤凰架构

单体架构是 Fenix's Bookstore 服务端的起始版本，它与此后基于微服务（Spring Cloud、Kubernetes）、服务网格（Istio）、无服务（Serverless）架构风格实现的其他版本，在业务功能上的表现是完全一致的。如果你不是针对性地带着解决某个具体问题、了解某项具体工具、技术的目的而来，而是有较充裕的时间，希望了解软件架构的全貌与发展的话，笔者推荐以此工程入手来探索现代软件架构，因为单体架构的结构是相对直观的易于理解的，对后面接触的其他架构风格也起良好的铺垫作用。

运行程序

以下几种途径，可以运行程序，浏览最终的效果：

通过 Docker 容器方式运行：
```
$ docker run -d -p 8080:8080 --name bookstore icyfenix/bookstore:monolithic
```
然后在浏览器访问：http://localhost:8080，系统预置了一个用户（user:icyfenix，pw:123456），也可以注册新用户来测试。默认会使用 HSQLDB 的内存模式作为数据库，并在系统启动时自动初始化好了 Schema，完全开箱即用。但这同时也意味着当程序运行结束时，所有的数据都将不会被保留。如果希望使用 HSQLDB 的文件模式，或者其他非嵌入式的独立的数据库支持的话，也是很简单的。以常用的 MySQL/MariaDB 为例，程序中也已内置了 MySQL 的表结构初始化脚本，你可以使用环境变量PROFILES来激活 Spring Boot 中针对 MySQL 所提供的配置，命令如下所示：
```
$ docker run -d -p 8080:8080 --name bookstore icyfenix/bookstore:monolithic -e PROFILES=mysql
```
此时你需要通过 Docker link、Docker Compose 或者直接在主机的 Host 文件中提供一个名为mysql_lan的 DNS 映射，使程序能顺利链接到数据库，关于数据库的更多配置，可参考源码中的application-mysql.yml。

通过 Git 上的源码，以 Maven 运行：

# 克隆获取源码
$ git clone https://github.com/fenixsoft/monolithic_arch_springboot.git
# 进入工程根目录
$ cd monolithic_arch_springboot
# 编译打包
# 采用Maven Wrapper，此方式只需要机器安装有JDK 8或以上版本即可，无需包括Maven在内的其他任何依赖
# 如在Windows下应使用mvnw.cmd package代替以下命令
$ ./mvnw package
# 运行程序，地址为localhost:8080
$ java -jar target/bookstore-1.0.0-Monolithic-SNAPSHOT.jar

然后在浏览器访问：http://localhost:8080，系统预置了一个用户（user:icyfenix，pw:123456），也可以注册新用户来测试。

通过 Git 上的源码，在 IDE 环境中运行：
- 以 IntelliJ IDEA 为例，Git 克隆本项目后，在 File -> Open 菜单选择本项目所在的目录，或者 pom.xml 文件，以 Maven 方式导入工程。
- IDEA 将自动识别出这是一个 SpringBoot 工程，并定位启动入口为 BookstoreApplication，待 IDEA 内置的 Maven 自动下载完所有的依赖包后，运行该类即可启动。
- 如你使用其他的 IDE，没有对 SpringBoot 的直接支持，亦可自行定位到 BookstoreApplication，这是一个带有 main()方法的 Java 类，运行即可。
- 可通过 IDEA 的 Maven 面板中 Lifecycle 里面的 package 来对项目进行打包、发布。
- 在 IDE 环境中修改配置（如数据库等）会更加简单，具体可以参考工程中application.yml和application-mysql.yml中的内容。

技术组件

Fenix's Bookstore 单体架构后端尽可能采用标准的技术组件进行构建，不依赖于具体的实现，包括：

JSR 370：Java API for RESTful Web Services 2.1（JAX-RS 2.1） RESTFul 服务方面，采用的实现为 Jersey 2，亦可替换为 Apache CXF、RESTeasy、WebSphere、WebLogic 等。
JSR 330：Dependency Injection for Java 1.0 依赖注入方面，采用的的实现为 SpringBoot 2 中内置的 Spring Framework 5。虽然在多数场合中尽可能地使用了 JSR 330 的标准注解，但仍有少量地方由于 Spring 在对@Named、@Inject 等注解的支持表现上与本身提供的注解差异，使用了 Spring 的私有注解。如替换成其他的 CDI 实现，如 HK2，需要较大的改动。
JSR 338：Java Persistence 2.2 持久化方面，采用的实现为 Spring Data JPA。可替换为 Batoo JPA、EclipseLink、OpenJPA 等实现，只需将使用 CrudRepository 所省略的代码手动补全回来即可，无需其他改动。
JSR 380：Bean Validation 2.0 数据验证方面，采用的实现为 Hibernate Validator 6，可替换为 Apache BVal 等其他验证框架。
JSR 315：Java Servlet 3.0 Web 访问方面，采用的实现为 SpringBoot 2 中默认的 Tomcat 9 Embed，可替换为 Jetty、Undertow 等其他 Web 服务器。

有以下组件仍然依赖了非标准化的技术实现，包括：

JSR 375：Java EE Security API specification 1.0 认证/授权方面，在 2017 年才发布的 JSR 375 中仍然没有直接包含 OAuth2 和 JWT 的直接支持，因后续实现微服务架构时对比的需要，单体架构中选择了 Spring Security 5 作为认证服务，Spring Security OAuth 2.3 作为授权服务，Spring Security JWT 作为 JWT 令牌支持，并未采用标准的 JSR 375 实现，如 Soteria。
JSR 353/367：Java API for JSON Processing/Binding 在 JSON 序列化/反序列化方面，由于 Spring Security OAuth 的限制（使用 JSON-B 作为反序列化器时的结果与 Jackson 等有差异），采用了 Spring Security OAuth 默认的 Jackson，并未采用标准的 JSR 353/367 实现，如 Apache Johnzon、Eclipse Yasson 等。

工程结构

Fenix's Bookstore 单体架构后端参考（并未完全遵循）了 DDD 的分层模式和设计原则，整体分为以下四层：

Resource：对应 DDD 中的 User Interface 层，负责向用户显示信息或者解释用户发出的命令。请注意，这里指的“用户”不一定是使用用户界面的人，可以是位于另一个进程或计算机的服务。由于本工程采用了 MVVM 前后端分离模式，这里所指的用户实际上是前端的服务消费者，所以这里以 RESTFul 中的核心概念“资源”（Resource）来命名。
Application：对应 DDD 中的 Application 层，负责定义软件本身对外暴露的能力，即软件本身可以完成哪些任务，并负责对内协调领域对象来解决问题。根据 DDD 的原则，应用层要尽量简单，不包含任何业务规则或者知识，而只为下一层中的领域对象协调任务，分配工作，使它们互相协作，这一点在代码上表现为 Application 层中一般不会存在任何的条件判断语句。在许多项目中，Application 层都会被选为包裹事务（代码进入此层事务开始，退出此层事务提交或者回滚）的载体。
Domain：对应 DDD 中的 Domain 层，负责实现业务逻辑，即表达业务概念，处理业务状态信息以及业务规则这些行为，此层是整个项目的重点。
Infrastructure：对应 DDD 中的 Infrastructure 层，向其他层提供通用的技术能力，譬如持久化能力、远程服务通讯、工具集，等等。