org.apache.tapestry5.upload.internal.services

## Class MultipartDecoderImpl

- java.lang.Object
- - org.apache.tapestry5.upload.internal.services.MultipartDecoderImpl

- All Implemented Interfaces:
    EventListener, ThreadCleanupListener, MultipartDecoder

      public class MultipartDecoderImpl
      extends Object
      implements MultipartDecoder, ThreadCleanupListener

  Implementation of multipart decoder for servlets. This implementation is perthread scope.

- - ### Constructor Summary

    Constructors
    Constructor and Description
    `MultipartDecoderImpl(org.apache.commons.fileupload.FileItemFactory fileItemFactory, long maxRequestSize, long maxFileSize, String requestEncoding)`

  - ### Method Summary

    All Methods Instance Methods Concrete Methods
    Modifier and Type | Method and Description
    --- | ---
    `protected void` | `addUploadedFile(String name, UploadedFileItem file)`
    `protected org.apache.commons.fileupload.servlet.ServletFileUpload` | `createFileUpload()`
    `HttpServletRequest` | `decode(HttpServletRequest request)` Decodes the request, returning a new `HttpServletRequest` implementation that will allow access to the form fields submitted in the request (but omits uploaded files).
    `UploadedFile` | `getFileUpload(String parameterName)`
    `org.apache.commons.fileupload.FileUploadException` | `getUploadException()` Returns the exception the occured during the file upload, or null if the processing of the multipart upload stream was succesful.
    `protected List<org.apache.commons.fileupload.FileItem>` | `parseRequest(HttpServletRequest request)`
    `protected HttpServletRequest` | `processFileItems(HttpServletRequest request, List<org.apache.commons.fileupload.FileItem> fileItems)`
    `void` | `threadDidCleanup()` Invoked by `PerthreadManager` service when a thread performs and end-of-request cleanup.

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### Constructor Detail

    - #### MultipartDecoderImpl

          public MultipartDecoderImpl(org.apache.commons.fileupload.FileItemFactory fileItemFactory,
                                      @Symbol(value="upload.requestsize-max")
                                      long maxRequestSize,
                                      @Symbol(value="upload.filesize-max")
                                      long maxFileSize,
                                      @Symbol(value="tapestry.charset")
                                      String requestEncoding)

  - ### Method Detail

    - #### getFileUpload

          public UploadedFile getFileUpload(String parameterName)

      Specified by:
        `getFileUpload` in interface `MultipartDecoder`
      Parameters:
        `parameterName` - Name of the query parameter associated with the uploaded file
      Returns:
        a file upload with the given name, or null if no such file upload was in the request.

    - #### decode

          public HttpServletRequest decode(HttpServletRequest request)

      Description copied from interface: `MultipartDecoder`
      Decodes the request, returning a new `HttpServletRequest` implementation that will allow access to the form fields submitted in the request (but omits uploaded files).
      Specified by:
        `decode` in interface `MultipartDecoder`
      Parameters:
        `request` - The incoming servlet request
      Returns:
        decoded http request

    - #### threadDidCleanup

          public void threadDidCleanup()

      Description copied from interface: `ThreadCleanupListener`
      Invoked by `PerthreadManager` service when a thread performs and end-of-request cleanup.
      Specified by:
        `threadDidCleanup` in interface `ThreadCleanupListener`

    - #### parseRequest

          protected List<org.apache.commons.fileupload.FileItem> parseRequest(HttpServletRequest request)

    - #### createFileUpload

          protected org.apache.commons.fileupload.servlet.ServletFileUpload createFileUpload()

    - #### processFileItems

          protected HttpServletRequest processFileItems(HttpServletRequest request,
                                                        List<org.apache.commons.fileupload.FileItem> fileItems)

    - #### addUploadedFile

          protected void addUploadedFile(String name,
                                         UploadedFileItem file)

    - #### getUploadException

          public org.apache.commons.fileupload.FileUploadException getUploadException()

      Description copied from interface: `MultipartDecoder`
      Returns the exception the occured during the file upload, or null if the processing of the multipart upload stream was succesful.
      Specified by:
        `getUploadException` in interface `MultipartDecoder`

${project.version} - Copyright © 2003-2015 The Apache Software Foundation.