KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > taglibs > response > ContainsHeaderTag


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.response;
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>containsHeader</b>, used to determine if the Http Response
27  * contains the header named <b>name</b>.
28  * <p>
29  * Includes the body of the tag if the header exists.
30  * <p>
31  * You can set the optional tag attribute <b>value</b> to <b>true</b> or
32  * <b>false</b>. The body of the tag is included if containsHeader matches
33  * the value.
34  * <p>
35  * JSP Tag Lib Descriptor
36  * <p><pre>
37  * &lt;name&gt;containsHeader&lt;/name&gt;
38  * &lt;tagclass&gt;org.apache.taglibs.response.ContainsHeaderTag&lt;/tagclass&gt;
39  * &lt;bodycontent&gt;JSP&lt;/bodycontent&gt;
40  * &lt;info&gt;Test whether the HTTP Response contains a header.&lt;/info&gt;
41  * &lt;attribute&gt;
42  * &lt;name&gt;name&lt;/name&gt;
43  * &lt;required&gt;required&lt;/required&gt;
44  * &lt;rtexprvalue&gt;false&lt;/rtexprvalue&gt;
45  * &lt;/attribute&gt;
46  * &lt;attribute&gt;
47  * &lt;name&gt;value&lt;/name&gt;
48  * &lt;required&gt;false&lt;/required&gt;
49  * &lt;rtexprvalue&gt;false&lt;/rtexprvalue&gt;
50  * &lt;/attribute&gt;
51  * </pre>
52  *
53  * @author Glenn Nielsen
54  */
55
56 public class ContainsHeaderTag extends TagSupport
57 {
58     private String JavaDoc name = null;
59     private boolean value = true;
60
61     /**
62      * Used to test whether the HTTP Response contains a header.
63      *
64      * @return SKIP_BODY if containsHeader doesn't match value, EVAL_BODY_INCLUDE if containsHeader matches value
65      */
66     public final int doStartTag() throws JspException
67     {
68     boolean result =
69     ((HttpServletResponse)pageContext.getResponse()).containsHeader(name);
70
71     if( value == result )
72         return EVAL_BODY_INCLUDE;
73
74     return SKIP_BODY;
75     }
76
77     /**
78      * Set the optional tag attribute <b>value</b> to true or false.
79      *
80      * @param boolean true or false
81      */
82     public final void setValue(boolean value)
83     {
84     this.value = value;
85     }
86
87     /**
88      * Required attribute, name of the header.
89      *
90      * @param String name
91      */
92     public final void setName(String JavaDoc nam)
93     {
94     name = nam;
95     }
96
97 }
98
Popular Tags