WIP: SQLDEV-2076 Add ConnectionHelper example

Initial set up for new extension development on Mac

Author: bjeffrie

sqldeveloper/extension/build.properties

@@ -6,7 +6,8 @@
 # This is where the builds will deploy the extension
 # and where we can find our dependencies 
 #sqldev.dir=D:/sqldeveloper-4.2.0.17.089.1709/sqldeveloper
-sqldev.dir=D:/sqldeveloper-19.2.1/sqldeveloper
+#sqldev.dir=D:/sqldeveloper-19.2.1/sqldeveloper
+sqldev.dir=/Users/bjeffrie/eclipse-workspace-20.1/sql-developer/ide
 
 # Information about the company or person creating the extension
 extension.owner=Oracle Examples

sqldeveloper/extension/java/ConnectionHelper/README.md

@@ -0,0 +1,34 @@
+# SQL Developer Examples
+## ConnectionHelper
+Accept connection info from the command line (and maybe on a [SocketServer](https://docs.oracle.com/javase/tutorial/networking/sockets/clientServer.html))
+
+### Command Line
+sqldeveloper -_conName_**=**_user_\[_**/**_\[_pw_]]**@**_host_**:**_port_(**:**_sid_|**/**_svc_)\[**#**_role_]
+
+Where:
+- *connName* is the name you would like for the connection
+- *user* is the user name for the schema you want to use
+- */password* is the password for that user *(optional - if missing e.g., user@ or user/@, SQLDeveloper will prompt for it)*
+- *host* is the host that the database is on
+- *port* is the port the database is listening on
+- *:sid* is the sid for the database *(One of :sid or /svc MUST be supplied)*
+- */svc* is the service name for the database *(One of :sid or /svc MUST be supplied)*
+- *#role* is the role *(optional - one of SYSDBA, SYSOPER, SYSBACKUP, SYSDG, SYSKM, SYSASM if used)*
+
+### [ConnectionHelperAddin](src/oracle/db/example/sqldeveloper/extension/connectionhelper/ConnectionHelperAddin.java)
+1. Creates the requested connection in a "Transient" folder
+2. Navigates to and opens the new connection
+3. Sets up a hook to remove the connection when SQLDeveloper shuts down
+
+### TODO
+* Preference page _(May need/want preference page as a load trigger hook)_
+ * CheckBox: Accept connection info on command line [false]
+ * CheckBox: Persist command line connections [false]
+* [SocketServer](https://docs.oracle.com/javase/tutorial/networking/sockets/clientServer.html)
+* Preference page
+ * NumericSpinner: Listener port [4444]
+ * CheckBox: Autostart server
+ * Button: Start now 
+* Simple client test app for [SocketServer](https://docs.oracle.com/javase/tutorial/networking/sockets/clientServer.html)
+
+

sqldeveloper/extension/java/README.md

@@ -19,3 +19,6 @@ a PLDoc template if PL/Scope information is available.
 
 * [InsertTemplateAction](InsertTemplateAction)
 A quick context menu action on code editor to insert a template string for @maternaDev01
+
+* [ConnectionHelper](ConnectionHelper)
+Accept connection info from the command line (and maybe on a [SocketServer](https://docs.oracle.com/javase/tutorial/networking/sockets/clientServer.html))

sqldeveloper/extension/setenv.sh

@@ -0,0 +1,6 @@
+export ANT_HOME=/usr/local/Cellar/ant/1.10.5
+export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_221.jdk/Contents/Home
+export ANT_BIN=${ANT_HOME}/bin
+export SQLDEV_BIN=/Users/bjeffrie/eclipse-workspace-20.1/sql-developer/ide/sqldeveloper/bin
+export PATH=${PATH}:${ANT_BIN}:${SQLDEV_BIN}
+

sqldeveloper/extension/setup.md

@@ -3,7 +3,7 @@
 ## First things first: Getting the pieces
 
 ### Java JDK 8
-We are currently using [jdk1.8](http://www.oracle.com/technetwork/java/javase/downloads/java-archive-javase8-2177648.html)
+We are currently using [jdk1.8](https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html)
 
 ### SQL Developer
 You'll need a copy of [SQL Developer](http://www.oracle.com/technetwork/developer-tools/sql-developer/) both as a deployment location for testing and as the source for required library files.