# HG changeset patch
# User Jaroslav Tulach <jtulach@netbeans.org>
# Date 1213430028 -7200
# Node ID adf4440db8886de15c929d72543240878d7b0655
# Parent  935c169667a2d9e85b3907f48fbf192fc71b600b
How to write extension point

diff -r 935c169667a2 -r adf4440db888 samples/extensionpoint/build.xml
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/samples/extensionpoint/build.xml	Sat Jun 14 09:53:48 2008 +0200
@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project name="extensionpoint" default="run" basedir=".">
+    <target name="clean">
+        <delete dir="build"/>
+    </target>
+    
+    <target name="build">
+        <antcall target="-build-one">
+            <param name="version" value="api"/>
+        </antcall>
+        <antcall target="-build-one">
+            <param name="version" value="helloworld"/>
+            <param name="cp" location="build/api/classes"/>
+        </antcall>
+        <antcall target="-build-one">
+            <param name="version" value="hellodesign"/>
+            <param name="cp" location="build/api/classes"/>
+        </antcall>
+    </target>
+    
+    <target name="run" depends="build">
+        <echo level="info" message="Running without any extension points."/>
+        <antcall target="-run-one">
+        </antcall>
+        <echo level="info" message="Running with 'Hello World!' extension."/>
+        <antcall target="-run-one">
+            <param name="version1" value="helloworld"/>
+        </antcall>
+        <echo level="info" message="Running with 'Hello Design!' extension."/>
+        <antcall target="-run-one">
+            <param name="version1" value="hellodesign"/>
+        </antcall>
+        <echo level="info" message="Running with both extension."/>
+        <antcall target="-run-one">
+            <param name="version1" value="helloworld"/>
+            <param name="version2" value="hellodesign"/>
+        </antcall>
+    </target>
+
+    
+    <!-- support methods -->
+    
+    <target name="-run-one">
+        <java 
+            classpath="build/${version1}/classes:build/${version2}/classes:build/api/classes:../libs/dist/org-openide-util.jar" 
+            classname="org.apidesign.extensionpoint.Main"
+            failonerror="true" 
+        >
+            <jvmarg value="-ea"/>
+        </java>
+    </target>
+    
+    <target name="-build-one">
+        <fail message="You need to specify version number" unless="version"/>
+        
+        <mkdir dir="build/${version}/classes"/>
+        <property name="cp" value=""/>
+        <javac 
+            srcdir="src-${version}" 
+            destdir="build/${version}/classes" 
+            source="1.5" target="1.5"
+            classpath="${cp}"
+        />
+        <copy todir="build/${version}/classes">
+            <fileset dir="src-${version}">
+                <exclude name="**/*.java"/>
+            </fileset>
+        </copy>
+    </target>
+</project>
diff -r 935c169667a2 -r adf4440db888 samples/extensionpoint/nbproject/project.xml
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/samples/extensionpoint/nbproject/project.xml	Sat Jun 14 09:53:48 2008 +0200
@@ -0,0 +1,105 @@
+<?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>extensionpoint</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>extensionpoint</name>
+            <properties/>
+            <folders>
+                <source-folder>
+                    <label>extensionpoint</label>
+                    <location>.</location>
+                    <encoding>UTF-8</encoding>
+                </source-folder>
+                <source-folder>
+                    <label>src-hellodesign</label>
+                    <type>java</type>
+                    <location>src-hellodesign</location>
+                    <encoding>UTF-8</encoding>
+                </source-folder>
+                <source-folder>
+                    <label>src-helloworld</label>
+                    <type>java</type>
+                    <location>src-helloworld</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="run">
+                    <target>run</target>
+                </action>
+                <action name="rebuild">
+                    <target>clean</target>
+                    <target>build</target>
+                </action>
+            </ide-actions>
+            <export>
+                <type>folder</type>
+                <location>build/api/classes</location>
+                <build-target>build</build-target>
+            </export>
+            <export>
+                <type>folder</type>
+                <location>build/api2.0/classes</location>
+                <build-target>build</build-target>
+            </export>
+            <view>
+                <items>
+                    <source-folder style="packages">
+                        <label>src-api</label>
+                        <location>src-api</location>
+                    </source-folder>
+                    <source-folder style="packages">
+                        <label>src-helloworld</label>
+                        <location>src-helloworld</location>
+                    </source-folder>
+                    <source-folder style="packages">
+                        <label>src-hellodesign</label>
+                        <location>src-hellodesign</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="run"/>
+                    <ide-action name="debug"/>
+                </context-menu>
+            </view>
+            <subprojects/>
+        </general-data>
+        <java-data xmlns="http://www.netbeans.org/ns/freeform-project-java/1">
+            <compilation-unit>
+                <package-root>src-api</package-root>
+                <classpath mode="compile">../libs/dist/org-openide-util.jar</classpath>
+                <built-to>build/api/classes</built-to>
+                <source-level>1.5</source-level>
+            </compilation-unit>
+            <compilation-unit>
+                <package-root>src-helloworld</package-root>
+                <classpath mode="compile">src-api</classpath>
+                <built-to>build/helloworld/classes</built-to>
+                <source-level>1.5</source-level>
+            </compilation-unit>
+            <compilation-unit>
+                <package-root>src-hellodesign</package-root>
+                <classpath mode="compile">src-api</classpath>
+                <built-to>build/hellodesign/classes</built-to>
+                <source-level>1.5</source-level>
+            </compilation-unit>
+        </java-data>
+    </configuration>
+</project>
diff -r 935c169667a2 -r adf4440db888 samples/extensionpoint/src-api/org/apidesign/extensionpoint/Main.java
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/samples/extensionpoint/src-api/org/apidesign/extensionpoint/Main.java	Sat Jun 14 09:53:48 2008 +0200
@@ -0,0 +1,44 @@
+package org.apidesign.extensionpoint;
+
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+import javax.swing.JOptionPane;
+import org.apidesign.extensionpoint.api.TipOfTheDay;
+import org.openide.util.Lookup;
+
+public class Main {
+    public static void main(String[] args) {
+        for (;;) {
+            // BEGIN: extension.point.Query
+            Collection<? extends TipOfTheDay> all = Lookup.getDefault().lookupAll(TipOfTheDay.class);
+            List<TipOfTheDay> arr = new ArrayList<TipOfTheDay>(all);
+            Collections.shuffle(arr);
+
+            String msg;
+            String title;
+            int type;
+            if (arr.isEmpty()) {
+                msg = "I do not know what to say!";
+                title = "No provider registered";
+                type = JOptionPane.WARNING_MESSAGE;
+            } else {
+                msg = arr.get(0).sayHello();
+                title = "Selected from " + arr.size() + " providers";
+                type = JOptionPane.INFORMATION_MESSAGE;
+            }
+            // END: extension.point.Query
+
+            String again = "Once Again";
+            String exit = "Exit";
+            String[] options = new String[] { again, exit };
+            int ret = JOptionPane.showOptionDialog(null, msg, title, 0, type, null, options, exit);
+
+            if (ret != 0) {
+                break;
+            }
+        }
+        System.exit(0);
+    }
+}
diff -r 935c169667a2 -r adf4440db888 samples/extensionpoint/src-api/org/apidesign/extensionpoint/api/TipOfTheDay.java
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/samples/extensionpoint/src-api/org/apidesign/extensionpoint/api/TipOfTheDay.java	Sat Jun 14 09:53:48 2008 +0200
@@ -0,0 +1,8 @@
+// BEGIN: extension.point.Tip
+package org.apidesign.extensionpoint.api;
+
+public interface TipOfTheDay {
+    public String sayHello();
+}
+// END: extension.point.Tip
+
diff -r 935c169667a2 -r adf4440db888 samples/extensionpoint/src-hellodesign/META-INF/services/org.apidesign.extensionpoint.api.TipOfTheDay
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/samples/extensionpoint/src-hellodesign/META-INF/services/org.apidesign.extensionpoint.api.TipOfTheDay	Sat Jun 14 09:53:48 2008 +0200
@@ -0,0 +1,1 @@
+org.apidesign.extensionpoint.impl1.HelloDesign
diff -r 935c169667a2 -r adf4440db888 samples/extensionpoint/src-hellodesign/org/apidesign/extensionpoint/impl1/HelloDesign.java
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/samples/extensionpoint/src-hellodesign/org/apidesign/extensionpoint/impl1/HelloDesign.java	Sat Jun 14 09:53:48 2008 +0200
@@ -0,0 +1,9 @@
+package org.apidesign.extensionpoint.impl1;
+
+import org.apidesign.extensionpoint.api.TipOfTheDay;
+
+public class HelloDesign implements TipOfTheDay{
+    public String sayHello() {
+        return "Hello API Design!";
+    }
+}
diff -r 935c169667a2 -r adf4440db888 samples/extensionpoint/src-helloworld/META-INF/services/org.apidesign.extensionpoint.api.TipOfTheDay
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/samples/extensionpoint/src-helloworld/META-INF/services/org.apidesign.extensionpoint.api.TipOfTheDay	Sat Jun 14 09:53:48 2008 +0200
@@ -0,0 +1,3 @@
+# BEGIN: extension.point.Reg2
+org.apidesign.extensionpoint.impl2.HelloWorld
+# END: extension.point.Reg2
diff -r 935c169667a2 -r adf4440db888 samples/extensionpoint/src-helloworld/org/apidesign/extensionpoint/impl2/HelloWorld.java
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/samples/extensionpoint/src-helloworld/org/apidesign/extensionpoint/impl2/HelloWorld.java	Sat Jun 14 09:53:48 2008 +0200
@@ -0,0 +1,12 @@
+// BEGIN: extension.point.Impl2
+package org.apidesign.extensionpoint.impl2;
+
+import org.apidesign.extensionpoint.api.TipOfTheDay;
+
+
+public class HelloWorld implements TipOfTheDay {
+    public String sayHello() {
+        return "Hello World!";
+    }
+}
+// END: extension.point.Impl2