Additional set up info including example batch file to set environment;

additional info on DependencyViewer controls

Author: bjeffrie

sqldeveloper/extension/java/DependencyExample/README.md

@@ -9,12 +9,28 @@ The exact jars needed from them can be found in *DependencyExample/DependencyExa
 [Set up your environment](../../setup.md), get the required libraries (see above), build the (default) deploy target, and start SQLDeveloper from the command line WITH THE (sqldeveloper/bin/)sqldeveloper -clean OPTION.  
 
 On the first run, only the triggers defined in extension.xml will load.  
+
 ![DependencyExampleAbout diagram](images/DependencyExampleAbout.png)  
+
 In our case, that means the context menu entry only and NOT the dependency viewer tab referenced in the hook section (via DependencyExampleGraphViewer.xml which is in the directory the hook says to load xml from)
+
 ![DependencyExampleContextMenu diagram](images/DependencyExampleContextMenu.png)  
+
 Which opens the dependency diagram AND causes the rest of the extension hooks to load. (The editor tab name is pulled from the 1st selected node but will switch when focus goes to another editor and back. TODO: This really should be implemented as it's own dockable, not as an 'editor'.) 
+
 ![DependencyExampleZoomedOut diagram](images/DependencyExampleZoomedOut.png)  
-the diagram is scrollable, zoomable, editable, and can be exported to svg (all thanks to the FXDiagram library.) Double clicking on a node performs a "DrillLink" to open the SQL Developer editor for that node.  
+
+The diagram is scrollable, zoomable, editable, and can be exported to svg (all thanks to the FXDiagram library.) 
+Controls:
+* Scroll with mouse wheel
+* Zoom with Ctrl + mouse wheel
+* Select with left click, Ctrl+left click to add to selection, or draw bounding box with mouse
+* Move nodes / selection / diagram by holding down right mouse button & dragging. Left button also works for node / selection
+* Double clicking on a node performs a "DrillLink" to open the SQL Developer editor for that node.
+* Right click brings up context menu. Hover over icons to see what is available. Note that do / undo refer to changes made to the diagram since opening it.   
+
 ![DependencyExampleZoomedIn diagram](images/DependencyExampleZoomedIn.png)  
+
 Now that it is fully loaded, the viewer definition is active and a dependency graph tab is added to the object viewers. (The next time a new one is opened.) 
+
 ![DependencyExampleViewer diagram](images/DependencyExampleViewer.png)  

sqldeveloper/extension/java/DependencyExample/src/oracle/db/example/sqldeveloper/extension/dependency/control/FxDiagram.java

@@ -112,7 +112,6 @@ Everyone is permitted to copy and distribute copies of this Agreement, but in or
 import javafx.collections.ObservableList;
 import javafx.event.EventHandler;
 import javafx.geometry.Insets;
-import javafx.scene.Cursor;
 import javafx.scene.input.KeyEvent;
 import javafx.scene.input.MouseButton;
 import javafx.scene.input.MouseEvent;
@@ -239,17 +238,12 @@ public void handle(MouseEvent event) {
                     lastClickTime = now;
                 }
                 if (MouseButton.PRIMARY == event.getButton() && timeBetween < doubleClickThreshold) {
-                    setCursor(Cursor.WAIT);
                     SwingUtilities.invokeLater(() -> {
                         try {
                             model.performDrill(key);
                         } catch (Exception e) {
                             String msg = DependencyExampleResources.format(DependencyExampleResources.DependencyExampleFxControl_drillLink_fail, key);
                             Logger.warn(FxDiagram.class, msg, e);
-                        } finally {
-                            Platform.runLater(() -> {
-                                FxDiagram.this.setCursor(Cursor.DEFAULT);
-                            });
                         }
                     });
                 } else {

sqldeveloper/extension/setenv.bat

@@ -0,0 +1,6 @@
+SET ANT_HOME=D:\apache-ant-1.10.3
+SET JAVA_HOME=C:\Program Files\Java\jdk1.8.0_152
+SET ANT_BIN=%ANT_HOME%\bin
+SET SQLDEV_BIN=D:\sqldeveloper-18.1.0\sqldeveloper\sqldeveloper\bin
+SET PATH=%PATH%;%ANT_BIN%;%SQLDEV_BIN%
+

sqldeveloper/extension/setup.md

@@ -30,14 +30,15 @@ sqldeveloper/extension is an eclipse project directory but the examples are buil
 ## Wiring it together
 ### build.properties
 * extension/build.properties - Update to point to your SQL Developer installation & optionally change the owner info.
+* extension/java/SQLDeveloper18.1.userlibraries - **IF** you are using eclipse, update the paths to point to your SQL Developer installation and import the library.
 
 ### Third party libraries
 **If/when** you plan to build the [Dependency Example](java/DependencyExample), see that page for additional set up requirements.
 
 ## Making it go
 If you are using eclipse, I'm going to assume you know how to import an existing project and run ant tasks but continue reading to learn about the various ant tasks and how they are used.
 
-If you are using ant from the command line, make sure `ANT_HOME` and `JAVA_HOME` are defined for your environment and that ant is on your `PATH` and accessible from the command line.
+If you are using ant from the command line, make sure `ANT_HOME` and `JAVA_HOME` are defined for your environment and that ant is on your `PATH` and accessible from the command line. An example setenv.bat file to do this is in the extension folder. I included sqldeveloper on the path so I wouldn't have to navigate around.
 
 ### Ant tasks
 The [XML Packaged](xml/packaged) example and all of the [Java](java) examples use ant to build and deploy the example. The 'heavy lifting' is all defined in buildtools so the individual build.xml files for each example are pretty simple. There only a few targets of interest: