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