How to use

RFC2965Spec

in

org.apache.commons.httpclient.cookie

/**
 * @param policy cookie policy to get the CookieSpec for
 * @return cookie specification interface for the given policy
 * 
 * @deprecated Use {@link CookiePolicy#getCookieSpec(String)} 
 */
public static CookieSpec getSpecByPolicy(int policy) {
  switch(policy) {
    case COMPATIBILITY: 
      return new CookieSpecBase(); 
    case NETSCAPE_DRAFT: 
      return new NetscapeDraftSpec(); 
    case RFC2109:
      return new RFC2109Spec();
    case RFC2965:
      return new RFC2965Spec();
    default:
      return getDefaultSpec(); 
  }
}

private void doFormatCookie2(final Cookie2 cookie, final StringBuffer buffer) {
  String name = cookie.getName();
  String value = cookie.getValue();
  if (value == null) {
    value = "";
  }
  this.formatter.format(buffer, new NameValuePair(name, value));
  // format domain attribute
  if (cookie.getDomain() != null && cookie.isDomainAttributeSpecified()) {
    buffer.append("; ");
    this.formatter.format(buffer, new NameValuePair("$Domain", cookie.getDomain()));
  }
  // format path attribute
  if ((cookie.getPath() != null) && (cookie.isPathAttributeSpecified())) {
    buffer.append("; ");
    this.formatter.format(buffer, new NameValuePair("$Path", cookie.getPath()));
  }
  // format port attribute
  if (cookie.isPortAttributeSpecified()) {
    String portValue = "";
    if (!cookie.isPortAttributeBlank()) {
      portValue = createPortAttribute(cookie.getPorts());
    }
    buffer.append("; ");
    this.formatter.format(buffer, new NameValuePair("$Port", portValue));
  }
}

/**
 * Return a string suitable for sending in a <tt>"Cookie"</tt> header as
 * defined in RFC 2965
 * @param cookie a {@link org.apache.commons.httpclient.Cookie} to be formatted as string
 * @return a string suitable for sending in a <tt>"Cookie"</tt> header.
 */
public String formatCookie(final Cookie cookie) {
  LOG.trace("enter RFC2965Spec.formatCookie(Cookie)");
  if (cookie == null) {
    throw new IllegalArgumentException("Cookie may not be null");
  }
  if (cookie instanceof Cookie2) {
    Cookie2 cookie2 = (Cookie2) cookie;
    int version = cookie2.getVersion();
    final StringBuffer buffer = new StringBuffer();
    this.formatter.format(buffer, new NameValuePair("$Version", Integer.toString(version)));
    buffer.append("; ");
    doFormatCookie2(cookie2, buffer);
    return buffer.toString();
  } else {
    // old-style cookies are formatted according to the old rules
    return this.rfc2109.formatCookie(cookie);
  }
}

  return false;
CookieOrigin origin = new CookieOrigin(getEffectiveHost(host), port, path, secure); 
for (Iterator i = getAttribHandlerIterator(); i.hasNext(); ) {
  CookieAttributeHandler handler = (CookieAttributeHandler) i.next();
  if (!handler.match(cookie, origin)) {

  path = PATH_DELIM;
host = getEffectiveHost(host);
      parseAttribute((NameValuePair) entry.getValue(), cookie);

/**
 * Gets attribute handler {@link CookieAttributeHandler} for the
 * given attribute.
 *
 * @param name attribute name. e.g. Domain, Path, etc.
 * @throws IllegalStateException if handler not found for the
 *          specified attribute.
 */
protected CookieAttributeHandler getAttribHandler(final String name) {
  CookieAttributeHandler handler = findAttribHandler(name);
  if (handler == null) {
    throw new IllegalStateException("Handler not registered for " +
                    name + " attribute.");
  } else {
    return handler;
  }
}

/**
 * Match cookie domain attribute.
 */
public boolean match(final Cookie cookie, final CookieOrigin origin) {
  if (cookie == null) {
    throw new IllegalArgumentException("Cookie may not be null");
  }
  if (origin == null) {
    throw new IllegalArgumentException("Cookie origin may not be null");
  }
  String host = origin.getHost().toLowerCase();
  String cookieDomain = cookie.getDomain();
  // The effective host name MUST domain-match the Domain
  // attribute of the cookie.
  if (!domainMatch(host, cookieDomain)) {
    return false;
  }
  // effective host name minus domain must not contain any dots
  String effectiveHostWithoutDomain = host.substring(
      0, host.length() - cookieDomain.length());
  if (effectiveHostWithoutDomain.indexOf('.') != -1) {
    return false;
  }
  return true;
}

public Header getVersionHeader() {
  ParameterFormatter formatter = new ParameterFormatter();
  StringBuffer buffer = new StringBuffer();
  formatter.format(buffer, new NameValuePair("$Version",
      Integer.toString(getVersion())));
  return new Header("Cookie2", buffer.toString(), true);
}

  return parse(host, port, path, secure, header.getValue());
} else if (header.getName().equalsIgnoreCase(RFC2109Spec.SET_COOKIE_KEY)) {

  throw new MalformedCookieException("Cookie name may not start with $");
CookieOrigin origin = new CookieOrigin(getEffectiveHost(host), port, path, secure); 
for (Iterator i = getAttribHandlerIterator(); i.hasNext(); ) {
 CookieAttributeHandler handler = (CookieAttributeHandler) i.next();
 handler.validate(cookie, origin);

  path = PATH_DELIM;
host = getEffectiveHost(host);
      parseAttribute((NameValuePair) entry.getValue(), cookie);

final String paramValue = attribute.getValue();
CookieAttributeHandler handler = findAttribHandler(paramName);
if (handler == null) {

if (!domainMatch(host, cookieDomain)) {
  throw new MalformedCookieException(
      "Domain attribute \"" + cookie.getDomain()

public Header getVersionHeader() {
  ParameterFormatter formatter = new ParameterFormatter();
  StringBuffer buffer = new StringBuffer();
  formatter.format(buffer, new NameValuePair("$Version",
      Integer.toString(getVersion())));
  return new Header("Cookie2", buffer.toString(), true);
}

  return parse(host, port, path, secure, header.getValue());
} else if (header.getName().equalsIgnoreCase(RFC2109Spec.SET_COOKIE_KEY)) {

  return false;
CookieOrigin origin = new CookieOrigin(getEffectiveHost(host), port, path, secure); 
for (Iterator i = getAttribHandlerIterator(); i.hasNext(); ) {
  CookieAttributeHandler handler = (CookieAttributeHandler) i.next();
  if (!handler.match(cookie, origin)) {

  path = PATH_DELIM;
host = getEffectiveHost(host);
      parseAttribute((NameValuePair) entry.getValue(), cookie);

/**
 * Gets attribute handler {@link CookieAttributeHandler} for the
 * given attribute.
 *
 * @param name attribute name. e.g. Domain, Path, etc.
 * @throws IllegalStateException if handler not found for the
 *          specified attribute.
 */
protected CookieAttributeHandler getAttribHandler(final String name) {
  CookieAttributeHandler handler = findAttribHandler(name);
  if (handler == null) {
    throw new IllegalStateException("Handler not registered for " +
                    name + " attribute.");
  } else {
    return handler;
  }
}

Cookie2 cookie = (Cookie2) cookies[i];
doFormatCookie2(cookie, buffer);

/**
 * Match cookie domain attribute.
 */
public boolean match(final Cookie cookie, final CookieOrigin origin) {
  if (cookie == null) {
    throw new IllegalArgumentException("Cookie may not be null");
  }
  if (origin == null) {
    throw new IllegalArgumentException("Cookie origin may not be null");
  }
  String host = origin.getHost().toLowerCase();
  String cookieDomain = cookie.getDomain();
  // The effective host name MUST domain-match the Domain
  // attribute of the cookie.
  if (!domainMatch(host, cookieDomain)) {
    return false;
  }
  // effective host name minus domain must not contain any dots
  String effectiveHostWithoutDomain = host.substring(
      0, host.length() - cookieDomain.length());
  if (effectiveHostWithoutDomain.indexOf('.') != -1) {
    return false;
  }
  return true;
}