# HG changeset patch
# User Jaroslav Tulach <jtulach@netbeans.org>
# Date 1213430356 -7200
# Node ID 0f658628beacc603895f44204356cf7c7e9bc7ab
# Parent  7aaa7b256c7ebe22a1336c68af0e2378ea52295c
First two versions of client provider Visitor

diff -r 7aaa7b256c7e -r 0f658628beac samples/visitor/21-clientprovider/build.xml
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/samples/visitor/21-clientprovider/build.xml	Sat Jun 14 09:59:16 2008 +0200
@@ -0,0 +1,96 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project name="Build Script" default="test" basedir=".">
+    <target name="clean">
+        <delete dir="build"/>
+    </target>
+    
+    <target name="compile" depends="build"/>
+    <target name="build" depends="-libraries">
+        <antcall target="-build-one">
+            <param name="version" value="api1.0"/>
+        </antcall>
+        <antcall target="-build-one">
+            <param name="version" value="api2.0"/>
+        </antcall>
+        
+        <antcall target="-build-one">
+            <param name="version" value="test"/>
+            <param name="cp" value="build/api1.0/classes:${junit.jar}"/>
+        </antcall>
+
+        <echo level="info" message="Next compilation will fails, as adding methods into interface is not binary compatible"/>
+        <antcall target="-build-one">
+            <param name="version" value="test"/>
+            <param name="out" value="will-not-compile"/>
+            <param name="cp" value="build/api2.0/classes:${junit.jar}"/>
+            <param name="failonerror" value="false"/>
+        </antcall>
+
+        <antcall target="-build-one">
+            <param name="version" value="test2.0"/>
+            <param name="cp" value="build/api2.0/classes:build/test/classes:${junit.jar}"/>
+        </antcall>
+    </target>
+    
+    <target name="test" depends="build">
+        <echo level="info" message="PrintVisitor on old API. This should succeeds."/>
+        <antcall target="-run-one">
+            <param name="version" value="api1.0"/>
+        </antcall>
+        <echo level="info" message="PrintVisitor on old API. This would not compile, but it runs as it does not deal with minus at all."/>
+        <antcall target="-run-one">
+            <param name="version" value="api2.0"/>
+        </antcall>
+        <echo level="info" message="PrintVisitor on new API. This yields runtime error."/>
+        <antcall target="-run-one">
+            <param name="test" value="test2.0"/>
+            <param name="extra.cp" value="build/test/classes"/>
+            <param name="version" value="api2.0"/>
+        </antcall>
+    </target>
+    
+    <!-- support methods -->
+    
+    <target name="-libraries">
+        <ant dir="../../libs/"/>
+        
+        <property name="junit.jar" location="../../libs/dist/junit-4.4.jar"/>
+    </target>
+    
+    <target name="-run-one">
+        <fail message="You need to specify API version number" unless="version"/>
+        <property name="test" value="test"/>
+        <mkdir dir="build/${test}results${version}"/>
+        <junit dir="build/test/classes" errorproperty="tests.failed" failureproperty="tests.failed" fork="true" showoutput="true">
+            <batchtest todir="build/${test}results${version}">
+                <fileset dir="build/${test}/classes">
+                    <filename name="**/*Test.class"/>
+                </fileset>
+            </batchtest>
+            <classpath>
+                <path location="build/${version}/classes"/>
+                <path location="build/${test}/classes"/>
+                <path location="${junit.jar}"/>
+                <path path="${extra.cp}"/>
+            </classpath>
+            <formatter type="brief" usefile="false"/>
+            <formatter type="xml"/>
+        </junit>
+    </target>
+    
+    <target name="-build-one">
+        <fail message="You need to specify version number" unless="version"/>
+        
+        <property name="cp" value=""/>
+        <property name="out" value="${version}"/>
+        <property name="failonerror" value="true"/>
+        <mkdir dir="build/${out}/classes"/>
+        <javac 
+            srcdir="src-${version}" 
+            destdir="build/${out}/classes" 
+            source="1.5" target="1.5"
+            classpath="${cp}"
+            failonerror="${failonerror}"
+        />
+    </target>
+</project>
diff -r 7aaa7b256c7e -r 0f658628beac samples/visitor/21-clientprovider/nbproject/project.xml
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/samples/visitor/21-clientprovider/nbproject/project.xml	Sat Jun 14 09:59:16 2008 +0200
@@ -0,0 +1,107 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://www.netbeans.org/ns/project/1" xmlns:ns4="null">
+    <type>org.netbeans.modules.ant.freeform</type>
+    <configuration>
+        <general-data xmlns="http://www.netbeans.org/ns/freeform-project/1">
+            <name>clientprovider</name>
+        </general-data>
+        <general-data xmlns="http://www.netbeans.org/ns/freeform-project/2">
+            <!-- Do not use Project Properties customizer when editing this file manually. -->
+            <name>clientprovider</name>
+            <properties/>
+            <folders>
+                <source-folder>
+                    <label>src-api1.0</label>
+                    <type>java</type>
+                    <location>src-api1.0</location>
+                    <encoding>UTF-8</encoding>
+                </source-folder>
+                <source-folder>
+                    <label>src-api2.0</label>
+                    <type>java</type>
+                    <location>src-api2.0</location>
+                    <encoding>UTF-8</encoding>
+                </source-folder>
+                <source-folder>
+                    <label>test</label>
+                    <type>java</type>
+                    <location>src-test</location>
+                    <encoding>UTF-8</encoding>
+                </source-folder>
+                <source-folder>
+                    <label>test-2.0</label>
+                    <type>java</type>
+                    <location>src-test2.0</location>
+                    <encoding>UTF-8</encoding>
+                </source-folder>
+            </folders>
+            <ide-actions>
+                <action name="build">
+                    <target>build</target>
+                </action>
+                <action name="clean">
+                    <target>clean</target>
+                </action>
+                <action name="test">
+                    <target>test</target>
+                </action>
+                <action name="run">
+                    <target>test</target>
+                </action>
+                <action name="rebuild">
+                    <target>clean</target>
+                    <target>build</target>
+                </action>
+            </ide-actions>
+            <view>
+                <items>
+                    <source-folder style="packages">
+                        <label>API Version 1.0</label>
+                        <location>src-api1.0</location>
+                    </source-folder>
+                    <source-folder style="packages">
+                        <label>API Version 2.0</label>
+                        <location>src-api2.0</location>
+                    </source-folder>
+                    <source-folder style="packages">
+                        <label>Usage of the API</label>
+                        <location>src-test</location>
+                    </source-folder>
+                    <source-folder style="packages">
+                        <label>Usage of new structures with old visitor</label>
+                        <location>src-test2.0</location>
+                    </source-folder>
+                    <source-file>
+                        <location>build.xml</location>
+                    </source-file>
+                </items>
+                <context-menu>
+                    <ide-action name="build"/>
+                    <ide-action name="rebuild"/>
+                    <ide-action name="clean"/>
+                    <ide-action name="test"/>
+                </context-menu>
+            </view>
+        </general-data>
+        <java-data xmlns="http://www.netbeans.org/ns/freeform-project-java/1">
+            <compilation-unit>
+                <package-root>src-api1.0</package-root>
+                <source-level>1.5</source-level>
+            </compilation-unit>
+            <compilation-unit>
+                <package-root>src-api2.0</package-root>
+                <source-level>1.5</source-level>
+            </compilation-unit>
+            <compilation-unit>
+                <package-root>src-test</package-root>
+                <classpath mode="compile">src-api1.0:../../libs/dist/junit-4.4.jar</classpath>
+                <source-level>1.5</source-level>
+            </compilation-unit>
+            <compilation-unit>
+                <package-root>src-test2.0</package-root>
+                <classpath mode="compile">src-api2.0:src-test:../../libs/dist/junit-4.4.jar</classpath>
+                <source-level>1.5</source-level>
+            </compilation-unit>
+        </java-data>
+    </configuration>
+</project>
diff -r 7aaa7b256c7e -r 0f658628beac samples/visitor/21-clientprovider/src-api1.0/org/apidesign/visitor/Language.java
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/samples/visitor/21-clientprovider/src-api1.0/org/apidesign/visitor/Language.java	Sat Jun 14 09:59:16 2008 +0200
@@ -0,0 +1,49 @@
+package org.apidesign.visitor;
+
+public final class Language {
+    private Language() { }
+    
+    // BEGIN: visitor.clientprovider.v1
+    public interface Expression {
+        public abstract void visit(Visitor v);
+    }
+    public interface Plus extends Expression {
+        public Expression getFirst();
+        public Expression getSecond();
+    }
+    public interface Number extends Expression {
+        public int getValue();
+    }
+
+    public static abstract class Visitor {
+        Visitor() {}
+
+        public Visitor create(Version1_0 v) {
+            return create1_0(v);
+        }
+
+        public interface Version1_0 {
+            public boolean visitUnknown(Expression e);
+            public void visitPlus(Plus s);
+            public void visitNumber(Number n);
+        }
+
+        public abstract void dispatchPlus(Plus p);
+        public abstract void dispatchNumber(Number n);
+    }
+    // END: visitor.clientprovider.v1
+    
+    static Visitor create1_0(final Visitor.Version1_0 v) {
+        return new Visitor() {
+            @Override
+            public void dispatchPlus(Plus p) {
+                v.visitPlus(p);
+            }
+
+            @Override
+            public void dispatchNumber(Number n) {
+                v.visitNumber(n);
+            }
+        };
+    }
+}
diff -r 7aaa7b256c7e -r 0f658628beac samples/visitor/21-clientprovider/src-api2.0/org/apidesign/visitor/Language.java
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/samples/visitor/21-clientprovider/src-api2.0/org/apidesign/visitor/Language.java	Sat Jun 14 09:59:16 2008 +0200
@@ -0,0 +1,93 @@
+package org.apidesign.visitor;
+
+public final class Language {
+    private Language() { }
+    
+    public interface Expression {
+        public abstract void visit(Visitor v);
+    }
+    public interface Plus extends Expression {
+        public Expression getFirst();
+        public Expression getSecond();
+    }
+    public interface Number extends Expression {
+        public int getValue();
+    }
+    // BEGIN: visitor.clientprovider.v2
+    /** @since 2.0 */
+    public interface Minus extends Expression {
+        public Expression getFirst();
+        public Expression getSecond();
+    }
+    
+    public static abstract class Visitor {
+        Visitor() {}
+        /** @since 2.0 */
+        public static Visitor create(Version2_0 v) {
+            return create2_0(v);
+        }
+
+        /** @since 2.0 */
+        public interface Version2_0 extends Version1_0 {
+            public void visitMinus(Minus m);
+        }
+
+
+        /** @since 2.0 */
+        public abstract void dispatchNumber(Number n);
+    // FINISH: visitor.clientprovider.v2
+        
+        public Visitor create(Version1_0 v) {
+            return create1_0(v);
+        }
+
+        public interface Version1_0 {
+            public boolean visitUnknown(Expression e);
+            public void visitPlus(Plus s);
+            public void visitNumber(Number n);
+        }
+
+        public abstract void dispatchPlus(Plus p);
+        public abstract void dispatchMinus(Minus m);
+    }
+    
+    static Visitor create1_0(final Visitor.Version1_0 v) {
+        return new Visitor() {
+            @Override
+            public void dispatchPlus(Plus p) {
+                v.visitPlus(p);
+            }
+
+            @Override
+            public void dispatchNumber(Number n) {
+                v.visitNumber(n);
+            }
+
+            @Override
+            public void dispatchMinus(Minus m) {
+                if (v.visitUnknown(m)) {
+                    m.getFirst().visit(this);
+                    m.getSecond().visit(this);
+                }
+            }
+        };
+    }
+    static Visitor create2_0(final Visitor.Version2_0 v) {
+        return new Visitor() {
+            @Override
+            public void dispatchPlus(Plus p) {
+                v.visitPlus(p);
+            }
+
+            @Override
+            public void dispatchNumber(Number n) {
+                v.visitNumber(n);
+            }
+
+            @Override
+            public void dispatchMinus(Minus m) {
+                v.visitMinus(m);
+            }
+        };
+    }
+}
diff -r 7aaa7b256c7e -r 0f658628beac samples/visitor/21-clientprovider/src-test/org/apidesign/test/visitor/PrintTest.java
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/samples/visitor/21-clientprovider/src-test/org/apidesign/test/visitor/PrintTest.java	Sat Jun 14 09:59:16 2008 +0200
@@ -0,0 +1,49 @@
+package org.apidesign.test.visitor;
+
+import static junit.framework.Assert.*;
+import org.apidesign.visitor.notevolutionready.Language.Expression;
+import org.apidesign.visitor.notevolutionready.Language.Number;
+import org.apidesign.visitor.notevolutionready.Language.Plus;
+import org.apidesign.visitor.notevolutionready.Language.Visitor;
+import org.junit.Test;
+
+public class PrintTest {
+
+    // BEGIN: visitor.notevolutionready.print
+    public static class PrintVisitor implements Visitor {
+        StringBuffer sb = new StringBuffer();
+        
+        public void visitPlus(Plus s) {
+            s.getFirst().visit(this);
+            sb.append(" + ");
+            s.getSecond().visit(this);
+        }
+
+        public void visitNumber(Number n) {
+            sb.append (n.getValue());
+        }
+    }
+    
+    @Test public void printOnePlusOne() {
+        Number one = new Number(1);
+        Expression plus = new Plus(one, one);
+        
+        PrintVisitor print = new PrintVisitor();
+        plus.visit(print);
+        
+        assertEquals("1 + 1", print.sb.toString());
+    }
+    // END: visitor.notevolutionready.print
+
+    @Test public void printOnePlusTwoPlusThree() {
+        Number one = new Number(1);
+        Number two = new Number(2);
+        Number three = new Number(3);
+        Expression plus = new Plus(one, new Plus(two, three));
+        
+        PrintVisitor print = new PrintVisitor();
+        plus.visit(print);
+        
+        assertEquals("1 + 2 + 3", print.sb.toString());
+    }
+}
diff -r 7aaa7b256c7e -r 0f658628beac samples/visitor/21-clientprovider/src-test2.0/org/apidesign/test/visitor/PrintOfMinusStructureTest.java
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/samples/visitor/21-clientprovider/src-test2.0/org/apidesign/test/visitor/PrintOfMinusStructureTest.java	Sat Jun 14 09:59:16 2008 +0200
@@ -0,0 +1,25 @@
+package org.apidesign.test.visitor;
+
+import org.apidesign.test.visitor.PrintTest.PrintVisitor;
+import static junit.framework.Assert.*;
+import org.apidesign.visitor.notevolutionready.Language.Expression;
+import org.apidesign.visitor.notevolutionready.Language.Minus;
+import org.apidesign.visitor.notevolutionready.Language.Number;
+import org.apidesign.visitor.notevolutionready.Language.Plus;
+import org.apidesign.visitor.notevolutionready.Language.Visitor;
+import org.junit.Test;
+
+public class PrintOfMinusStructureTest {
+    @Test public void printOneMinusTwo() {
+        // BEGIN: visitor.notevolutionready.oldwithnew
+        Number one = new Number(1);
+        Number two = new Number(2);
+        Expression plus = new Minus(one, two);
+        
+        PrintVisitor print = new PrintVisitor();
+        plus.visit(print); // fails with AbstractMethodError
+        
+        assertEquals("1 - 2", print.sb.toString());
+        // END: visitor.notevolutionready.oldwithnew
+    }
+}