例外からの実装の詳細の漏洩を防ぐ方法

例外は、エラー状態を通知するための強力な機能です。
しかし、適切に使用しないと、実装の詳細が漏洩し、コードのモジュール性を損なう可能性があります。

本記事では、例外からの実装の詳細の漏洩を防ぐ方法について解説します。
サンプルコードを交えながら、具体的なテクニックを見ていきましょう。

例外から実装の詳細が漏洩すると問題が発生する可能性

以下のコードは、ファイルの読み込みを行うFileReaderクラスの一部です。

class FileReader:
    def __init__(self, file_path):
        self.file_path = file_path

    def read_file(self):
        try:
            with open(self.file_path, 'r') as file:
                content = file.read()
                return content
        except FileNotFoundError:
            raise FileNotFoundError(f"File not found: {self.file_path}")

このコードでは、FileReaderクラスがファイルの読み込みを行っています。
ファイルが見つからない場合、FileNotFoundError例外が発生します。

しかし、この実装には以下のような問題があります。

ファイルシステムの実装の詳細（FileNotFoundError）が、FileReaderクラスの利用者に漏洩している
FileReaderクラスの利用者は、ファイルシステムに関する知識が必要になる
ファイルシステムが変更された場合、FileReaderクラスの利用者にも影響が及ぶ

これらの問題は、FileReaderクラスがファイルシステムの実装の詳細に依存しているために発生します。

解決策: 例外の抽象化

上記の問題を解決するために、例外を抽象化し、実装の詳細を隠蔽します。

class FileReaderError(Exception):
    """FileReaderクラスの汎用的な例外クラス"""
    pass

class FileReader:
    def __init__(self, file_path):
        self.file_path = file_path

    def read_file(self):
        try:
            with open(self.file_path, 'r') as file:
                content = file.read()
                return content
        except FileNotFoundError:
            raise FileReaderError(f"File not found: {self.file_path}")

この変更点は以下の通りです。