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     */
016    package org.opengion.hayabusa.servlet;
017    
018    import org.opengion.hayabusa.common.HybsSystem;
019    import org.opengion.hayabusa.servlet.multipart.MultipartParser;
020    import org.opengion.hayabusa.servlet.multipart.Part;
021    import org.opengion.hayabusa.servlet.multipart.FilePart;
022    import org.opengion.hayabusa.servlet.multipart.ParamPart;
023    // import org.opengion.fukurou.util.ZipArchive;                         // 5.7.1.2 (2013/12/20) zip 対å¿?
024    
025    import java.io.File;
026    import java.io.IOException;
027    import java.util.Map;
028    // import java.util.HashMap;
029    import java.util.TreeMap;
030    import java.util.List;
031    import java.util.ArrayList;
032    import java.util.Set;
033    import java.util.Random ;
034    import java.util.concurrent.atomic.AtomicInteger;       // 5.5.2.6 (2012/05/25) findbugs対å¿?
035    import javax.servlet.http.HttpServletRequest;
036    
037    /**
038     * ファイルをサーバã?にアãƒ??ロードするå?合に使用されるã?ルチパートå?ç�?‚µーブレãƒ?ƒˆですã?
039     *
040     * 通常のファイルアãƒ??ロード時の、form で使用する、enctype="multipart/form-data"
041     * を指定したå?合ã?、他ã?リクエスト情報もã?取り出すことが可能ですã?
042     *
043     * ファイルをアãƒ??ロード後に、指定ã?ファイル名に変更する機è?がありますã?
044     * file 登録ãƒ?‚¤アログでæŒ?®šしã�?name にã€?_NEW" とã�?�†名称を付けたリクエストå?ã‚?
045     * ファイルのアãƒ??ロードと同時に送信することで、この名前にファイルを付け替えますã?
046     * またã?アãƒ??ロード後ã?ファイル名ã?、name æŒ?®šã?名称で、取りå?せますã?
047     * クライアントから登録したオリジナルのファイル名ã?、name にã€?_ORG" とã�?�†名称
048     * で取り出すことが可能ですã?
049     *
050     * maxPostSize : æœ?¤§転送サイズ(Byte)を指定しますã? 0,またã?マイナスで無制限ですã?
051     * useBackup   : ファイルアãƒ??ロード時に、すでに同名のファイルが存在した場合にã€?
052     *               バックアãƒ??処ç�?renameTo)するかどã�?�‹[true/false]を指定しまã�?初期値:false)
053     *
054     * ファイルアãƒ??ロード時に、アãƒ??ロードå?に、同名ã?ファイルが存在した場合ã?、既存機è?は、そのまま
055     * 置き換えてã�?�¾したがã?簡易バージョンアãƒ??機è?として、useBackup="true" を指定すると、既存ã?ファイルã‚?
056     * リネã?ãƒ?�—て、バãƒ?‚¯アãƒ??ファイルを作æ?しますã?
057     * バックアãƒ??ファイルは、アãƒ??ロードフォルãƒ?‚’基準として、_backup/ファイルå�?拡張子_処ç�?™‚刻のlong値.拡張å­?になりますã?
058     * オリジナルのファイル名(拡張子付)を残したままã€?_処ç�?™‚刻のlong値" を追åŠ?�—、さらに、オリジナルの拡張子を追åŠ?�—ますã?
059     * バックアãƒ??ファイルの形式ã?æŒ?®šできませんã€?
060     *
061     * 5.7.1.2 (2013/12/20) zip 対å¿?
062     * filename 属æ?にã€?.zip" の拡張子ã?ファイル名をæŒ?®šしたå?合ã?、アãƒ??ロードされたä¸??のファイルã‚?
063     * ZIP圧縮しますã?これは、アãƒ??ロード後ã?処ç�?�«なりますã?
064     * ZIP圧縮のオリジナルファイルは、そのまま残りますã?
065     * なおã?ZIPファイルは、useBackup属æ?ã‚?true に設定してもã?無関係に、上書きされますã?
066     *
067     * @og.group そã?他機è?
068     *
069     * @version  4.0
070     * @author       Kazuhiko Hasegawa
071     * @since    JDK5.0,
072     */
073    public final class MultipartRequest {
074    //      private static volatile int dumyNewFileCnt = 1 ;        // 3.8.1.4 (2006/03/17)
075            private static AtomicInteger dumyNewFileCnt = new AtomicInteger(1);             // 5.5.2.6 (2012/05/25) findbugs対å¿?
076    
077            private static String RANDOM_KEY = new Random().nextInt( Integer.MAX_VALUE ) + "_" ;            // 5.6.5.3 (2013/06/28) アãƒ??ロード時のãƒ?ƒŸーファイル名をもう少しã�?�‘ランãƒ?ƒ にするã€?
078    
079    //      private final Map<String,List<String>> parameters   = new HashMap<String,List<String>>();
080    //      private final Map<String,UploadedFile> files              = new HashMap<String,UploadedFile>();
081            private final Map<String,List<String>> parameters   = new TreeMap<String,List<String>>();               // 5.6.5.2 (2013/06/21) ソートしますã?
082    
083            // 5.7.1.1 (2013/12/13) HTML5 ファイルアãƒ??ロードã?è¤?•°選択ï¼?ultiple?‰対å¿?
084    //      private final Map<String,UploadedFile> files              = new TreeMap<String,UploadedFile>();             // 5.6.5.2 (2013/06/21) ソートしますã?
085            private final List<UploadedFile> files                            = new ArrayList<UploadedFile>();                  // 5.7.1.1 (2013/12/13) HTML5対å¿?
086    
087            /**
088             * MultipartRequest オブジェクトを構築しますã?
089             *
090             * 引数として、ファイルアãƒ??ロード時の保存フォルãƒ??æœ?¤§サイズ、エンコードã?
091             * 新しいファイル名などを指定できますã?新しいファイル名ã?、アãƒ??ロードされる
092             * ファイルがä¸?�¤ã�?�‘の場合に使用できますã?è¤?•°のファイルを同時に変更したã�?
093             * 場合ã?、アãƒ??ロードルールにのっとりã?リクエストパラメータでæŒ?®šしてくださいã€?
094             *
095             * HTML5 では、ファイルアãƒ??ロード時に、multiple 属æ???nputタグのtype="file"?‰を
096             * 付ける事で、ファイルをè¤?•°選択できますã?
097             * そã?場合ã?、inputのname属æ?は、ä¸?�¤なので、_NEW による名前の書き換えã?できませんã€?
098             *
099             * @og.rev 3.8.1.3A (2006/01/30) 新ファイル名にオリジナルファイル名ã?拡張子をセãƒ?ƒˆしまã�?
100             * @og.rev 4.0.0.0 (2007/11/28) メソãƒ?ƒ‰の戻りå?をチェãƒ?‚¯しますã?
101             * @og.rev 5.5.2.6 (2012/05/25) findbugs対応ã?staticフィールドへの書き込みに、AtomicInteger を利用しますã?
102             * @og.rev 5.6.5.3 (2013/06/28) useBackup引数追åŠ?
103             * @og.rev 5.7.1.1 (2013/12/13) HTML5 ファイルアãƒ??ロードã?è¤?•°選択ï¼?ultiple?‰対å¿?
104             * @og.rev 5.7.1.2 (2013/12/20) zip 対å¿?
105             *
106             * @param       request HttpServletRequestオブジェクãƒ?
107             * @param       saveDirectory   ファイルアãƒ??ロードがあったå?合ã?保存フォルãƒ?��
108             * @param       maxPostSize     ファイルアãƒ??ロード時のæœ?¤§ファイルサイズ(Byte)0,またã?マイナスで無制é™?
109             * @param       encoding        ファイルのエンコーãƒ?
110             * @param       inputFilename   アãƒ??ロードされたファイルの新しい名前
111             * @param       useBackup               ファイルアãƒ??ロード時に、バãƒ?‚¯アãƒ??処ç�?�™るかどã�?�‹[true/false]を指å®?
112             * @throws IOException 入出力エラーが発生したとã�?
113             */
114            public MultipartRequest(final HttpServletRequest request,
115                                                            final String saveDirectory,
116                                                            final int maxPostSize,
117                                                            final String  encoding,
118    //                                                      final String  inputFilename ) throws IOException {
119                                                            final String  inputFilename,
120                                                            final boolean useBackup ) throws IOException {                  // 5.6.5.3 (2013/06/28) 追åŠ?
121    
122                    if(request == null) {
123                            throw new IllegalArgumentException("request cannot be null");
124                    }
125                    if(saveDirectory == null) {
126                            throw new IllegalArgumentException("saveDirectory cannot be null");
127                    }
128                    // 5.5.2.6 (2012/05/25) 0,またã?マイナスで無制é™?
129    //              if(maxPostSize <= 0) {
130    //                      throw new IllegalArgumentException("maxPostSize must be positive");
131    //              }
132    
133                    // Save the dir
134                    File dir = new File(saveDirectory);
135    
136                    // Check saveDirectory is truly a directory
137                    if(!dir.isDirectory()) {
138                            throw new IllegalArgumentException("Not a directory: " + saveDirectory);
139                    }
140    
141                    // Check saveDirectory is writable
142                    if(!dir.canWrite()) {
143                            throw new IllegalArgumentException("Not writable: " + saveDirectory);
144                    }
145    
146                    // Parse the incoming multipart, storing files in the dir provided,
147                    // and populate the meta objects which describe what we found
148                    MultipartParser parser = new MultipartParser(request, maxPostSize);
149                    if(encoding != null) {
150                            parser.setEncoding(encoding);
151                    }
152    
153                    // 5.7.1.1 (2013/12/13) HTML5 ファイルアãƒ??ロードã?è¤?•°選択ï¼?ultiple?‰対å¿?
154    //              List<String> list = new ArrayList<String>();
155    
156                    Part part;
157                    while ((part = parser.readNextPart()) != null) {
158                            String name = part.getName();
159                            if( part.isParam() && part instanceof ParamPart ) {
160                                    ParamPart paramPart = (ParamPart)part;
161                                    String value = paramPart.getStringValue();
162                                    List<String> existingValues = parameters.get(name);
163                                    if(existingValues == null) {
164                                            existingValues = new ArrayList<String>();
165                                            parameters.put(name, existingValues);
166                                    }
167                                    existingValues.add(value);
168                            }
169                            else if( part.isFile() && part instanceof FilePart ) {
170                                    FilePart filePart = (FilePart)part;
171    //                              String fileName = filePart.getFilename();
172                                    String orgName = filePart.getFilename();                // 5.7.1.1 (2013/12/13) 判りやすいように変数名変更
173    //                              if(fileName != null) {
174                                    if(orgName != null) {
175                                            // 5.7.1.1 (2013/12/13) HTML5 ファイルアãƒ??ロードã?è¤?•°選択ï¼?ultiple?‰対å¿?
176                                            // 同ä¸?name で、è¤?•°ファイルを扱ã�?¿?¦�がありますã?
177    //                                      list.add( name );               // 3.5.6.5 (2004/08/09) æŒ?®šã? name 属æ?
178                                            // 3.8.1.2 (2005/12/19) 仮ファイルでセーブするã?
179    //                                      String newName = String.valueOf( dumyNewFileCnt++ ) ;   // 3.8.1.4 (2006/03/17)
180    //                                      String newName = String.valueOf( dumyNewFileCnt.getAndIncrement() ) ;   // 5.5.2.6 (2012/05/25) findbugs対å¿?
181                                            String uniqKey = RANDOM_KEY + dumyNewFileCnt.getAndIncrement() ;                // 5.6.5.3 (2013/06/28) アãƒ??ロード時のãƒ?ƒŸーファイル名をもう少しã�?�‘ランãƒ?ƒ にするã€?
182    //                                      filePart.setFilename( newName );                        // 5.6.5.3 (2013/06/28) newName はã‚?‚„こしã�??で、変更
183                                            filePart.setFilename( uniqKey );
184                                            filePart.writeTo(dir);
185    
186                                            // 5.7.1.1 (2013/12/13) HTML5 ファイルアãƒ??ロードã?è¤?•°選択ï¼?ultiple?‰対å¿?
187                                            files.add( new UploadedFile(
188                                                                                            uniqKey,                // 5.7.1.1 (2013/12/13) é ?•ª変更
189                                                                                            dir.toString(),
190                                                                                            name,                   // 5.7.1.1 (2013/12/13) é ?›®追åŠ?
191    //                                                                                      fileName,
192                                                                                            orgName,
193                                                                                            filePart.getContentType()));
194    
195    //                                      files.put(name,
196    //                                                        new UploadedFile( dir.toString(),
197    ////                                                                                            newName,        // 3.8.1.2 (2005/12/19)
198    //                                                                                              tempName,               // 3.8.1.2 (2005/12/19)
199    //                                                                                              fileName,
200    //                                                                                              filePart.getContentType()));
201                                    }
202    //                              else {
203    //                                      files.put(name, new UploadedFile(null, null, null, null));
204    //                              }
205                            }
206                            else {
207                                    String errMsg = "Partオブジェクトが、ParamPartでã‚?ilePartでもありませんã€?
208                                                            + " class=[" + part.getClass() + "]";
209                                    throw new RuntimeException( errMsg );
210                            }
211                    }
212    
213                    // 3.5.6.5 (2004/08/09) 登録後にファイルをリネã?ãƒ?�—ますã?
214                    // 5.7.1.1 (2013/12/13) HTML5 ファイルアãƒ??ロードã?è¤?•°選択ï¼?ultiple?‰対å¿?
215    //              int size = list.size();
216                    int size = files.size();
217    
218                    // 5.7.1.2 (2013/12/20) zip 対å¿?
219                    File[] tgtFiles = new File[size];
220                    boolean isZip = ( inputFilename != null && inputFilename.endsWith( ".zip" ) );
221    
222                    for( int i=0; i<size; i++ ) {
223    //                      String name = list.get(i);
224    //                      File file = getFile( name );
225                            UploadedFile upFile = files.get(i);
226                            String name = upFile.getName();         // 5.7.1.1 (2013/12/13)
227    
228                            String newName = (isZip) ? null : inputFilename ;
229                            if( newName == null && name != null ) {
230                                    int adrs = name.lastIndexOf( HybsSystem.JOINT_STRING ); // カラãƒ?_行番号 の __ の位置
231                                    if( adrs < 0 ) {
232                                            newName = getParameter( name + "_NEW" );
233                                    }
234                                    else {
235                                            newName = getParameter( name.substring( 0,adrs ) + "_NEW" + name.substring( adrs ) );
236                                    }
237                            }
238    
239                            // 5.7.1.1 (2013/12/13) UploadedFile å†?�§処ç�?�™るよã�?�«変更
240                            tgtFiles[i] = upFile.renameTo( newName,useBackup );
241    
242    //                      // 3.8.1.3 (2006/02/06) 新ファイル名に拡張子がなã�?�¨ã�?
243    //                      // 旧ファイル名から拡張子取得し新ファイル名にæ–?­—å?連çµ?
244    //                      if( newName != null && newName.length() > 0 ) {
245    //                              // 新ファイル名から拡張子取å¾?
246    //                              String newExt = getExtension( newName );
247    //                              if( newExt == null || newExt.length() == 0 ) {
248    ////                                    String oldExt = getExtension( getOriginalFileName( name ) );            // 5.7.1.1 (2013/12/13)
249    //                                      String oldExt = getExtension( upFile.getOriginalFileName() );
250    ////                                    newName = new StringBuilder().append( newName ).append( "." ).append( oldExt ).toString();
251    //                                      newName = newName + "." + oldExt ;
252    //                              }
253    //                      }
254    //                      else {
255    ////                            newName = getOriginalFileName( name );          // 5.7.1.1 (2013/12/13)
256    //                              newName = upFile.getOriginalFileName();
257    //                      }
258    //
259    //                      // 3.8.1.2 (2005/12/19) 基本çš?�«はすべてのケースでファイル名変更が発生するã?
260    //                      File file = upFile.getFile();           // 5.7.1.1 (2013/12/13)
261    //                      if( file != null && newName != null && newName.length() > 0 ) {
262    //                              File newFile = new File( dir,newName );
263    //
264    //                              // 5.6.5.3 (2013/06/28) useBackup ファイルアãƒ??ロード時に、バãƒ?‚¯アãƒ??処ç�?�™るかどã�?�‹[true/false]を指å®?
265    ////                            if( newFile.exists() && !newFile.delete() ) {
266    ////                                    String errMsg = "既存ã?ファイル[" + newName + "]が削除できませんでしたã€?;
267    ////                                    throw new RuntimeException( errMsg );
268    ////                            }
269    //                              if( newFile.exists() ) {
270    //                                      if( useBackup ) {
271    //                                              // newName にフォルãƒ?šŽ層を含ã‚??合に、そなえてã€?
272    //                                              File parent = newFile.getParentFile();                  // バックアãƒ??すべきファイルのフォルãƒ?
273    //                                              File backup = new File( parent , "_backup" );   // そã?直下にã€?_backup" フォルãƒ?‚’作æ?
274    //                                              if( backup != null && !backup.exists() && !backup.mkdirs() ) {
275    //                                                      String errMsg = "バックアãƒ??処ç�?�§backupフォルãƒ??作æ?に失敗しましたã€?" + backup + "]";
276    //                                                      throw new RuntimeException( errMsg );
277    //                                              }
278    //                                              // バックアãƒ??ファイル名ã?、å?のファイルå�?拡張子含ã‚? ??"_" + 現在時刻のlong値 + "." + å…??ファイルの拡張å­?
279    //                                              String bkupName = newFile.getName() + "_" + System.currentTimeMillis() + "."  + getExtension( newName ) ;
280    //                                              File fromFile = new File( dir,newName );                // オリジナルの newFile をrename するとまずいので、同名ã?Fileオブジェクトを作æ?
281    //                                              File bkupFile = new File( backup,bkupName );
282    //
283    //                                              if( !fromFile.renameTo( bkupFile ) ) {
284    //                                                      String errMsg = "バックアãƒ??処ç�?�§バックアãƒ??ファイルをリネã?ãƒ?�§きませんでしたã€?" + bkupFile + "]" ;
285    //                                                      throw new RuntimeException( errMsg );
286    //                                              }
287    //                                      }
288    //                                      else if( !newFile.delete() ) {
289    //                                              String errMsg = "既存ã?ファイル[" + newName + "]が削除できませんでしたã€?;
290    //                                              throw new RuntimeException( errMsg );
291    //                                      }
292    //                              }
293    //
294    ////                            file.renameTo( newFile );
295    //                              if( !file.renameTo( newFile ) ) {
296    //                                      String errMsg = "æ‰?®šã?ファイルをリネã?ãƒ?�§きませんでしたã€?" + file + "]" ;
297    //                                      throw new RuntimeException( errMsg );
298    //                              }
299    ////                            UploadedFile fup = files.get( name );
300    ////                            fup.setFilesystemName( newName );
301    //                              upFile.setFilesystemName( newName );
302    //                      }
303                    }
304                    // 5.7.1.2 (2013/12/20) zip 対å¿?
305            //  ä¸?—¦保留にしますã?
306            //      if( isZip ) {
307            //              File zipFile = new File( saveDirectory,inputFilename );
308            //              ZipArchive.compress( zipFile,tgtFiles );
309            //      }
310            }
311    
312            /**
313             * リクエストパラメータの名前配å?を取得しますã?
314             *
315             * @return      リクエストパラメータの名前配å?
316             */
317            public String[] getParameterNames() {
318                    Set<String> keyset = parameters.keySet();
319                    return keyset.toArray( new String[keyset.size()] );
320            }
321    
322            /**
323             * ファイルアãƒ??ロードされたファイル群のファイル名é?列を取得しますã?
324             *
325             * @og.rev 5.7.1.1 (2013/12/13) HTML5 ファイルアãƒ??ロードã?è¤?•°選択ï¼?ultiple?‰対応ã?為、å»?­¢
326             *
327             * @return      アãƒ??ロードされたファイル名é?åˆ?
328             */
329    //      public String[] getFilenames() {
330    //              Set<String> keyset = files.keySet();
331    //              return keyset.toArray( new String[keyset.size()] );
332    //      }
333    
334            /**
335             * ファイルアãƒ??ロードされたファイル群のファイル配å?を取得しますã?
336             *
337             * @og.rev 5.7.1.1 (2013/12/13) HTML5 ファイルアãƒ??ロードã?è¤?•°選択ï¼?ultiple?‰対å¿?
338             *
339             * @return      アãƒ??ロードされたファイル群
340             */
341            public UploadedFile[] getUploadedFile() {
342                    return files.toArray( new UploadedFile[files.size()] );
343            }
344    
345            /**
346             * æŒ?®šã?名前のリクエストパラメータの値を取得しますã?
347             *
348             * è¤?•°存在する場合ã?、ä¸?•ªæœ?¾Œã?値を返しますã?
349             *
350             * @param       name    リクエストパラメータå�?
351             *
352             * @return      パラメータの値
353             */
354            public String getParameter( final String name ) {
355                    List<String> values = parameters.get(name);
356                    if( values == null || values.isEmpty() ) {
357                            return null;
358                    }
359                    return values.get(values.size() - 1);
360            }
361    
362            /**
363             * æŒ?®šã?名前のリクエストパラメータの値をé?列型式で取得しますã?
364             *
365             * @og.rev 5.3.2.0 (2011/02/01) 新規作æ?
366             *
367             * @param       name    リクエストパラメータå�?
368             *
369             * @return      パラメータの値配å?
370             */
371            public String[] getParameters( final String name ) {
372                    List<String> values = parameters.get(name);
373                    if( values == null || values.isEmpty() ) {
374                            return null;
375                    }
376    //              return values.toArray( new String[0] );
377                    return values.toArray( new String[values.size()] );
378            }
379    
380            /**
381             * æŒ?®šã?名前のリクエストパラメータの値をé?åˆ?int)型式で取得しますã?
382             *
383             * @og.rev 5.3.2.0 (2011/02/01) 新規作æ?
384             * @og.rev 5.3.6.0 (2011/06/01) 配å?値ã�?"の場合にNumberFormatExceptionが発生するバグを修正
385             *
386             * @param       name    リクエストパラメータå�?
387             *
388             * @return      パラメータの値配å?
389             */
390            public int[] getIntParameters( final String name ) {
391                    List<String> values = parameters.get(name);
392                    if( values == null || values.isEmpty() ) {
393                            return null;
394                    }
395    
396    //              int[] rtn = new int[values.size()];
397    //              for( int i=0; i<values.size(); i++ ) {
398    //                      rtn[i] = Integer.valueOf( values.get(i) );
399    //              }
400    
401                    // 5.3.6.0 (2011/06/01) ゼロストリング("")はint変換対象から予め除外すã‚?
402                    List<Integer> intVals = new ArrayList<Integer>();
403                    for( int i=0; i<values.size(); i++ ) {
404                            String str = values.get(i);
405                            if( str != null && str.length() > 0 ) {
406                                    intVals.add( Integer.parseInt( str ) );
407                            }
408                    }
409                    if( intVals.isEmpty() ) {
410                            return null;
411                    }
412    
413                    int[] rtn = new int[intVals.size()];
414                    for( int i=0; i<intVals.size(); i++ ) {
415                            rtn[i] = intVals.get(i).intValue();
416                    }
417    
418                    return rtn;
419            }
420    
421            /**
422             * æŒ?®šã?名前の UploadedFile オブジェクトかã‚?登録されるファイル名を取得しますã?
423             *
424             * 登録されるファイル名とは、新たに書き換えられたファイル名ã?ことですã?
425             *
426             * @og.rev 5.6.6.1 (2013/07/12) null 対ç­?
427             * @og.rev 5.7.1.1 (2013/12/13) HTML5 ファイルアãƒ??ロードã?è¤?•°選択ï¼?ultiple?‰対応ã?ためå»?­¢
428             *
429             * @param       name    キーæƒ??
430             *
431             * @return      新たに書き換えられたファイルå�?
432             */
433    //      public String getFilesystemName( final String name ) {
434    //              UploadedFile file = files.get(name);
435    ////            return file.getFilesystemName();  // may be null
436    //              return (file == null) ? null : file.getFilesystemName();  // may be null
437    //      }
438    
439            /**
440             * æŒ?®šã?名前の UploadedFile オブジェクトかã‚?アãƒ??ロードされたファイル名を取得しますã?
441             *
442             * アãƒ??ロードされたファイル名とは、オリジナルのファイル名ã?ことですã?
443             *
444             * @og.rev 5.6.6.1 (2013/07/12) null 対ç­?
445             * @og.rev 5.7.1.1 (2013/12/13) HTML5 ファイルアãƒ??ロードã?è¤?•°選択ï¼?ultiple?‰対応ã?ためå»?­¢
446             *
447             * @param       name    キーæƒ??
448             *
449             * @return      オリジナルのファイルå�?
450             */
451    //      public String getOriginalFileName( final String name ) {
452    //              UploadedFile file = files.get(name);
453    ////            return file.getOriginalFileName();  // may be null
454    //              return (file == null) ? null : file.getOriginalFileName();  // may be null
455    //      }
456    
457            /**
458             * æŒ?®šã?名前の UploadedFile オブジェクトかã‚?File オブジェクトを取得しますã?
459             *
460             * @og.rev 5.6.6.1 (2013/07/12) null 対ç­?
461             * @og.rev 5.7.1.1 (2013/12/13) HTML5 ファイルアãƒ??ロードã?è¤?•°選択ï¼?ultiple?‰対å¿?
462             *
463             * @param       name    キーæƒ??
464             *
465             * @return      Fileオブジェクãƒ?
466             */
467    //      public File getFile( final String name ) {
468    //              UploadedFile file = files.get(name);
469    ////            return file.getFile();  // may be null
470    //              return (file == null) ? null : file.getFile();  // may be null
471    //      }
472    
473            /**
474             * ファイル名かã‚?拡張子を取得しますã?
475             *
476             * @og.rev 5.7.1.1 (2013/12/13) UploadedFileクラスに移å‹?
477             *
478             * @param       fileName        ファイルå�?
479             * @return      拡張å­?
480             */
481    //      private String getExtension( final String fileName ) {
482    //              int index = fileName.lastIndexOf('.');
483    //              if(index!=-1) {
484    //                      return fileName.substring(index + 1, fileName.length());
485    //              }
486    //              return "";
487    //      }
488    }
489    
490    /**
491     * ファイルをサーバã?にアãƒ??ロードするå?合に使用されるファイル管ç�??部クラスですã?
492     *
493     * @og.group そã?他機è?
494     * @og.rev 5.7.1.1 (2013/12/13) HTML5 ファイルアãƒ??ロードã?è¤?•°選択ï¼?ultiple?‰対応ã?ため、publicåŒ?
495     *
496     * @version  4.0
497     * @author       Kazuhiko Hasegawa
498     * @since    JDK5.0,
499     */
500    //final class UploadedFile {
501    //
502    //      private String filename;
503    //      private final String name;
504    //      private final String dir;
505    //      private final String original;
506    //      private final String type;
507    //
508    //      /**
509    //       * アãƒ??ロードファイルの管ç�?‚ªブジェクトを作æ?しますã?
510    //       *
511    //       * @og.rev 5.7.1.1 (2013/12/13) HTML5 ファイルアãƒ??ロードã?è¤?•°選択ï¼?ultiple?‰対å¿?
512    //       *
513    //       * @param       dir     ファイルを保管するフォルãƒ?
514    //       * @param       name            ファイルアãƒ??ロードされた時ã?name属æ?
515    //       * @param       filename        ファイルå�?置き換えå¾?
516    //       * @param       original        ファイルå�?オリジナル)
517    //       * @param       type    コンãƒ?ƒ³トタイãƒ?
518    //       */
519    //      UploadedFile( final String dir, final String name, final String filename, final String original, final String type) {
520    //              this.dir                = dir;
521    //              this.name               = name;
522    //              this.filename   = filename;
523    //              this.original   = original;
524    //              this.type               = type;
525    //      }
526    //
527    //      /**
528    //       * ファイルアãƒ??ロードされた時ã?name属æ?を取得しますã?
529    //       *
530    //       * @og.rev 5.7.1.1 (2013/12/13) HTML5 ファイルアãƒ??ロードã?è¤?•°選択ï¼?ultiple?‰対å¿?
531    //       *
532    //       * @return      ファイルアãƒ??ロードされた時ã?name属æ?
533    //       */
534    //      public String getName() {
535    //              return name;
536    //      }
537    //
538    //      /**
539    //       * コンãƒ?ƒ³トタイプを取得しますã?
540    //       *
541    //       * @return      コンãƒ?ƒ³トタイãƒ?
542    //       */
543    //      public String getContentType() {
544    //              return type;
545    //      }
546    //
547    //      /**
548    //       * ファイルå�?置き換えå¾?を取得しますã?
549    //       *
550    //       * @return      ファイルå�?置き換えå¾?
551    //       */
552    //      public String getFilesystemName() {
553    //              return filename;
554    //      }
555    //
556    //      /**
557    //       * ファイルå�?置き換えå¾?をセãƒ?ƒˆしますã?
558    //       *
559    //       * @param       name    ファイルå�?置き換えå¾?
560    //       */
561    //      public void setFilesystemName( final String name ) {
562    //              filename = name;
563    //      }
564    //
565    //      /**
566    //       * ファイルå�?オリジナル)を取得しますã?
567    //       *
568    //       * @return      ファイルå�?オリジナル)
569    //       */
570    //      public String getOriginalFileName() {
571    //              return original;
572    //      }
573    //
574    //      /**
575    //       * ファイルå�?置き換えå¾?の File オブジェクトを取得しますã?
576    //       *
577    //       * @return File File オブジェクãƒ?
578    //       */
579    //      public File getFile() {
580    //              if(dir == null || filename == null) {
581    //                      return null;
582    //              }
583    //              else {
584    //                      return new File(dir + File.separator + filename);
585    //              }
586    //      }
587    //}