EM-Synchrony 项目教程

EM-Synchrony 项目教程

em-synchrony Fiber aware EventMachine clients and convenience classes 项目地址: https://gitcode.com/gh_mirrors/em/em-synchrony

1. 项目介绍

EM-Synchrony 是一个用于 Ruby 的库，旨在通过提供 Fiber 感知的 EventMachine 客户端和便利类来简化事件驱动代码的编写。它允许开发者在使用 EventMachine 时，能够更自然地编写同步风格的代码，同时保持异步执行的效率。EM-Synchrony 提供了多种功能，包括 Fiber 感知的连接池、迭代器、多请求接口、TCPSocket 替换等，使得处理并发任务变得更加简单和直观。

2. 项目快速启动

安装

首先，确保你已经安装了 Ruby 和 Bundler。然后，在你的 Gemfile 中添加以下内容：

gem 'em-synchrony'

接着运行：

bundle install

基本使用

以下是一个简单的示例，展示了如何使用 EM-Synchrony 进行并发的 HTTP 请求：

require "em-synchrony"
require "em-synchrony/em-http"

EM.synchrony do
  multi = EM::Synchrony::Multi.new

  multi.add :a, EM::HttpRequest.new("http://www.example.com").aget
  multi.add :b, EM::HttpRequest.new("http://www.example.com").apost

  res = multi.perform
  p res

  EM.stop
end

在这个示例中，我们使用 EM-Synchrony 的 Multi 接口并发地发起两个 HTTP 请求，并在所有请求完成后打印结果。

3. 应用案例和最佳实践

应用案例

并发数据库查询

EM-Synchrony 可以与数据库客户端（如 MySQL2）结合使用，实现并发的数据库查询：

require "em-synchrony"
require "em-synchrony/mysql2"

EM.synchrony do
  db = EventMachine::Synchrony::ConnectionPool.new(size: 2) do
    Mysql2::EM::Client.new
  end

  multi = EventMachine::Synchrony::Multi.new

  multi.add :a, db.aquery("select sleep(1)")
  multi.add :b, db.aquery("select sleep(1)")

  res = multi.perform
  p res

  EM.stop
end

并发 Web 爬虫

使用 EM-Synchrony 可以轻松实现一个并发爬虫，控制并发请求的数量：

require "em-synchrony"
require "em-synchrony/em-http"
require "em-synchrony/fiber_iterator"

EM.synchrony do
  concurrency = 2
  urls = ['http://url1.com', 'http://url2.com']

  results = []
  EM::Synchrony::FiberIterator.new(urls, concurrency).each do |url|
    resp = EventMachine::HttpRequest.new(url).get
    results.push resp.response
  end

  p results
  EM.stop
end

最佳实践

• 控制并发数量：在使用 EM-Synchrony 进行并发操作时，合理控制并发数量，避免资源耗尽。
• 错误处理：在异步操作中，确保正确处理错误回调，避免未捕获的异常导致程序崩溃。
• 资源管理：使用连接池管理数据库连接等资源，避免频繁创建和销毁资源。

4. 典型生态项目

EM-HTTP-Request

EM-HTTP-Request 是一个基于 EventMachine 的 HTTP 客户端库，与 EM-Synchrony 结合使用可以实现高效的并发 HTTP 请求。

MySQL2

MySQL2 是一个 Ruby 的 MySQL 客户端库，支持异步操作。通过 EM-Synchrony，可以将其与 EventMachine 结合，实现并发的数据库查询。

Redis

Redis 是一个高性能的键值存储系统，EM-Synchrony 支持 Redis 的异步操作，可以用于构建高效的缓存系统。

ActiveRecord

ActiveRecord 是 Ruby on Rails 的 ORM 框架，通过 EM-Synchrony，可以实现异步的数据库操作，提升 Rails 应用的性能。

通过这些生态项目的结合，EM-Synchrony 能够帮助开发者构建高效、可扩展的 Ruby 应用。

em-synchrony Fiber aware EventMachine clients and convenience classes 项目地址: https://gitcode.com/gh_mirrors/em/em-synchrony