Class CookieSpecBase

    • Constructor Summary

      Constructors 
      Constructor Description
      CookieSpecBase()
      Deprecated.
      Default constructor
    • Method Summary

      All Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      boolean domainMatch​(java.lang.String host, java.lang.String domain)
      Deprecated.
      Performs domain-match as implemented in common browsers.
      java.lang.String formatCookie​(Cookie cookie)
      Deprecated.
      Return a string suitable for sending in a "Cookie" header
      Header formatCookieHeader​(Cookie cookie)
      Deprecated.
      Create a "Cookie" Header containing the Cookie.
      Header formatCookieHeader​(Cookie[] cookies)
      Deprecated.
      Create a "Cookie" Header containing all Cookies in cookies.
      java.lang.String formatCookies​(Cookie[] cookies)
      Deprecated.
      Create a "Cookie" header value containing all Cookies in cookies suitable for sending in a "Cookie" header
      java.util.Collection getValidDateFormats()
      Deprecated.
      Returns the Collection of date patterns used for parsing.
      boolean match​(java.lang.String host, int port, java.lang.String path, boolean secure, Cookie cookie)
      Deprecated.
      Return true if the cookie should be submitted with a request with given attributes, false otherwise.
      Cookie[] match​(java.lang.String host, int port, java.lang.String path, boolean secure, Cookie[] cookies)
      Deprecated.
      Return an array of Cookies that should be submitted with a request with given attributes, false otherwise.
      Cookie[] parse​(java.lang.String host, int port, java.lang.String path, boolean secure, java.lang.String header)
      Deprecated.
      Parses the Set-Cookie value into an array of Cookies.
      Cookie[] parse​(java.lang.String host, int port, java.lang.String path, boolean secure, Header header)
      Deprecated.
      Parse the "Set-Cookie" Header into an array of Cookies.
      void parseAttribute​(NameValuePair attribute, Cookie cookie)
      Deprecated.
      Parse the cookie attribute and update the corresponsing Cookie properties.
      boolean pathMatch​(java.lang.String path, java.lang.String topmostPath)
      Deprecated.
      Performs path-match as implemented in common browsers.
      void setValidDateFormats​(java.util.Collection datepatterns)
      Deprecated.
      Sets the Collection of date patterns used for parsing.
      void validate​(java.lang.String host, int port, java.lang.String path, boolean secure, Cookie cookie)
      Deprecated.
      Performs most common Cookie validation
      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • CookieSpecBase

        public CookieSpecBase()
        Deprecated.
        Default constructor
    • Method Detail

      • parse

        public Cookie[] parse​(java.lang.String host,
                              int port,
                              java.lang.String path,
                              boolean secure,
                              java.lang.String header)
                       throws MalformedCookieException
        Deprecated.
        Parses the Set-Cookie value into an array of Cookies.

        The syntax for the Set-Cookie response header is:

         set-cookie      =    "Set-Cookie:" cookies
         cookies         =    1#cookie
         cookie          =    NAME "=" VALUE * (";" cookie-av)
         NAME            =    attr
         VALUE           =    value
         cookie-av       =    "Comment" "=" value
                         |    "Domain" "=" value
                         |    "Max-Age" "=" value
                         |    "Path" "=" value
                         |    "Secure"
                         |    "Version" "=" 1*DIGIT
         
        Specified by:
        parse in interface CookieSpec
        Parameters:
        host - the host from which the Set-Cookie value was received
        port - the port from which the Set-Cookie value was received
        path - the path from which the Set-Cookie value was received
        secure - true when the Set-Cookie value was received over secure conection
        header - the Set-Cookie received from the server
        Returns:
        an array of Cookies parsed from the Set-Cookie value
        Throws:
        MalformedCookieException - if an exception occurs during parsing
        See Also:
        CookieSpec.validate(String, int, String, boolean, Cookie)
      • parse

        public Cookie[] parse​(java.lang.String host,
                              int port,
                              java.lang.String path,
                              boolean secure,
                              Header header)
                       throws MalformedCookieException
        Deprecated.
        Parse the "Set-Cookie" Header into an array of Cookies.

        The syntax for the Set-Cookie response header is:

         set-cookie      =    "Set-Cookie:" cookies
         cookies         =    1#cookie
         cookie          =    NAME "=" VALUE * (";" cookie-av)
         NAME            =    attr
         VALUE           =    value
         cookie-av       =    "Comment" "=" value
                         |    "Domain" "=" value
                         |    "Max-Age" "=" value
                         |    "Path" "=" value
                         |    "Secure"
                         |    "Version" "=" 1*DIGIT
         
        Specified by:
        parse in interface CookieSpec
        Parameters:
        host - the host from which the Set-Cookie header was received
        port - the port from which the Set-Cookie header was received
        path - the path from which the Set-Cookie header was received
        secure - true when the Set-Cookie header was received over secure conection
        header - the Set-Cookie received from the server
        Returns:
        an array of Cookies parsed from the "Set-Cookie" header
        Throws:
        MalformedCookieException - if an exception occurs during parsing
        See Also:
        CookieSpec.validate(String, int, String, boolean, Cookie)
      • getValidDateFormats

        public java.util.Collection getValidDateFormats()
        Deprecated.
        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:
        collection of date patterns
      • setValidDateFormats

        public void setValidDateFormats​(java.util.Collection datepatterns)
        Deprecated.
        Description copied from interface: CookieSpec
        Sets the Collection of date patterns used for parsing. The String patterns must be compatible with SimpleDateFormat.
        Specified by:
        setValidDateFormats in interface CookieSpec
        Parameters:
        datepatterns - collection of date patterns
      • validate

        public void validate​(java.lang.String host,
                             int port,
                             java.lang.String path,
                             boolean secure,
                             Cookie cookie)
                      throws MalformedCookieException
        Deprecated.
        Performs most common Cookie validation
        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 an exception occurs during validation
      • match

        public boolean match​(java.lang.String host,
                             int port,
                             java.lang.String path,
                             boolean secure,
                             Cookie cookie)
        Deprecated.
        Return true if the cookie should be submitted with a request with given attributes, false otherwise.
        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 (ignored)
        path - the path to which the request is being submitted
        secure - true if the request is using a secure connection
        cookie - Cookie to be matched
        Returns:
        true if the cookie matches the criterium
      • domainMatch

        public boolean domainMatch​(java.lang.String host,
                                   java.lang.String domain)
        Deprecated.
        Performs domain-match as implemented in common browsers.
        Specified by:
        domainMatch in interface CookieSpec
        Parameters:
        host - The target host.
        domain - The cookie domain attribute.
        Returns:
        true if the specified host matches the given domain.
      • pathMatch

        public boolean pathMatch​(java.lang.String path,
                                 java.lang.String topmostPath)
        Deprecated.
        Performs path-match as implemented in common browsers.
        Specified by:
        pathMatch in interface CookieSpec
        Parameters:
        path - The target path.
        topmostPath - The cookie path attribute.
        Returns:
        true if the paths match
      • match

        public Cookie[] match​(java.lang.String host,
                              int port,
                              java.lang.String path,
                              boolean secure,
                              Cookie[] cookies)
        Deprecated.
        Return an array of Cookies that should be submitted with a request with given attributes, false otherwise.
        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 (currently 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 Cookies to be matched
        Returns:
        an array of Cookies matching the criterium
      • formatCookie

        public java.lang.String formatCookie​(Cookie cookie)
        Deprecated.
        Return a string suitable for sending in a "Cookie" header
        Specified by:
        formatCookie in interface CookieSpec
        Parameters:
        cookie - a Cookie to be formatted as string
        Returns:
        a string suitable for sending in a "Cookie" header.
      • formatCookies

        public java.lang.String formatCookies​(Cookie[] cookies)
                                       throws java.lang.IllegalArgumentException
        Deprecated.
        Create a "Cookie" header value containing all Cookies in cookies suitable for sending in a "Cookie" header
        Specified by:
        formatCookies in interface CookieSpec
        Parameters:
        cookies - an array of Cookies to be formatted
        Returns:
        a string suitable for sending in a Cookie header.
        Throws:
        java.lang.IllegalArgumentException - if an input parameter is illegal
      • formatCookieHeader

        public Header formatCookieHeader​(Cookie cookie)
        Deprecated.
        Create a "Cookie" Header containing the Cookie.
        Specified by:
        formatCookieHeader in interface CookieSpec
        Parameters:
        cookie - Cookies to be formatted as a Cookie header
        Returns:
        a Cookie header.