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    
024    import java.io.File;
025    import java.io.IOException;
026    import java.util.Map;
027    // import java.util.HashMap;
028    import java.util.TreeMap;
029    import java.util.List;
030    import java.util.ArrayList;
031    import java.util.Set;
032    import java.util.Random ;
033    import java.util.concurrent.atomic.AtomicInteger;       // 5.5.2.6 (2012/05/25) findbugs蟇ｾ蠢?
034    import javax.servlet.http.HttpServletRequest;
035    
036    /**
037     * 繝輔ぃ繧､繝ｫ繧偵し繝ｼ繝舌?縺ｫ繧｢繝??繝ｭ繝ｼ繝峨☆繧句?蜷医↓菴ｿ逕ｨ縺輔ｌ繧九?繝ｫ繝√ヱ繝ｼ繝亥?逅?し繝ｼ繝悶Ξ繝?ヨ縺ｧ縺吶?
038     *
039     * 騾壼ｸｸ縺ｮ繝輔ぃ繧､繝ｫ繧｢繝??繝ｭ繝ｼ繝画凾縺ｮ縲’orm 縺ｧ菴ｿ逕ｨ縺吶ｋ縲‘nctype="multipart/form-data"
040     * 繧呈欠螳壹＠縺溷?蜷医?縲∽ｻ悶?繝ｪ繧ｯ繧ｨ繧ｹ繝域ュ蝣ｱ繧ゅ?蜿悶ｊ蜃ｺ縺吶％縺ｨ縺悟庄閭ｽ縺ｧ縺吶?
041     *
042     * 繝輔ぃ繧､繝ｫ繧偵い繝??繝ｭ繝ｼ繝牙ｾ後↓縲∵欠螳壹?繝輔ぃ繧､繝ｫ蜷阪↓螟画峩縺吶ｋ讖溯?縺後≠繧翫∪縺吶?
043     * file 逋ｻ骭ｲ繝?う繧｢繝ｭ繧ｰ縺ｧ謖?ｮ壹＠縺?name 縺ｫ縲?_NEW" 縺ｨ縺?≧蜷咲ｧｰ繧剃ｻ倥￠縺溘Μ繧ｯ繧ｨ繧ｹ繝亥?繧?
044     * 繝輔ぃ繧､繝ｫ縺ｮ繧｢繝??繝ｭ繝ｼ繝峨→蜷梧凾縺ｫ騾∽ｿ｡縺吶ｋ縺薙→縺ｧ縲√％縺ｮ蜷榊燕縺ｫ繝輔ぃ繧､繝ｫ繧剃ｻ倥￠譖ｿ縺医∪縺吶?
045     * 縺ｾ縺溘?繧｢繝??繝ｭ繝ｼ繝牙ｾ後?繝輔ぃ繧､繝ｫ蜷阪?縲］ame 謖?ｮ壹?蜷咲ｧｰ縺ｧ縲∝叙繧雁?縺帙∪縺吶?
046     * 繧ｯ繝ｩ繧､繧｢繝ｳ繝医°繧臥匳骭ｲ縺励◆繧ｪ繝ｪ繧ｸ繝翫Ν縺ｮ繝輔ぃ繧､繝ｫ蜷阪?縲］ame 縺ｫ縲?_ORG" 縺ｨ縺?≧蜷咲ｧｰ
047     * 縺ｧ蜿悶ｊ蜃ｺ縺吶％縺ｨ縺悟庄閭ｽ縺ｧ縺吶?
048     *
049     * maxPostSize : 譛?､ｧ霆｢騾√し繧､繧ｺ(Byte)繧呈欠螳壹＠縺ｾ縺吶? 0,縺ｾ縺溘?繝槭う繝翫せ縺ｧ辟｡蛻ｶ髯舌〒縺吶?
050     * useBackup   : 繝輔ぃ繧､繝ｫ繧｢繝??繝ｭ繝ｼ繝画凾縺ｫ縲√☆縺ｧ縺ｫ蜷悟錐縺ｮ繝輔ぃ繧､繝ｫ縺悟ｭ伜惠縺励◆蝣ｴ蜷医↓縲?
051     *               繝舌ャ繧ｯ繧｢繝??蜃ｦ逅?renameTo)縺吶ｋ縺九←縺?°[true/false]繧呈欠螳壹＠縺ｾ縺?蛻晄悄蛟､:false)
052     *
053     * 繝輔ぃ繧､繝ｫ繧｢繝??繝ｭ繝ｼ繝画凾縺ｫ縲√い繝??繝ｭ繝ｼ繝牙?縺ｫ縲∝酔蜷阪?繝輔ぃ繧､繝ｫ縺悟ｭ伜惠縺励◆蝣ｴ蜷医?縲∵里蟄俶ｩ溯?縺ｯ縲√◎縺ｮ縺ｾ縺ｾ
054     * 鄂ｮ縺肴鋤縺医※縺?∪縺励◆縺後?邁｡譏薙ヰ繝ｼ繧ｸ繝ｧ繝ｳ繧｢繝??讖溯?縺ｨ縺励※縲「seBackup="true" 繧呈欠螳壹☆繧九→縲∵里蟄倥?繝輔ぃ繧､繝ｫ繧?
055     * 繝ｪ繝阪?繝?＠縺ｦ縲√ヰ繝?け繧｢繝??繝輔ぃ繧､繝ｫ繧剃ｽ懈?縺励∪縺吶?
056     * 繝舌ャ繧ｯ繧｢繝??繝輔ぃ繧､繝ｫ縺ｯ縲√い繝??繝ｭ繝ｼ繝峨ヵ繧ｩ繝ｫ繝?ｒ蝓ｺ貅悶→縺励※縲＼backup/繝輔ぃ繧､繝ｫ蜷?諡｡蠑ｵ蟄神蜃ｦ逅?凾蛻ｻ縺ｮlong蛟､.諡｡蠑ｵ蟄?縺ｫ縺ｪ繧翫∪縺吶?
057     * 繧ｪ繝ｪ繧ｸ繝翫Ν縺ｮ繝輔ぃ繧､繝ｫ蜷搾ｼ域僑蠑ｵ蟄蝉ｻ假ｼ峨ｒ谿九＠縺溘∪縺ｾ縲?_蜃ｦ逅?凾蛻ｻ縺ｮlong蛟､" 繧定ｿｽ蜉?＠縲√＆繧峨↓縲√が繝ｪ繧ｸ繝翫Ν縺ｮ諡｡蠑ｵ蟄舌ｒ霑ｽ蜉?＠縺ｾ縺吶?
058     * 繝舌ャ繧ｯ繧｢繝??繝輔ぃ繧､繝ｫ縺ｮ蠖｢蠑上?謖?ｮ壹〒縺阪∪縺帙ｓ縲?
059     *
060     * @og.group 縺昴?莉匁ｩ溯?
061     *
062     * @version  4.0
063     * @author       Kazuhiko Hasegawa
064     * @since    JDK5.0,
065     */
066    public final class MultipartRequest {
067    //      private static volatile int dumyNewFileCnt = 1 ;        // 3.8.1.4 (2006/03/17)
068            private static AtomicInteger dumyNewFileCnt = new AtomicInteger(1);             // 5.5.2.6 (2012/05/25) findbugs蟇ｾ蠢?
069    
070            private static String RANDOM_KEY = new Random().nextInt() + "_" ;               // 5.6.5.3 (2013/06/28) 繧｢繝??繝ｭ繝ｼ繝画凾縺ｮ繝?Α繝ｼ繝輔ぃ繧､繝ｫ蜷阪ｒ繧ゅ≧蟆代＠縺?￠繝ｩ繝ｳ繝?Β縺ｫ縺吶ｋ縲?
071    
072    //      private final Map<String,List<String>> parameters   = new HashMap<String,List<String>>();
073    //      private final Map<String,UploadedFile> files              = new HashMap<String,UploadedFile>();
074            private final Map<String,List<String>> parameters   = new TreeMap<String,List<String>>();               // 5.6.5.2 (2013/06/21) 繧ｽ繝ｼ繝医＠縺ｾ縺吶?
075            private final Map<String,UploadedFile> files              = new TreeMap<String,UploadedFile>();             // 5.6.5.2 (2013/06/21) 繧ｽ繝ｼ繝医＠縺ｾ縺吶?
076    
077            /**
078             * MultipartRequest 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ讒狗ｯ峨＠縺ｾ縺吶?
079             *
080             * 蠑墓焚縺ｨ縺励※縲√ヵ繧｡繧､繝ｫ繧｢繝??繝ｭ繝ｼ繝画凾縺ｮ菫晏ｭ倥ヵ繧ｩ繝ｫ繝??譛?､ｧ繧ｵ繧､繧ｺ縲√お繝ｳ繧ｳ繝ｼ繝峨?
081             * 譁ｰ縺励＞繝輔ぃ繧､繝ｫ蜷阪↑縺ｩ繧呈欠螳壹〒縺阪∪縺吶?譁ｰ縺励＞繝輔ぃ繧､繝ｫ蜷阪?縲√い繝??繝ｭ繝ｼ繝峨＆繧後ｋ
082             * 繝輔ぃ繧､繝ｫ縺御ｸ?▽縺?￠縺ｮ蝣ｴ蜷医↓菴ｿ逕ｨ縺ｧ縺阪∪縺吶?隍?焚縺ｮ繝輔ぃ繧､繝ｫ繧貞酔譎ゅ↓螟画峩縺励◆縺?
083             * 蝣ｴ蜷医?縲√い繝??繝ｭ繝ｼ繝峨Ν繝ｼ繝ｫ縺ｫ縺ｮ縺｣縺ｨ繧翫?繝ｪ繧ｯ繧ｨ繧ｹ繝医ヱ繝ｩ繝｡繝ｼ繧ｿ縺ｧ謖?ｮ壹＠縺ｦ縺上□縺輔＞縲?
084             *
085             * @og.rev 3.8.1.3A (2006/01/30) 譁ｰ繝輔ぃ繧､繝ｫ蜷阪↓繧ｪ繝ｪ繧ｸ繝翫Ν繝輔ぃ繧､繝ｫ蜷阪?諡｡蠑ｵ蟄舌ｒ繧ｻ繝?ヨ縺励∪縺?
086             * @og.rev 4.0.0.0 (2007/11/28) 繝｡繧ｽ繝?ラ縺ｮ謌ｻ繧雁?繧偵メ繧ｧ繝?け縺励∪縺吶?
087             * @og.rev 5.5.2.6 (2012/05/25) findbugs蟇ｾ蠢懊?static繝輔ぅ繝ｼ繝ｫ繝峨∈縺ｮ譖ｸ縺崎ｾｼ縺ｿ縺ｫ縲、tomicInteger 繧貞茜逕ｨ縺励∪縺吶?
088             * @og.rev 5.6.5.3 (2013/06/28) useBackup蠑墓焚霑ｽ蜉?
089             *
090             * @param       request HttpServletRequest繧ｪ繝悶ず繧ｧ繧ｯ繝?
091             * @param       saveDirectory   繝輔ぃ繧､繝ｫ繧｢繝??繝ｭ繝ｼ繝峨′縺ゅ▲縺溷?蜷医?菫晏ｭ倥ヵ繧ｩ繝ｫ繝?錐
092             * @param       maxPostSize     繝輔ぃ繧､繝ｫ繧｢繝??繝ｭ繝ｼ繝画凾縺ｮ譛?､ｧ繝輔ぃ繧､繝ｫ繧ｵ繧､繧ｺ(Byte)0,縺ｾ縺溘?繝槭う繝翫せ縺ｧ辟｡蛻ｶ髯?
093             * @param       encoding        繝輔ぃ繧､繝ｫ縺ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝?
094             * @param       inputFilename   繧｢繝??繝ｭ繝ｼ繝峨＆繧後◆繝輔ぃ繧､繝ｫ縺ｮ譁ｰ縺励＞蜷榊燕
095             * @param       useBackup               繝輔ぃ繧､繝ｫ繧｢繝??繝ｭ繝ｼ繝画凾縺ｫ縲√ヰ繝?け繧｢繝??蜃ｦ逅?☆繧九°縺ｩ縺?°[true/false]繧呈欠螳?
096             * @throws IOException
097             */
098            public MultipartRequest(final HttpServletRequest request,
099                                                            final String saveDirectory,
100                                                            final int maxPostSize,
101                                                            final String  encoding,
102    //                                                      final String  inputFilename ) throws IOException {
103                                                            final String  inputFilename,
104                                                            final boolean useBackup ) throws IOException {                  // 5.6.5.3 (2013/06/28) 霑ｽ蜉?
105    
106                    if(request == null) {
107                            throw new IllegalArgumentException("request cannot be null");
108                    }
109                    if(saveDirectory == null) {
110                            throw new IllegalArgumentException("saveDirectory cannot be null");
111                    }
112                    // 5.5.2.6 (2012/05/25) 0,縺ｾ縺溘?繝槭う繝翫せ縺ｧ辟｡蛻ｶ髯?
113    //              if(maxPostSize <= 0) {
114    //                      throw new IllegalArgumentException("maxPostSize must be positive");
115    //              }
116    
117                    // Save the dir
118                    File dir = new File(saveDirectory);
119    
120                    // Check saveDirectory is truly a directory
121                    if(!dir.isDirectory()) {
122                            throw new IllegalArgumentException("Not a directory: " + saveDirectory);
123                    }
124    
125                    // Check saveDirectory is writable
126                    if(!dir.canWrite()) {
127                            throw new IllegalArgumentException("Not writable: " + saveDirectory);
128                    }
129    
130                    // Parse the incoming multipart, storing files in the dir provided,
131                    // and populate the meta objects which describe what we found
132                    MultipartParser parser = new MultipartParser(request, maxPostSize);
133                    if(encoding != null) {
134                            parser.setEncoding(encoding);
135                    }
136    
137                    List<String> list = new ArrayList<String>();
138    
139                    Part part;
140                    while ((part = parser.readNextPart()) != null) {
141                            String name = part.getName();
142                            if( part.isParam() && part instanceof ParamPart ) {
143                                    ParamPart paramPart = (ParamPart)part;
144                                    String value = paramPart.getStringValue();
145                                    List<String> existingValues = parameters.get(name);
146                                    if(existingValues == null) {
147                                            existingValues = new ArrayList<String>();
148                                            parameters.put(name, existingValues);
149                                    }
150                                    existingValues.add(value);
151                            }
152                            else if( part.isFile() && part instanceof FilePart ) {
153                                    FilePart filePart = (FilePart)part;
154                                    String fileName = filePart.getFilename();
155                                    if(fileName != null) {
156                                            list.add( name );               // 3.5.6.5 (2004/08/09)
157                                            // 3.8.1.2 (2005/12/19) 莉ｮ繝輔ぃ繧､繝ｫ縺ｧ繧ｻ繝ｼ繝悶☆繧九?
158    //                                      String newName = String.valueOf( dumyNewFileCnt++ ) ;   // 3.8.1.4 (2006/03/17)
159    //                                      String newName = String.valueOf( dumyNewFileCnt.getAndIncrement() ) ;   // 5.5.2.6 (2012/05/25) findbugs蟇ｾ蠢?
160                                            String tempName = RANDOM_KEY + dumyNewFileCnt.getAndIncrement() ;               // 5.6.5.3 (2013/06/28) 繧｢繝??繝ｭ繝ｼ繝画凾縺ｮ繝?Α繝ｼ繝輔ぃ繧､繝ｫ蜷阪ｒ繧ゅ≧蟆代＠縺?￠繝ｩ繝ｳ繝?Β縺ｫ縺吶ｋ縲?
161    //                                      filePart.setFilename( newName );                        // 5.6.5.3 (2013/06/28) newName 縺ｯ繧?ｄ縺薙＠縺??縺ｧ縲∝､画峩
162                                            filePart.setFilename( tempName );
163                                            filePart.writeTo(dir);
164                                            files.put(name,
165                                                              new UploadedFile( dir.toString(),
166    //                                                                                              newName,                // 3.8.1.2 (2005/12/19)
167                                                                                                    tempName,               // 3.8.1.2 (2005/12/19)
168                                                                                                    fileName,
169                                                                                                    filePart.getContentType()));
170                                    }
171                                    else {
172                                            files.put(name, new UploadedFile(null, null, null, null));
173                                    }
174                            }
175                            else {
176                                    String errMsg = "Part繧ｪ繝悶ず繧ｧ繧ｯ繝医′縲￣aramPart縺ｧ繧?ilePart縺ｧ繧ゅ≠繧翫∪縺帙ｓ縲?
177                                                            + " class=[" + part.getClass() + "]";
178                                    throw new RuntimeException( errMsg );
179                            }
180                    }
181    
182                    // 3.5.6.5 (2004/08/09) 逋ｻ骭ｲ蠕後↓繝輔ぃ繧､繝ｫ繧偵Μ繝阪?繝?＠縺ｾ縺吶?
183                    int size = list.size();
184                    for( int i=0; i<size; i++ ) {
185                            String name = list.get(i);
186                            File file = getFile( name );
187                            String newName = inputFilename;
188                            if( newName == null && name != null ) {
189                                    int adrs = name.lastIndexOf( HybsSystem.JOINT_STRING ); // 繧ｫ繝ｩ繝?_陦檎分蜿ｷ 縺ｮ __ 縺ｮ菴咲ｽｮ
190                                    if( adrs < 0 ) {
191                                            newName = getParameter( name + "_NEW" );
192                                    }
193                                    else {
194                                            newName = getParameter( name.substring( 0,adrs ) + "_NEW" + name.substring( adrs ) );
195                                    }
196                            }
197    
198                            // 3.8.1.3 (2006/02/06) 譁ｰ繝輔ぃ繧､繝ｫ蜷阪↓諡｡蠑ｵ蟄舌′縺ｪ縺?→縺?
199                            // 譌ｧ繝輔ぃ繧､繝ｫ蜷阪°繧画僑蠑ｵ蟄仙叙蠕励＠譁ｰ繝輔ぃ繧､繝ｫ蜷阪↓譁?ｭ怜?騾｣邨?
200                            if( newName != null && newName.length() > 0 ) {
201                                    // 譁ｰ繝輔ぃ繧､繝ｫ蜷阪°繧画僑蠑ｵ蟄仙叙蠕?
202                                    String newExt = getExtension( newName );
203                                    if( newExt == null || newExt.length() == 0 ) {
204                                            String oldExt = getExtension( getOriginalFileName( name ) );
205                                            newName = new StringBuilder().append( newName ).append( "." ).append( oldExt ).toString();
206                                    }
207                            }
208                            else {
209                                    newName = getOriginalFileName( name );
210                            }
211    
212                            // 3.8.1.2 (2005/12/19) 蝓ｺ譛ｬ逧?↓縺ｯ縺吶∋縺ｦ縺ｮ繧ｱ繝ｼ繧ｹ縺ｧ繝輔ぃ繧､繝ｫ蜷榊､画峩縺檎匱逕溘☆繧九?
213                            if( file != null && newName != null && newName.length() > 0 ) {
214                                    File newFile = new File( dir,newName );
215    
216                                    // 5.6.5.3 (2013/06/28) useBackup 繝輔ぃ繧､繝ｫ繧｢繝??繝ｭ繝ｼ繝画凾縺ｫ縲√ヰ繝?け繧｢繝??蜃ｦ逅?☆繧九°縺ｩ縺?°[true/false]繧呈欠螳?
217    //                              if( newFile.exists() && !newFile.delete() ) {
218    //                                      String errMsg = "譌｢蟄倥?繝輔ぃ繧､繝ｫ[" + newName + "]縺悟炎髯､縺ｧ縺阪∪縺帙ｓ縺ｧ縺励◆縲?;
219    //                                      throw new RuntimeException( errMsg );
220    //                              }
221                                    if( newFile.exists() ) {
222                                            if( useBackup ) {
223                                                    // newName 縺ｫ繝輔か繝ｫ繝?嚴螻､繧貞性繧??蜷医↓縲√◎縺ｪ縺医※縲?
224                                                    File parent = newFile.getParentFile();                  // 繝舌ャ繧ｯ繧｢繝??縺吶∋縺阪ヵ繧｡繧､繝ｫ縺ｮ繝輔か繝ｫ繝?
225                                                    File backup = new File( parent , "_backup" );   // 縺昴?逶ｴ荳九↓縲?_backup" 繝輔か繝ｫ繝?ｒ菴懈?
226                                                    if( backup != null && !backup.exists() && !backup.mkdirs() ) {
227                                                            String errMsg = "繝舌ャ繧ｯ繧｢繝??蜃ｦ逅?〒backup繝輔か繝ｫ繝??菴懈?縺ｫ螟ｱ謨励＠縺ｾ縺励◆縲?" + backup + "]";
228                                                            throw new RuntimeException( errMsg );
229                                                    }
230                                                    // 繝舌ャ繧ｯ繧｢繝??繝輔ぃ繧､繝ｫ蜷阪?縲∝?縺ｮ繝輔ぃ繧､繝ｫ蜷?諡｡蠑ｵ蟄仙性繧? ??"_" + 迴ｾ蝨ｨ譎ょ綾縺ｮlong蛟､ + "." + 蜈??繝輔ぃ繧､繝ｫ縺ｮ諡｡蠑ｵ蟄?
231                                                    String bkupName = newFile.getName() + "_" + System.currentTimeMillis() + "."  + getExtension( newName ) ;
232                                                    File fromFile = new File( dir,newName );                // 繧ｪ繝ｪ繧ｸ繝翫Ν縺ｮ newFile 繧池ename 縺吶ｋ縺ｨ縺ｾ縺壹＞縺ｮ縺ｧ縲∝酔蜷阪?File繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ菴懈?
233                                                    File bkupFile = new File( backup,bkupName );
234    
235                                                    if( !fromFile.renameTo( bkupFile ) ) {
236                                                            String errMsg = "繝舌ャ繧ｯ繧｢繝??蜃ｦ逅?〒繝舌ャ繧ｯ繧｢繝??繝輔ぃ繧､繝ｫ繧偵Μ繝阪?繝?〒縺阪∪縺帙ｓ縺ｧ縺励◆縲?" + bkupFile + "]" ;
237                                                            throw new RuntimeException( errMsg );
238                                                    }
239                                            }
240                                            else if( !newFile.delete() ) {
241                                                    String errMsg = "譌｢蟄倥?繝輔ぃ繧､繝ｫ[" + newName + "]縺悟炎髯､縺ｧ縺阪∪縺帙ｓ縺ｧ縺励◆縲?;
242                                                    throw new RuntimeException( errMsg );
243                                            }
244                                    }
245    
246    //                              file.renameTo( newFile );
247                                    if( !file.renameTo( newFile ) ) {
248                                            String errMsg = "謇?ｮ壹?繝輔ぃ繧､繝ｫ繧偵Μ繝阪?繝?〒縺阪∪縺帙ｓ縺ｧ縺励◆縲?" + file + "]" ;
249                                            throw new RuntimeException( errMsg );
250                                    }
251                                    UploadedFile fup = files.get( name );
252                                    fup.setFilesystemName( newName );
253                            }
254                    }
255            }
256    
257            /**
258             * 繝ｪ繧ｯ繧ｨ繧ｹ繝医ヱ繝ｩ繝｡繝ｼ繧ｿ縺ｮ蜷榊燕驟榊?繧貞叙蠕励＠縺ｾ縺吶?
259             *
260             * @return      繝ｪ繧ｯ繧ｨ繧ｹ繝医ヱ繝ｩ繝｡繝ｼ繧ｿ縺ｮ蜷榊燕驟榊?
261             */
262            public String[] getParameterNames() {
263                    Set<String> keyset = parameters.keySet();
264                    return keyset.toArray( new String[keyset.size()] );
265            }
266    
267            /**
268             * 繝輔ぃ繧､繝ｫ繧｢繝??繝ｭ繝ｼ繝峨＆繧後◆繝輔ぃ繧､繝ｫ鄒､縺ｮ繝輔ぃ繧､繝ｫ蜷埼?蛻励ｒ蜿門ｾ励＠縺ｾ縺吶?
269             *
270             * @return      繧｢繝??繝ｭ繝ｼ繝峨＆繧後◆繝輔ぃ繧､繝ｫ蜷埼?蛻?
271             */
272            public String[] getFilenames() {
273                    Set<String> keyset = files.keySet();
274                    return keyset.toArray( new String[keyset.size()] );
275            }
276    
277            /**
278             * 謖?ｮ壹?蜷榊燕縺ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医ヱ繝ｩ繝｡繝ｼ繧ｿ縺ｮ蛟､繧貞叙蠕励＠縺ｾ縺吶?
279             *
280             * @param       name    繝ｪ繧ｯ繧ｨ繧ｹ繝医ヱ繝ｩ繝｡繝ｼ繧ｿ蜷?
281             *
282             * @return      繝代Λ繝｡繝ｼ繧ｿ縺ｮ蛟､
283             */
284            public String getParameter( final String name ) {
285                    List<String> values = parameters.get(name);
286                    if( values == null || values.isEmpty() ) {
287                            return null;
288                    }
289                    return values.get(values.size() - 1);
290            }
291    
292            /**
293             * 謖?ｮ壹?蜷榊燕縺ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医ヱ繝ｩ繝｡繝ｼ繧ｿ縺ｮ蛟､繧帝?蛻怜梛蠑上〒蜿門ｾ励＠縺ｾ縺吶?
294             *
295             * @og.rev 5.3.2.0 (2011/02/01) 譁ｰ隕丈ｽ懈?
296             *
297             * @param       name    繝ｪ繧ｯ繧ｨ繧ｹ繝医ヱ繝ｩ繝｡繝ｼ繧ｿ蜷?
298             *
299             * @return      繝代Λ繝｡繝ｼ繧ｿ縺ｮ蛟､驟榊?
300             */
301            public String[] getParameters( final String name ) {
302                    List<String> values = parameters.get(name);
303                    if( values == null || values.isEmpty() ) {
304                            return null;
305                    }
306    //              return values.toArray( new String[0] );
307                    return values.toArray( new String[values.size()] );
308            }
309    
310            /**
311             * 謖?ｮ壹?蜷榊燕縺ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医ヱ繝ｩ繝｡繝ｼ繧ｿ縺ｮ蛟､繧帝?蛻?int)蝙句ｼ上〒蜿門ｾ励＠縺ｾ縺吶?
312             *
313             * @og.rev 5.3.2.0 (2011/02/01) 譁ｰ隕丈ｽ懈?
314             * @og.rev 5.3.6.0 (2011/06/01) 驟榊?蛟､縺?"縺ｮ蝣ｴ蜷医↓NumberFormatException縺檎匱逕溘☆繧九ヰ繧ｰ繧剃ｿｮ豁｣
315             *
316             * @param       name    繝ｪ繧ｯ繧ｨ繧ｹ繝医ヱ繝ｩ繝｡繝ｼ繧ｿ蜷?
317             *
318             * @return      繝代Λ繝｡繝ｼ繧ｿ縺ｮ蛟､驟榊?
319             */
320            public int[] getIntParameters( final String name ) {
321                    List<String> values = parameters.get(name);
322                    if( values == null || values.isEmpty() ) {
323                            return null;
324                    }
325    
326    //              int[] rtn = new int[values.size()];
327    //              for( int i=0; i<values.size(); i++ ) {
328    //                      rtn[i] = Integer.valueOf( values.get(i) );
329    //              }
330    
331                    // 5.3.6.0 (2011/06/01) 繧ｼ繝ｭ繧ｹ繝医Μ繝ｳ繧ｰ("")縺ｯint螟画鋤蟇ｾ雎｡縺九ｉ莠医ａ髯､螟悶☆繧?
332                    List<Integer> intVals = new ArrayList<Integer>();
333                    for( int i=0; i<values.size(); i++ ) {
334                            String str = values.get(i);
335                            if( str != null && str.length() > 0 ) {
336                                    intVals.add( Integer.parseInt( str ) );
337                            }
338                    }
339                    if( intVals.isEmpty() ) {
340                            return null;
341                    }
342    
343                    int[] rtn = new int[intVals.size()];
344                    for( int i=0; i<intVals.size(); i++ ) {
345                            rtn[i] = intVals.get(i).intValue();
346                    }
347    
348                    return rtn;
349            }
350    
351            /**
352             * 謖?ｮ壹?蜷榊燕縺ｮ UploadedFile 繧ｪ繝悶ず繧ｧ繧ｯ繝医°繧?逋ｻ骭ｲ縺輔ｌ繧九ヵ繧｡繧､繝ｫ蜷阪ｒ蜿門ｾ励＠縺ｾ縺吶?
353             *
354             * 逋ｻ骭ｲ縺輔ｌ繧九ヵ繧｡繧､繝ｫ蜷阪→縺ｯ縲∵眠縺溘↓譖ｸ縺肴鋤縺医ｉ繧後◆繝輔ぃ繧､繝ｫ蜷阪?縺薙→縺ｧ縺吶?
355             *
356             * @og.rev 5.6.6.1 (2013/07/12) null 蟇ｾ遲?
357             *
358             * @param       name    繧ｭ繝ｼ諠??
359             *
360             * @return      譁ｰ縺溘↓譖ｸ縺肴鋤縺医ｉ繧後◆繝輔ぃ繧､繝ｫ蜷?
361             */
362            public String getFilesystemName( final String name ) {
363                    UploadedFile file = files.get(name);
364    //              return file.getFilesystemName();  // may be null
365                    return (file == null) ? null : file.getFilesystemName();  // may be null
366            }
367    
368            /**
369             * 謖?ｮ壹?蜷榊燕縺ｮ UploadedFile 繧ｪ繝悶ず繧ｧ繧ｯ繝医°繧?繧｢繝??繝ｭ繝ｼ繝峨＆繧後◆繝輔ぃ繧､繝ｫ蜷阪ｒ蜿門ｾ励＠縺ｾ縺吶?
370             *
371             * 繧｢繝??繝ｭ繝ｼ繝峨＆繧後◆繝輔ぃ繧､繝ｫ蜷阪→縺ｯ縲√が繝ｪ繧ｸ繝翫Ν縺ｮ繝輔ぃ繧､繝ｫ蜷阪?縺薙→縺ｧ縺吶?
372             *
373             * @og.rev 5.6.6.1 (2013/07/12) null 蟇ｾ遲?
374             *
375             * @param       name    繧ｭ繝ｼ諠??
376             *
377             * @return      繧ｪ繝ｪ繧ｸ繝翫Ν縺ｮ繝輔ぃ繧､繝ｫ蜷?
378             */
379            public String getOriginalFileName( final String name ) {
380                    UploadedFile file = files.get(name);
381    //              return file.getOriginalFileName();  // may be null
382                    return (file == null) ? null : file.getOriginalFileName();  // may be null
383            }
384    
385            /**
386             * 謖?ｮ壹?蜷榊燕縺ｮ UploadedFile 繧ｪ繝悶ず繧ｧ繧ｯ繝医°繧?File 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ蜿門ｾ励＠縺ｾ縺吶?
387             *
388             * @og.rev 5.6.6.1 (2013/07/12) null 蟇ｾ遲?
389             *
390             * @param       name    繧ｭ繝ｼ諠??
391             *
392             * @return      File繧ｪ繝悶ず繧ｧ繧ｯ繝?
393             */
394            public File getFile( final String name ) {
395                    UploadedFile file = files.get(name);
396    //              return file.getFile();  // may be null
397                    return (file == null) ? null : file.getFile();  // may be null
398            }
399    
400            /**
401             * 繝輔ぃ繧､繝ｫ蜷阪°繧?諡｡蠑ｵ蟄舌ｒ蜿門ｾ励＠縺ｾ縺吶?
402             *
403             * @param       fileName        繝輔ぃ繧､繝ｫ蜷?
404             *
405             * @return      諡｡蠑ｵ蟄?
406             */
407            private String getExtension( final String fileName ) {
408                    int index = fileName.lastIndexOf('.');
409                    if(index!=-1) {
410                            return fileName.substring(index + 1, fileName.length());
411                    }
412                    return "";
413            }
414    }
415    
416    /**
417     * 繝輔ぃ繧､繝ｫ繧偵し繝ｼ繝舌?縺ｫ繧｢繝??繝ｭ繝ｼ繝峨☆繧句?蜷医↓菴ｿ逕ｨ縺輔ｌ繧九ヵ繧｡繧､繝ｫ邂｡逅??驛ｨ繧ｯ繝ｩ繧ｹ縺ｧ縺吶?
418     *
419     * @og.group 縺昴?莉匁ｩ溯?
420     *
421     * @version  4.0
422     * @author       Kazuhiko Hasegawa
423     * @since    JDK5.0,
424     */
425    final class UploadedFile {
426    
427            private String filename;
428            private final String dir;
429            private final String original;
430            private final String type;
431    
432            /**
433             * 繧｢繝??繝ｭ繝ｼ繝峨ヵ繧｡繧､繝ｫ縺ｮ邂｡逅?が繝悶ず繧ｧ繧ｯ繝医ｒ菴懈?縺励∪縺吶?
434             *
435             * @param       dir     繝輔ぃ繧､繝ｫ繧剃ｿ晉ｮ｡縺吶ｋ繝輔か繝ｫ繝?
436             * @param       filename        繝輔ぃ繧､繝ｫ蜷?鄂ｮ縺肴鋤縺亥ｾ?
437             * @param       original        繝輔ぃ繧､繝ｫ蜷?繧ｪ繝ｪ繧ｸ繝翫Ν)
438             * @param       type    繧ｳ繝ｳ繝?Φ繝医ち繧､繝?
439             */
440            UploadedFile( final String dir, final String filename, final String original, final String type) {
441                    this.dir = dir;
442                    this.filename = filename;
443                    this.original = original;
444                    this.type = type;
445            }
446    
447            /**
448             * 繧ｳ繝ｳ繝?Φ繝医ち繧､繝励ｒ蜿門ｾ励＠縺ｾ縺吶?
449             *
450             * @return      繧ｳ繝ｳ繝?Φ繝医ち繧､繝?
451             */
452            public String getContentType() {
453                    return type;
454            }
455    
456            /**
457             * 繝輔ぃ繧､繝ｫ蜷?鄂ｮ縺肴鋤縺亥ｾ?繧貞叙蠕励＠縺ｾ縺吶?
458             *
459             * @return      繝輔ぃ繧､繝ｫ蜷?鄂ｮ縺肴鋤縺亥ｾ?
460             */
461            public String getFilesystemName() {
462                    return filename;
463            }
464    
465            /**
466             * 繝輔ぃ繧､繝ｫ蜷?鄂ｮ縺肴鋤縺亥ｾ?繧偵そ繝?ヨ縺励∪縺吶?
467             *
468             * @param       name    繝輔ぃ繧､繝ｫ蜷?鄂ｮ縺肴鋤縺亥ｾ?
469             */
470            public void setFilesystemName( final String name ) {
471                    filename = name;
472            }
473    
474            /**
475             * 繝輔ぃ繧､繝ｫ蜷?繧ｪ繝ｪ繧ｸ繝翫Ν)繧貞叙蠕励＠縺ｾ縺吶?
476             *
477             * @return      繝輔ぃ繧､繝ｫ蜷?繧ｪ繝ｪ繧ｸ繝翫Ν)
478             */
479            public String getOriginalFileName() {
480                    return original;
481            }
482    
483            /**
484             * 繝輔ぃ繧､繝ｫ蜷?鄂ｮ縺肴鋤縺亥ｾ?縺ｮ File 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ蜿門ｾ励＠縺ｾ縺吶?
485             *
486             * @return File File 繧ｪ繝悶ず繧ｧ繧ｯ繝?
487             */
488            public File getFile() {
489                    if(dir == null || filename == null) {
490                            return null;
491                    }
492                    else {
493                            return new File(dir + File.separator + filename);
494                    }
495            }
496    }