エラー処理の指針

/*
 * 指定したデータベースに接続します
 *
 * @throws Example_Datasource_Exception 指定した DSN で接続できない場合
 *
 */
function connectDB($dsn)
{
    $this->db =& DB::connect($dsn);
    if (DB::isError($this->db)) {
        throw new Example_Datasource_Exception(
                "$dsn に接続できません:" . $this->db->getMessage()
        );
    }
}

/*
 * いくつかの候補の中から、接続可能なデータベースに接続します
 *
 * @throws Example_Datasource_Exception
 * 設定されたデータベースのどれにも接続できなかった場合
 *
 * @throws Example_Config_Exception
 * データベースの設定が見つからなかった場合
 */

function connect(Config $conf)
{
    $dsns =& $conf->searchPath(array('config', 'db'));
    if ($dsns === FALSE) throw new Example_Config_Exception(
        'config/db セクションが設定されていません。'
    );

    $dsns =& $dsns->toArray();

    foreach($dsns as $dsn) {
        try {
            $this->connectDB($dsn);
            return;
        } catch (Example_Datasource_Exception e) {
            // 何らかの警告/ログ出力コードにより、
            // そのデータベースに接続できなかったことを記録します
        }
    }
    throw new Example_Datasource_Exception(
        'どのデータベースにも接続できません'
    );
}

/*
 * loadConfig は、渡された設定内容をパースします。設定が無効な場合は
 * デフォルトの内容を設定します
 *
 */
function loadConfig(Config $conf)
{
    try {
        $this->config = $conf->parse();
    } catch (Config_Parse_Exception e) {
        // 警告やログ出力のコードをここに書き、
        // 不完全な復旧を行います
        $this->config = $this->defaultConfig;
    }
}

function divide($x, $y)
{
    if ($y == 0) {
        throw new Example_Aritmetic_Exception('ゼロによる除算');
    }
}

/*
 * 指定したデータベースに接続します
 *
 * @throws Example_Datasource_Exception
 * 指定した DSN で接続できない場合
 */
function connectDB($dsn)
{
    $this->db =& DB::connect($dsn);
    if (DB::isError($this->db)) {
        throw new Example_Datasource_Exception(
                "$dsn に接続できません:" . $this->db->getMessage()
        );
    }
}

function preTaxPrice($retailPrice, $taxRate)
{
    try {
        return $this->divide($retailPrice, 1 + $taxRate);
    } catch (Example_Aritmetic_Exception e) {
        throw new Example_Tax_Exception('税率が無効です。', e);
    }
}

function preTaxPrice($retailPrice, $taxRate)
{
    return $this->divide($retailPrice, 1 + $taxRate);
}

/**
 * ツリーから再帰的の文字列を探します
 * @throws ResultException
 */
public function search(TreeNode $node, $data)
{
    if ($node->data === $data) {
        throw new ResultException( $node );
    } else {
        search( $node->leftChild, $data );
        search( $node->rightChild, $data );
    }
}

/**
 * このメソッドは、異星人を探します。
 *
 * @return array Aliens オブジェクトの配列。
 * @throws AntennaBrokenException アンテナに障害が発生した場合
 *
 * @throws AntennaInUseException 別のプロセスが既にアンテナを使用している場合
 */
public function findAliens($color = 'green');

/**
 * セッションオブジェクトを共有メモリに読み込みます
 *
 * @throws LoadingException 下位レベルの IOException をラップし、
 * LoadingException として再スローします
 */
public function loadSessionObjects();

/**
 * データベースへのクエリを一括で実行します (それぞれ個別に実行します。トランザクション処理はありません)
 * @throws SQLException 下位レベルでの SQL エラーは、このメソッドでは何も処理しません
 */
public function batchExecute();