Hanami Router 开源项目教程

Hanami Router 开源项目教程

router Ruby/Rack HTTP router 项目地址: https://gitcode.com/gh_mirrors/router8/router

1. 项目介绍

Hanami Router 是一个轻量级、快速且兼容 Rack 的 HTTP 路由器，专为 Ruby 和 Hanami 框架设计。它提供了简洁的 DSL（领域特定语言）来定义路由，支持多种 HTTP 方法、变量匹配、重定向、命名路由等功能。Hanami Router 旨在简化路由配置，提高开发效率，同时保持高性能。

2. 项目快速启动

安装

首先，将 Hanami Router 添加到你的 Gemfile 中：

gem "hanami-router"

然后执行以下命令进行安装：

bundle install

基本使用

创建一个名为 config.ru 的文件，并添加以下代码：

# frozen_string_literal: true

require "hanami/router"

app = Hanami::Router.new do
  get "/", to: ->(env) { [200, [], ["Welcome to Hanami!"]] }
  get "/hello", to: ->(env) { [200, [], ["Hello, World!"]] }
end

run app

在终端中运行以下命令启动应用：

bundle exec rackup

访问 http://localhost:9292 和 http://localhost:9292/hello，你将看到相应的欢迎信息。

3. 应用案例和最佳实践

案例1：RESTful API 路由

Hanami Router 非常适合用于构建 RESTful API。以下是一个简单的示例：

Hanami::Router.new do
  get "/books", to: "books#index"
  get "/books/:id", to: "books#show"
  post "/books", to: "books#create"
  put "/books/:id", to: "books#update"
  delete "/books/:id", to: "books#destroy"
end

案例2：命名路由

命名路由可以帮助你更方便地生成 URL：

router = Hanami::Router.new(scheme: "https", host: "example.com") do
  get "/profile", to: "users#profile", as: :profile
end

router.path(:profile) # => "/profile"
router.url(:profile)  # => "https://example.com/profile"

最佳实践

• 使用命名路由：命名路由可以提高代码的可读性和可维护性。
• 合理使用变量匹配：通过变量匹配可以简化路由定义，但要注意避免过度使用，以免影响性能。
• 保持路由简洁：避免在路由中嵌入过多的逻辑，保持路由的简洁性和可读性。

4. 典型生态项目

Hanami Router 作为 Hanami 框架的一部分，与其他 Hanami 组件紧密集成。以下是一些典型的生态项目：

• Hanami Framework：Hanami 是一个全栈的 Ruby 框架，提供了 MVC 架构、ORM、模板引擎等功能，Hanami Router 是其核心组件之一。
• Rack：Hanami Router 完全兼容 Rack，可以与其他 Rack 应用无缝集成。
• Dry-rb：Hanami 框架大量使用了 Dry-rb 库，提供了强大的类型系统和验证功能，增强了 Hanami Router 的灵活性和可扩展性。

通过这些生态项目，Hanami Router 可以构建出功能强大且易于维护的 Web 应用。

router Ruby/Rack HTTP router 项目地址: https://gitcode.com/gh_mirrors/router8/router