java.lang.Object
- org.apache.commons.httpclient.cookie.CookiePolicy

```
@Deprecated
public abstract class CookiePolicy
extends Object
```
Deprecated.
Jakarta Commons HttpClient 3.x is deprecated in the Jenkins project. It is not recommended to use it in any new code. Instead, use HTTP client API plugins as a dependency in your code. E.g. Apache HttpComponents Client API 4.x Plugin or Async HTTP Client Plugin.
Cookie management policy class. The cookie policy provides corresponding cookie management interfrace for a given type or version of cookie.
RFC 2109 specification is used per default. Other supported specification can be chosen when appropriate or set default when desired
The following specifications are provided:
- BROWSER_COMPATIBILITY: compatible with the common cookie management practices (even if they are not 100% standards compliant)
- NETSCAPE: Netscape cookie draft compliant
- RFC_2109: RFC2109 compliant (default)
- IGNORE_COOKIES: do not automcatically process cookies
Since:

2.0

Field Summary

Fields
Modifier and Type	Field	Description
`static String`	`BROWSER_COMPATIBILITY`	Deprecated. The policy that provides high degree of compatibilty with common cookie management of popular HTTP agents.
`static int`	`COMPATIBILITY`	Deprecated. Use `BROWSER_COMPATIBILITY`
`static String`	`DEFAULT`	Deprecated. The default cookie policy.
`static String`	`IGNORE_COOKIES`	Deprecated. The policy that ignores cookies.
`static String`	`NETSCAPE`	Deprecated. The Netscape cookie draft compliant policy.
`static int`	`NETSCAPE_DRAFT`	Deprecated. Use `NETSCAPE`
`static String`	`RFC_2109`	Deprecated. The RFC 2109 compliant policy.
`static String`	`RFC_2965`	Deprecated. The RFC 2965 compliant policy.
`static int`	`RFC2109`	Deprecated. Use `RFC_2109`
`static int`	`RFC2965`	Deprecated. Use `RFC_2965`

Constructor Summary

Constructors
Constructor Description

CookiePolicy()
Deprecated.

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	Description
`static CookieSpec`	`getCompatibilitySpec()`	Deprecated. Use `getCookieSpec(String)`
`static CookieSpec`	`getCookieSpec(String id)`	Deprecated. Gets the `cookie specification` with the given ID.
`static int`	`getDefaultPolicy()`	Deprecated. Use `getDefaultSpec()`
`static CookieSpec`	`getDefaultSpec()`	Deprecated. Returns `cookie specification` registered as `DEFAULT`.
`static String[]`	`getRegisteredCookieSpecs()`	Deprecated. Obtains the currently registered cookie policy names.
`static CookieSpec`	`getSpecByPolicy(int policy)`	Deprecated. Use `getCookieSpec(String)`
`static CookieSpec`	`getSpecByVersion(int ver)`	Deprecated. Use `getCookieSpec(String)`
`static void`	`registerCookieSpec(String id, Class clazz)`	Deprecated. Registers a new `cookie specification` with the given identifier.
`static void`	`setDefaultPolicy(int policy)`	Deprecated. Use `registerCookieSpec(String, Class)`
`static void`	`unregisterCookieSpec(String id)`	Deprecated. Unregisters the `cookie specification` with the given ID.

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

- Field Detail
  - BROWSER_COMPATIBILITY
```
public static final String BROWSER_COMPATIBILITY
```
    Deprecated.
    
    The policy that provides high degree of compatibilty with common cookie management of popular HTTP agents.
    
    Since:
    
    3.0
    
    See Also:
    
    Constant Field Values
  - NETSCAPE
```
public static final String NETSCAPE
```
    Deprecated.
    
    The Netscape cookie draft compliant policy.
    
    Since:
    
    3.0
    
    See Also:
    
    Constant Field Values
  - RFC_2109
```
public static final String RFC_2109
```
    Deprecated.
    
    The RFC 2109 compliant policy.
    
    Since:
    
    3.0
    
    See Also:
    
    Constant Field Values
  - RFC_2965
```
public static final String RFC_2965
```
    Deprecated.
    
    The RFC 2965 compliant policy.
    
    Since:
    
    3.0
    
    See Also:
    
    Constant Field Values
  - IGNORE_COOKIES
```
public static final String IGNORE_COOKIES
```
    Deprecated.
    
    The policy that ignores cookies.
    
    Since:
    
    3.0
    
    See Also:
    
    Constant Field Values
  - DEFAULT
```
public static final String DEFAULT
```
    Deprecated.
    
    The default cookie policy.
    
    Since:
    
    3.0
    
    See Also:
    
    Constant Field Values
  - COMPATIBILITY
```
public static final int COMPATIBILITY
```
    Deprecated.
    Use BROWSER_COMPATIBILITY
    
    The COMPATIBILITY policy provides high compatibilty with common cookie management of popular HTTP agents.
    
    See Also:
    
    Constant Field Values
  - NETSCAPE_DRAFT
```
public static final int NETSCAPE_DRAFT
```
    Deprecated.
    Use NETSCAPE
    
    The NETSCAPE_DRAFT Netscape draft compliant policy.
    
    See Also:
    
    Constant Field Values
  - RFC2109
```
public static final int RFC2109
```
    Deprecated.
    Use RFC_2109
    
    The RFC2109 RFC 2109 compliant policy.
    
    See Also:
    
    Constant Field Values
  - RFC2965
```
public static final int RFC2965
```
    Deprecated.
    Use RFC_2965
    
    The RFC2965 RFC 2965 compliant policy.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - CookiePolicy
```
public CookiePolicy()
```
    Deprecated.
- Method Detail
  - registerCookieSpec
```
public static void registerCookieSpec(String id,
                                      Class clazz)
```
    Deprecated.
    
    Registers a new cookie specification with the given identifier. If a specification with the given ID already exists it will be overridden. This ID is the same one used to retrieve the cookie specification from getCookieSpec(String).
    
    Parameters:
    
    id - the identifier for this specification
    
    clazz - the cookie specification class to register
    
    Since:
    
    3.0
    
    See Also:
    
    getCookieSpec(String)
  - unregisterCookieSpec
```
public static void unregisterCookieSpec(String id)
```
    Deprecated.
    
    Unregisters the cookie specification with the given ID.
    
    Parameters:
    
    id - the ID of the cookie specification to unregister
    
    Since:
    
    3.0
  - getCookieSpec
```
public static CookieSpec getCookieSpec(String id)
                                throws IllegalStateException
```
    Deprecated.
    
    Gets the cookie specification with the given ID.
    
    Parameters:
    
    id - the cookie specification ID
    
    Returns:
    
    cookie specification
    
    Throws:
    
    IllegalStateException - if a policy with the ID cannot be found
    
    Since:
    
    3.0
  - getDefaultPolicy
```
public static int getDefaultPolicy()
```
    Deprecated.
    Use getDefaultSpec()
    
    Returns:
    
    default cookie policy
    
    See Also:
    
    getDefaultSpec()
  - setDefaultPolicy
```
public static void setDefaultPolicy(int policy)
```
    Deprecated.
    Use registerCookieSpec(String, Class)
    
    Parameters:
    
    policy - new default cookie policy
    
    See Also:
    
    DEFAULT
  - getSpecByPolicy
```
public static CookieSpec getSpecByPolicy(int policy)
```
    Deprecated.
    Use getCookieSpec(String)
    
    Parameters:
    
    policy - cookie policy to get the CookieSpec for
    
    Returns:
    
    cookie specification interface for the given policy
  - getDefaultSpec
```
public static CookieSpec getDefaultSpec()
```
    Deprecated.
    
    Returns cookie specification registered as DEFAULT. If no default cookie specification has been registered, RFC2109 specification is returned.
    
    Returns:
    
    default cookie specification
    
    See Also:
    
    DEFAULT
  - getSpecByVersion
```
public static CookieSpec getSpecByVersion(int ver)
```
    Deprecated.
    Use getCookieSpec(String)
    Gets the CookieSpec for a particular cookie version.
    Supported versions:
    
    version 0 corresponds to the Netscape draft
    version 1 corresponds to the RFC 2109
    Any other cookie value coresponds to the default spec
    Parameters:
    
    ver - the cookie version to get the spec for
    
    Returns:
    
    cookie specification interface intended for processing cookies with the given version
  - getCompatibilitySpec
```
public static CookieSpec getCompatibilitySpec()
```
    Deprecated.
    Use getCookieSpec(String)
    
    Returns:
    
    cookie specification interface that provides high compatibilty with common cookie management of popular HTTP agents
  - getRegisteredCookieSpecs
```
public static String[] getRegisteredCookieSpecs()
```
    Deprecated.
    
    Obtains the currently registered cookie policy names. Note that the DEFAULT policy (if present) is likely to be the same as one of the other policies, but does not have to be.
    
    Returns:
    
    array of registered cookie policy names
    
    Since:
    
    3.1

Class CookiePolicy

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

BROWSER_COMPATIBILITY

NETSCAPE

RFC_2109

RFC_2965

IGNORE_COOKIES

DEFAULT

COMPATIBILITY

NETSCAPE_DRAFT

RFC2109

RFC2965

Constructor Detail

CookiePolicy

Method Detail

registerCookieSpec

unregisterCookieSpec

getCookieSpec

getDefaultPolicy

setDefaultPolicy

getSpecByPolicy

getDefaultSpec

getSpecByVersion

getCompatibilitySpec

getRegisteredCookieSpecs