Add examples by @maarzt

Author: tpietzsch

src/test/java/org/scijava/optional/examples/advanced/Demo.java

@@ -0,0 +1,14 @@
+package org.scijava.optional.examples.advanced;
+
+public class Demo
+{
+	public static void main( String... args )
+	{
+		final OptionsAB options = new OptionsAB().b( "Hello" ).a( 42 );
+		System.out.println( "options = " + options );
+		System.out.println( "options.values = " + options.values );
+		System.out.println();
+		System.out.println( "Option a: " + options.values.a() );
+		System.out.println( "Option b: " + options.values.b() );
+	}
+}

src/test/java/org/scijava/optional/examples/advanced/OptionsA.java

@@ -0,0 +1,26 @@
+package org.scijava.optional.examples.advanced;
+
+import java.util.function.BiConsumer;
+import org.scijava.optional.Options;
+import org.scijava.optional.Values;
+
+interface OptionsA< T > extends Options< T >
+{
+	default T a( int a )
+	{
+		return setValue( "a", a );
+	}
+
+	interface Val extends Values
+	{
+		default int a()
+		{
+			return getValueOrDefault( "a", 0 );
+		}
+
+		default void forEach( BiConsumer< String, Object > action )
+		{
+			action.accept( "a", a() );
+		}
+	}
+}

src/test/java/org/scijava/optional/examples/advanced/OptionsAB.java

@@ -0,0 +1,28 @@
+package org.scijava.optional.examples.advanced;
+
+import java.util.function.BiConsumer;
+import org.scijava.optional.AbstractOptions;
+
+/**
+ * {@code OptionsAB} inherits options defined in interfaces {@code OptionsA} and {@code OptionsB}
+ */
+public class OptionsAB
+		extends AbstractOptions< OptionsAB >
+		implements OptionsA< OptionsAB >, OptionsB< OptionsAB >
+{
+	public Values values = new Values();
+
+	/**
+	 * {@code OptionsAB.Values} inherits default values defined in interfaces {@code OptionsA.Val} and {@code OptionsB.Val}
+	 */
+	public class Values extends AbstractValues implements OptionsA.Val, OptionsB.Val
+	{
+		@Override
+		public void forEach( BiConsumer< String, Object > action )
+		{
+			OptionsA.Val.super.forEach( action );
+			OptionsB.Val.super.forEach( action );
+		}
+	}
+}
+

src/test/java/org/scijava/optional/examples/advanced/OptionsB.java

@@ -0,0 +1,26 @@
+package org.scijava.optional.examples.advanced;
+
+import java.util.function.BiConsumer;
+import org.scijava.optional.Options;
+import org.scijava.optional.Values;
+
+public interface OptionsB< T > extends Options< T >
+{
+	default T b( String b )
+	{
+		return setValue( "b", b );
+	}
+
+	interface Val extends Values
+	{
+		default String b()
+		{
+			return getValueOrDefault( "b", "" );
+		}
+
+		default void forEach( BiConsumer< String, Object > action )
+		{
+			action.accept( "b", b() );
+		}
+	}
+}

src/test/java/org/scijava/optional/examples/simple/Demo.java

@@ -0,0 +1,64 @@
+package org.scijava.optional.examples.simple;
+
+import java.util.function.BiConsumer;
+import org.scijava.optional.AbstractOptions;
+
+public class Demo
+{
+	public static void main( String... args )
+	{
+		print( "new MyOptions()", new MyOptions() );
+		print( "new MyOptions().number( 42 )", new MyOptions().number( 42 ) );
+		print( "new MyOptions().text( \"Hello\" )", new MyOptions().text( "Hello" ) );
+		print( "new MyOptions().text( \"World\" ).number( 12 )", new MyOptions().text( "World" ).number( 12 ) );
+	}
+
+	private static void print( String title, MyOptions options )
+	{
+		System.out.println( title );
+		System.out.println( "  options = " + options );
+		System.out.println( "  options.values = " + options.values );
+		System.out.println( "  options.values.number() = " + options.values.number() );
+		System.out.println( "  options.values.text() = " + options.values.text() );
+		System.out.println();
+	}
+
+	public static class MyOptions extends AbstractOptions< MyOptions >
+	{
+		public MyOptions number( int number )
+		{
+			return setValue( "number", number );
+		}
+
+		public MyOptions text( String text )
+		{
+			return setValue( "text", text );
+		}
+
+		public Values values = new Values();
+
+		public class Values extends AbstractValues
+		{
+			public int number()
+			{
+				return getValueOrDefault( "number", -1 );
+			}
+
+			public String text()
+			{
+				return getValueOrDefault( "text", "" );
+			}
+
+			/*
+			 * Overriding forEach() makes default values show up in Values.toString().
+			 * (Try commenting it out.)
+			 */
+			@Override
+			public void forEach( final BiConsumer< String, Object > action )
+			{
+				action.accept( "number", number() );
+				action.accept( "text", text() );
+			}
+		}
+	}
+}