The aim of this interceptor is to set values in the stack/action based on cookie name/value of interest.
If an asterisk is present incookiesName parameter, it will be assume that all cookies name are to be injected into struts’ action, even thoughcookiesName is comma-separated by other values, e.g.(cookie1,*,cookie2).
IfcookiesName is left empty it will assume that no cookie will be injected into Struts’ action.
If an asterisk is present incookiesValue parameter, it will assume that all cookies name irrespective of its value will be injected into Struts’ action so long as the cookie name matches those specified incookiesName parameter.
IfcookiesValue is left empty it will assume that all cookie that match thecookieName parameter will be injected into Struts’ action.
The action could implementCookiesAware in order to have aMap of filtered cookies set into it.
cookiesName (mandatory) - Name of cookies to be injected into the action. If more than one cookie name is desired it could be comma-separated. If all cookies name is desired, it could simply be *, an asterisk. When many cookies name are comma-separated either of the cookie that match the name in the comma-separated list will be qualified.cookiesValue (mandatory) - Value of cookies that if its name matches cookieName attribute and its value matched this, will be injected into Struts’ action. If more than one cookie name is desired it could be comma-separated. If left empty, it will assume any value would be ok. If more than one value is specified (comma-separated) it will assume a match if either value is matched.acceptCookieNames (optional) - Pattern used to check if name of cookie matches the provided pattern.populateCookieValueIntoStack - this method will decide if this cookie value is qualified to be populated into the value stack (hence into the action itself)injectIntoCookiesAwareAction - this method will inject selected cookies (as ajava.util.Map) into action that implementsCookiesAware.<!-- This example will inject cookies named either 'cookie1' or 'cookie2' whose value could be either 'cookie1value' or 'cookie2value' into Struts' action. --><action...><interceptor-refname="cookie"><paramname="cookiesName">cookie1, cookie2</param><paramname="cookiesValue">cookie1value, cookie2value</param></interceptor-ref> ....</action><!-- This example will inject cookies named either 'cookie1' or 'cookie2' regardless of their value into Struts' action. --><action...><interceptor-refname="cookie"><paramname="cookiesName">cookie1, cookie2</param><paramname="cookiesValue">*</param><interceptor-ref> ...</action><!-- This example will inject cookies named either 'cookie1' with value 'cookie1value' or 'cookie2' with value 'cookie2value' into Struts' action. --><action...><interceptor-refname="cookie"><paramname="cookiesName">cookie1</param><paramname="cookiesValue">cookie1value</param></interceptor-ref><interceptor-refname="cookie"><paramname="cookiesName"<cookie2</param><paramname="cookiesValue">cookie2value</param></interceptor-ref> ....</action><!-- This example will inject any cookies regardless of its value into Struts' action. --><action...><interceptor-refname="cookie"><paramname="cookiesName">*</param><paramname="cookiesValue">*</param></interceptor-ref> ...</action>