在Ruby生态中，构建可维护的Web服务常常面临对象依赖混乱与路由逻辑分散的问题。Dry-web-roda结合dry-system与Roda框架，提供了一套以容器为核心的架构方案，让依赖注入和路由组织变得显式且可控。
什么是Dry-web-roda的容器与依赖注入
Dry-web-roda的底层依赖dry-system，它允许你定义一个系统容器，把服务、仓库、客户端等都注册为容器里的组件。组件可以是类、实例或者由proc构造的对象。依赖注入并不是在代码里直接写死 new 某个类，而是通过容器解析名称拿到已经装配好的对象。
例如，我们可以在容器里注册一个数据库和客户仓储，然后在操作类里声明需要哪些依赖。框架会在实例化时自动把对应组件填进来。这样做的好处是，在测试环境可以很方便地替换成内存实现，而不用修改业务代码。相比在全局变量里放一个 $db，容器方式明确了依赖边界。
require 'dry/system/container'
require 'dry/auto_inject'
class MyApp < Dry::System::Container
register(:db) { Sequel.connect('sqlite://blog.db') }
register(:post_repo) { PostRepo.new(container.resolve(:db)) }
end
Import = Dry::AutoInject(MyApp)
class CreatePost
include Import['db', 'post_repo']
def call(params)
post_repo.create(params)
end
end
service = CreatePost.new
service.call({ title: 'hello' })
路由如何与容器组件协作
Roda本身以路由块闻名，Dry-web-roda在此之上引入了应用切片（slice）和provider概念。每个路由分支可以绑定到某个子容器，从而只暴露该上下文需要的组件。这种组织方式让大型项目按业务域拆分路由，而不会让顶层文件膨胀。
下面示例展示了一个典型的Roda应用，在路由中通过容器拿到操作对象并处理请求。注意这里没有在动作里直接实例化仓库，而是从注入好的服务里调用。当路由变多时，你只需在对应slice中维护provider，不必改动核心容器。
require 'roda'
class API < Roda
plugin :json
route do |r|
r.on 'posts' do
r.post do
CreatePost.new.call(r.params)
end
r.get do
MyApp.resolve(:post_repo).list
end
end
end
end
依赖注入带来的测试优势
在没有注入的旧式写法中，控制器直接引用模型类，单元测试必须连数据库或打复杂桩。使用Dry-web-roda后，测试时可以构造一个测试容器，覆盖掉 db 与 post_repo，返回伪造数据。这样用例执行快且稳定。
下面代码演示如何用临时容器替换组件。这种写法清晰表达了被测对象的依赖，也避免了因为全局状态导致的测试顺序问题。对于持续集成环境，启动时间能明显缩短。
test_container = MyApp.dup
test_container.register(:post_repo) do
Class.new do
def list; [{ id: 1, title: 'mock' }]; end
def create(p); p; end
end.new
end
Import = Dry::AutoInject(test_container)
路由组织的实践建议
建议按业务边界划分slice，比如用户域、订单域各自拥有独立provider文件。每个provider用单独的rb描述组件构造逻辑，主容器通过 require 加载。这样新成员能快速定位某个接口背后的依赖图。
同时应避免在路由块里写厚逻辑。把处理过程推到操作类或服务对象，路由只负责参数提取与响应格式。配合依赖注入，操作类不依赖框架请求对象，可单独跑脚本调用，提升复用度。
| 方式 | 耦合度 | 测试成本 | 路由清晰度 |
|---|---|---|---|
| 全局常量 | 高 | 高 | 低 |
| Dry-web-roda注入 | 低 | 低 | 高 |
常见误区与纠正
有人认为依赖注入会增加大量样板代码。其实dry-auto_inject已经通过 include 与字符串声明削减了模板。另一个误区是容器越大越好，实际上应按slice隔离，防止组件名冲突与加载缓慢。
还有开发者把Roda路由写成深层嵌套且混杂SQL，这违背了架构初衷。应当让路由保持薄，依赖由容器统一管理，才能真正发挥Dry-web-roda的现代架构价值。
dry-web-rodadependency_injectionroute_organization修改时间：2026-08-12 01:03:25