附录

附录 A:架构

A.1. 基本编译和测试

要构建源代码,您需要安装 JDK 1.8。spring-doc.cn

该版本使用 Maven 包装器,因此您不必安装特定的 Maven 版本。要启用测试,您应该运行 RabbitMQ 服务器 在 localhost 和默认端口 (5672) 上 在构建之前。spring-doc.cn

主要的构建命令是spring-doc.cn

$ ./mvnw clean install

如果您愿意,您还可以添加 '-DskipTests' 以避免运行测试。spring-doc.cn

您也可以自己安装 Maven (>=3.3.3) 并运行命令 代替以下示例。如果你这样做,你也会 如果您的本地 Maven 设置没有,则可能需要添加 包含 Spring 预发布工件的存储库声明。mvn./mvnw-P spring
请注意,您可能需要增加内存量 可用于 Maven,方法是使用 类似于 .我们尝试在 配置,所以如果你发现你必须这样做来做一个 构建成功,请提交工单以将设置添加到 源代码控制。MAVEN_OPTS-Xmx512m -XX:MaxPermSize=128m.mvn

需要中间件的项目通常包括一个 ,因此请考虑使用 Docker Compose 来运行 middeware 服务器 在 Docker 容器中。docker-compose.ymlspring-doc.cn

A.2. 文档

有一个 “docs” 配置文件将生成文档。spring-doc.cn

./mvnw clean package -Pdocs -DskipTestsspring-doc.cn

然后,可以在 中找到参考文档。docs/target/contents/referencespring-doc.cn

A.3. 使用代码

如果您没有 IDE 首选项,我们建议您在处理代码时使用 Spring Tools SuiteEclipse。我们使用 m2eclipe eclipse 插件来支持 maven。其他 IDE 和工具 应该也可以正常工作。spring-doc.cn

A.3.1. 使用 m2eclipse 导入 eclipse

在使用 日蚀。如果您还没有安装 m2eclipse,可以从“eclipse marketplace 的spring-doc.cn

不幸的是,m2e 还不支持 Maven 3.3,所以一旦项目 导入到 Eclipse 中,您还需要告诉 m2eclipse 使用 项目的文件。如果您不这样做,那么您 可能会在 项目。打开 Eclipse 首选项,展开 Maven preferences,然后选择 User Settings。在 User Settings 字段中 单击 Browse 并导航到您导入的 Spring Cloud 项目 选择该项目中的文件。单击 Apply 并 ,然后 OK 保存首选项更改。.settings.xml.settings.xmlspring-doc.cn

或者,您也可以将存储库设置从 .settings.xml 复制到您自己的 .~/.m2/settings.xml

A.3.2. 在没有 m2eclipse 的情况下导入到 eclipse 中

如果您不想使用 m2eclipse,则可以使用 以下命令:spring-doc.cn

$ ./mvnw eclipse:eclipse

生成的 eclipse 项目可以通过从菜单中选择来导入。import existing projectsfilespring-doc.cn