View Javadoc

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  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  		if (collection instanceof Collection) {
52  			return _contains((Collection<?>) collection, obj);
53  		} else if (collection != null && collection.getClass().isArray()) {
54  			return _contains(Arrays.asList((Object[]) collection), obj);
55  		} else {
56  			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  		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  		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 		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 		final String[] c = classNames.split(",");
117 		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 		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 		if (date instanceof Date) {
148 			final SimpleDateFormat format = new SimpleDateFormat(pattern);
149 			return format.format(date);
150 		} else {
151 			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 		if (condition) {
170 			return value;
171 		}
172 		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 		if (str == null) {
194 			return "";
195 		}
196 		final String characterEncoding = ThreadContext.getRequest()
197 				.getCharacterEncoding();
198 		try {
199 			return URLBodyEncoder.encode(str.toString(), characterEncoding);
200 		} catch (final UnsupportedEncodingException e) {
201 			throw new IORuntimeException(e);
202 		}
203 	}
204 
205 }