附录
附录 A:架构
A.1. 基本编译和测试
要构建源代码,您需要安装 JDK 1.8。
该版本使用 Maven 包装器,因此您不必安装特定的 Maven 版本。要启用测试,您应该运行 RabbitMQ 服务器 在 localhost 和默认端口 (5672) 上 在构建之前。
主要的构建命令是
$ ./mvnw clean install
如果您愿意,您还可以添加 '-DskipTests' 以避免运行测试。
您也可以自己安装 Maven (>=3.3.3) 并运行命令
代替以下示例。如果你这样做,你也会
如果您的本地 Maven 设置没有,则可能需要添加
包含 Spring 预发布工件的存储库声明。mvn ./mvnw -P spring |
请注意,您可能需要增加内存量
可用于 Maven,方法是使用
类似于 .我们尝试在
配置,所以如果你发现你必须这样做来做一个
构建成功,请提交工单以将设置添加到
源代码控制。MAVEN_OPTS -Xmx512m -XX:MaxPermSize=128m .mvn |
需要中间件的项目通常包括一个 ,因此请考虑使用 Docker Compose 来运行 middeware 服务器
在 Docker 容器中。docker-compose.yml
A.2. 文档
有一个 “docs” 配置文件将生成文档。
./mvnw clean package -Pdocs -DskipTests
然后,可以在 中找到参考文档。docs/target/contents/reference
A.3. 使用代码
如果您没有 IDE 首选项,我们建议您在处理代码时使用 Spring Tools Suite 或 Eclipse。我们使用 m2eclipe eclipse 插件来支持 maven。其他 IDE 和工具 应该也可以正常工作。
A.3.1. 使用 m2eclipse 导入 eclipse
不幸的是,m2e 还不支持 Maven 3.3,所以一旦项目
导入到 Eclipse 中,您还需要告诉 m2eclipse 使用
项目的文件。如果您不这样做,那么您
可能会在
项目。打开 Eclipse 首选项,展开 Maven
preferences,然后选择 User Settings。在 User Settings 字段中
单击 Browse 并导航到您导入的 Spring Cloud 项目
选择该项目中的文件。单击 Apply 并
,然后 OK 保存首选项更改。.settings.xml
.settings.xml
或者,您也可以将存储库设置从 .settings.xml 复制到您自己的 .~/.m2/settings.xml |
A.3.2. 在没有 m2eclipse 的情况下导入到 eclipse 中
如果您不想使用 m2eclipse,则可以使用 以下命令:
$ ./mvnw eclipse:eclipse
生成的 eclipse 项目可以通过从菜单中选择来导入。import existing projects
file