Hanami 开源项目教程

Hanami 开源项目教程

hanamiThe web, with simplicity.项目地址:https://gitcode.com/gh_mirrors/ha/hanami

1. 项目介绍

Hanami 是一个现代的 Ruby 框架，旨在提供一个轻量级、模块化和灵活的 Web 应用程序开发环境。Hanami 的设计理念是保持简单性和可维护性，同时提供强大的功能和灵活性。Hanami 的核心思想是将应用程序分解为多个独立的组件，每个组件都可以独立开发、测试和部署。

Hanami 的主要特点包括：

• 模块化设计：应用程序被分解为多个独立的组件，每个组件都有自己的目录结构和命名空间。
• 轻量级：Hanami 的核心库非常轻量，只包含必要的功能，避免不必要的依赖。
• 灵活性：Hanami 允许开发者自由选择数据库、模板引擎和其他工具，以满足特定需求。
• 测试友好：Hanami 提供了强大的测试工具，支持单元测试、集成测试和功能测试。

2. 项目快速启动

安装 Hanami

首先，确保你已经安装了 Ruby 和 Bundler。然后，使用以下命令安装 Hanami：

gem install hanami

创建新项目

使用以下命令创建一个新的 Hanami 项目：

hanami new my_project

启动开发服务器

进入项目目录并启动开发服务器：

cd my_project
bundle install
hanami server

现在，你可以在浏览器中访问 http://localhost:2300 查看你的 Hanami 应用程序。

创建控制器和视图

Hanami 使用命令行工具来生成控制器和视图。例如，创建一个名为 home 的控制器：

hanami generate action web home#index

这将在 apps/web/controllers/home/index.rb 中生成控制器，并在 apps/web/templates/home/index.html.erb 中生成视图模板。

编写代码

在生成的控制器文件中，你可以编写处理请求的逻辑：

# apps/web/controllers/home/index.rb
module Web::Controllers::Home
  class Index
    include Web::Action

    def call(params)
      @message = "Hello, Hanami!"
    end
  end
end

在视图模板中，你可以使用控制器传递的数据：

<!-- apps/web/templates/home/index.html.erb -->
<h1><%= @message %></h1>

运行测试

Hanami 提供了强大的测试工具。你可以使用以下命令运行测试：

bundle exec rake test

3. 应用案例和最佳实践

应用案例

Hanami 已经被用于构建各种类型的 Web 应用程序，包括博客、电子商务平台、API 服务等。由于其模块化和灵活的设计，Hanami 特别适合需要高度定制化和可维护性的项目。

最佳实践

• 模块化设计：将应用程序分解为多个独立的组件，每个组件都有自己的目录结构和命名空间。
• 依赖注入：使用依赖注入来管理组件之间的依赖关系，提高代码的可测试性和可维护性。
• 自动化测试：充分利用 Hanami 提供的测试工具，编写全面的单元测试、集成测试和功能测试。
• 代码复用：通过共享模块和插件来复用代码，减少重复工作。

4. 典型生态项目

Hanami 生态系统中有许多有用的项目和工具，可以帮助开发者更高效地构建应用程序。以下是一些典型的生态项目：

• Hanami::Model：Hanami 的数据库访问层，支持多种数据库，如 PostgreSQL、MySQL 等。
• Hanami::Assets：用于管理静态资源（如 CSS、JavaScript、图片等）的工具。
• Hanami::Mailer：用于发送电子邮件的工具。
• Hanami::CLI：Hanami 的命令行工具，用于生成代码、运行任务等。

这些工具和项目可以帮助开发者更高效地构建 Hanami 应用程序，并提高代码的可维护性和可扩展性。

hanamiThe web, with simplicity.项目地址:https://gitcode.com/gh_mirrors/ha/hanami