BATCH-484: added documentation for ItemTransformerItemWriter, ItemTransformer, and CompsiteItemTransformer.

spring-batch-infrastructure/src/test/java/org/springframework/batch/item/transform/ItemTransformerItemWriterFunctionalTests.java

@@ -0,0 +1,114 @@
+/*
+ * Copyright 2006-2008 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.batch.item.transform;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import org.springframework.batch.item.ClearFailedException;
+import org.springframework.batch.item.FlushFailedException;
+import org.springframework.batch.item.ItemWriter;
+
+import junit.framework.TestCase;
+
+/**
+ * These functional tests were created for the Reference Documentation and show how various
+ * combinations of ItemTransformer can be used with an ItemTransformerItemWriter.
+ * 
+ * @author Lucas Ward
+ *
+ */
+public class ItemTransformerItemWriterFunctionalTests extends TestCase {
+	
+	public void testTransform() throws Exception{
+		
+		ItemTransformerItemWriter itemTransformerItemWriter = new ItemTransformerItemWriter();
+		itemTransformerItemWriter.setItemTransformer(new FooTransformer());
+		itemTransformerItemWriter.setDelegate(new BarWriter());
+		itemTransformerItemWriter.write(new Foo());
+	}
+	
+	public void testComposite() throws Exception{
+		
+		CompositeItemTransformer compositeTransformer = new CompositeItemTransformer();
+		List itemTransformers = new ArrayList();
+		itemTransformers.add(new FooTransformer());
+		itemTransformers.add(new BarTransformer());
+		compositeTransformer.setItemTransformers(itemTransformers);
+		ItemTransformerItemWriter itemTransformerItemWriter = new ItemTransformerItemWriter();
+		itemTransformerItemWriter.setItemTransformer(compositeTransformer);
+		itemTransformerItemWriter.setDelegate(new FoobarWriter());
+		itemTransformerItemWriter.write(new Foo());
+	}
+	
+	public class Foo {
+		
+	}
+	
+	public class Bar {
+		public Bar(Foo foo) {
+		}
+	}
+	
+	public class Foobar{
+		public Foobar(Bar bar){}
+	}
+	
+	public class FooTransformer implements ItemTransformer{
+
+		//Preform simple transformation, convert a Foo to a Barr
+		public Object transform(Object item) throws Exception {
+			assertTrue(item instanceof Foo);
+			Foo foo = (Foo)item;
+			return new Bar(foo);
+		}
+	}
+	
+	public class BarTransformer implements ItemTransformer{
+
+		public Object transform(Object item) throws Exception {
+			assertTrue(item instanceof Bar);
+			return new Foobar((Bar)item);
+		}
+	}
+	
+	public class BarWriter implements ItemWriter{
+
+		public void write(Object item) throws Exception {
+		  assertTrue(item instanceof Bar);
+		}
+		
+		public void clear() throws ClearFailedException {
+		}
+
+		public void flush() throws FlushFailedException {
+		}
+		
+	}
+	
+	public class FoobarWriter implements ItemWriter{
+
+		public void write(Object item) throws Exception {
+		  assertTrue(item instanceof Foobar);
+		}
+		
+		public void clear() throws ClearFailedException {
+		}
+
+		public void flush() throws FlushFailedException {
+		}
+	}
+}