ドキュメント価格ブログ
お問い合わせ
ログイン無料で新規登録
Back to Tech Articles

Rustのモジュールシステムによる大規模Webプロジェクトの構造化

Oct 10, 2025
# Misc

Ethan Miller

Product Engineer · Leapcell

この記事はEnglish、한국어、Deutschでも利用できます
Cover of "Rustのモジュールシステムによる大規模Webプロジェクトの構造化"

大規模なWebアプリケーションの開発は、コードベースの管理という、少なくともその一つとも言える特有の課題を提示します。プロジェクトが拡大するにつれて、組織化の不備は、依存関係の絡まり、ナビゲーションの困難さ、そして新しいチームメンバーにとって急峻な学習曲線にすぐに繋がります。パフォーマンスと安全性が最優先されるRustエコシステムでは、コード構造に対しても同様に堅牢なアプローチが不可欠です。この記事では、Rustの強力なモジュールシステム、特にmodとuseの実践的な応用について掘り下げ、これらを活用して大規模プロジェクトのためにクリーンで、保守可能で、スケーラブルなアーキテクチャを構築する方法を実演します。これらの見かけ上シンプルなキーワードが、複雑なロジックを整理し、コードの再利用性を促進し、生産的な開発環境を育むための不可欠なツールにどのように変わるかを探ります。

Rustモジュールとその応用の理解

実践的な例に入る前に、Rustのモジュールシステムの基盤となるコアコンセプトを簡単に定義しましょう。

  • モジュール (mod): モジュールは、ライブラリまたはバイナリクレート内でコードを整理する方法です。関数、構造体、列挙型、トレイト、さらには他のモジュールの定義を含めることができます。モジュールは明確な階層を作成し、アイテムの可視性を制御します。デフォルトでは、モジュール内のアイテムはそのモジュールに対してプライベートです。
  • 可視性キーワード (pub, pub(crate), pub(super), pub(in super::super)): これらのキーワードは、アイテムがどこからアクセスできるかを決定します。pubはアイテムをモジュールの外部の任意のコードに公開します。pub(crate)は可視性を現在のクレートに制限します。pub(super)はアイテムを親モジュールに可視にします。pub(in path)は特定のパスへの可視性を正確に制御できます。
  • use宣言 (use): useキーワードは、モジュールからアイテムを現在のスコープに取り込み、短い名前で参照できるようにします。これにより、長い完全修飾パスの必要がなくなり、可視性が向上します。

この理解を得た上で、仮説上の大規模Webアプリケーション、おそらくEコマースプラットフォームを想定し、それをどのように構造化できるかを見てみましょう。

コアアーキテクチャ Prinzipien

大規模なWebプロジェクトでは、通常、レイヤードアーキテクチャを目指します。一般的なパターンには以下が含まれます：

  1. アプリケーションエントリポイント: main.rs（ライブラリの場合はlib.rs）
  2. 設定: 環境変数、データベース接続などを処理します。
  3. ルート/コントローラー: APIエンドポイントを定義し、着信リクエストを処理します。
  4. サービス/ビジネスロジック: コアビジネスルールをカプセル化し、データアクセスを調整します。
  5. モデル/エンティティ: データ構造（例：ユーザー、製品、注文）を表します。
  6. データベースアクセス/リポジトリ: データベースとの対話。
  7. ユーティリティ/共有: 一般的なヘルパー関数、エラー処理など。

modとuseによる構造の実装

私たちのEコマースプロジェクトが単一のバイナリクレートとして構造化されていると想像してみましょう。srcディレクトリは次のようなものになるかもしれません：

src/
├── main.rs
├── config.rs
├── db/
│   ├── mod.rs
│   └── schema.rs
│   └── models.rs
│   └── products.rs
│   └── users.rs
│   └── orders.rs
├── routes/
│   ├── mod.rs
│   ├── auth.rs
│   ├── products.rs
│   └── users.rs
├── services/
│   ├── mod.rs
│   ├── auth.rs
│   ├── products.rs
│   └── users.rs
└── utils/
    ├── mod.rs
    └── error.rs
    └── helpers.rs

main.rsエントリポイント

main.rsはオーケストレーターとなり、アプリケーションのさまざまな部分を統合します。

// src/main.rs

mod config;
mod db;
mod routes;
mod services;
mod utils;

// 通常、名前の衝突を避け、パスを短くするために特定のアイテムを使用します
use crate::config::app_config;
use crate::db::establish_connection;
use crate::routes::create_router;

#[tokio::main]
async fn main() {
// 設定のロード
let config = app_config::load().expect("Failed to load configuration");

// データベース接続の確立
let db_pool = establish_connection(&config.database_url)
.await
.expect("Failed to connect to database");

// アプリケーション全体の状態の初期化（例：共有リソースのArc）
let app_state = todo!(); // 実際のアプリケーション状態のプレースホルダー

// Webサーバーの作成と実行
let app = create_router(app_state);
let listener = tokio::net::TcpListener::bind(&config.server_address)
.await
.expect("Failed to bind server address");

println!("Server running on {}", config.server_address);

axum::serve(listener, app)
.await
.expect("Server failed to start");
}

main.rsの先頭にあるmod宣言に注目してください。これらはトップレベルモジュールを導入します。次に、use crate::module::itemは特定のアイテムをスコープ内にもたらし、完全なパスなしで直接アクセスできるようにします。

サブモジュールの整理

例としてdbモジュールのネストされたモジュールを見てみましょう。

// src/db/mod.rs

pub mod schema; // データベーススキーマを定義します（例：Dieselマクロを使用）
pub mod models; // データベーステーブルにマッピングされるRust構造体を定義します
pub mod products; // 製品データアクセスに関連する関数を含みます
pub mod users;    // ユーザーデータアクセスに関連する関数を含みます
pub mod orders;   // 注文データアクセスに関連する関数を含みます

use diesel::PgConnection;
use diesel::r2d2::{ConnectionManager, Pool};
use std::env;

pub type DbPool = Pool<ConnectionManager<PgConnection>>;

pub async fn establish_connection(database_url: &str) -> Result<DbPool, String> {
let manager = ConnectionManager::<PgConnection>::new(database_url);
Pool::builder()
.test_on_check_out(true)
.build(manager)
.map_err(|e| format!("Failed to create pool: {}", e))
}

ここでは、pub modによりschema、models、productsなどがcrate::dbパス内の他のモジュールで利用可能になります。establish_connection関数もpubであるため、main.rsから呼び出すことができます。db/mod.rs内のuseステートメントはdbモジュールローカルです。

次に、src/db/products.rsを検討します：

// src/db/products.rs

use diesel::prelude::*;
use crate::db::{DbPool, models::Product}; // 親モジュールや兄弟モジュールからアイテムを使用します

pub async fn find_all_products(pool: &DbPool) -> Result<Vec<Product>, String> {
todo!() // 実際の製品取得ロジック
}

pub async fn find_product_by_id(pool: &DbPool, product_id: i32) -> Result<Option<Product>, String> {
todo!() // 実際の製品取得ロジック
}

pub async fn create_product(pool: &DbPool, new_product: NewProduct) -> Result<Product, String> {
todo!() // 実際の製品作成ロジック
}

// ...その他の製品関連DB操作

src/db/products.rs内では、use crate::db::{DbPool, models::Product}を使用します。DbPoolはsrc/db/mod.rsによって公開され、models::Productはdb親モジュールの兄弟モジュールであるmodelsモジュールから取得されます。これはモジュール階層をナビゲートする方法を示しています。

ルートとサービス

routesモジュールはAPIエンドポイントを定義し、通常AxumやActix-webなどのWebフレームワークを使用します。servicesモジュールはビジネスロジックをカプセル化し、ルートとデータベースアクセスの間の仲介役を務めます。

// src/routes/mod.rs

pub mod auth;
pub mod products;
pub mod users;

use axum::{routing::get, Router};
use std::sync::Arc;
use crate::utils::error::AppError; // カスタムエラータイプのインポート例

pub struct AppState {
// 共有アプリケーション状態の例
pub db_pool: crate::db::DbPool,
// その他の共有リソース
}

// メインアプリケーションルーターを作成する関数
pub fn create_router(app_state: Arc<AppState>) -> Router {
Router::new()
.route("/", get(|| async { "Hello, world!" }))
.nest("/auth", auth::auth_routes(app_state.clone()))
.nest("/products", products::product_routes(app_state.clone()))
.nest("/users", users::user_routes(app_state.clone()))
// ここにさらにルートを追加します
}
// src/routes/products.rs

use axum::{
extract::{Path, State},
Json, Router, routing::{get, post},
};
use serde::{Deserialize, Serialize};
use std::sync::Arc;
use crate::routes::AppState; // routes/mod.rsで定義されたAppStateをインポート
use crate::services; // servicesモジュールにアクセス
use crate::utils::error::AppError; // カスタムエラータイプをレスポンスに使用

#[derive(Serialize)]
struct ProductResponse {
id: i32,
name: String,
price: f64,
}

#[derive(Deserialize)]
struct CreateProductRequest {
name: String,
price: f64,
}

pub fn product_routes(app_state: Arc<AppState>) -> Router {
Router::new()
.route("/", get(get_all_products).post(create_product))
.route("/:id", get(get_product_by_id))
.with_state(app_state)
}

async fn get_all_products(State(app_state): State<Arc<AppState>>) -> Result<Json<Vec<ProductResponse>>, AppError> {
let products = services::products::get_all_products(&app_state.db_pool)
.await?
.into_iter()
.map(|p| ProductResponse { id: p.id, name: p.name, price: p.price as f64 })
.collect();
Ok(Json(products))
}

async fn get_product_by_id(
State(app_state): State<Arc<AppState>>,
Path(product_id): Path<i32>,
) -> Result<Json<ProductResponse>, AppError> {
let product = services::products::get_product_by_id(&app_state.db_pool, product_id)
.await?
.map(|p| ProductResponse { id: p.id, name: p.name, price: p.price as f64 })
.ok_or(AppError::NotFound)?;
Ok(Json(product))
}

async fn create_product(
State(app_state): State<Arc<AppState>>,
Json(payload): Json<CreateProductRequest>,
) -> Result<Json<ProductResponse>, AppError> {
let new_product = services::products::create_product(&app_state.db_pool, payload.name, payload.price)
.await?
.map(|p| ProductResponse { id: p.id, name: p.name, price: p.price as f64 })
.ok_or(AppError::InternalServerError)?; // エラー処理の例
Ok(Json(new_product))
}

servicesモジュールは、get_all_products、get_product_by_idなどの実際の実装を含み、dbモジュール関数を呼び出します。

// src/services/products.rs

use crate::db; // データベース関連の関数にアクセスします
use crate::db::DbPool;
use crate::db::models::{Product, NewProduct};
use crate::utils::error::AppError;

pub async fn get_all_products(pool: &DbPool) -> Result<Vec<Product>, AppError> {
db::products::find_all_products(pool)
.await
.map_err(|e| AppError::InternalServerErrorDetail(e.to_string()))
}

pub async fn get_product_by_id(pool: &DbPool, product_id: i32) -> Result<Option<Product>, AppError> {
db::products::find_product_by_id(pool, product_id)
.await
.map_err(|e| AppError::InternalServerErrorDetail(e.to_string()))
}

pub async fn create_product(pool: &DbPool, name: String, price: f64) -> Result<Option<Product>, AppError> {
let new_product = NewProduct { name, price: price as i32 }; // 単純化のためpriceはDBでi32と仮定
db::products::create_product(pool, new_product)
.await
.map_err(|e| AppError::InternalServerErrorDetail(e.to_string()))
}

src/services/products.rsでは、use crate::db;を使用してデータベース関連の関数にアクセスします。次にdb::products::find_all_productsやその他の類似関数を呼び出します。この明確な責務分離により、ルートは薄く、リクエスト/レスポンスの解析のみを行い、ビジネスロジックはサービスに委譲され、サービスはさらにデータアクセスをデータベース層に委譲することが保証されます。

このアプローチの利点

  • 明瞭さと可読性: アプリケーションを論理的なモジュールに分割することにより、コードベースはナビゲートしやすく、理解しやすくなります。
  • 保守性: データベーススキーマなどの特定の領域での変更は、アプリケーションの無関係な部分に波及する可能性が低くなります。
  • テスト容易性: 個々のモジュール（例：サービス、データベース操作）を独立して単体テストできるため、より堅牢なソフトウェアが得られます。
  • コラボレーション: 複数の開発者が、マージコンフリクトを少なくし、責任の明確な理解のもとで、異なるモジュールを同時に作業できます。
  • カプセル化: モジュールは公開するもの（pub）と内部に保持するもの（pubでないもの）を制御し、最小権限の原則を遵守し、意図しないアクセスを防ぎます。

結論

Rustのモジュールシステムは、modとuseによって強化され、最も複雑なWebアプリケーションの構造化のための堅牢で柔軟な基盤を提供します。コードを論理的なモジュールに思慮深く整理し、明示的な可視性ルールを使用することにより、開発者は非常に保守可能で、スケーラブルで、理解しやすいプロジェクトを構築できます。この体系的なアプローチは、開発プロセスを強化するだけでなく、アプリケーションのアーキテクチャが進化し成長するにつれて堅実であり続けることを保証します。モジュールシステムを習得することは、大規模Web開発のためのRustの潜在能力を最大限に引き出す鍵となります。

Share this article

HackerNews

More Posts from Leapcell

cover

Derive マクロがいかにRust Web開発を効率化するか

cover

WebフレームワークルーティングにおけるRustクロージャ Fn, FnMut, FnOnce の探求

Popular Posts