dry-system 使用指南

dry-system 使用指南

dry-system Application framework with state management and built-in dependency injection support 项目地址: https://gitcode.com/gh_mirrors/dr/dry-system

项目介绍

dry-system 是一个由 dry-rb 社区维护的应用框架，它集成了状态管理与内置依赖注入（Dependency Injection，简称 DI）功能。该库旨在提供一种简洁的方式来组织和管理Ruby应用程序的组件，通过声明式配置提升模块化和可测试性。干爽Ruby（dry-rb）是一系列Ruby库的集合，专注于简化和标准化Ruby编程中的常见任务。

项目快速启动

要快速启动并运行 dry-system，首先确保您的环境中安装了MRI Ruby 3.0及以上版本或者JRuby 9.4及以上版本。然后遵循以下步骤：

步骤一：添加gem到项目

在您的Ruby项目的 Gemfile 中添加以下行来引入 dry-system：

gem 'dry-system', '~> 版本号'

替换 版本号 为当前最新的稳定版，可通过访问其GitHub页面 或者 RubyGems 查找。

步骤二：初始化 dry-system

在终端执行以下命令来设置基础配置：

bundle exec dry-system init

这将会创建一个初始配置文件，通常命名为 project.yml。

步骤三：配置与启动

编辑 project.yml 来注册您的应用组件。例如，注册一个简单的服务类：

components:
  - name: my_service
    file: './app/services/my_service.rb'

在 my_service.rb 中定义您的服务：

class MyService
  def call
    "Hello, dry-system!"
  end
end

最后，在您的应用入口处，使用如下代码来启动系统并访问服务：

require 'dry/system'

system = Dry::System.configure do |config|
  config.project_root = Dir.pwd
end.boot

puts system.components['my_service'].call

应用案例和最佳实践

在使用 dry-system 时，最佳实践包括将业务逻辑分解为小的、职责单一的服务，通过配置文件明确地声明它们之间的依赖关系。这不仅有利于理解和维护，还能提高测试效率。例如，对于数据库连接、日志记录等基础设施服务，应优先使用DI进行注入，以增强代码的解耦性。

典型生态项目

dry-rb 生态系统还包括了如 dry-configurable, dry-validation, 和 dry-effects 等其他库，这些可以与 dry-system 联合使用来构建更健壮、结构化的Ruby应用。例如，利用 dry-validation 进行输入验证，结合 dry-configurable 管理应用配置，能够进一步增强应用的质量和可维护性。

通过上述步骤和策略，您可以有效地利用 dry-system 构建和组织现代的Ruby应用程序，享受更加高效、模块化且易于维护的开发体验。

dry-system Application framework with state management and built-in dependency injection support 项目地址: https://gitcode.com/gh_mirrors/dr/dry-system