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.component.html.ext;
20  
21  import javax.faces.context.FacesContext;
22  
23  import org.apache.myfaces.buildtools.maven2.plugin.builder.annotation.JSFComponent;
24  import org.apache.myfaces.buildtools.maven2.plugin.builder.annotation.JSFProperty;
25  import org.apache.myfaces.component.AltProperty;
26  import org.apache.myfaces.component.DataProperties;
27  import org.apache.myfaces.component.DisplayValueOnlyAware;
28  import org.apache.myfaces.component.EscapeAware;
29  import org.apache.myfaces.component.ForceIdAware;
30  import org.apache.myfaces.component.UserRoleAware;
31  import org.apache.myfaces.component.UserRoleUtils;
32  import org.apache.myfaces.component.html.util.HtmlComponentUtils;
33  import org.apache.myfaces.custom.ExtendedComponentBase;
34  import org.apache.myfaces.shared_tomahawk.component.DisplayValueOnlyCapable;
35  import org.apache.myfaces.shared_tomahawk.component.EscapeCapable;
36  
37  /**
38   * Extends standard selectManyCheckbox with user role support and
39   * a valueType attribute. 
40   * 
41   * Additionally this extended selectManyCheckbox accepts a layout 
42   * attribute of value "spread" (see custom checkbox tag).
43   *  
44   * Unless otherwise specified, all attributes accept static values or EL expressions.
45   * 
46   * @since 1.1.7
47   * @author Manfred Geiler (latest modification by $Author: jakobk $)
48   * @version $Revision: 955214 $ $Date: 2010-06-16 07:16:02 -0500 (Wed, 16 Jun 2010) $
49   */
50  @JSFComponent(
51      name = "t:selectManyCheckbox",
52      clazz = "org.apache.myfaces.component.html.ext.HtmlSelectManyCheckbox",
53      tagClass = "org.apache.myfaces.generated.taglib.html.ext.HtmlSelectManyCheckboxTag")
54  public abstract class AbstractHtmlSelectManyCheckbox
55          extends javax.faces.component.html.HtmlSelectManyCheckbox
56          implements UserRoleAware, DisplayValueOnlyCapable,  
57          EscapeCapable, DisplayValueOnlyAware, EscapeAware,
58          ForceIdAware, DataProperties, AltProperty,
59          ExtendedComponentBase
60  {
61      public static final String COMPONENT_TYPE = "org.apache.myfaces.HtmlSelectManyCheckbox";
62      public static final String DEFAULT_RENDERER_TYPE = "org.apache.myfaces.Checkbox";
63  
64      public String getClientId(FacesContext context)
65      {
66          String clientId = HtmlComponentUtils.getClientId(this, getRenderer(context), context);
67          if (clientId == null)
68          {
69              clientId = super.getClientId(context);
70          }
71  
72          return clientId;
73      }
74  
75      public boolean isRendered()
76      {
77          if (!UserRoleUtils.isVisibleOnUserRole(this)) return false;
78          return super.isRendered();
79      }
80  
81      public boolean isSetDisplayValueOnly(){
82          return getDisplayValueOnly() != null ? true : false;  
83      }
84      
85      public boolean isDisplayValueOnly(){
86          return getDisplayValueOnly() != null ? getDisplayValueOnly().booleanValue() : false;
87      }
88      
89      public void setDisplayValueOnly(boolean displayValueOnly){
90          this.setDisplayValueOnly((Boolean) Boolean.valueOf(displayValueOnly));
91      }
92  
93      /**
94       * A integer representing the number of checkbox rows if the 
95       * layout is lineDirection and checkbox columns if the layout 
96       * is pageDirection.
97       */
98      @JSFProperty
99      public abstract String getLayoutWidth();
100     
101     /**
102      * Specifies the value type of the selectable items. This attribute is
103      * similar to the collectionType attribute introduced in JSF 2.0. 
104      * It can be used to declare the type of the selectable items when using
105      * a Collection to store the values in the managed bean, because it is 
106      * not possible in Java to get the value type of a type-safe Collection
107      * (in contrast to arrays where this is possible). 
108      * 
109      * @since 2.0
110      */
111     @JSFProperty
112     public abstract String getValueType(); 
113     
114     private static boolean booleanFromObject(Object obj, boolean defaultValue)
115     {
116         if(obj instanceof Boolean)
117         {
118             return ((Boolean) obj).booleanValue();
119         }
120         else if(obj instanceof String)
121         {
122             return Boolean.valueOf(((String) obj)).booleanValue();
123         }
124 
125         return defaultValue;
126     }
127 }