Package org.apache.tomcat.util.http.fileupload

## Interface FileItemHeaders

- All Known Implementing Classes:
    `FileItemHeadersImpl`

      public interface FileItemHeaders

  This class provides support for accessing the headers for a file or form item that was received within a `multipart/form-data` POST request.

  Since:
    1.2.1

- - ### Method Summary

    All Methods Instance Methods Abstract Methods
    Modifier and Type | Method | Description
    --- | --- | ---
    `String` | `getHeader​(String name)` | Returns the value of the specified part header as a `String`.
    `Iterator<String>` | `getHeaderNames()` | Returns an `Iterator` of all the header names.
    `Iterator<String>` | `getHeaders​(String name)` | Returns all the values of the specified item header as an `Iterator` of `String` objects.

- - ### Method Detail

    - #### getHeader

          String getHeader​(String name)

      Returns the value of the specified part header as a `String`. If the part did not include a header of the specified name, this method return `null`. If there are multiple headers with the same name, this method returns the first header in the item. The header name is case insensitive.
      Parameters:
        `name` - a `String` specifying the header name
      Returns:
        a `String` containing the value of the requested header, or `null` if the item does not have a header of that name

    - #### getHeaders

          Iterator<String> getHeaders​(String name)

      Returns all the values of the specified item header as an `Iterator` of `String` objects.

      If the item did not include any headers of the specified name, this method returns an empty `Iterator`. The header name is case insensitive.

      Parameters:
        `name` - a `String` specifying the header name
      Returns:
        an `Iterator` containing the values of the requested header. If the item does not have any headers of that name, return an empty `Iterator`

    - #### getHeaderNames

          Iterator<String> getHeaderNames()

      Returns an `Iterator` of all the header names.

      Returns:
        an `Iterator` containing all of the names of headers provided with this file item. If the item does not have any headers return an empty `Iterator`