附录
附录 A:架构
A.1. 基本编译和测试
要构建源代码,您需要安装 JDK 1.8。
该构建使用 Maven 包装器,因此您不必安装特定的 Maven 版本。要启用测试,您应该运行 RabbitMQ 服务器 在本地主机和默认端口 (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. 文档
有一个“文档”配置文件将生成文档。
./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
在使用 m2eclipe eclipse 插件时,我们建议使用 日蚀。如果您还没有安装 m2eclipse,则可以从 “eclipse 市场“。
不幸的是,m2e 还不支持 Maven 3.3,所以一旦项目
导入到 Eclipse 中,您还需要告诉 m2eclipse 使用
这.settings.xml
文件。如果您不这样做,您将
可能会在
项目。打开您的 Eclipse 首选项,展开 Maven
首选项,然后选择用户设置。在“用户设置”字段中
单击“浏览”并导航到您导入的 Spring Cloud 项目
选择.settings.xml
文件。单击应用,然后
然后确定以保存首选项更改。
或者,您可以从.settings.xml 变成你自己的~/.m2/settings.xml . |
A.3.2. 在没有 m2eclipse 的情况下导入到 eclipse 中
如果您不想使用 m2eclipse,您可以使用 以下命令:
$ ./mvnw eclipse:eclipse
生成的 Eclipse 项目可以通过选择import existing projects
从file
菜单。