[jboss-cvs] jboss-seam/doc/reference/en/modules ...

[Shane Bryzak]

  User: sbryzak2
  Date: 07/02/06 11:35:41

  Modified:    doc/reference/en/modules  controls.xml
  Log:
  fileUpload configuration
  
  Revision  Changes    Path
  1.18      +36 -1     jboss-seam/doc/reference/en/modules/controls.xml
  
  (In the diff below, changes in quantity of whitespace are not shown.)
  
  Index: controls.xml
  ===================================================================
  RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/controls.xml,v
  retrieving revision 1.17
  retrieving revision 1.18
  diff -u -b -r1.17 -r1.18
  --- controls.xml	30 Jan 2007 09:01:52 -0000	1.17
  +++ controls.xml	6 Feb 2007 16:35:41 -0000	1.18
  @@ -388,11 +388,46 @@
                    ]]>
                  </programlisting>
                  
  +               <para>
  +                  The following configuration options for multipart requests may be configured in components.xml:
  +               </para>
  +               
  +               <itemizedlist>
  +                 <listitem>
  +                 <para>
  +                   <literal>createTempFiles</literal> &mdash; if this option is set to true, uploaded files are
  +                   streamed to a temporary file instead of in memory.
  +                 </para>
  +                 </listitem>
  +                 <listitem>
  +                 <para>
  +                    <literal>maxRequestSize</literal> &mdash; the maximum size of a file upload request, in bytes.
  +                 </para>
  +                 </listitem>
  +               </itemizedlist>
  +               
  +               <para>
  +                 Here's an example:
  +               </para>
  +               
  +               <programlisting>
  +                 <![CDATA[
  +    <component class="org.jboss.seam.servlet.MultipartConfig">
  +        <property name="createTempFiles">true</property>
  +        <property name="maxRequestSize">1000000</property>
  +    </component>                 
  +                 ]]>
  +               </programlisting>
  +               
  +               <para>
  +                 And here's a list of the supported attributes for the <literal>fileUpload</literal> control:
  +               </para>
  +               
                  <itemizedlist>
                      <listitem>
                      <para>
                          <literal>data</literal> &mdash; this value binding receives the binary file data.  
  -                       The receiving field should be declared as a <literal>byte[]</literal> (required).
  +                       The receiving field should be declared as a <literal>byte[]</literal> or <literal>InputStream</literal> (required).
                      </para>
                      </listitem>
                      <listitem>