KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > taglibs > request > EqualsCookieTag


1 /*
2  * Copyright 1999,2004 The Apache Software Foundation.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16
17 package org.apache.taglibs.request;
18
19 import java.util.*;
20 import javax.servlet.*;
21 import javax.servlet.http.*;
22 import javax.servlet.jsp.*;
23 import javax.servlet.jsp.tagext.*;
24
25 /**
26  * JSP Tag <b>equalsCookie</b>, used to determine if a Request
27  * cookie equals the value of the "match" tag attribute.
28  * <p>
29  * Includes the body of the tag if the cookie equals the value of the
30  * "match" tag cookie.
31  * <p>
32  * You can set the optional tag cookie <b>value</b> to <i>true</i> or
33  * <i>false</i>. The body of the tag is included if equalsCookie matches
34  * the value.
35  * <p>
36  * You can set the optional tag cookie <b>ignoreCase</b> to <i>true</i> or
37  * <i>false</i>. If ignoreCase is set to true, then the comparison between the
38  * request cookie and the "match" tag attribute will <i>not</i> be
39  * case-sensitive.
40  * <p>
41  * JSP Tag Lib Descriptor
42  * <p><pre>
43  * &lt;name>equalsCookie&lt;/name>
44  * &lt;tagclass>org.apache.taglibs.request.EqualsCookieTag&lt;/tagclass>
45  * &lt;bodycontent>JSP&lt;/bodycontent>
46  * &lt;info>Includes the body of the tag if the request cookie equals the
47  * value of the "match" tag cookie.&lt;/info>
48  * &lt;attribute>
49  * &lt;name>name&lt;/name>
50  * &lt;required>true&lt;/required>
51  * &lt;rtexprvalue>false&lt;/rtexprvalue>
52  * &lt;/attribute>
53  * &lt;attribute>
54  * &lt;name>value&lt;/name>
55  * &lt;required>false&lt;/required>
56  * &lt;rtexprvalue>false&lt;/rtexprvalue>
57  * &lt;/attribute>
58  * &lt;attribute>
59  * &lt;name>match&lt;/name>
60  * &lt;required>true&lt;/required>
61  * &lt;rtexprvalue>true&lt;/rtexprvalue>
62  * &lt;/attribute>
63  * &lt;attribute>
64  * &lt;name>ignoreCase&lt;/name>
65  * &lt;required>false&lt;/required>
66  * &lt;rtexprvalue>false&lt;/rtexprvalue>
67  * &lt;/attribute>
68  * </pre>
69  *
70  * @author Glenn Nielsen
71  */
72
73
74 public class EqualsCookieTag extends TagSupport
75 {
76     private String JavaDoc name = null;
77     private String JavaDoc match = null;
78     //default behaviour is don't ignore case and execute body when tag contents
79 //equal value set by setMatch
80 private boolean ignoreCase = false;
81     private boolean value = true;
82
83     /**
84      * Includes the body of the tag if the request cookie equals the value set in the
85      * 'match' cookie.
86      *
87      * @return SKIP_BODY if equalsCookie body content does not equal the value of
88      * the match cookie, EVAL_BODY_include if it does
89      */
90     public final int doStartTag() throws JspException
91     {
92         //result is whether or not tag contents equal the match cookie
93 boolean result = false;
94         // Get the cookies
95 Cookie cookie = null;
96         Cookie [] cookies =
97             ((HttpServletRequest)pageContext.getRequest()).getCookies();
98         if( cookies != null ) {
99             for( int i = 0; i < cookies.length; i++ ) {
100                 if( cookies[i].getName().equals(name) ) {
101                     cookie = cookies[i];
102                     break;
103                 }
104             }
105         }
106         
107         if (cookie != null) {
108             if (ignoreCase) {
109                 result = cookie.getValue().equalsIgnoreCase(match);
110             } else {
111                 result = cookie.getValue().equals(match);
112             }
113         }
114         
115         if( value == result )
116             return EVAL_BODY_INCLUDE;
117
118         return SKIP_BODY;
119     }
120
121     /**
122      * Set the required tag cookie <b>name</b>.
123      *
124      * @param String name of request cookie
125      */
126     public final void setName(String JavaDoc str)
127     {
128     name = str;
129     }
130
131
132     /**
133      * Set the String that will be compared to the request
134      * cookie.
135      *
136      * @param String value to match against the request cookie
137      */
138     public final void setMatch(String JavaDoc str) {
139         match=str;
140     }
141     
142
143     /**
144      * If ignoreCase is set to true, then the comparison
145      * between the "match" attribute and the
146      * request cookie will <i>not</i> be case sensitive
147      *
148      * @param boolean true = ignore case<BR>false = case sensitive<BR>
149      * default value = false
150      */
151     public final void setIgnoreCase(boolean value) {
152         ignoreCase = value;
153     }
154     
155     /**
156      * Set the optional tag cookie <b>value</b> to true or false.
157      *
158      * @param boolean true or false
159      */
160     public final void setValue(boolean value)
161     {
162     this.value = value;
163     }
164
165 }
166
Popular Tags