Ready for Preview!

Added doc for favorites example
Changed cfu / update center URLs to gitcdn

Author: bjeffrie

sqldeveloper/extension/README.md

@@ -4,6 +4,13 @@ You can add new folders and nodes to navigators, new actions on objects (*or set
 
 Depending on requirements, this can be done in either XML or java and deployed by simply copying an XML file to the appropriate directory, or creating an extension jar -- or *check for updates* bundle for XML and/or java.
 
+### New
+
+* [XML Based Favorites Example](xml/favorites)
+
+
+* [Example Update Center](https://github.com/bjeffrie/sqldev-update-center) (external) with pre-built cfu bundles for these examples. 
+
 ### Contents
 
 * [Set Up / Tutorial](./setup.md) - A step by step guide to building your first extension and check for updates bundle.

sqldeveloper/extension/build.properties

@@ -16,5 +16,5 @@ extension.owner.url=https://github.com/oracle/oracle-db-examples/tree/master/sql
 #
 # Base location of the CFU site. 
 # This is where the produced updates.xml will say the cfu bundle files are.
-update.url=https://cdn.rawgit.com/bjeffrie/sqldev-update-center/master
+update.url=https://gitcdn.xyz/repo/bjeffrie/sqldev-update-center/master
 

sqldeveloper/extension/xml/README.md

@@ -17,10 +17,15 @@ This allows combining a number of xml definitions together as well as the abilit
 
 * [individual](individual)  
 Examples for ACTION, EDITOR, NAVIGATOR
-  
+
+
 * [packaged](packaged)  
 XML Examples packaged as an extension.jar  
 
-  
+
+* [Simple Favorites](favorites)  
+XML-Based favorites folders (packaged as an extension.jar)
+
+
 * [schema](schema)  
 XML schema for the three extension types. Note that the dialogs(ACTION) schema is heavily annotated and has been run through [xsddoc](http://xframe.sourceforge.net/xsddoc/index.html) to produce javadoc-like documentation [here](http://xmlns.oracle.com/sqldeveloper/3_1/dialogs).     

sqldeveloper/extension/xml/favorites/README.md

@@ -0,0 +1,53 @@
+# [SQL Developer](http://www.oracle.com/technetwork/developer-tools/sql-developer/) Examples
+## Simple Favorites
+XML-Based favorites folders (packaged as an extension.jar)
+
+This extension ands the ability to manage and use a simple favorites table in the connection schema (or available via public synonym from another). 
+
+### First, The Ugly
+
+* Because of the simplistic design, creating the table and adding favorites will require issuing a commit on the current connection. All actions state this explicitly and indicate if there are transactions pending.
+
+
+* In order for the objects in a favorites folder to behave as the real thing, a separate query must be used for each object type. This example includes all 50+ of the types shown in an Oracle connection navigator. I encourage you to remove the types you do not care about from favorites_nav.xml & favorites_actions.xml if the performance is an issue.
+
+
+* Since the objects in a favorites folder act as the real object, you can delete a favorites folder via context menu from the tree but will need to use SQL or the data viewer on the raw SQX$FAVORITES table to remove favorites from a folder.
+
+
+* Since the focus is on the object you are adding to favorites, the favorites tree will not update automatically. You will need to manually update the favorites / folder node to see the newly added object references. 
+
+### Now The Good
+
+* It's pretty darn useful even with the limitations!
+
+* After installing the extension or using one of the [manual methods](../../xml) to register the raw XML files, use the context menu on an open connection to create the favorites table.  
+![Create Favorites Table image](images/CreateFavoritesTable.png) ![Favorites Table Created image](images/FavoritesTableCreated.png)
+
+
+* The context menu on Favorites allows you to add folders or drop the favorites table.  
+![Add Favorites Folder image](images/AddFavoritesFolder.png) ![After Add Favorites Folder image](images/AfterAddFavoritesFolder.png)
+
+
+* The context menu on any object declared in favorites_actions.xml will have an add to favorites option. Choosing a favorites folder to put it in is required.  
+![Add To Favorites image](images/AddToFavorites.png) ![Add To Favorites Succeeded image](images/AddToFavoritesSucceeded.png) ![After Add To Favorites image](images/AfterAddToFavorites.png)
+
+
+* Note that since favorites is declared for connType="Oracle", it will "follow you"  as you navigate to / add to favorites from the Other Users tree nodes.  
+![After Add To Favorites image 2](images/AfterAddToFavorites2.png) 
+
+### And Lastly
+Given the interest this has generated, I am looking at doing a java working sets style version to overcome the ugly aspects of this one. Perhaps as a hands on lab or OBE kind of series. 
+
+
+I welcome feedback on this example and ideas for desirable features of a potential working sets version at [my fork](https://github.com/bjeffrie/oracle-db-examples) of the examples repository.
+
+
+#### The changes I see needing are:
+* Separate navigator / connection / repository for working sets. (I.e., similar to migrations or unit testing so the current connection is not impacted.)
+* Much more efficient declaration and handling of favorites folder contents and actions.
+* Being able to manipulate favorites references from the tree (delete specifically but maybe also drag / drop operations)
+* Updating the favorites hierarchy when adding new references.
+* Favorites folder nesting? Unlimited or?
+
+ 

sqldeveloper/extension/xml/favorites/images/AddFavoritesFolder.png

@@ -1 +1 @@
-favorites_folder_label=Favorites (sketchy - for Peter Nosko)
+favorites_folder_label=Favorites

sqldeveloper/extension/xml/favorites/images/AddToFavorites.png

@@ -42,9 +42,9 @@ limitations under the License.
     "OBJECT_NAME" VARCHAR2(128),
     CONSTRAINT OBJ_NEEDS_FAV_FOLDER CHECK ((FAV_FOLDER IS NULL AND OBJECT_TYPE='FAV_FOLDER') OR (FAV_FOLDER IS NOT NULL AND FAV_FOLDER!=''))  
    ) ;
---  INSERT INTO SDX$FAVORITES (FAV_FOLDER, OBJECT_OWNER, OBJECT_TYPE, OBJECT_NAME)
---                 VALUES ('', '#OBJECT_OWNER#', 'FAV_FOLDER', 'Default')
---  ;
+  INSERT INTO SDX$FAVORITES (FAV_FOLDER, OBJECT_OWNER, OBJECT_TYPE, OBJECT_NAME)
+                 VALUES ('', '#OBJECT_OWNER#', 'FAV_FOLDER', 'Default')
+  ;
   COMMIT
   ;
         ]]>
@@ -99,8 +99,6 @@ COMMIT
 		<sql type="SCRIPT"><![CDATA[
   INSERT INTO SDX$FAVORITES (OBJECT_OWNER, OBJECT_TYPE, OBJECT_NAME)
                  VALUES (sys_context('USERENV','AUTHENTICATED_IDENTITY'), 'FAV_FOLDER', '#0#')
-                 WHERE NOT EXISTS (SELECT OBJECT_NAME FROM SDX$FAVORITES WHERE OBJECT_NAME='#0#'
-                                      AND OBJECT_TYPE='FAV_FOLDER')
   ;
   COMMIT
   ;