Version 5

hannes — Fri, 15 Jun 2007 20:46:30 +0000

52	To preserve the benefit, it is necessary to take some care when dealing with file uploads. There is a new getInputStream() method in helma.util.MimePart\|http://adele.helma.org/source/viewcvs.cgi/helma/src/helma/util/MimePart.java?cvsroot=hop which allows to read the content from an input stream rather than loading it into memory all at once using getContent(). The MimePart.writeToFile(filename) method will try to rename the temporary file if it is on the same physical file system as the target file, saving the effort of actually moving or copying the bytes.
60
61	If the file is just saved, the MimePart.writeToFile(filename) method will try to just rename the temporary file if it is on the same physical file system as the target file. Bytes are only moved when the target file is on a different file system than the temporary file.

Version 4

hannes — Fri, 15 Jun 2007 20:43:40 +0000

To preserve the benefit, it is necessary to take some care when dealing with file uploads. There is a new getInputStream() method in *helma.util.MimePart|http://adele.helma.org/source/viewcvs.cgi/helma/src/helma/util/MimePart.java?cvsroot=hop* which allows to read the content from an input stream rather than loading it into memory all at once using getContent(). The MimePart.writeToFile(filename) method will try to rename the temporary file if it is on the same physical file system as the target file, saving the effort of actually moving or copying the bytes.

Version 3

hannes — Fri, 15 Jun 2007 16:02:05 +0000

73	# upload limit per file
74	gobi.uploadLimit = 2048
75	# assuming maximum of 5 upload fields per form
76	gobi.totalUploadLimit = 10240
77

Version 2

hannes — Fri, 15 Jun 2007 15:56:01 +0000

1	.=.=.= work in progress Specialized and aggregated parameter collections .=.=.=
3	In previous versions of Helma, HTTP parameters, cookies, and selected HTTP headers were all coerced into the req.data collection. Helma 1.6 introduces separate collections for various data, with req.data acting as a combinator of the varous collections to maintain backwards compatibility.
4
5	The new collections are:
6
7	<dl>
8	<dt>req.postParams</dt>
9	<dd>Holds parameters passed from a HTTP POST request.</dd>
10	<dt>req.queryParams</dt>
11	<dd>Holds parameters passed from the HTTP query string.</dd>
12	<dt>req.params</dt>
13	<dd>Holds parameters combined from the HTTP query string and the HTTP POST request.</dd>
14	<dt>req.cookies</dt>
15	<dd>Holds cookies sent by the HTTP client. Access via <code>req.cookies.cookiename</code> to retrieve the cookie value as string, or <code>req.cookies.cookiename_cookie</code> to retieve the javax.servlet.http.Cookie\|http://java.sun.com/products/servlet/2.3/javadoc/javax/servlet/http/Cookie.html instance.</dd>
16	<dt>req.data</dt>
17	<dd>Backwards compatible collection containing HTTP parameters, cookies, and assorted HTTP headers.</dd>
18	</dl>
19
20	=== Improved handling of multi-value parameters
21
22	Before version 1.6, Helma only set the req.data.paramname_array array value if a parameter value actually had more than one value. With Helma 1.6, it is always possible to access parameter values as arrays, even if they only have one value. This makes handling multi-valued parameters much easier, because it is no longer necessary to handle the one-value case separately.
23
6	Helma allows HTTP parameters to be grouped into objects using a objectid[partid] syntax in the parameter name. For example, a parameter name of foo[bar] will result in a req.data.foo object being created. The actual parameter value will be available at req.data.foo.bar.
7
8	This feature can be used recursively, meaning that a parameter named foo[bar][dong] will result in req.data.foo.bar.dong.
9
10	=== HTTP header methods
11
12	Helma 1.6 provides the following new methods to access HTTP headers in the response and request objects:
13
14	req.getHeader(name)
15	req.getHeaders(name)
16	req.getIntHeader(name)
17	req.getDateHeader(name)
18
19	res.setHeader(name, value)
20	res.setDateHeader(name, value)
21	res.addHeader(name, value)
22	res.addDateHeader(name, value)
23
9	Todo, see http://helma.org/bugs/show_bug.cgi?id=522
10
12	File uploads in Helma 1.6 have a dramatically impoved memory footprint compared to previous versions by storing uploaded files to a temporary file rather than passing them in memory as byte arrays. With this, it is possible to handle really large files easily.
13
14	To preserve the benefit, it is necessary to take some care when dealing with file uploads. There is a new getInputStream() method in helma.util.MimePart\|http://adele.helma.org/source/viewcvs.cgi/helma/src/helma/util/MimePart.java?cvsroot=hop which allows to read the content from an input stream rather than loading it into memory all at once using getContent().
15
16	To support this, the Helma Image constructor now can take an input stream as argument. The following code snippet shows how it is possible to use this feature in a way that is compatible with previous versions of Helma:
17
18	// read image from input stream if available -
19	// otherwise pass content as byte array.
20	var img = new Image(req.data.file.inputStream \|\|
21	req.data.file.content);
22
15	Helma 1.6 supports tracking of file upload progress via a user's session. Upload tracking is activated by adding a <code>upload_id</code> parameter to the query string. The current upload status can be retrieved by using the <code>session.getUploadStatus(upload_id)</code> method, which returns null or an instance of helma.framework.UploadStatus\|http://adele.helma.org/source/viewcvs.cgi/helma/src/helma/framework/UploadStatus.java?cvsroot===hop, totalUploadLimit optionwhose toString() method handily returns a JSON representation of itself.
16
17	There's a demo available\|Upload Demo that includes source code.
18
19	=== TotalUploadLimit option
20
21	Before Helma 1.6, there was only an uploadLimit option to allow setting the maximum allowed upload size in apps.properties. However, this applied to both combined and individual upload size, resulting in the per-file upload limit to vary with the number of file input fields per form.
22
23	Helma 1.6 introduces the totalUploadLimit property, which allows to set the combined upload size independent from the per-file size.
24
25	By default, totalUploadLimit is set equal to uploadLimit.

Version 1

hannes — Mon, 04 Jun 2007 17:42:34 +0000

Set tags to helma 1.6

1	... work in progress ...
3	=== HTTP parameter grouping
4
5	=== HTTP parameter remainders
6
7	=== File upload memory requirements
8
9	=== File upload monitoring
10
11	=== totalUploadLimit option

helma.org/wiki/New HTTP-related Features in Helma 1.6

Version 5

Version 4

Version 3

Version 2

Version 1