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.filter;
017
018import org.opengion.fukurou.system.OgRuntimeException ;         // 6.4.2.0 (2016/01/29)
019import org.opengion.hayabusa.common.HybsSystem;
020import org.opengion.fukurou.util.StringUtil;                            // 6.3.8.0 (2015/09/11)
021
022import java.util.Locale;
023
024import java.io.File;
025import java.io.IOException;
026import java.io.UnsupportedEncodingException;
027import jakarta.servlet.ServletRequest;
028import jakarta.servlet.ServletResponse;
029import jakarta.servlet.Filter;
030import jakarta.servlet.FilterChain;
031import jakarta.servlet.FilterConfig;
032import jakarta.servlet.ServletException;
033import jakarta.servlet.http.HttpServletRequest;
034import jakarta.servlet.http.HttpServletResponse;
035
036/**
037 * Filter インターフェースを継承した HTMLデモ画面を作成するフィルタクラスです。
038 * web.xml で filter 設定することにより、使用できます。
039 * このフィルターでは、通常の画面アクセスを行うと、指定のフォルダに対して
040 * JSPをHTMLに変換した形で、ファイルをセーブしていきます。このHTMLは、
041 * デモサンプル画面として、使用できます。
042 * 出来る限り、デモ画面として使えるように、画面間リンクや、ボタン制御を
043 * JavaScript を挿入する事で実現しています。
044 *
045 * フィルターに対してweb.xml でパラメータを設定します。
046 *   ・saveDir   :ファイルをセーブするディレクトリ(初期値:filetemp/DIR/)
047 *   ・omitFiles :セーブ対象外のファイルのCSV形式での指定(初期値:eventColumnMaker.jsp,realtimecheck.jsp)
048 *
049 * パラメータがない場合は、G:/webapps/作番/filetemp/DIR/ 以下に自動設定されます。
050 * また、ディレクトリが、相対パスの場合は、G:/webapps/作番/ 以下に、絶対パスの
051 * 場合は、そのパスの下に作成されます。 *
052 *
053 * 【WEB-INF/web.xml】
054 *     <filter>
055 *         <filter-name>FileFilter</filter-name>
056 *         <filter-class>org.opengion.hayabusa.filter.FileFilter</filter-class>
057 *         <init-param>
058 *             <param-name>saveDir</param-name>
059 *             <param-value>filetemp/DIR/</param-value>
060 *         </init-param>
061 *     </filter>
062 *
063 *     <filter-mapping>
064 *         <filter-name>FileFilter</filter-name>
065 *         <url-pattern>/jsp/*</url-pattern>
066 *     </filter-mapping>
067 *
068 * @og.group フィルター処理
069 *
070 * @version  4.0
071 * @author   Kazuhiko Hasegawa
072 * @since    JDK5.0,
073 */
074public class FileFilter implements Filter {
075        private static boolean useFilter = true ;               // 6.3.8.3 (2015/10/03)
076
077        private String saveDir  ;                       // "G:/webapps/gf/filetemp/DIR/" など
078        private String omitFiles = "eventColumnMaker.jsp,realtimecheck.jsp" ;   // 6.3.8.0 (2015/09/11) セーブ対象外のファイルのCSV形式での指定(初期値:)
079
080        /**
081         * Filter インターフェースの doFilter メソッド
082         *
083         * Filter クラスの doFilter メソッドはコンテナにより呼び出され、 最後のチェーンにおける
084         * リソースへのクライアントリクエストのために、 毎回リクエスト・レスポンスのペアが、
085         * チェーンを通して渡されます。 このメソッドに渡される FilterChain を利用して、Filter が
086         * リクエストやレスポンスをチェーン内の次のエンティティ(Filter)にリクエストとレスポンスを
087         * 渡す事ができます。
088         * このメソッドの典型的な実装は以下のようなパターンとなるでしょう。
089         * 1. リクエストの検査
090         * 2. オプションとして、入力フィルタリング用にコンテンツもしくはヘッダをフィルタリング
091         *    するためにカスタム実装によるリクエストオブジェクトのラップ
092         * 3. オプションとして、出力フィルタリング用にコンテンツもしくはヘッダをフィルタリング
093         *    するためにカスタム実装によるレスポンスオブジェクトラップ
094         * 4. 以下の a)、b) のどちらか
095         *    a) FileterChain オブジェクト(chain.doFilter()) を利用してチェーンの次のエンティティを呼び出す
096         *    b) リクエスト処理を止めるために、リクエスト・レスポンスのペアをフィルタチェーンの次の
097         *       エンティティに渡さない
098         * 5. フィルタチェーンの次のエンティティの呼び出した後、直接レスポンスのヘッダをセット
099         *
100         * @og.rev 6.3.8.3 (2015/10/03) フィルターの停止処理。
101         * @og.rev 6.8.4.2 (2017/12/25) エンコード変換対応対応のキー(fileDownloadサーブレットでエンコードをON/OFF指定に利用)
102         * @og.rev 8.0.0.1 (2021/10/08) USE_STR_CONV_KEY 廃止
103         *
104         * @param       req             ServletRequestオブジェクト
105         * @param       res             ServletResponseオブジェクト
106         * @param       chain   FilterChainオブジェクト
107         * @throws IOException 入出力エラーが発生したとき
108         * @throws ServletException サーブレット関係のエラーが発生した場合、throw されます。
109         */
110        public void doFilter( final ServletRequest req,
111                                                        final ServletResponse res,
112                                                        final FilterChain chain ) throws IOException, ServletException {
113
114                if( req instanceof HttpServletRequest && res instanceof HttpServletResponse ) {
115                        final HttpServletRequest  request  = (HttpServletRequest) req;
116
117                        try {
118                                request.setCharacterEncoding( "UTF-8" );
119                        }
120                        catch( final UnsupportedEncodingException ex ) {
121                                throw new OgRuntimeException( ex );
122                        }
123
124                        final String filename = makeFileName( request );
125                        if( useFilter && filename != null ) {           // 6.3.8.3 (2015/10/03) フィルターの停止処理
126                                // 6.4.1.1 (2016/01/16) PMD refactoring. Avoid declaring a variable if it is unreferenced before a possible exit point.
127                                final HttpServletResponse response = (HttpServletResponse) res;
128                                final FileResponseWrapper wrappedResponse = new FileResponseWrapper(response,filename);
129                                chain.doFilter(req, wrappedResponse);
130                                wrappedResponse.finishResponse();
131                        }
132                        else {
133//                              // 6.8.4.2 (2017/12/25)
134//                              // 8.0.0.1 (2021/10/08) cloud対応 … USE_STR_CONV_KEY 廃止(初期値を、false と同等に変更)
135//                              req.setAttribute( HybsSystem.USE_STR_CONV_KEY , "false" );              // FileDownloadサーブレットのファイル名文字化け対応
136
137                                chain.doFilter(req, res);
138                        }
139                }
140        }
141
142        /**
143         * フィルターの初期処理メソッドです。
144         *
145         * フィルターに対してweb.xml で初期パラメータを設定します。
146         *   ・saveDir   :ファイルをセーブするディレクトリ(初期値:filetemp/DIR/)
147         *   ・omitFiles :セーブ対象外のファイルのCSV形式での指定(初期値:eventColumnMaker.jsp,realtimecheck.jsp)
148         *                ファイル名には、jsp まで含めてください。omitFiles.contains( jspID ) で判定します。
149         *
150         * @og.rev 5.7.3.2 (2014/02/28) Tomcat8 対応。getRealPath( "/" ) の互換性のための修正。
151         * @og.rev 6.2.4.1 (2015/05/22) REAL_PATH 対応。realPath は、HybsSystem経由で、取得する。
152         * @og.rev 6.3.8.0 (2015/09/11) セーブ対象外のファイルのCSV形式での指定(omitFiles属性)。
153         *
154         * @param filterConfig FilterConfigオブジェクト
155         */
156        public void init(final FilterConfig filterConfig) {
157                final String realPath = HybsSystem.getRealPath();                                       // 6.2.4.1 (2015/05/22) REAL_PATH 対応
158
159                String dir = filterConfig.getInitParameter("saveDir");
160                if( dir != null && dir.length() > 1 ) {
161                        dir = dir.replace( '\\','/' );
162                        if( dir.charAt(0) == '/' || dir.charAt(1) == ':' ) {
163                                saveDir = dir;
164                        }
165                        else {
166                                saveDir = realPath + dir ;
167                        }
168
169                        if( dir.charAt(dir.length()-1) != '/' ) {
170                                saveDir = saveDir + "/" ;
171                        }
172                }
173                else {
174                        saveDir = realPath + "filetemp/DIR/" ;
175                }
176
177                // 6.3.8.0 (2015/09/11) セーブ対象外のファイルのCSV形式での指定(omitFiles属性)。
178                omitFiles = StringUtil.nval( filterConfig.getInitParameter( "omitFiles" ) , omitFiles );
179        }
180
181        /**
182         * Filter インターフェースの destroy メソッド (何もしません)。
183         *
184         * サービス状態を終えた事を Filter に伝えるために Web コンテナが呼び出します。
185         * Filter の doFilter メソッドが終了したか、タイムアウトに達した全てのスレッドにおいて、
186         * このメソッドを一度だけ呼び出されます。 Web コンテナがこのメソッドを呼び出した後は、
187         * Filter のこのインスタンスにおいて二度と doFilter メソッドを呼び出す事はありません。
188         *
189         * このメソッドは、フィルタに保持されている(例えば、メモリ、ファイルハンドル、スレッド)
190         * 様々なリソースを開放する機会を与え、 あらゆる永続性の状態が、メモリ上における Filter
191         * の現在の状態と同期しているように注意してください。
192         */
193        public void destroy() {
194                // noop
195        }
196
197        /**
198         * フィルターの実行/停止を設定するメソッドです。
199         *
200         * 初期値は、true:実行 です。
201         *
202         * @og.rev 6.3.8.3 (2015/10/03) フィルターの停止処理。メソッド名変更、引数の意味反転。
203         *
204         * @param flag (true:実行  false:停止)
205         */
206        public static void setUseFilter( final boolean flag ) {
207                useFilter = flag;
208        }
209
210        /**
211         * フィルターの内部状態(強制停止/解除)を取得するメソッドです。
212         * これは、現在、アクセス制限がどうなっているかという状態ではなく、
213         * 強制停止されているかどうかの確認メソッドです。
214         *
215         * @og.rev 6.3.8.3 (2015/10/03) フィルターの停止処理。メソッド名変更、戻り値の意味反転。
216         *
217         * @return      (true:実行  false:停止)
218         */
219        public static boolean isUseFilter() {
220                return useFilter;
221        }
222
223        /**
224         * セーブするファイル名を、リクエスト情報より取得します。
225         *
226         * リクエストされたファイル(.jsp)を、HTMLファイル(.htm)にするだけでなく、
227         * 呼び出されたときの command を元に、ファイル名を作成します。
228         *   command="NEW"    + forward.jsp  ⇒  "forward.htm"
229         *   command="RENEW"  + forward.jsp  ⇒  "renew.htm"
230         *   command="日本語名+ forward.jsp  ⇒  "コマンド名.htm"
231         *   command="日本語名+ update.jsp   ⇒  "コマンド名.htm"
232         *   command="NEW"    + index.jsp    ⇒  "indexNW.htm"
233         *   command="RENEW"  + index.jsp    ⇒  "indexRNW.htm"
234         *   command="NEW"    + query.jsp    ⇒  "queryNW.htm"
235         *   command="NEW"    + resultXX.jsp ⇒  "forwardXX.htm"                 5.6.3.4 (2013/04/26) result.jsp にフレームを使うパターン(3ペイン)
236         *   matrixMenu対応
237         *         URI分離          URI分離           request取出
238         *      ① gamenId="jsp"  + index.jsp       + GAMENID=XXXX  ⇒ saveDir + "jsp/indexXXXX.htm"         Matrixメニューからの画面呼出し。
239         *      ② gamenId="jsp"  + result.jsp      + GAMENID=XXXX  ⇒ saveDir + "jsp/indexXXXX.htm"         画面QUERYのヘッダーメニュー
240         *      ③ gamenId="menu" + multiMenu.jsp   + group=YYYY    ⇒ saveDir + "menu/menuYYYY.htm"         通常メニューのグループ選択
241         *      ④ gamenId="menu" + matrixMenu.jsp  + group=YYYY    ⇒ saveDir + "menu/matrixMenuYYYY.htm"   Matrixメニューのグループ選択
242         *   その他             xxxx.jsp     ⇒  "xxxx.htm"
243         *
244         * このメソッドは、フィルタに保持されている(例えば、メモリ、ファイルハンドル、スレッド)
245         * 様々なリソースを開放する機会を与え、 あらゆる永続性の状態が、メモリ上における Filter
246         * の現在の状態と同期しているように注意してください。
247         *
248         * @og.rev 4.0.0.0 (2007/11/28) メソッドの戻り値をチェックします。
249         * @og.rev 4.3.3.0 (2008/10/01) Matrixメニュー対応
250         * @og.rev 5.5.2.5 (2012/05/21) update.jsp に出力されるファイルを、コマンド名.htm に出力するように機能追加
251         * @og.rev 5.6.3.4 (2013/04/26) 5.6.3.4 (2013/04/26) command="NEW" + resultXX.jsp ⇒  "forwardXX.htm"。 result.jsp にフレームを使うパターン(3ペイン)
252         * @og.rev 5.6.4.2 (2013/05/17) Matrixメニュー buttonRequest 廃止対応
253         * @og.rev 6.1.0.0 (2014/12/26) refactoring: 引数を、ServletRequest から、HttpServletRequest に変更。
254         * @og.rev 6.3.8.0 (2015/09/11) セーブ対象外のファイルのCSV形式での指定(omitFiles属性)。
255         * @og.rev 6.3.8.4 (2015/10/09) セーブフォルダを、URIではなく、画面IDから取得する。
256         * @og.rev 6.9.9.2 (2018/09/18) oota tmp add start 画面別にreportView.htmを出力する // oota tmp 02_「SAL1021_出荷_帳票リンク_新沼」対応
257         *
258         * @param request HttpServletRequestオブジェクト
259         *
260         * @return      セーブするファイル名
261         */
262        private String makeFileName( final HttpServletRequest request ) {
263                final String requestURI = request.getRequestURI();
264
265                final int index2        = requestURI.lastIndexOf( '/' );
266//              final String jspID      = requestURI.substring( index2+1 );
267                // 6.9.9.2 (2018/09/18) oota tmp add start URLの終わりが「/」の場合は、index.jspとして判定する。
268                final String jspID      = StringUtil.nval( requestURI.substring( index2+1 ) , "index.jsp" );
269                final int index1        = requestURI.lastIndexOf( '/',index2-1 );
270                String gamenId          = requestURI.substring( index1+1,index2 );
271
272                // 6.9.9.2 (2018/09/18) oota test add start jsの出力(commonディレクトリ以外のjsを出力する)
273                if( jspID != null && jspID.endsWith(".js") && requestURI.indexOf("/common/") < 0 ) {
274                        return saveDir + gamenId + "/" + jspID;                 // return file;
275                }
276
277                String file = null;
278
279                if( jspID != null && jspID.endsWith( ".jsp" ) ) {
280                        if( omitFiles.contains( jspID ) ) { return file; }              // 6.3.8.0 (2015/09/11) return null;
281
282                        final String cmd = request.getParameter( "command" );
283                        if( cmd != null && jspID.equals( "forward.jsp" ) ) {
284                                if( "NEW".equals( cmd ) ) { file = "forward.htm"; }
285                                else if( "RENEW".equals( cmd ) || "REVIEW".equals( cmd ) ) { file = "renew.htm"; }
286                                else {
287                                        final String xferVal = request.getParameter( HybsSystem.NO_XFER_KEY + cmd );
288                                        // 5.5.2.5 (2012/05/21) update.jsp に出力されるファイルを、コマンド名.htm に出力するように機能追加
289                                        if( "update.jsp".equals( xferVal ) ) {
290                                                file = cmd + ".htm" ;
291                                        }
292                                        else if( xferVal != null && xferVal.endsWith( "jsp" ) ) {
293                                                file = xferVal.toLowerCase(Locale.JAPAN).replace( "jsp","htm" );
294                                        }
295                                        else {
296                                                final String xferCmd = request.getParameter( HybsSystem.NO_XFER_KEY + cmd + "CMD" );
297                                                // 6.4.1.1 (2016/01/16) PMD refactoring. Avoid if (x != y) ..; else ..;
298                                                file = xferCmd == null
299                                                                        ? cmd.toLowerCase(Locale.JAPAN) + ".htm"
300                                                                        : xferCmd.toLowerCase(Locale.JAPAN) + ".htm";
301                                        }
302                                }
303                        }
304                        else if( "index.jsp".equals( jspID ) && ( "RENEW".equals( cmd ) || "REVIEW".equals( cmd ) ) ) {
305                                file = "indexRNW.htm";
306                        }
307                        else if( "index.jsp".equals( jspID ) && "NEW".equals( cmd ) ) {
308                                file = "indexNW.htm";
309                        }
310                        else if( "query.jsp".equals( jspID ) && "NEW".equals( cmd ) ) {
311                                file = "queryNW.htm";
312                        }
313                        // 5.6.3.4 (2013/04/26) command="NEW" + resultXX.jsp ⇒  "forwardXX.htm"。 result.jsp にフレームを使うパターン(3ペイン)
314                        else if( jspID.startsWith( "result" ) && "NEW".equals( cmd ) ) {
315                                file = "forward" + jspID.substring( 6,jspID.length()-4 ) + ".htm" ;
316                        }
317                        // 5.6.4.2 (2013/05/17) fileDownload.jsp の対応
318                        else if( "fileDownload.jsp".equals( jspID ) ) {
319                                gamenId = request.getParameter( "GAMENID" );    // gamenId(元はフォルダを抽出)をリクエスト変数から取得する。
320                                // 6.4.2.1 (2016/02/05) PMD refactoring.
321                                // 日本語ファイル名で抽出する場合。ただし、セーブ時は、UnicodeLittle なので、"fileDownload:" でマーカーする。
322                                file = "fileDownload:" + request.getParameter( "filename" );
323                        }
324                        else {
325                                file = jspID.substring( 0,jspID.length()-4 ) + ".htm" ;
326                        }
327
328                        // 6.9.9.2 (2018/09/18) oota tmp add start 画面別にreportView.htmを出力する // oota tmp 02_「SAL1021_出荷_帳票リンク_新沼」対応
329                        if( "reportView.jsp".equals( jspID ) ) {
330                                gamenId = request.getParameter( "PGPSET" ); // reportView.jspには「PGPSET」に画面IDを渡しているので、取得できるはず。
331                        }
332
333                        // 5.6.4.2 (2013/05/17) Matrixメニュー 対応
334                        //    URI分離          URI分離           request取出
335                        // ① gamenId="jsp"  + index.jsp       + GAMENID=XXXX  ⇒ saveDir + "jsp/indexXXXX.htm"         Matrixメニューからの画面呼出し。
336                        // ② gamenId="jsp"  + result.jsp      + GAMENID=XXXX  ⇒ saveDir + "jsp/indexXXXX.htm"         画面QUERYのヘッダーメニュー
337                        // ③ gamenId="menu" + multiMenu.jsp   + group=YYYY    ⇒ saveDir + "menu/menuYYYY.htm"         通常メニューのグループ選択
338                        // ④ gamenId="menu" + matrixMenu.jsp  + group=YYYY    ⇒ saveDir + "menu/matrixMenuYYYY.htm"   Matrixメニューのグループ選択
339                        final String guiKey = request.getParameter( "GAMENID" );
340                        final String group  = request.getParameter( "group" );
341
342                        if( "jsp".equals( gamenId ) && guiKey != null ) {
343                                if( "index.jsp".equals( jspID ) || "result.jsp".equals( jspID ) ) {
344                                        file = "jsp/index" + guiKey + ".htm";                           // ①,②
345                                }
346                        }
347                        else if( group != null ) {
348                                if( "multiMenu.jsp".equals( jspID ) ) {
349                                        file = gamenId + "/menu" + group + ".htm";                      // ③
350                                }
351                                else if( "matrixMenu.jsp".equals( jspID ) ) {
352                                        file = gamenId + "/matrixMenu" + group + ".htm";        // ④
353                                }
354                                gamenId = "jsp" ;                       // トリッキー
355                        }
356
357                        if( "jsp".equals( gamenId ) ) { file = saveDir + file; }
358                        // 6.3.8.4 (2015/10/09) セーブフォルダを、URIではなく、画面IDから取得する。
359                        // 6.4.1.1 (2016/01/16) PMD refactoring. Avoid if (x != y) ..; else ..;
360                        else if( guiKey == null ) {             file = saveDir + gamenId + "/" + file; }
361                        else {                                                  file = saveDir + guiKey  + "/" + file; }
362
363                        final File fl = new File( file ).getParentFile();
364                        if( fl != null && !fl.exists() && !fl.mkdirs() ) {
365                                final String errMsg = "所定のフォルダが作成できませんでした。[" + fl + "]" ;
366                                throw new OgRuntimeException( errMsg );
367                        }
368                }
369                return file;
370        }
371}