Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.apache.commons.httpclient.cookie
Class IgnoreCookiesSpec

    java.lang.Object
      org.apache.commons.httpclient.cookie.IgnoreCookiesSpec

All Implemented Interfaces:
  CookieSpec

    public class IgnoreCookiesSpec

extends Object
implements CookieSpec

A cookie spec that does nothing. Cookies are neither parsed, formatted nor matched. It can be used to effectively disable cookies altogether.

Since:
  3.0

Field Summary

Fields inherited from interface org.apache.commons.httpclient.cookie.CookieSpec
`PATH_DELIM, PATH_DELIM_CHAR`

Constructor Summary
`IgnoreCookiesSpec()`

Method Summary
`boolean` | `domainMatch(String host, String domain)` Performs domain-match as defined by the cookie specification.
`String` | `formatCookie(Cookie cookie)` Create a `"Cookie"` header value for an array of cookies.
`Header` | `formatCookieHeader(Cookie cookie)` Create a `"Cookie"` Header for single Cookie.
`Header` | `formatCookieHeader(Cookie[] cookies)` Create a `"Cookie"` Header for an array of Cookies.
`String` | `formatCookies(Cookie[] cookies)` Create a `"Cookie"` header value for an array of cookies.
`Collection` | `getValidDateFormats()` Returns the `Collection` of date patterns used for parsing.
`boolean` | `match(String host, int port, String path, boolean secure, Cookie cookie)` Determines if a Cookie matches a location.
`Cookie[]` | `match(String host, int port, String path, boolean secure, Cookie[] cookies)` Returns an empty `cookie` array.
`Cookie[]` | `parse(String host, int port, String path, boolean secure, Header header)` Returns an empty `cookie` array.
`Cookie[]` | `parse(String host, int port, String path, boolean secure, String header)` Returns an empty `cookie` array.
`void` | `parseAttribute(NameValuePair attribute, Cookie cookie)` Does nothing.
`boolean` | `pathMatch(String path, String topmostPath)` Performs path-match as defined by the cookie specification.
`void` | `setValidDateFormats(Collection datepatterns)` Does nothing.
`void` | `validate(String host, int port, String path, boolean secure, Cookie cookie)` Does nothing.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

### IgnoreCookiesSpec

    public IgnoreCookiesSpec()

Method Detail

### parse

    public Cookie[] parse(String host,
                          int port,
                          String path,
                          boolean secure,
                          String header)
                   throws MalformedCookieException

  Returns an empty `cookie` array. All parameters are ignored.

  Specified by:
    `parse` in interface `CookieSpec`
  Parameters:
    `host` - the host which sent the `Set-Cookie` header
    `port` - the port which sent the `Set-Cookie` header
    `path` - the path which sent the `Set-Cookie` header
    `secure` - `true` when the `Set-Cookie` header was received over secure conection
    `header` - the `Set-Cookie` received from the server
  Returns:
    an array of `Cookie`s parsed from the Set-Cookie value
  Throws:
    `MalformedCookieException` - if an exception occurs during parsing
  See Also:
    `CookieSpec.validate(String, int, String, boolean, Cookie)`

### getValidDateFormats

    public Collection getValidDateFormats()

  Description copied from interface: `CookieSpec`
  Returns the `Collection` of date patterns used for parsing. The String patterns are compatible with the `SimpleDateFormat`.

  Specified by:
    `getValidDateFormats` in interface `CookieSpec`
  Returns:
    `null`

### setValidDateFormats

    public void setValidDateFormats(Collection datepatterns)

  Does nothing.

  Specified by:
    `setValidDateFormats` in interface `CookieSpec`
  Parameters:
    `datepatterns` - collection of date patterns

### formatCookie

    public String formatCookie(Cookie cookie)

  Description copied from interface: `CookieSpec`
  Create a `"Cookie"` header value for an array of cookies.

  Specified by:
    `formatCookie` in interface `CookieSpec`
  Parameters:
    `cookie` - the cookie to be formatted as string
  Returns:
    `null`

### formatCookieHeader

    public Header formatCookieHeader(Cookie cookie)
                              throws IllegalArgumentException

  Description copied from interface: `CookieSpec`
  Create a `"Cookie"` Header for single Cookie.

  Specified by:
    `formatCookieHeader` in interface `CookieSpec`
  Parameters:
    `cookie` - the Cookie format as a `Cookie` header
  Returns:
    `null`
  Throws:
    `IllegalArgumentException` - if an input parameter is illegal

### formatCookieHeader

    public Header formatCookieHeader(Cookie[] cookies)
                              throws IllegalArgumentException

  Description copied from interface: `CookieSpec`
  Create a `"Cookie"` Header for an array of Cookies.

  Specified by:
    `formatCookieHeader` in interface `CookieSpec`
  Parameters:
    `cookies` - the Cookies format into a Cookie header
  Returns:
    `null`
  Throws:
    `IllegalArgumentException` - if an input parameter is illegal

### formatCookies

    public String formatCookies(Cookie[] cookies)
                         throws IllegalArgumentException

  Description copied from interface: `CookieSpec`
  Create a `"Cookie"` header value for an array of cookies.

  Specified by:
    `formatCookies` in interface `CookieSpec`
  Parameters:
    `cookies` - the Cookies to be formatted
  Returns:
    `null`
  Throws:
    `IllegalArgumentException` - if an input parameter is illegal

### match

    public boolean match(String host,
                         int port,
                         String path,
                         boolean secure,
                         Cookie cookie)

  Description copied from interface: `CookieSpec`
  Determines if a Cookie matches a location.

  Specified by:
    `match` in interface `CookieSpec`
  Parameters:
    `host` - the host to which the request is being submitted
    `port` - the port to which the request is being submitted
    `path` - the path to which the request is being submitted
    `secure` - `true` if the request is using a secure connection
    `cookie` - the Cookie to be matched
  Returns:
    `false`

### match

    public Cookie[] match(String host,
                          int port,
                          String path,
                          boolean secure,
                          Cookie[] cookies)

  Returns an empty `cookie` array. All parameters are ignored.

  Specified by:
    `match` in interface `CookieSpec`
  Parameters:
    `host` - the host to which the request is being submitted
    `port` - the port to which the request is being submitted (currenlty ignored)
    `path` - the path to which the request is being submitted
    `secure` - `true` if the request is using a secure protocol
    `cookies` - an array of `Cookie`s to be matched
  Returns:
    `true` if the cookie should be submitted with a request with given attributes, `false` otherwise.

### parse

    public Cookie[] parse(String host,
                          int port,
                          String path,
                          boolean secure,
                          Header header)
                   throws MalformedCookieException,
                          IllegalArgumentException

  Returns an empty `cookie` array. All parameters are ignored.

  Specified by:
    `parse` in interface `CookieSpec`
  Parameters:
    `host` - the host which sent the `Set-Cookie` header
    `port` - the port which sent the `Set-Cookie` header
    `path` - the path which sent the `Set-Cookie` header
    `secure` - `true` when the `Set-Cookie` header was received over secure conection
    `header` - the `Set-Cookie` received from the server
  Returns:
    an array of `Cookie`s parsed from the header
  Throws:
    `MalformedCookieException` - if an exception occurs during parsing
    `IllegalArgumentException` - if an input parameter is illegal
  See Also:
    `CookieSpec.validate(String, int, String, boolean, Cookie)`

### parseAttribute

    public void parseAttribute(NameValuePair attribute,
                               Cookie cookie)
                        throws MalformedCookieException,
                               IllegalArgumentException

  Does nothing.

  Specified by:
    `parseAttribute` in interface `CookieSpec`
  Parameters:
    `attribute` - cookie attribute from the `Set-Cookie`
    `cookie` - the to be updated
  Throws:
    `MalformedCookieException` - if an exception occurs during parsing
    `IllegalArgumentException` - if an input parameter is illegal

### validate

    public void validate(String host,
                         int port,
                         String path,
                         boolean secure,
                         Cookie cookie)
                  throws MalformedCookieException,
                         IllegalArgumentException

  Does nothing.

  Specified by:
    `validate` in interface `CookieSpec`
  Parameters:
    `host` - the host from which the `Cookie` was received
    `port` - the port from which the `Cookie` was received
    `path` - the path from which the `Cookie` was received
    `secure` - `true` when the `Cookie` was received using a secure connection
    `cookie` - the Cookie to validate
  Throws:
    `MalformedCookieException` - if the cookie is invalid
    `IllegalArgumentException` - if an input parameter is illegal

### domainMatch

    public boolean domainMatch(String host,
                               String domain)

  Description copied from interface: `CookieSpec`
  Performs domain-match as defined by the cookie specification.

  Specified by:
    `domainMatch` in interface `CookieSpec`
  Parameters:
    `host` - The target host.
    `domain` - The cookie domain attribute.
  Returns:
    `false`

### pathMatch

    public boolean pathMatch(String path,
                             String topmostPath)

  Description copied from interface: `CookieSpec`
  Performs path-match as defined by the cookie specification.

  Specified by:
    `pathMatch` in interface `CookieSpec`
  Parameters:
    `path` - The target path.
    `topmostPath` - The cookie path attribute.
  Returns:
    `false`

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2001-2007 Apache Software Foundation. All Rights Reserved.