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主页。
- 选择文件 -> 导入 -> 现有Gradle项目
- 浏览到Spring AMQP根文件夹
- 点击完成
使用IntelliJ IDEA
要生成IDEA元数据(.iml和.ipr文件),请执行以下操作:
./gradlew idea
更新日志
每个版本解决的问题列表可以在Github中找到。
其他资源
为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)。