View Javadoc
1   /**
2    * This file Copyright (c) 2003-2018 Magnolia International
3    * Ltd.  (http://www.magnolia-cms.com). All rights reserved.
4    *
5    *
6    * This file is dual-licensed under both the Magnolia
7    * Network Agreement and the GNU General Public License.
8    * You may elect to use one or the other of these licenses.
9    *
10   * This file is distributed in the hope that it will be
11   * useful, but AS-IS and WITHOUT ANY WARRANTY; without even the
12   * implied warranty of MERCHANTABILITY or FITNESS FOR A
13   * PARTICULAR PURPOSE, TITLE, or NONINFRINGEMENT.
14   * Redistribution, except as permitted by whichever of the GPL
15   * or MNA you select, is prohibited.
16   *
17   * 1. For the GPL license (GPL), you can redistribute and/or
18   * modify this file under the terms of the GNU General
19   * Public License, Version 3, as published by the Free Software
20   * Foundation.  You should have received a copy of the GNU
21   * General Public License, Version 3 along with this program;
22   * if not, write to the Free Software Foundation, Inc., 51
23   * Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
24   *
25   * 2. For the Magnolia Network Agreement (MNA), this file
26   * and the accompanying materials are made available under the
27   * terms of the MNA which accompanies this distribution, and
28   * is available at http://www.magnolia-cms.com/mna.html
29   *
30   * Any modifications to this file must keep this entire header
31   * intact.
32   *
33   */
34  package info.magnolia.cms.beans.runtime;
35  
36  import java.io.File;
37  import java.util.Enumeration;
38  import java.util.Hashtable;
39  import java.util.Map;
40  
41  import org.apache.commons.lang3.StringUtils;
42  
43  
44  /**
45   * A util class to access file uploads in multipart post requests. Use {@link #getDocument(String)} to access an uploaded file.
46   */
47  public class MultipartForm {
48  
49      /**
50       * The name of the request attribute containing a MultipartForm instance.
51       */
52      public static final String REQUEST_ATTRIBUTE_NAME = "multipartform";
53  
54      private final Map<String, String[]> parameters;
55  
56      private final Map<String, Document> documents;
57  
58      private final Map parameterList;
59  
60      public MultipartForm() {
61          this.parameters = new Hashtable<String, String[]>();
62          this.documents = new Hashtable<String, Document>();
63          this.parameterList = new Hashtable();
64      }
65  
66      /**
67       * @deprecated since 4.0 - should not be needed anymore since MAGNOLIA-2449 - request parameters should be correctly wrapped.
68       */
69      @Deprecated
70      public void addParameter(String name, Object value) {
71          if (value instanceof String[]) {
72              this.parameters.put(name, (String[]) value);
73          } else {
74              this.parameters.put(name, new String[]{(String) value});
75          }
76      }
77  
78      /**
79       * @deprecated since 4.0 - should not be needed anymore since MAGNOLIA-2449 - request parameters should be correctly wrapped.
80       */
81      @Deprecated
82      public void removeParameter(String name) {
83          this.parameters.remove(name);
84      }
85  
86      /**
87       * @deprecated since 4.0 - should not be needed anymore since MAGNOLIA-2449 - request parameters should be correctly wrapped.
88       */
89      @Deprecated
90      public Map<String, String[]> getParameters() {
91          return this.parameters;
92      }
93  
94      /**
95       * @deprecated since 4.0 - should not be needed anymore since MAGNOLIA-2449 - request parameters should be correctly wrapped.
96       */
97      @Deprecated
98      public String getParameter(String name) {
99          try {
100             String[] params = this.parameters.get(name);
101             if (params != null && params.length > 0) {
102                 return params[0];
103             }
104             return null;
105         } catch (Exception e) {
106             return null;
107         }
108     }
109 
110     /**
111      * @deprecated since 4.0 - should not be needed anymore since MAGNOLIA-2449 - request parameters should be correctly wrapped.
112      */
113     @Deprecated
114     public String[] getParameterValues(String name) {
115         try {
116             return ((String[]) this.parameterList.get(name));
117         } catch (Exception e) {
118             return null;
119         }
120     }
121 
122     /**
123      * @deprecated since 4.0 - should not be needed anymore since MAGNOLIA-2449 - request parameters should be correctly wrapped.
124      */
125     @Deprecated
126     public void addparameterValues(String name, String[] values) {
127         this.parameterList.put(name, values);
128     }
129 
130     public void addDocument(String atomName, String fileName, String type, File file) {
131         if (StringUtils.isEmpty(fileName)) {
132             return;
133         }
134         Documentme/Document.html#Document">Document document = new Document();
135         document.setAtomName(atomName);
136         document.setType(type);
137         document.setFile(file);
138         if (!StringUtils.contains(fileName, ".")) {
139             document.setExtension(StringUtils.EMPTY);
140             document.setFileName(fileName);
141         } else {
142             document.setExtension(StringUtils.substringAfterLast(fileName, "."));
143             document.setFileName(StringUtils.substringBeforeLast(fileName, "."));
144         }
145         this.documents.put(atomName, document);
146     }
147 
148     public Document getDocument(String name) {
149         return this.documents.get(name);
150     }
151 
152     public Map<String, Document> getDocuments() {
153         return this.documents;
154     }
155 
156     /**
157      * @deprecated since 4.0 - should not be needed anymore since MAGNOLIA-2449 - request parameters should be correctly wrapped.
158      */
159     @Deprecated
160     public Enumeration<String> getParameterNames() {
161         return ((Hashtable<String, String[]>) this.parameters).keys();
162     }
163 }