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. A child consisting of multiple elements should
26 * be nested within a container component (i.e., within an h:panelGroup for HTML library components).
27 *
28 * Unless otherwise specified, all attributes accept static values or EL expressions.
29 *
30 * see Javadoc of <a href="http://java.sun.com/javaee/javaserverfaces/1.2/docs/api/index.html">JSF Specification</a>
31 *
32 * @JSFJspTag name="f:facet" bodyContent="JSP"
33 */
34 public class FacetTag extends TagSupport
35 {
36 private static final long serialVersionUID = -5254277925259361302L;
37 private String _name;
38
39 public String getName()
40 {
41 return _name;
42 }
43
44 /**
45 * The name of the facet to be created. This must be a static value.
46 *
47 * @JSFJspAttribute required="true"
48 */
49 public void setName(String name)
50 {
51 _name = name;
52 }
53
54 @Override
55 public void release()
56 {
57 super.release();
58 _name = null;
59 }
60
61 @Override
62 public int doStartTag() throws JspException
63 {
64 return EVAL_BODY_INCLUDE;
65 }
66
67 }