Qusion 技术文档

1. 安装指南

在开始使用 Qusion 前，您需要安装以下依赖：

• Erlang
• RabbitMQ
• AMQP Ruby 库

安装 Erlang 和 RabbitMQ 请参考相应的官方文档。以下是安装 AMQP Ruby 库的命令：

(sudo) gem install amqp

然后，您可以通过以下命令将 Qusion 作为插件安装到您的项目中：

script/plugin install git://github.com/danielsdeleo/qusion.git

2. 项目的使用说明

在 config/environment.rb 文件中，添加以下代码以配置 EventMachine 和 AMQP：

config.gem "eventmachine"
config.gem "amqp"

config.after_initialize do
  Qusion.start # 如果使用 config/amqp.yml 或默认设置，无需提供任何选项
end

现在，您可以在控制器或模型中像平常一样使用 AMQP 功能。例如：

MQ.new.queue("my-work-queue").publish("do work, son!")

这将正常工作。

3. 项目API使用文档

Qusion 提供了一个通道池功能，以避免频繁创建新的 AMQP 通道。使用 Qusion.channel 替代 MQ.new。以下是一些使用示例：

# 创建队列：
Qusion.channel.queue("my-worker-queue")
# 主题：
Qusion.channel.topic("my-topic-exchange")
# 等。

默认的通道池大小是 5，您可以通过以下方式在 environment.rb 中修改它：

Qusion.channel_pool_size(3)

4. 项目安装方式

除了通过 Git 插件安装外，您还可以将 Qusion 作为依赖添加到您的项目 Gemfile 中，然后执行 bundle install：

gem 'qusion', git: 'https://github.com/danielsdeleo/qusion.git'

Qusion 支持使用 YAML 配置文件来配置 AMQP 服务器详细信息。如果使用 Rails 或 Merb，可以在 config/amqp.yml 中设置开发、测试和生产环境的配置。以下是配置示例：

# config/amqp.yml
development:
  host: localhost
  port: 5672
  user: guest
  pass: guest
  vhost: /
  timeout: 3600
  logging: false
  ssl: false

test:
  host: localhost
  port: 5672
  ...

production:
  host: localhost
  port: 5672
  ...

如果使用其他框架，如 Sinatra 或 Ramaze，可以指定配置文件路径：

Qusion.start("/path/to/amqp.yml")

如果不提供配置文件，Qusion 会使用默认选项。此外，您也可以直接传递选项给 Qusion.start() 方法：

Qusion.start(:host => "my-amqp-broker.mydomain.com", :user => "me", :pass => "am_I_really_putting_this_in_VCS?")

以上就是关于 Qusion 的技术文档，希望对您有所帮助。如果您在使用过程中遇到任何问题或需要添加新功能，请随时在 GitHub 上进行反馈。