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. 
38   * 
39   * See javax.faces.component.UIComponent#getAttributes()
40   * See javax.faces.component.UIComponent#setValueExpression(java.lang.String, javax.el.ValueExpression)
41   * @author Jacob Hookom
42   * @version $Id$
43   */
44  @JSFFaceletTag(
45          name = "f:attribute",
46          bodyContent = "empty", 
47          tagClass="org.apache.myfaces.taglib.core.AttributeTag")
48  public final class AttributeHandler extends TagHandler
49      implements javax.faces.view.facelets.AttributeHandler
50  {
51      private final TagAttribute _name;
52  
53      private final TagAttribute _value;
54  
55      /**
56       * @param config
57       */
58      public AttributeHandler(TagConfig config)
59      {
60          super(config);
61          _name = getRequiredAttribute("name");
62          _value = getRequiredAttribute("value");
63      }
64  
65      /*
66       * (non-Javadoc)
67       * 
68       * See javax.faces.view.facelets.FaceletHandler#apply(
69       *       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 }