    001/*
    002 * Copyright (c) 2009 The openGion Project.
    003 *
    004 * Licensed under the Apache License, Version 2.0 (the "License");
    005 * you may not use this file except in compliance with the License.
    006 * You may obtain a copy of the License at
    007 *
    008 *     http://www.apache.org/licenses/LICENSE-2.0
    009 *
    010 * Unless required by applicable law or agreed to in writing, software
    011 * distributed under the License is distributed on an "AS IS" BASIS,
    012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
    013 * either express or implied. See the License for the specific language
    014 * governing permissions and limitations under the License.
    015 */
    016package org.opengion.hayabusa.common;
    017
    018import org.opengion.fukurou.system.OgRuntimeException ;         // 6.4.2.0 (2016/01/29)
    019
    020/**
    021 * 有効件数が オーバーフローした場合に 発生させる RuntimeException のサブクラスです。
    022 *
    023 * RuntimeException を継承しているため、try{} catch() {} は不要です。
    024 * SAXパーサーなどのイベントモデルで、途中打ち切りを行うには、SAXException を発生させて、
    025 * それを catch する構造が一般的(http://www.ibm.com/developerworks/jp/xml/library/x-tipsaxstop/)
    026 * ですが、本来のエラーと区別したいのと、SAX以外の汎用的に使いたいため、HybsOverflowException を
    027 * 用意しました。
    028 *
    029 * 内部処理は、コメントを発生させるだけです。
    030 * コンストラクタとして、オーバーした件数を取るのと、メッセージを渡せるのと、
    031 * ２種類しか用意していません。
    032 *
    033 * @og.group エラー処理
    034 * @og.rev 6.2.0.0 (2015/02/27) 新規追加
    035 * @og.rev 6.2.2.0 (2015/03/27) fukurou.model → hayabusa.common へ、移植
    036 * @og.rev 6.4.2.0 (2016/01/29) 継承元を、RuntimeException ではなく、OgRuntimeException に変更。
    037 *
    038 * @version  6.0
    039 * @author   Kazuhiko Hasegawa
    040 * @since    JDK4.0,
    041 */
    042public class HybsOverflowException extends OgRuntimeException {
    043        private static final long serialVersionUID = 642020160129L ;
    044
    045        /**
    046         * 有効件数が オーバーフローした場合に 発生させる RuntimeException のサブクラス
    047         *
    048         * 引数に、有効件数(=制限件数)を取り、独自にエラーメッセージを作成します。
    049         * 基本的には、このメッセージは、引数のまま、文字列にして投げるだけです。
    050         *
    051         * @og.rev 6.2.0.0 (2015/02/27) オーバーフロー時に起動する RuntimeException
    052         */
    053        public HybsOverflowException() { super(); }             // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。
    054
    055        /**
    056         * 有効件数が オーバーフローした場合に 発生させる RuntimeException のサブクラス
    057         *
    058         * 引数に、有効件数(=制限件数)を取り、独自にエラーメッセージを作成します。
    059         * 『指定の制限件数( XX 件)を超えました。』
    060         *
    061         * @og.rev 6.2.0.0 (2015/02/27) オーバーフロー時に起動する RuntimeException
    062         * @og.rev 6.4.1.2 (2016/01/22) メッセージを追加します。
    063         *
    064         * @param       rowCnt  件数
    065         */
    066        public HybsOverflowException( final int rowCnt ) {
    067                super( "指定の制限件数( " + rowCnt + ")を超えました。" );
    068        }
    069
    070        /**
    071         * オーバーフロー時に起動する RuntimeException のサブクラス
    072         *
    073         * 引数に、独自のエラーメッセージを渡します。
    074         * 基本的には、このメッセージは、引数のまま、投げるだけです。
    075         *
    076         * @og.rev 6.2.0.0 (2015/02/27) オーバーフロー時に起動する RuntimeException
    077         *
    078         * @param       str     詳細メッセージ
    079         */
    080        public HybsOverflowException( final String str ) {
    081                super( str );
    082        }
    083}