Coverage Report - org.seasar.cubby.tags.CubbyFunctions
 
Classes in this File Line Coverage Branch Coverage Complexity
CubbyFunctions
28%
7/25
29%
4/14
0
 
 1  
 /*
 2  
  * Copyright 2004-2008 the Seasar Foundation and the Others.
 3  
  *
 4  
  * Licensed under the Apache License, Version 2.0 (the "License");
 5  
  * you may not use this file except in compliance with the License.
 6  
  * You may obtain a copy of the License at
 7  
  *
 8  
  *     http://www.apache.org/licenses/LICENSE-2.0
 9  
  *
 10  
  * Unless required by applicable law or agreed to in writing, software
 11  
  * distributed under the License is distributed on an "AS IS" BASIS,
 12  
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
 13  
  * either express or implied. See the License for the specific language
 14  
  * governing permissions and limitations under the License.
 15  
  */
 16  
 package org.seasar.cubby.tags;
 17  
 
 18  
 import java.io.UnsupportedEncodingException;
 19  
 import java.text.SimpleDateFormat;
 20  
 import java.util.Arrays;
 21  
 import java.util.Collection;
 22  
 import java.util.Date;
 23  
 import java.util.Map;
 24  
 
 25  
 import javax.servlet.http.HttpServletRequest;
 26  
 
 27  
 import org.seasar.cubby.controller.ThreadContext;
 28  
 import org.seasar.cubby.util.CubbyUtils;
 29  
 import org.seasar.cubby.util.URLBodyEncoder;
 30  
 import org.seasar.framework.exception.IORuntimeException;
 31  
 
 32  
 /**
 33  
  * Cubby の JSP functions を提供します。
 34  
  * 
 35  
  * @author baba
 36  
  * @since 1.0.0
 37  
  */
 38  0
 public class CubbyFunctions {
 39  
 
 40  
         /**
 41  
          * 配列やコレクションに指定したオブジェクトが含まれるかどうかを判定します。
 42  
          * 
 43  
          * @param collection
 44  
          *            配列や{@link Collection コレクション}
 45  
          * @param obj
 46  
          *            配列やコレクションにあるかどうかを調べる要素
 47  
          * @return 配列やコレクションに指定したオブジェクトが含まれる場合は <code>true</code>、そうでない場合は
 48  
          *         <code>false</code>
 49  
          */
 50  
         public static Boolean contains(final Object collection, final Object obj) {
 51  2
                 if (collection instanceof Collection) {
 52  2
                         return _contains((Collection<?>) collection, obj);
 53  0
                 } else if (collection != null && collection.getClass().isArray()) {
 54  0
                         return _contains(Arrays.asList((Object[]) collection), obj);
 55  
                 } else {
 56  0
                         return false;
 57  
                 }
 58  
         }
 59  
 
 60  
         /**
 61  
          * 指定された要素が{@link Collection}内にあるかどうかを示します。
 62  
          * 
 63  
          * @param collection
 64  
          *            コレクション
 65  
          * @param obj
 66  
          *            コレクションにあるかどうかを調べる要素
 67  
          * @return 指定された要素が{@link Collection}内にある場合は <code>true</code>、そうでない場合は
 68  
          *         <code>false</code>
 69  
          */
 70  
         private static Boolean _contains(final Collection<?> collection,
 71  
                         final Object obj) {
 72  2
                 return collection.contains(obj);
 73  
         }
 74  
 
 75  
         /**
 76  
          * {@link Map}に指定したキーが含まれるかどうかを判定します。
 77  
          * 
 78  
          * @param map
 79  
          *            マップ
 80  
          * @param key
 81  
          *            マップにあるかどうかが判定されるキー
 82  
          * @return {@link Map}に指定したキーが含まれる場合は <code>true</code>、そうでない場合は
 83  
          *         <code>false</code>
 84  
          */
 85  
         public static Boolean containsKey(final Map<?, ?> map, final Object key) {
 86  0
                 return map.containsKey(key);
 87  
         }
 88  
 
 89  
         /**
 90  
          * {@link Map}に指定した値が含まれるかどうかを判定します。
 91  
          * 
 92  
          * @param map
 93  
          *            マップ
 94  
          * @param value
 95  
          *            マップにあるかどうかを判定される値
 96  
          * @return {@link Map}に指定した値が含まれる場合は <code>true</code>、そうでない場合は
 97  
          *         <code>false</code>
 98  
          */
 99  
         public static Boolean containsValue(final Map<?, ?> map, final Object value) {
 100  0
                 return map.containsValue(value);
 101  
         }
 102  
 
 103  
         /**
 104  
          * 指定したカンマ区切りの文字列をインデックス値でサイクルして出力します。
 105  
          * <p>
 106  
          * 主に行毎に色分けする場合に CSS のクラス名を出力する場合に使用します。
 107  
          * </p>
 108  
          * 
 109  
          * @param index
 110  
          *            インデックス
 111  
          * @param classNames
 112  
          *            カンマ区切りの文字列
 113  
          * @return 指定したインデックスに対応する文字列
 114  
          */
 115  
         public static String odd(final Integer index, final String classNames) {
 116  0
                 final String[] c = classNames.split(",");
 117  0
                 return c[index % c.length];
 118  
         }
 119  
 
 120  
         /**
 121  
          * HTMLをエスケープします。
 122  
          * <p>
 123  
          * JSTLのoutタグの代わりに使用します。EL式で出力された文字列はエスケープされないため、エスケープを行いたい場合はこのfunctionを使用します。
 124  
          * </p>
 125  
          * 
 126  
          * @param str
 127  
          *            エスケープする文字列
 128  
          * @return エスケープされた HTML
 129  
          */
 130  
         public static String out(final Object str) {
 131  103
                 return str == null ? "" : CubbyUtils.escapeHtml(str.toString());
 132  
         }
 133  
 
 134  
         /**
 135  
          * {@link Date}型のオブジェクトをフォーマットして出力します。
 136  
          * <p>
 137  
          * JSTL の dateFormat タグの代わりに使用します。
 138  
          * </p>
 139  
          * 
 140  
          * @param date
 141  
          *            日付/時刻文字列にフォーマットする日付/時刻値
 142  
          * @param pattern
 143  
          *            日付と時刻のフォーマットを記述するパターン
 144  
          * @return フォーマットされた日付/時刻文字列
 145  
          */
 146  
         public static String dateFormat(final Object date, final String pattern) {
 147  0
                 if (date instanceof Date) {
 148  0
                         final SimpleDateFormat format = new SimpleDateFormat(pattern);
 149  0
                         return format.format(date);
 150  
                 } else {
 151  0
                         return "";
 152  
                 }
 153  
         }
 154  
 
 155  
         /**
 156  
          * 第1引数の条件が true のときは第2引数を属性の値として出力し、第1引数の条件が false のときは属性自体を出力しません。
 157  
          * <p>
 158  
          * 条件によって disabled や checked などの属性の出力する・しないを制御したい場合に使用します。
 159  
          * 出力する・しないの制御はカスタムタグで行うので、t:input/t:select/t:textarea と組み合わせて使用してください。
 160  
          * </p>
 161  
          * 
 162  
          * @param condition
 163  
          *            属性を出力する条件
 164  
          * @param value
 165  
          * @return condition が <code>true</code> の場合は value、そうでない場合は
 166  
          *         {@link TagUtils#REMOVE_ATTRIBUTE}
 167  
          */
 168  
         public static Object ifrender(final Boolean condition, final Object value) {
 169  0
                 if (condition) {
 170  0
                         return value;
 171  
                 }
 172  0
                 return TagUtils.REMOVE_ATTRIBUTE;
 173  
         }
 174  
 
 175  
         /**
 176  
          * 文字列を Base64 でエンコードします。
 177  
          * <p>
 178  
          * JSTL の url タグの代わりに使用します。
 179  
          * {@code HttpServletRequest#getCharacterEncoding()}で取得した文字コードでエンコードされます。
 180  
          * </p>
 181  
          * <p>
 182  
          * 例:<br/>
 183  
          *                 ${f:url('abc あいう'))} -> abc%20%E3%81%82%E3%81%84%E3%81%86
 184  
          * </p>
 185  
          * 
 186  
          * @param str
 187  
          *            エンコードする文字列
 188  
          * @return エンコードされた文字列
 189  
          * @see HttpServletRequest#setCharacterEncoding(String)
 190  
          * @see HttpServletRequest#getCharacterEncoding()
 191  
          */
 192  
         public static String url(final Object str) {
 193  2
                 if (str == null) {
 194  0
                         return "";
 195  
                 }
 196  2
                 final String characterEncoding = ThreadContext.getRequest()
 197  
                                 .getCharacterEncoding();
 198  
                 try {
 199  2
                         return URLBodyEncoder.encode(str.toString(), characterEncoding);
 200  0
                 } catch (final UnsupportedEncodingException e) {
 201  0
                         throw new IORuntimeException(e);
 202  
                 }
 203  
         }
 204  
 
 205  
 }