Move samples from spring-cloud-stream

source/README.md

@@ -0,0 +1,38 @@
+Spring Cloud Stream Source Sample
+=============================
+
+In this *Spring Cloud Stream* sample, a timestamp is published on an interval determined by the fixedDelay property.
+
+## Requirements
+
+To run this sample, you will need to have installed:
+
+* Java 8 or Above
+
+This example requires Redis to be running on localhost.
+
+## Code Tour
+
+This sample is a Spring Boot application that uses Spring Cloud Stream to publish timestamp data. The source module has 3 primary components:
+
+* SourceApplication - the Spring Boot Main Application
+* TimeSource - the module that will generate the timestamp and post the message to the stream
+* TimeSourceOptionsMetadata - defines the configurations that are available to setup the TimeSource
+    	 * format - how to render the current time, using SimpleDateFormat
+    	 * fixedDelay - time delay between messages
+    	 * initialDelay - delay before the first message
+    	 * timeUnit - the time unit for the fixed and initial delays
+    	 * maxMessages - the maximum messages per poll; -1 for unlimited
+
+## Building with Maven
+
+Build the sample by executing:
+
+	source>$ mvn clean package
+
+## Running the Sample
+
+To start the source module execute the following:
+
+	source>$ java -jar target/spring-cloud-stream-sample-source-1.0.0.BUILD-SNAPSHOT-exec.jar
+

source/pom.xml

@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+
+	<artifactId>spring-cloud-stream-sample-source</artifactId>
+	<packaging>jar</packaging>
+	<name>spring-cloud-stream-sample-source</name>
+	<description>Demo project for source module</description>
+
+	<parent>
+		<groupId>org.springframework.cloud</groupId>
+		<artifactId>spring-cloud-stream-samples</artifactId>
+		<version>1.0.0.BUILD-SNAPSHOT</version>
+	</parent>
+
+	<properties>
+		<start-class>demo.SourceApplication</start-class>
+	</properties>
+
+	<dependencies>
+		<dependency>
+			<groupId>org.springframework.cloud</groupId>
+			<artifactId>spring-cloud-stream</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.cloud</groupId>
+			<artifactId>spring-cloud-stream-binder-redis</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-configuration-processor</artifactId>
+			<optional>true</optional>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-redis</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-test</artifactId>
+			<scope>test</scope>
+		</dependency>
+	</dependencies>
+
+	<build>
+		<plugins>
+			<plugin>
+				<groupId>org.springframework.boot</groupId>
+				<artifactId>spring-boot-maven-plugin</artifactId>
+				<configuration>
+					<classifier>exec</classifier>
+				</configuration>
+			</plugin>
+		</plugins>
+	</build>
+
+</project>

source/src/main/java/demo/DateFormat.java

@@ -0,0 +1,93 @@
+/*
+ * Copyright 2015 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 demo;
+
+import static java.lang.annotation.ElementType.*;
+import static java.lang.annotation.RetentionPolicy.*;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+import java.text.SimpleDateFormat;
+
+import javax.validation.Constraint;
+import javax.validation.ConstraintValidator;
+import javax.validation.ConstraintValidatorContext;
+import javax.validation.Payload;
+
+/**
+ * The annotated String must be a valid {@link java.text.SimpleDateFormat} pattern.
+ *
+ * @author Eric Bottard
+ */
+@Target({METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER})
+@Retention(RUNTIME)
+@Documented
+@Constraint(validatedBy = {DateFormat.DateFormatValidator.class})
+public @interface DateFormat {
+
+	String DEFAULT_MESSAGE = "";
+
+	String message() default DEFAULT_MESSAGE;
+
+	Class<?>[] groups() default {};
+
+	Class<? extends Payload>[] payload() default {};
+
+
+	/**
+	 * Defines several {@link DateFormat} annotations on the same element.
+	 *
+	 * @see DateFormat
+	 */
+	@Target({METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER})
+	@Retention(RUNTIME)
+	@Documented
+	@interface List {
+
+		DateFormat[] value();
+	}
+
+	public static class DateFormatValidator implements ConstraintValidator<DateFormat, CharSequence> {
+
+		private String message;
+
+		@Override
+		public void initialize(DateFormat constraintAnnotation) {
+			this.message = constraintAnnotation.message();
+		}
+
+		@Override
+		public boolean isValid(CharSequence value, ConstraintValidatorContext context) {
+			if (value == null) {
+				return true;
+			}
+			try {
+				new SimpleDateFormat(value.toString());
+			}
+			catch (IllegalArgumentException e) {
+				if (DEFAULT_MESSAGE.equals(this.message)) {
+					context.disableDefaultConstraintViolation();
+					context.buildConstraintViolationWithTemplate(e.getMessage()).addConstraintViolation();
+				}
+				return false;
+			}
+			return true;
+		}
+	}
+
+}

source/src/main/java/demo/SourceApplication.java

@@ -0,0 +1,29 @@
+/*
+ * Copyright 2015 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 demo;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class SourceApplication {
+
+	public static void main(String[] args) {
+		SpringApplication.run(SourceApplication.class, args);
+	}
+
+}

source/src/main/java/demo/TimeSource.java

@@ -0,0 +1,50 @@
+/*
+ * Copyright 2015 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 demo;
+
+import java.text.SimpleDateFormat;
+import java.util.Date;
+
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.context.properties.EnableConfigurationProperties;
+import org.springframework.cloud.stream.annotation.EnableBinding;
+import org.springframework.cloud.stream.messaging.Source;
+import org.springframework.context.annotation.Bean;
+import org.springframework.integration.annotation.InboundChannelAdapter;
+import org.springframework.integration.annotation.Poller;
+import org.springframework.integration.core.MessageSource;
+import org.springframework.messaging.support.GenericMessage;
+
+/**
+ * @author Dave Syer
+ * @author Glenn Renfro
+ *
+ */
+@EnableBinding(Source.class)
+@EnableConfigurationProperties(TimeSourceOptionsMetadata.class)
+public class TimeSource {
+
+	@Autowired
+	private TimeSourceOptionsMetadata options;
+
+	@Bean
+	@InboundChannelAdapter(value = Source.OUTPUT, poller = @Poller(fixedDelay = "${fixedDelay}", maxMessagesPerPoll = "1"))
+	public MessageSource<String> timerMessageSource() {
+		return () -> new GenericMessage<>(new SimpleDateFormat(this.options.getFormat()).format(new Date()));
+	}
+
+}

source/src/main/java/demo/TimeSourceOptionsMetadata.java

@@ -0,0 +1,103 @@
+/*
+ * Copyright 2013-2015 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 demo;
+
+import javax.validation.constraints.Min;
+import javax.validation.constraints.Pattern;
+
+import org.springframework.boot.context.properties.ConfigurationProperties;
+
+/**
+ * Describes options to the {@code time} source module.
+ *
+ * @author Eric Bottard
+ * @author Gary Russell
+ */
+@ConfigurationProperties
+public class TimeSourceOptionsMetadata {
+
+	/**
+	 * 	how to render the current time, using SimpleDateFormat
+	 */
+	private String format = "yyyy-MM-dd HH:mm:ss";
+
+	/**
+	 * time delay between messages, expressed in TimeUnits (seconds by default)
+	 */
+	private int fixedDelay = 1;
+
+	/**
+	 * an initial delay when using a fixed delay trigger, expressed in TimeUnits (seconds by default)
+	 */
+	private int initialDelay = 0;
+
+	/**
+	 * the time unit for the fixed and initial delays
+	 */
+	private String timeUnit = "SECONDS";
+
+	/**
+	 * the maximum messages per poll; -1 for unlimited
+	 */
+	long maxMessages = 1;
+
+	public long getMaxMessages() {
+		return this.maxMessages;
+	}
+
+	public void setMaxMessages(long maxMessages) {
+		this.maxMessages = maxMessages;
+	}
+
+	@Min(0)
+	public int getInitialDelay() {
+		return this.initialDelay;
+	}
+
+	public void setInitialDelay(int initialDelay) {
+		this.initialDelay = initialDelay;
+	}
+
+	@Pattern(regexp = "(?i)(NANOSECONDS|MICROSECONDS|MILLISECONDS|SECONDS|MINUTES|HOURS|DAYS)",
+			message = "timeUnit must be one of NANOSECONDS, MICROSECONDS, MILLISECONDS, SECONDS, MINUTES, HOURS, DAYS (case-insensitive)")
+	public String getTimeUnit() {
+		return this.timeUnit;
+	}
+
+	public void setTimeUnit(String timeUnit) {
+		this.timeUnit = timeUnit.toUpperCase();
+	}
+
+	@DateFormat
+	public String getFormat() {
+		return this.format;
+	}
+
+	public void setFormat(String format) {
+		this.format = format;
+	}
+
+	public int getFixedDelay() {
+		return this.fixedDelay;
+	}
+
+	public void setFixedDelay(int fixedDelay) {
+		this.fixedDelay = fixedDelay;
+	}
+
+
+}

source/src/main/resources/application.yml

@@ -0,0 +1,24 @@
+server:
+  port: 8080
+fixedDelay: 5000
+spring:
+  cloud:
+    stream:
+      bindings:
+        output:
+          destination: testtock
+          contentType: text/plain
+        # uncomment below to use the last digit of the seconds as a partition key
+        # hashcode(key) % N is then applied with N being the partitionCount value
+        # thus, even seconds should go to the 0 queue, odd seconds to the 1 queue
+        #producerProperties:
+        #  partitionKeyExpression: payload.charAt(payload.length()-1)
+        #  partitionCount: 2
+
+---
+spring:
+  profiles: extended
+  cloud:
+    stream:
+      bindings:
+        output: xformed

source/src/test/java/demo/ModuleApplicationTests.java

@@ -0,0 +1,36 @@
+/*
+ * Copyright 2015 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 demo;
+
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.springframework.test.annotation.DirtiesContext;
+import org.springframework.test.context.web.WebAppConfiguration;
+import org.springframework.boot.test.SpringApplicationConfiguration;
+import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
+
+@RunWith(SpringJUnit4ClassRunner.class)
+@SpringApplicationConfiguration(classes = SourceApplication.class)
+@WebAppConfiguration
+@DirtiesContext
+public class ModuleApplicationTests {
+
+	@Test
+	public void contextLoads() {
+	}
+
+}