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.component.AltProperty;
24  import org.apache.myfaces.component.DataProperties;
25  import org.apache.myfaces.component.DisplayValueOnlyAware;
26  import org.apache.myfaces.component.EscapeAware;
27  import org.apache.myfaces.component.ForceIdAware;
28  import org.apache.myfaces.component.UserRoleAware;
29  import org.apache.myfaces.component.UserRoleUtils;
30  import org.apache.myfaces.component.html.util.HtmlComponentUtils;
31  import org.apache.myfaces.custom.ExtendedComponentBase;
32  import org.apache.myfaces.shared_tomahawk.component.DisplayValueOnlyCapable;
33  import org.apache.myfaces.shared_tomahawk.component.EscapeCapable;
34  
35  /**
36   * Extends standard selectManyCheckbox with user role support. 
37   * 
38   * Additionally this extended selectManyCheckbox accepts a layout 
39   * attribute of value "spread" (see custom checkbox tag).
40   *  
41   * Unless otherwise specified, all attributes accept static values or EL expressions.
42   * 
43   * @JSFComponent
44   *   name = "t:selectManyCheckbox"
45   *   class = "org.apache.myfaces.component.html.ext.HtmlSelectManyCheckbox"
46   *   tagClass = "org.apache.myfaces.generated.taglib.html.ext.HtmlSelectManyCheckboxTag"
47   * @since 1.1.7
48   * @author Manfred Geiler (latest modification by $Author: lu4242 $)
49   * @version $Revision: 691856 $ $Date: 2008-09-03 21:40:30 -0500 (Wed, 03 Sep 2008) $
50   */
51  public abstract class AbstractHtmlSelectManyCheckbox
52          extends javax.faces.component.html.HtmlSelectManyCheckbox
53          implements UserRoleAware, DisplayValueOnlyCapable,  
54          EscapeCapable, DisplayValueOnlyAware, EscapeAware,
55          ForceIdAware, DataProperties, AltProperty,
56          ExtendedComponentBase
57  {
58      public static final String COMPONENT_TYPE = "org.apache.myfaces.HtmlSelectManyCheckbox";
59      public static final String DEFAULT_RENDERER_TYPE = "org.apache.myfaces.Checkbox";
60  
61      public String getClientId(FacesContext context)
62      {
63          String clientId = HtmlComponentUtils.getClientId(this, getRenderer(context), context);
64          if (clientId == null)
65          {
66              clientId = super.getClientId(context);
67          }
68  
69          return clientId;
70      }
71  
72      public boolean isRendered()
73      {
74          if (!UserRoleUtils.isVisibleOnUserRole(this)) return false;
75          return super.isRendered();
76      }
77  
78      public boolean isSetDisplayValueOnly(){
79          return getDisplayValueOnly() != null ? true : false;  
80      }
81      
82      public boolean isDisplayValueOnly(){
83          return getDisplayValueOnly() != null ? getDisplayValueOnly().booleanValue() : false;
84      }
85      
86      public void setDisplayValueOnly(boolean displayValueOnly){
87          this.setDisplayValueOnly((Boolean) Boolean.valueOf(displayValueOnly));
88      }
89  
90      /**
91       * A integer representing the number of checkbox rows if the 
92       * layout is lineDirection and checkbox columns if the layout 
93       * is pageDirection.
94       * 
95       * @JSFProperty
96       */
97      public abstract String getLayoutWidth();
98  
99      private static boolean booleanFromObject(Object obj, boolean defaultValue)
100     {
101         if(obj instanceof Boolean)
102         {
103             return ((Boolean) obj).booleanValue();
104         }
105         else if(obj instanceof String)
106         {
107             return Boolean.valueOf(((String) obj)).booleanValue();
108         }
109 
110         return defaultValue;
111     }
112 }