View Javadoc

1   /*
2    * Licensed to the Apache Software Foundation (ASF) under one
3    * or more contributor license agreements.  See the NOTICE file
4    * distributed with this work for additional information
5    * regarding copyright ownership.  The ASF licenses this file
6    * to you under the Apache License, Version 2.0 (the
7    * "License"); you may not use this file except in compliance
8    * with the License.  You may obtain a copy of the License at
9    *
10   *   http://www.apache.org/licenses/LICENSE-2.0
11   *
12   * Unless required by applicable law or agreed to in writing,
13   * software distributed under the License is distributed on an
14   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15   * KIND, either express or implied.  See the License for the
16   * specific language governing permissions and limitations
17   * under the License.
18   */
19  package javax.faces.webapp;
20  
21  import javax.servlet.jsp.JspException;
22  import javax.servlet.jsp.tagext.TagSupport;
23  
24  /**
25   * This tag adds its child as a facet of the nearest parent UIComponent.
26   * A child consisting of multiple elements should be nested within a
27   * container component (i.e., within an h:panelGroup for HTML library
28   * components).
29   * 
30   * Unless otherwise specified, all attributes accept static values or EL expressions.
31   * 
32   * see Javadoc of <a href="http://java.sun.com/javaee/javaserverfaces/1.2/docs/api/index.html">JSF Specification</a>
33   *
34   * @JSFJspTag
35   *   name="f:facet"
36   *   bodyContent="JSP"
37   *   
38   * @author Manfred Geiler (latest modification by $Author: lu4242 $)
39   * @version $Revision: 693358 $ $Date: 2008-09-08 22:54:29 -0500 (Mon, 08 Sep 2008) $
40   */
41  public class FacetTag
42          extends TagSupport
43  {
44      private static final long serialVersionUID = -5254277925259361302L;
45      private String _name;
46  
47      public String getName()
48      {
49          return _name;
50      }
51  
52      /**
53       * The name of the facet to be created.  This must be a static value.
54       * 
55       * @JSFJspAttribute
56       *   required="true"
57       */
58      public void setName(String name)
59      {
60          _name = name;
61      }
62  
63      public void release()
64      {
65          super.release();
66          _name = null;
67      }
68  
69      public int doStartTag()
70              throws JspException
71      {
72          return EVAL_BODY_INCLUDE;
73      }
74  
75  }