    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.resource;
    017
    018/**
    019 * カレンダＤＢを検索する為の クエリインターフェースです。
    020 *
    021 * カレンダデータは、ＤＢまたは標準のカレンダより休日を求めることができます。
    022 *
    023 * @og.rev 3.6.0.0 (2004/09/17) 新規作成
    024 * @og.group リソース管理
    025 *
    026 * @version  4.0
    027 * @author   Kazuhiko Hasegawa
    028 * @since    JDK5.0,
    029 */
    030public interface CalendarQuery {
    031
    032        /**
    033         * ４つの引数を受け取り、整合性チェックを行います。
    034         * 引数は、各クラスによって使用するカラム名(意味)が異なります。
    035         * また、すべての引数をチェックするのではなく、クラス毎に、チェックする
    036         * カラムの数は、異なります。
    037         * ※ 引数が正しくない場合は、HybsSystemException を発行します。
    038         *
    039         * @og.rev 6.9.9.3 (2018/09/25) 可変引数に変更します(PMD Rather than using a lot of String arguments, consider using a container object for those values.)。
    040         *
    041         * @param       args    データベース検索時の引数( CDJGS:事業所コード のみ)
    042//       * @param       arg1    データベース検索時の第１引数
    043//       * @param       arg2    データベース検索時の第２引数
    044//       * @param       arg3    データベース検索時の第３引数
    045//       * @param       arg4    データベース検索時の第４引数
    046         *
    047         * @return      入力パラメータに応じた配列文字列(必要分のみ配列化)
    048         */
    049//      String[] checkArgment( String arg1,String arg2,String arg3,String arg4 ) ;
    050        String[] checkArgment( final String... args );
    051
    052        /**
    053         * データベース検索の為の Select 文を返します。
    054         * 引数リストとともに、使用します。
    055         *
    056         * @return データベース検索の為の Select 文
    057         *
    058         */
    059        String getQuery() ;
    060
    061        /**
    062         * データベースの持ち方を指定します。
    063         * 持ち方がフラット(横持ち=1～31の日付をカラムで持つ)の場合、trueを返します。
    064         * 縦持ち(日付単位で、行情報として持つ)場合は、false です。
    065         *
    066         * @return DBの持ち方がフラット(横持ち=1～31の日付をカラムで持つ)の場合、true
    067         *
    068         */
    069        boolean isFlatTable() ;
    070}