View Javadoc
1   /*
2    * Copyright 2014 the original author or authors.
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, either express or implied.
13   * See the License for the specific language governing permissions and
14   * limitations under the License.
15   */
16  
17  package com.orangesignal.csv.io;
18  
19  import static com.orangesignal.csv.bean.CsvEntityTemplate.defaultIfEmpty;
20  import static com.orangesignal.csv.bean.FieldUtils.getFieldValue;
21  
22  import java.io.Closeable;
23  import java.io.Flushable;
24  import java.io.IOException;
25  import java.lang.reflect.Array;
26  import java.lang.reflect.Field;
27  import java.util.Arrays;
28  import java.util.Collections;
29  import java.util.List;
30  
31  import com.orangesignal.csv.CsvWriter;
32  import com.orangesignal.csv.annotation.CsvColumn;
33  import com.orangesignal.csv.annotation.CsvColumns;
34  import com.orangesignal.csv.annotation.CsvEntity;
35  import com.orangesignal.csv.annotation.CsvColumnException;
36  import com.orangesignal.csv.bean.CsvEntityTemplate;
37  
38  /**
39   * 区切り文字形式データ注釈要素 {@link CsvEntity} で注釈付けされた Java プログラム要素で区切り文字形式データアクセスを行う区切り文字形式出力ストリームを提供します。
40   * 
41   * @author Koji Sugisawa
42   * @since 1.4.0
43   */
44  public class CsvEntityWriter<T> implements Closeable, Flushable {
45  
46  	/**
47  	 * 区切り文字形式出力ストリームを保持します。
48  	 */
49  	private CsvWriter writer;
50  
51  	/**
52  	 * Java プログラム要素操作の簡素化ヘルパーを保持します。
53  	 */
54  	private final CsvEntityTemplate<T> template;
55  
56  	/**
57  	 * 区切り文字形式データの列見出し (ヘッダ) 行の出力を無効化するかどうかを保持します。
58  	 * 
59  	 * @since 2.2
60  	 */
61  	private final boolean disableWriteHeader;
62  
63  	/**
64  	 * 項目名のリストを保持します。
65  	 */
66  	private List<String> columnNames;
67  
68  	private int columnCount = -1;
69  
70  	// ------------------------------------------------------------------------
71  	// 利便性のための静的メソッド
72  
73  	/**
74  	 * 新しい {@link CsvEntityWriter} のインスタンスを返します。
75  	 * このメソッドは利便性のために提供しています。
76  	 * 
77  	 * @param writer 区切り文字形式出力ストリーム
78  	 * @param entityClass 区切り文字形式データ注釈要素 {@link CsvEntity} で注釈付けされた Java プログラム要素の型
79  	 * @return 新しい {@link CsvEntityWriter} のインスタンス
80  	 * @throws IllegalArgumentException {@code writer} または {@code entityClass} が {@code null} の場合。
81  	 */
82  	public static <T> CsvEntityWriter<T> newInstance(final CsvWriter writer, final Class<T> entityClass) {
83  		return new CsvEntityWriter<T>(writer, entityClass);
84  	}
85  
86  	/**
87  	 * 新しい {@link CsvEntityWriter} のインスタンスを返します。
88  	 * このメソッドは利便性のために提供しています。
89  	 * 
90  	 * @param writer 区切り文字形式出力ストリーム
91  	 * @param entityClass 区切り文字形式データ注釈要素 {@link CsvEntity} で注釈付けされた Java プログラム要素の型
92  	 * @param disableWriteHeader 区切り文字形式データの列見出し (ヘッダ) 行の出力を無効化するかどうか
93  	 * @return 新しい {@link CsvEntityWriter} のインスタンス
94  	 * @throws IllegalArgumentException {@code writer} または {@code entityClass} が {@code null} の場合。
95  	 * @since 2.2
96  	 */
97  	public static <T> CsvEntityWriter<T> newInstance(final CsvWriter writer, final Class<T> entityClass, final boolean disableWriteHeader) {
98  		return new CsvEntityWriter<T>(writer, entityClass, disableWriteHeader);
99  	}
100 
101 	/**
102 	 * 新しい {@link CsvEntityWriter} のインスタンスを返します。
103 	 * このメソッドは利便性のために提供しています。
104 	 * 
105 	 * @param writer 区切り文字形式出力ストリーム
106 	 * @param template Java プログラム要素操作の簡素化ヘルパー
107 	 * @return 新しい {@link CsvEntityWriter} のインスタンス
108 	 * @throws IllegalArgumentException {@code writer} または {@code template} が {@code null} の場合。
109 	 */
110 	public static <T> CsvEntityWriter<T> newInstance(final CsvWriter writer, final CsvEntityTemplate<T> template) {
111 		return new CsvEntityWriter<T>(writer, template);
112 	}
113 
114 	/**
115 	 * 新しい {@link CsvEntityWriter} のインスタンスを返します。
116 	 * このメソッドは利便性のために提供しています。
117 	 * 
118 	 * @param writer 区切り文字形式出力ストリーム
119 	 * @param template Java プログラム要素操作の簡素化ヘルパー
120 	 * @param disableWriteHeader 区切り文字形式データの列見出し (ヘッダ) 行の出力を無効化するかどうか
121 	 * @return 新しい {@link CsvEntityWriter} のインスタンス
122 	 * @throws IllegalArgumentException {@code writer} または {@code template} が {@code null} の場合。
123 	 * @since 2.2
124 	 */
125 	public static <T> CsvEntityWriter<T> newInstance(final CsvWriter writer, final CsvEntityTemplate<T> template, final boolean disableWriteHeader) {
126 		return new CsvEntityWriter<T>(writer, template, disableWriteHeader);
127 	}
128 
129 	// ------------------------------------------------------------------------
130 	// コンストラクタ
131 
132 	/**
133 	 * 指定された区切り文字形式出力ストリームと Java プログラム要素の型を使用して、このクラスを構築するコンストラクタです。
134 	 * 
135 	 * @param writer 区切り文字形式出力ストリーム
136 	 * @param entityClass 区切り文字形式データ注釈要素 {@link CsvEntity} で注釈付けされた Java プログラム要素の型
137 	 * @throws IllegalArgumentException {@code writer} または {@code entityClass} が {@code null} の場合。
138 	 */
139 	public CsvEntityWriter(final CsvWriter writer, final Class<T> entityClass) {
140 		this(writer, new CsvEntityTemplate<T>(entityClass), false);
141 	}
142 
143 	/**
144 	 * 指定された区切り文字形式出力ストリームと Java プログラム要素の型を使用して、このクラスを構築するコンストラクタです。
145 	 * 
146 	 * @param writer 区切り文字形式出力ストリーム
147 	 * @param entityClass 区切り文字形式データ注釈要素 {@link CsvEntity} で注釈付けされた Java プログラム要素の型
148 	 * @param disableWriteHeader 区切り文字形式データの列見出し (ヘッダ) 行の出力を無効化するかどうか
149 	 * @throws IllegalArgumentException {@code writer} または {@code entityClass} が {@code null} の場合。
150 	 * @since 2.2
151 	 */
152 	public CsvEntityWriter(final CsvWriter writer, final Class<T> entityClass, final boolean disableWriteHeader) {
153 		this(writer, new CsvEntityTemplate<T>(entityClass), disableWriteHeader);
154 	}
155 
156 	/**
157 	 * 指定された区切り文字形式出力ストリームと Java プログラム要素操作の簡素化ヘルパーを使用して、このクラスを構築するコンストラクタです。
158 	 * 
159 	 * @param writer 区切り文字形式出力ストリーム
160 	 * @param template Java プログラム要素操作の簡素化ヘルパー
161 	 * @throws IllegalArgumentException {@code writer} または {@code template} が {@code null} の場合。
162 	 */
163 	public CsvEntityWriter(final CsvWriter writer, final CsvEntityTemplate<T> template) {
164 		this(writer, template, false);
165 	}
166 
167 	/**
168 	 * 指定された区切り文字形式出力ストリームと Java プログラム要素操作の簡素化ヘルパーを使用して、このクラスを構築するコンストラクタです。
169 	 * 
170 	 * @param writer 区切り文字形式出力ストリーム
171 	 * @param template Java プログラム要素操作の簡素化ヘルパー
172 	 * @param disableWriteHeader 区切り文字形式データの列見出し (ヘッダ) 行の出力を無効化するかどうか
173 	 * @throws IllegalArgumentException {@code writer} または {@code template} が {@code null} の場合。
174 	 * @since 2.2
175 	 */
176 	public CsvEntityWriter(final CsvWriter writer, final CsvEntityTemplate<T> template, final boolean disableWriteHeader) {
177 		if (writer == null) {
178 			throw new IllegalArgumentException("CsvWriter must not be null");
179 		}
180 		if (template == null) {
181 			throw new IllegalArgumentException("CsvEntityTemplate must not be null");
182 		}
183 		this.writer        = writer;
184 		this.template      = template;
185 		this.disableWriteHeader = disableWriteHeader;
186 	}
187 
188 	// ------------------------------------------------------------------------
189 	// プライベート メソッド
190 
191 	/**
192 	 * Checks to make sure that the stream has not been closed
193 	 */
194 	private void ensureOpen() throws IOException {
195 		if (writer == null) {
196 			throw new IOException("CsvWriter closed");
197 		}
198 	}
199 
200 	private void ensureHeader() throws IOException {
201 		synchronized (this) {
202 			if (columnNames == null) {
203 				final List<String> names = template.createWritableColumnNames();
204 				// ヘッダ行が有効な場合は項目名の一覧を出力します。
205 				if (!disableWriteHeader && template.getType().getAnnotation(CsvEntity.class).header()) {
206 					writer.writeValues(names);
207 				}
208 				template.prepare(names, template.getType().getDeclaredFields());
209 				columnNames = Collections.unmodifiableList(names);
210 				columnCount = names.size();
211 			}
212 		}
213 	}
214 
215 	// ------------------------------------------------------------------------
216 	// オーバーライド メソッド
217 
218 	@Override
219 	public void flush() throws IOException {
220 		synchronized (this) {
221 			ensureOpen();
222 			writer.flush();
223 		}
224 	}
225 
226 	@Override
227 	public void close() throws IOException {
228 		synchronized (this) {
229 			ensureOpen();
230 			writer.close();
231 			writer = null;
232 			columnNames = null;
233 			columnCount = -1;
234 		}
235 	}
236 
237 	// ------------------------------------------------------------------------
238 	// パブリック メソッド
239 
240 	/**
241 	 * 可能であれば項目名を書き込みます。項目名が既に書き込まれている場合や、
242 	 * 区切り文字形式データの列見出し (ヘッダ) 行の出力が無効化されている場合、このメソッドは何も行いません。
243 	 * 
244 	 * @throws IOException 入出力エラーが発生した場合
245 	 * @see {@link #isDisableWriteHeader()}
246 	 */
247 	public void writeHeader() throws IOException {
248 		synchronized (this) {
249 			ensureOpen();
250 			ensureHeader();
251 		}
252 	}
253 
254 	/**
255 	 * 指定された Java プログラム要素を区切り文字形式で書き込みます。
256 	 * {@code null} が指定された場合は空行が書き込まれます。
257 	 * 
258 	 * @param entity 書き込む Java プログラム要素。または {@code null}
259 	 * @return データの出力を行った場合は {@code true} それ以外の場合 (フィルタにより書き込みがスキップされた場合) は {@code false}
260 	 * @throws CsvColumnException 区切り文字形式のデータ項目の検証操作実行中にエラーが発生した場合
261 	 * @throws IOException 入出力エラーが発生した場合
262 	 */
263 	public boolean write(final T entity) throws IOException {
264 		synchronized (this) {
265 			ensureOpen();
266 			ensureHeader();
267 
268 			// 要素が null の場合は null 出力します。
269 			if (entity == null || entity.getClass().getAnnotation(CsvEntity.class) == null) {
270 				writer.writeValues(null);
271 				return true;
272 			}
273 
274 			final List<String> values = toValues(entity);
275 			if (template.isAccept(columnNames, values)) {
276 				return false;
277 			}
278 			writer.writeValues(values);
279 			return true;
280 		}
281 	}
282 
283 	private List<String> toValues(final T entity) throws IOException {
284 		final String[] values = new String[columnCount];
285 		for (final Field field : entity.getClass().getDeclaredFields()) {
286 			final CsvColumns columns = field.getAnnotation(CsvColumns.class);
287 			if (columns != null) {
288 				int arrayIndex = 0;
289 				for (final CsvColumn column : columns.value()) {
290 					if (!column.access().isWriteable()) {
291 						arrayIndex++;
292 						continue;
293 					}
294 					int pos = column.position();
295 					if (pos < 0) {
296 						pos = columnNames.indexOf(defaultIfEmpty(column.name(), field.getName()));
297 					}
298 					if (pos == -1) {
299 						throw new IOException(String.format("Invalid CsvColumn field %s", field.getName()));
300 					}
301 					Object o = getFieldValue(entity, field);
302 					if (field.getType().isArray()) {
303 						if (o != null) {
304 							o = Array.get(o, arrayIndex);
305 						}
306 						arrayIndex++;
307 					}
308 					values[pos] = template.objectToString(pos, o);
309 					if (values[pos] == null && !column.defaultValue().isEmpty()) {
310 						// デフォルト値が指定されていて、値がない場合はデフォルト値を代入します。
311 						values[pos] = column.defaultValue();
312 					}
313 					if (values[pos] == null && column.required()) {
314 						throw new CsvColumnException(String.format("%s must not be null", columnNames.get(pos)), entity);
315 					}
316 				}
317 			}
318 			final CsvColumn column = field.getAnnotation(CsvColumn.class);
319 			if (column != null && column.access().isWriteable()) {
320 				int pos = column.position();
321 				if (pos < 0) {
322 					pos = columnNames.indexOf(defaultIfEmpty(column.name(), field.getName()));
323 				}
324 				if (pos == -1) {
325 					throw new IOException(String.format("Invalid CsvColumn field %s", field.getName()));
326 				}
327 				values[pos] = template.objectToString(pos, getFieldValue(entity, field));
328 				if (values[pos] == null && !column.defaultValue().isEmpty()) {
329 					// デフォルト値が指定されていて、値がない場合はデフォルト値を代入します。
330 					values[pos] = column.defaultValue();
331 				}
332 				if (values[pos] == null && column.required()) {
333 					throw new CsvColumnException(String.format("%s must not be null", columnNames.get(pos)), entity);
334 				}
335 			}
336 		}
337 		return Arrays.asList(values);
338 	}
339 
340 	// ------------------------------------------------------------------------
341 	// getter / setter
342 
343 	/**
344 	 * Java プログラム要素操作の簡素化ヘルパーを返します。
345 	 * 
346 	 * @return Java プログラム要素操作の簡素化ヘルパー
347 	 * @since 2.1
348 	 */
349 	public CsvEntityTemplate<T> getTemplate() {
350 		return template;
351 	}
352 
353 	/**
354 	 * 区切り文字形式データの列見出し (ヘッダ) 行の出力が無効化されているかどうかを返します。
355 	 * 
356 	 * @return 区切り文字形式データの列見出し (ヘッダ) 行の出力が無効化されているかどうか
357 	 * @since 2.2
358 	 */
359 	public boolean isDisableWriteHeader() {
360 		return disableWriteHeader;
361 	}
362 
363 }