# FastAPI + PostgreSQLの設計パターン（Repository + Service 層）

## 目次
1. はじめに
2. FastAPIの概要
3. PostgreSQLの役割
4. Repositoryパターンの概念
5. Service層の概念
6. システムアーキテクチャ
7. コード例：Repositoryパターン
8. コード例：Service層の実装
9. テスト戦略
10. まとめ

## 1-1. はじめに
FastAPIとPostgreSQLを用いた設計パターンにおいて、RepositoryとServiceの層に分けるアプローチは、コードの可読性や保守性を大幅に向上させると共に、ビジネスロジックの明確な分離を実現します。このアプローチにより、システムの複雑性を軽減し、開発チームの生産性を向上させることができます。

## 2-1. FastAPIの概要
FastAPIは、Pythonで構築された現代的で高速なWebフレームワークです。非同期処理をサポートしており、高性能なAPIを効率よく開発することができます。また、自動ドキュメント生成機能により、APIの仕様を明確に伝達することが可能です。

## 3-1. PostgreSQLの役割
PostgreSQLは、オープンソースのリレーショナルデータベース管理システムであり、高度なSQLコンプライアンスと拡張性を提供します。データの整合性やACID特性を確保しつつ、効率的にデータを管理するために非常に適しています。

## 4-1. Repositoryパターンの概念
Repositoryパターンは、データアクセ層を抽象化し、データベース操作を集合的に取り扱うことでデータロジックを隠蔽する手法です。このパターンにより、ビジネスロジックはデータベースから切り離され、データ操作の一貫性が保証されます。

### 4-2. メリット
- データアクセスの標準化
- テストの容易さ
- ビジネスロジックからのデータ操作の分離

## 5-1. Service層の概念
Service層は、ビジネスロジックを集中させる場所です。ここでは、Repository層を利用してデータを処理し、アプリケーションの不可侵な論理を管理します。

### 5-2. メリット
- 複雑なビジネスロジックの管理
- コードの再利用性向上
- ビジネスロジックのテストが容易になる

## 6-1. システムアーキテクチャ
この設計パターンにおけるシステムアーキテクチャは以下のようになります。

```
Client -> Controller -> Service -> Repository -> Database (PostgreSQL)
```

- **Client**: ユーザーからのリクエストを受け取るインターフェイス
- **Controller**: リクエストをService層に渡す役割
- **Service**: ビジネスロジックを処理し、Repository層と連携
- **Repository**: データベース操作を抽象化
- **Database**: 物理的なデータのストレージ

## 7-1. コード例：Repositoryパターン
以下に、基本的なRepositoryパターンのコード例を示します。

```python
# database.py
from sqlalchemy import create_engine
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy.orm import sessionmaker

DATABASE_URL = "postgresql://user:password@localhost/dbname"

engine = create_engine(DATABASE_URL)
SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
Base = declarative_base()

# models.py
from sqlalchemy import Column, Integer, String
from .database import Base

class User(Base):
    __tablename__ = "users"
    id = Column(Integer, primary_key=True, index=True)
    name = Column(String, index=True)

# repository.py
from sqlalchemy.orm import Session
from . import models

class UserRepository:
    def __init__(self, db: Session):
        self.db = db

    def get_user(self, user_id: int):
        return self.db.query(models.User).filter(models.User.id == user_id).first()

    def create_user(self, user: models.User):
        self.db.add(user)
        self.db.commit()
        self.db.refresh(user)
        return user
```

## 8-1. コード例：Service層の実装
Service層の実装により、ビジネスロジックを管理します。

```python
# service.py
from sqlalchemy.orm import Session
from .repository import UserRepository
from .models import User

class UserService:
    def __init__(self, db: Session):
        self.user_repository = UserRepository(db)

    def get_user_details(self, user_id: int) -> User:
        return self.user_repository.get_user(user_id)

    def add_user(self, user_data):
        new_user = User(**user_data)
        return self.user_repository.create_user(new_user)
```

## 9-1. テスト戦略
テスト戦略においては、各層を個別にユニットテストし、全体の動作確認は統合テストでカバーします。特に、モックオブジェクトとdependency injectionの技術を活用することで、効率的なテストを実施することが可能です。

## 10-1. まとめ
本記事では、FastAPIとPostgreSQLを使用した設計パターンの中で、RepositoryとService層を組み合わせたアーキテクチャの利点と実例を解説しました。この手法を利用することで、ビジネスロジックをシンプルに保ちながら、システムの柔軟性と保守性を大幅に向上させることができます。

本設計パターンの適用により、プロジェクトの規模や要求が進化するにつれて、コードが一貫して読みやすく、メンテナンスがしやすいシステムを構築することが可能です。 [cv:issue_marketplace_engineer]

FastAPI + PostgreSQLの設計パターン（Repository + Service 層）

目次

続きを読むには単価診断を受けてください（30秒）