Spring AMQP

该项目为使用Spring和Java与AMQP 0.9.1，特别是RabbitMQ提供支持。

行为准则

请查看我们的行为准则。

报告安全漏洞

请查看我们的安全政策。

检出和构建

要从GitHub检出项目并使用Gradle从源代码构建，请执行以下操作：

git clone git://github.com/SpringSource/spring-amqp.git
cd spring-amqp
./gradlew build

如果在构建过程中遇到内存不足错误，请增加Gradle可用的堆内存和永久代内存：

GRADLE_OPTS='-XX:MaxPermSize=1024m -Xmx1024m'

要构建并将jar安装到本地Maven缓存中：

./gradlew install

要构建API Javadoc（结果将在build/api中）：

./gradlew api

要构建参考文档（结果将在build/site中）：

./gradlew antora

要构建完整的发布版本，包括-dist、-docs和-schema压缩文件（结果将在build/distributions中）

./gradlew dist

要使用Sonar进行分析和收集指标：

./gradlew clean build sonar

（请确保Sonar正在运行，例如在localhost的9000端口上）

使用Eclipse

要生成Eclipse元数据（.classpath和.project文件），请执行以下操作：

./gradlew eclipse

完成后，您可以像往常一样将项目导入Eclipse：

文件 -> 导入 -> 将现有项目导入工作空间

浏览到*'spring-amqp'*根目录。所有项目都应该无错误导入。

使用Spring Tools

使用STS Gradle支持，您可以直接导入Gradle项目，无需先生成Eclipse元数据。 请参阅Spring Tools主页。

1. 选择文件 -> 导入 -> 现有Gradle项目
2. 浏览到Spring AMQP根文件夹
3. 点击完成

使用IntelliJ IDEA

要生成IDEA元数据（.iml和.ipr文件），请执行以下操作：

./gradlew idea

更新日志

每个版本解决的问题列表可以在Github中找到。

其他资源

• Spring AMQP主页
• Spring AMQP源代码
• Spring AMQP示例
• StackOverflow

为Spring AMQP做贡献

以下是您参与社区的一些方式：

• 通过回答问题并参与讨论，在Stack Overflow上参与Spring社区。

• 为bug和新功能创建Github问题，并对您感兴趣的问题进行评论和投票。

• Github是用于社交编码的：如果您想编写代码，我们鼓励通过此存储库的分支提交拉取请求来做出贡献。 如果您想以这种方式贡献代码，请引用您要解决的特定Github问题。

在我们接受非平凡的补丁或拉取请求之前，我们需要您签署贡献者协议。 签署贡献者协议并不会授予任何人对主存储库的提交权限，但这意味着我们可以接受您的贡献，如果我们接受，您将获得作者署名。 活跃的贡献者可能会被邀请加入核心团队，并获得合并拉取请求的权限。

代码约定和内务管理

这些都不是拉取请求的必要条件，但它们都会有所帮助。它们也可以在原始拉取请求之后但合并之前添加。

• 使用Spring Framework代码格式约定（如果您使用Eclipse，请从项目根目录导入eclipse-code-formatter.xml）。
• 确保所有新的.java文件都有一个简单的Javadoc类注释，至少包含一个标识您的@author标签，最好还有至少一段关于该类用途的说明。
• 为所有新的.java文件添加ASF许可证头注释（从项目中的现有文件复制）
• 如果您对.java文件进行了实质性修改（不仅仅是美化修改），请将自己添加为@author。
• 添加一些Javadocs，如果您更改了命名空间，还要添加一些XSD文档元素。
• 一些单元测试也会有很大帮助 - 总得有人来做。
• 如果没有其他人使用您的分支，请将其重新基于当前的主分支（或主项目中的其他目标分支）。

许可证

Spring AMQP根据Apache软件许可证2.0版的条款发布（参见LICENSE.txt）。