Class Cookie

  • Direct Known Subclasses:
    NewCookie

    public class Cookie
    extends Object
    Represents the value of a HTTP cookie, transferred in a request. RFC 2109 specifies the legal characters for name, value, path and domain. The default version of 1 corresponds to RFC 2109.
    See Also:
    IETF RFC 2109
    • Field Detail

      • DEFAULT_VERSION

        public static final int DEFAULT_VERSION
        Cookies using the default version correspond to RFC 2109.
        See Also:
        Constant Field Values
    • Constructor Detail

      • Cookie

        public Cookie​(String name,
                      String value,
                      String path,
                      String domain,
                      int version)
        Create a new instance.
        Parameters:
        name - the name of the cookie
        value - the value of the cookie
        path - the URI path for which the cookie is valid
        domain - the host domain for which the cookie is valid
        version - the version of the specification to which the cookie complies
        Throws:
        IllegalArgumentException - if name is null
      • Cookie

        public Cookie​(String name,
                      String value,
                      String path,
                      String domain)
        Create a new instance.
        Parameters:
        name - the name of the cookie
        value - the value of the cookie
        path - the URI path for which the cookie is valid
        domain - the host domain for which the cookie is valid
        Throws:
        IllegalArgumentException - if name is null
      • Cookie

        public Cookie​(String name,
                      String value)
        Create a new instance.
        Parameters:
        name - the name of the cookie
        value - the value of the cookie
        Throws:
        IllegalArgumentException - if name is null
    • Method Detail

      • valueOf

        public static Cookie valueOf​(String value)
                              throws IllegalArgumentException
        Creates a new instance of Cookie by parsing the supplied string.
        Parameters:
        value - the cookie string
        Returns:
        the newly created Cookie
        Throws:
        IllegalArgumentException - if the supplied string cannot be parsed or is null
      • getName

        public String getName()
        Get the name of the cookie
        Returns:
        the name
      • getValue

        public String getValue()
        Get the value of the cookie
        Returns:
        the value
      • getVersion

        public int getVersion()
        Get the version of the cookie
        Returns:
        the version
      • getDomain

        public String getDomain()
        Get the domain of the cookie
        Returns:
        the domain
      • getPath

        public String getPath()
        Get the path of the cookie
        Returns:
        the path
      • toString

        public String toString()
        Convert the cookie to a string suitable for use as the value of the corresponding HTTP header.
        Overrides:
        toString in class Object
        Returns:
        a stringified cookie
      • hashCode

        public int hashCode()
        Generate a hashcode by hashing all of the cookies properties
        Overrides:
        hashCode in class Object
        Returns:
        the hashcode
      • equals

        public boolean equals​(Object obj)
        Compare for equality
        Overrides:
        equals in class Object
        Parameters:
        obj - the object to compare to
        Returns:
        true if the object is a Cookie with the same value for all properties, false otherwise.