    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.taglib;
    017
    018import org.opengion.fukurou.util.ToString;                                              // 6.1.1.0 (2015/01/17)
    019import org.opengion.fukurou.util.StringUtil;                                    // 7.0.5.0 (2019/09/09)
    020
    021// import static org.opengion.fukurou.util.StringUtil.nval;             // 7.0.5.0 (2019/09/09) static import をやめます。
    022
    023/**
    024 * 左右分割スクロール処理を行う、View を設定します。
    025 *
    026 * BODY部に記述された Viewタグに対して、左右分割情報を追記設定します。
    027 * Viewタグの左側には、このタグで指定された fixDisplay のカラムを columnDisplay に
    028 * 設定するとともに、このタグで指定された numberType をセットします。
    029 * (初期値は、numberType="sequence" です。)
    030 * Viewタグの右側には、fixDisplay のカラムを noDisplay のカラムに設定するとともに、
    031 * command="VIEW" , noMessage="true" , useSelectedRow="false" , numberType="delete"
    032 * をセットします。(既存の設定値があれば、それに追記されます。)
    033 *
    034 * @og.formSample
    035 * ●形式：&lt;og:splitView  fixDisplay="CLM,NAME_JA"&gt;&lt;og:view ・・・  /&gt;&lt;/og:splitView&gt;
    036 * ●body：あり(EVAL_BODY_INCLUDE:BODYをインクルードし、{&#064;XXXX} は解析しません)
    037 *
    038 * ●Tag定義：
    039 *   &lt;og:splitView
    040 *       fixDisplay          【TAG】固定するカラム名を、CSV形式(CSV形式)で設定します
    041 *       useSplit            【TAG】左右分割する場合は、trueを、分割せずに、BODYのviewタグだけ使用する場合は、false をセットします。
    042 *       caseKey             【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null)
    043 *       caseVal             【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null)
    044 *       caseNN              【TAG】指定の値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます(初期値:判定しない)
    045 *       caseNull            【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます(初期値:判定しない)
    046 *       caseIf              【TAG】指定の値が、true/TRUE文字列の場合は、このタグは使用されます(初期値:判定しない)
    047 *   &gt;   ... Body ...
    048 *   &lt;/og:splitView&gt;
    049 *
    050 * ●使用例
    051 *    &lt;og:splitView fixDisplay="CLM,NAME_JA"&gt;
    052 *      &lt;og:view
    053 *          viewFormType    = "HTMLTable"
    054 *          command         = "{&#064;command}"
    055 *          checked         = "{&#064;checked}"
    056 *          startNo         = "{&#064;startNo}"
    057 *          pageSize        = "{&#064;pageSize}"
    058 *          noWritable      = "{&#064;noWritable}"
    059 *          columnWritable  = "{&#064;columnWritable}"
    060 *      /&gt;
    061 *    &lt;/og:splitView&gt;
    062 *
    063 * @og.rev 5.3.0.0 (2010/12/01) 新規作成
    064 * @og.group 画面部品
    065 *
    066 * @version  4.0
    067 * @author       Kazuhiko Hasegawa
    068 * @since    JDK5.0,
    069 */
    070public class SplitViewTag extends CommonTagSupport {
    071        /** このプログラムのVERSION文字列を設定します。   {@value} */
    072        private static final String VERSION = "7.0.5.0 (2019/09/09)" ;
    073        private static final long serialVersionUID = 705020190909L ;
    074
    075        private static final String SPLIT_A =
    076                                // 8.1.0.0 (2021/12/28) HTML5 準拠に見直し(type="text/css" 不要)
    077//                                "<style type=\"text/css\">#GantBody div tr { height:22px; }</style>"                          + CR
    078                                  "<style>#GantBody div tr { height:22px; }</style>"                                                            + CR
    079                                + "<table id=\"GantBody\" border=\"0px\" cellpadding=\"0px\" cellspacing=\"0px\""       + CR
    080                                + "       frame=\"box\" rules=\"all\" style=\"margin:0px;padding:0px;\">"                       + CR
    081                                + "  <tr style=\"margin:0px;padding:0px;\">"                                                                            + CR
    082                                + "    <td valign=\"top\" style=\"margin:0px; padding:0px;\" >"                                         + CR
    083                                + "      <div id=\"X1\" style=\"overflow-x:hidden; overflow-y:hidden;\" >"                      + CR ;
    084
    085        private static final String SPLIT_B =
    086                                  "      </div>"                                                                                                        + CR
    087                                + "    </td>"                                                                                                           + CR
    088                                + "    <td valign=\"top\" style=\"margin:0px; padding:0px;\">"          + CR
    089                                + "      <div id=\"X2\" style=\"position:absolute; overflow-x:hidden; overflow-y:hidden;\" >" + CR ;
    090
    091        private static final String SPLIT_C =
    092                                  "       </div>"               + CR
    093                                + "    </td>"                   + CR
    094                                + "  </tr>"                             + CR
    095                                + "</table>"                    + CR ;
    096
    097        private String  fixDisplay              ;
    098        private boolean useSplit                = true;         // 左右分割のON/OFFﾌﾗｸﾞ
    099
    100        private boolean firstStepFlag   = true;         // BODY部の view 処理の制御
    101
    102        /**
    103         * デフォルトコンストラクター
    104         *
    105         * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
    106         */
    107        public SplitViewTag() { super(); }              // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。
    108
    109        /**
    110         * Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
    111         *
    112         * @og.rev 6.9.5.0 (2018/04/23) 左右分割に、使用をON/OFFするﾌﾗｸﾞを追加
    113         *
    114         * @return      後続処理の指示( EVAL_BODY_INCLUDE )
    115         */
    116        @Override
    117        public int doStartTag() {
    118                // 6.9.5.0 (2018/04/23) 左右分割に、使用をON/OFFするﾌﾗｸﾞを追加
    119                if( useTag() ) {
    120                        if( useSplit ) {
    121                                firstStepFlag = true;
    122                                // EVAL_BODY_BUFFERED ではなく、Viewなので、INCLUDE 処理します。
    123                                jspPrint( SPLIT_A );
    124                        }
    125                        return EVAL_BODY_INCLUDE ;              // Body インクルード( extends TagSupport 時)
    126                }
    127                return SKIP_BODY ;                                      // Body を評価しない
    128
    129//              firstStepFlag = true;
    130//              // EVAL_BODY_BUFFERED ではなく、Viewなので、INCLUDE 処理します。
    131//              jspPrint( SPLIT_A );
    132//              return EVAL_BODY_INCLUDE ;                                      // Body インクルード( extends TagSupport 時)
    133        }
    134
    135        /**
    136         * Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。
    137         *
    138         * @og.rev 6.9.5.0 (2018/04/23) 左右分割に、使用をON/OFFするﾌﾗｸﾞを追加
    139         *
    140         * @return      後続処理の指示(SKIP_BODY)
    141         */
    142        @Override
    143        public int doAfterBody() {
    144                // 6.9.5.0 (2018/04/23) 左右分割に、使用をON/OFFするﾌﾗｸﾞを追加
    145                if( useSplit ) {
    146                        if( firstStepFlag ) {
    147                                firstStepFlag = false;
    148
    149                                jspPrint( SPLIT_B );
    150                                // EVAL_BODY_INCLUDE なので、コンテンツの取得ではなく、処理のみ実行されます。
    151                                return EVAL_BODY_BUFFERED ;     // ボディーを再評価( extends BodyTagSupport 時)
    152                        }
    153                        else {
    154                                jspPrint( SPLIT_C );
    155                                return SKIP_BODY ;                      // Body を評価しない
    156                        }
    157                }
    158                return SKIP_BODY ;                                      // Body を評価しない
    159
    160//              if( firstStepFlag ) {
    161//                      firstStepFlag = false;
    162//
    163//                      jspPrint( SPLIT_B );
    164//                      return EVAL_BODY_BUFFERED ;     // ボディーを再評価( extends BodyTagSupport 時)
    165//              }
    166//              else {
    167//                      jspPrint( SPLIT_C );
    168//                      return SKIP_BODY ;                      // Body を評価しない
    169//              }
    170        }
    171
    172        /**
    173         * タグリブオブジェクトをリリースします。
    174         * キャッシュされて再利用されるので、フィールドの初期設定を行います。
    175         *
    176         */
    177        @Override
    178        protected void release2() {
    179                super.release2();
    180                fixDisplay = null;
    181                useSplit   = true;
    182        }
    183
    184        /**
    185         * 【TAG】固定するカラム名を、CSV形式(CSV形式)で設定します。
    186         *
    187         * @og.tag
    188         * Viewタグの左側(固定部)には、このタグで指定された fixDisplay のカラムを
    189         * columnDisplay に設定します。
    190         * Viewタグの右側には、fixDisplay のカラムを noDisplay のカラムに設定します。
    191         * 既存の設定値(noDisplay)があれば、それに追記されます。
    192         *
    193         * @og.rev 7.0.5.0 (2019/09/09) StringUtil#nvalCsv(String,String) で、CSV形式の文字列を正規化します。
    194         *
    195         * @param   clms 固定するカラム名(CSV形式)
    196         */
    197        public void setFixDisplay( final String clms ) {
    198//              fixDisplay = nval( getRequestParameter( clms ),fixDisplay );
    199                fixDisplay = StringUtil.nvalCsv( getRequestParameter( clms ),fixDisplay );              // 7.0.5.0 (2019/09/09)
    200        }
    201
    202        /**
    203         * 固定するカラム名を、CSV形式(CSV形式)で取得します。
    204         *
    205         * これは、BODY部に記述された、viewタグからアクセスされるメソッドです。
    206         * 設定されていない場合は、null です。
    207         *
    208         * @return      固定するカラム名(CSV形式)
    209         */
    210        protected String getFixDisplay() {
    211                return fixDisplay ;
    212        }
    213
    214        /**
    215         * 【TAG】左右分割機能の ON/OFF を設定します(初期値=true:左右分割を使用する)。
    216         *
    217         * @og.tag
    218         * 左右分割する場合は、trueを、分割せずに、BODYのviewタグだけ使用する場合は、false をセットします。
    219         * BODYも含めての使用を制御する場合は、case属性(caseKey , caseVal , caseNN , caseNull , caseIf)を、
    220         * 使用してください。
    221         * 初期値は、true:左右分割を使用する です。
    222         *
    223         * @og.rev 6.9.5.0 (2018/04/23) 左右分割に、使用をON/OFFするﾌﾗｸﾞを追加
    224         * @og.rev 7.0.5.0 (2019/09/09) static import をやめます。
    225         *
    226         * @param   flag 左右分割機能の ON/OFF [true:左右分割/false:BODYのみ表示]
    227         */
    228        public void setUseSplit( final String flag ) {
    229//              useSplit = nval( getRequestParameter( flag ),useSplit );
    230                useSplit = StringUtil.nval( getRequestParameter( flag ),useSplit );             // 7.0.5.0 (2019/09/09) static import をやめます。
    231        }
    232
    233        /**
    234         * 左右分割機能の ON/OFF を取得します。
    235         *
    236         * 左右分割する場合は、trueを、分割せずに、BODYのviewタグだけ使用する場合は、false がセットされています。
    237         * これは、BODY部に記述された、viewタグからアクセスされるメソッドです。
    238         * falseの場合は、viewタグで、左右分割処理を行わないようにします。
    239         *
    240         * @og.rev 6.9.5.0 (2018/04/23) 左右分割に、使用をON/OFFするﾌﾗｸﾞを追加
    241         *
    242         * @return      左右分割機能の ON/OFF[true:左右分割/false:BODYのみ表示]
    243         */
    244        protected boolean isUseSplit() {
    245                return useSplit ;
    246        }
    247
    248        /**
    249         * BODY部の view 処理の制御を行うためのフラグを返します。
    250         *
    251         * 左右分割を行うには、Viewタグを２回出力する必要があります。
    252         * ここでは isFirstStep="true" が１回目(左側:固定部)で、false が
    253         * 右側(可変部)になるように、View側で制御します。
    254         *
    255         * @return      BODY部の view 処理の制御(true:１回目 / false:２回目)
    256         */
    257        protected boolean isFirstStep() {
    258                return firstStepFlag ;
    259        }
    260
    261        /**
    262         * このオブジェクトの文字列表現を返します。
    263         * 基本的にデバッグ目的に使用します。
    264         *
    265         * @return このクラスの文字列表現
    266         * @og.rtnNotNull
    267         */
    268        @Override
    269        public String toString() {
    270                return ToString.title( this.getClass().getName() )
    271                                .println( "VERSION"                     ,VERSION        )
    272                                .println( "fixDisplay"          ,fixDisplay     )
    273                                .println( "Other..."    ,getAttributes().getAttribute() )
    274                                .fixForm().toString() ;
    275        }
    276}