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 org.apache.myfaces.view.facelets.tag.jsf.core;
20  
21  import java.io.IOException;
22  
23  import javax.el.ELException;
24  import javax.faces.FacesException;
25  import javax.faces.component.UIComponent;
26  import javax.faces.view.facelets.FaceletContext;
27  import javax.faces.view.facelets.FaceletException;
28  import javax.faces.view.facelets.TagAttribute;
29  import javax.faces.view.facelets.TagConfig;
30  import javax.faces.view.facelets.TagException;
31  import javax.faces.view.facelets.TagHandler;
32  
33  import org.apache.myfaces.buildtools.maven2.plugin.builder.annotation.JSFFaceletTag;
34  
35  /**
36   * Sets the specified name and attribute on the parent UIComponent. If the "value" specified is not a literal, it will
37   * instead set the ValueExpression on the UIComponent. <p /> See <a target="_new"
38   * href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/tlddocs/f/attribute.html">tag documentation</a>.
39   * 
40   * @see javax.faces.component.UIComponent#getAttributes()
41   * @see javax.faces.component.UIComponent#setValueExpression(java.lang.String, javax.el.ValueExpression)
42   * @author Jacob Hookom
43   * @version $Id$
44   */
45  @JSFFaceletTag(
46          name = "f:attribute",
47          bodyContent = "empty", 
48          tagClass="org.apache.myfaces.taglib.core.AttributeTag")
49  public final class AttributeHandler extends TagHandler
50      implements javax.faces.view.facelets.AttributeHandler
51  {
52      private final TagAttribute _name;
53  
54      private final TagAttribute _value;
55  
56      /**
57       * @param config
58       */
59      public AttributeHandler(TagConfig config)
60      {
61          super(config);
62          _name = getRequiredAttribute("name");
63          _value = getRequiredAttribute("value");
64      }
65  
66      /*
67       * (non-Javadoc)
68       * 
69       * @see javax.faces.view.facelets.FaceletHandler#apply(javax.faces.view.facelets.FaceletContext, javax.faces.component.UIComponent)
70       */
71      public void apply(FaceletContext ctx, UIComponent parent) throws IOException, FacesException, FaceletException,
72              ELException
73      {
74          if (parent == null)
75          {
76              throw new TagException(this.tag, "Parent UIComponent was null");
77          }
78  
79          // only process if the parent is new to the tree
80          if (parent.getParent() == null)
81          {
82              String n = _name.getValue(ctx);
83              if (!parent.getAttributes().containsKey(n))
84              {
85                  if (_value.isLiteral())
86                  {
87                      parent.getAttributes().put(n, _value.getValue());
88                  }
89                  else
90                  {
91                      parent.setValueExpression(n, _value.getValueExpression(ctx, Object.class));
92                  }
93              }
94          }
95      }
96  
97      public String getAttributeName(FaceletContext ctx)
98      {
99          return _name.getValue(ctx);
100     }
101 }