Ignore src/adaptors dir in build process.

.gitignore

@@ -1,3 +1,5 @@
 .DS_Store
 AIRAliases.js
 AIRIntrospector.js
+/lib/
+.c9settings.xml

README.md

@@ -13,14 +13,16 @@ A very light clientside JSON document store.
 	adaptor ......... device browsers supported ............ desktop browsers supported ....
 	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 	webkitsqlite .... iPhone OS, Android 2.0, Palm webOS ... Safari, Chrome ................
-	gearssqlite ..... Android 1.5, 1.7 ..................... Whenever gears is present .....
+	gearssqlite ..... Android 1.5, 1.6, BlackBerry 5.0+..... Whenever gears is present .....
 	domStorage ...... iPhone OS, Android 2.0, Palm webOS ... IE, Firefox, Safari, Chrome ...
 	cookie .......... Presumably all of em ................. Presumably all of em ..........
     userdata ........ IE ................................... IE ............................
     air-async ....... Adobe Air ............................ Adobe Air .....................
     air ............. Adobe Air ............................ Adobe Air .....................
-    blackberry ...... BlackBerry 4.7 and higher ............ N/A ...........................
+    blackberry ...... BlackBerry 4.7 and higher w/ PhoneGap. N/A ...........................
     couchdb ......... All .................................. All ........................... 
+    server .......... All .................................. All ...........................
+    auto ............ All .................................. All ...........................
 
 INSTALL
 ===
@@ -35,11 +37,25 @@ Lawnchair does not assume how you want to use it. At a minimum will be required
 - One of the adaptor js files can found in `./src/adaptors`.
 - Adobe AIR adaptor example xml config files can be found in `./util`.
 - CouchDB adaptor requires the http://localhost:5984/_utils/script/couch.js lib.
+- Server adaptor requires a server-side API; see top of ServerAdaptor.js for more details.
+- Auto adaptor (actual filename is BeachfrontAdaptor) tries to detect and load other adaptor.
 
-Its probably a good idea to concat/minify the js you require. Its a common request to 
+Its probably a good idea to concat/minify the js you require (see below). Its a common request to 
 provide a single file that does some sort of feature detection which, in theory, is nice 
 but in practice its far more efficient to only load what you need (especially on mobile).
 
+BUILDING
+===
+Run ./build from your terminal and provide the list of adapters you want to include in your final
+Lawnchair build. Does a bit of fuzzy (suffix) matching for you. Examples:
+
+    ./build air blackberry
+    ./build webkit dom
+
+The first will build a Lawnchair with both AIR adapters plus the BlackBerry one. The second will
+build a Lawnchair with WebKitSQLite support as well as DOMStorage support. 
+
+
 TESTING
 ===
 

build

@@ -0,0 +1,41 @@
+#!/bin/bash
+# Help
+
+help() {
+    echo "------ usage --------------------------------------------------";
+    echo "| build [adapter1 [adapter 2 [...]]]                          |";
+    echo "------ description --------------------------------------------";
+    echo "| Builds lawnchair with the specified adapters. Does a        |";
+    echo "| wildcard suffix search based on the adapter arguments you   |";
+    echo "| provide. Builds to lc-prod.js in current directory.         |";
+    echo "|----- list of adapters --------------------------------------|";
+    echo "| AIRSqlite                                                   |";
+    echo "| AIRSqliteAsync                                              |";
+    echo "| BlackBerry                                                  |";
+    echo "| Cookie                                                      |";
+    echo "| Couch                                                       |";
+    echo "| DOMStorage                                                  |";
+    echo "| GearsSQLite                                                 |";
+    echo "| Server                                                      |";
+    echo "| UserData                                                    |";
+    echo "| WebKitSqlite                                                |";
+    echo "---------------------------------------------------------------";
+}
+if [ $# -lt 1 ]
+then
+    help;
+    echo "ERROR: You need to provide at least one adapter as argument.";
+else
+    echo "Including base Lawnchair JS...";
+    adapterSrc="src/Lawnchair.js src/adaptors/LawnchairAdaptorHelpers.js";
+    for arg in "$@"
+    do
+        for file in $(find src/adaptors -type f -iname $arg*)
+        do
+            echo "Adding adapter '$file' to lc_prod.js...";
+            adapterSrc="$adapterSrc $file";
+        done
+    done
+    cat $adapterSrc > lc_prod.js;
+    echo "... done.";
+fi 

spec/public/adaptors/air-async.html

@@ -12,7 +12,8 @@
 	<script src="../../../src/Lawnchair.js" type="text/javascript" charset="utf-8"></script>
 
 	<script type="text/javascript" charset="utf-8">
-		store = new Lawnchair({table:'test', adaptor:'air-async'});
+	    adapter='air-async';
+		store = new Lawnchair({adaptor:adapter,table:'test'},function(){});
 	</script>
 	<!--
 		because string callbacks aren't supported, we need to rewrite the tests

spec/public/adaptors/air.html

@@ -12,7 +12,8 @@
 	<script src="../../../src/Lawnchair.js" type="text/javascript" charset="utf-8"></script>
 
 	<script type="text/javascript" charset="utf-8">
-		store = new Lawnchair({table:'test', adaptor:'air'});
+	    adapter='air';
+		store = new Lawnchair({adaptor:adapter,table:'test'},function(){});
 	</script>
 	<!--
 		because string callbacks aren't supported, we need to rewrite the tests

spec/public/adaptors/blackberrystorage.html

@@ -12,7 +12,8 @@
 	<script src="../../../src/Lawnchair.js" type="text/javascript" charset="utf-8"></script>
 
 	<script type="text/javascript" charset="utf-8">
-		store = new Lawnchair({adaptor:'blackberry'});
+	    adapter='blackberry';
+		store = new Lawnchair({adaptor:adapter},function(){});
 	</script>
 	<script src="../lawnchair-spec.js" type="text/javascript" charset="utf-8"></script>
 </head>

spec/public/adaptors/cookie.html

@@ -11,7 +11,8 @@
 	<script src="../../../src/Lawnchair.js" type="text/javascript" charset="utf-8"></script>
 
 	<script type="text/javascript" charset="utf-8">
-		store = new Lawnchair({adaptor:'cookie'});
+	    adapter='cookie';
+		store = new Lawnchair({adaptor:adapter},function(){});
 	</script>
 	<script src="../lawnchair-spec.js" type="text/javascript" charset="utf-8"></script>
 </head>

spec/public/adaptors/couch.html

@@ -10,7 +10,8 @@
 	<script src="../../../src/adaptors/CouchAdaptor.js" type="text/javascript" charset="utf-8"></script>
 	<script src="../../../src/Lawnchair.js" type="text/javascript" charset="utf-8"></script>
 	<script type="text/javascript" charset="utf-8">
-		store = new Lawnchair({adaptor:'couch', name:'test-store'});
+	    adapter='couch';
+		store = new Lawnchair({adaptor:adapter,name:'test-store'},function(){});
 	</script>
 	<script src="../lawnchair-spec.js" type="text/javascript" charset="utf-8"></script>
 </head>

spec/public/adaptors/dom-session.html

@@ -10,7 +10,8 @@
 	<script src="../../../src/Lawnchair.js" type="text/javascript" charset="utf-8"></script>
 
 	<script type="text/javascript" charset="utf-8">
-		store = new Lawnchair({storage:sessionStorage, adaptor:'dom'});
+	    adapter='dom';
+		store = new Lawnchair({adaptor:adapter, storage:sessionStorage},function(){});
 	</script>
 	<script src="../lawnchair-spec.js" type="text/javascript" charset="utf-8"></script>
 

spec/public/adaptors/dom.html

@@ -11,7 +11,8 @@
 	<script src="../../../src/Lawnchair.js" type="text/javascript" charset="utf-8"></script>
 
 	<script type="text/javascript" charset="utf-8">
-		store = new Lawnchair({adaptor:'dom'});
+	    adapter = 'dom';
+		store = new Lawnchair({adaptor:adapter},function(){});
 	</script>
 	<script src="../lawnchair-spec.js" type="text/javascript" charset="utf-8"></script>
 </head>

spec/public/adaptors/gears.html

@@ -10,7 +10,8 @@
 	<script src="../../../src/adaptors/GearsSQLiteAdaptor.js" type="text/javascript" charset="utf-8"></script>
 	<script src="../../../src/Lawnchair.js" type="text/javascript" charset="utf-8"></script>
 	<script type="text/javascript" charset="utf-8">
-		store = new Lawnchair({table:'test', adaptor:'gears'});
+	    adapter = 'gears';
+		store = new Lawnchair({table:'test', adaptor:adapter},function(){});
 	</script>
 	<script src="../lawnchair-spec.js" type="text/javascript" charset="utf-8"></script>
 </head>

spec/public/adaptors/server-examples/session.jsp

@@ -0,0 +1,53 @@
+<%@ page import="java.io.*, java.util.*" %><%
+    // TODO: support client-specified IDs for differentiating between stores.
+	if (request.getParameter("nuke") != null || request.getParameter("all") != null) {
+        // nuke() and all()
+        boolean isNuke = (request.getParameter("nuke") != null);
+        boolean isAll = (request.getParameter("all") != null);
+		Enumeration attributeNames=(request.getSession(false)).getAttributeNames();
+        StringBuffer all = new StringBuffer("[");
+        while(attributeNames.hasMoreElements()){
+            String attributeName=(String) attributeNames.nextElement();
+            if (isNuke) {
+                session.removeAttribute(attributeName);
+            } else {
+                all.append((String)session.getAttribute(attributeName));
+                all.append(",");
+            }
+        }
+        if (isAll) {
+            if (all.length() > 1) all.deleteCharAt(all.length()-1); // trim trailing comma
+            all.append("]");
+            out.print(all.toString());
+        } else {
+            out.print("{}");
+        }
+	} else if (request.getParameter("get") != null) {
+		// get()
+        String key = request.getParameter("get");
+        StringBuffer json = new StringBuffer();
+        json.append((String)session.getAttribute(key));
+        out.print(json.toString());
+    } else if (request.getParameter("remove") != null) {
+        // remove()
+        String key = request.getParameter("remove");
+        StringBuffer json = new StringBuffer();
+        json.append((String)session.getAttribute(key));
+        session.removeAttribute(key);
+        out.print(json.toString());
+	} else if (request.getParameter("save") != null) {
+        // save()
+        String key = request.getParameter("save");
+		// Grab POST data
+		BufferedReader FormBuffer = request.getReader();
+		StringBuffer BodyContent = new StringBuffer();
+		String NextLine = FormBuffer.readLine();
+		while (NextLine != null) {
+			BodyContent.append(NextLine);
+			NextLine = FormBuffer.readLine();
+		}
+		// Save to session attribute
+		session.setAttribute(key, BodyContent.toString());
+		out.print(BodyContent.toString());
+    }
+%>

spec/public/adaptors/server.html

@@ -0,0 +1,25 @@
+<!DOCTYPE html>
+<html>
+<head>
+	<title>Lawnchair Server</title>
+	<link rel="stylesheet" href="../lib/qunit.css" type="text/css" media="screen" title="no title" charset="utf-8">
+	<script src="../lib/qunit.js" type="text/javascript" charset="utf-8"></script>
+    <script src="../lib/json2.js" type="text/javascript" charset="utf-8"></script>
+
+	<script src="../../../src/adaptors/LawnchairAdaptorHelpers.js" type="text/javascript" charset="utf-8"></script>
+	<script src="../../../src/adaptors/ServerAdaptor.js" type="text/javascript" charset="utf-8"></script>
+	<script src="../../../src/Lawnchair.js" type="text/javascript" charset="utf-8"></script>
+
+	<script type="text/javascript" charset="utf-8">
+        alert('You must deploy this on a Tomcat instance to get it to work! Relies on a server-side component!');
+		store = new Lawnchair({adaptor:'server', endpoint:'server-examples/session.jsp'});
+	</script>
+	<script src="../lawnchair-spec.js" type="text/javascript" charset="utf-8"></script>
+</head>
+<body>
+	<h1 id="qunit-header">Lawnchair, Server Adapter Specs</h1>
+    <h2 id="qunit-banner"></h2>
+    <h2 id="qunit-userAgent"></h2>
+    <ol id="qunit-tests"></ol>
+</body>
+</html>

spec/public/adaptors/userdata.html

@@ -11,7 +11,8 @@
 	<script src="../../../src/Lawnchair.js" type="text/javascript" charset="utf-8"></script>
 
 	<script type="text/javascript" charset="utf-8">
-		store = new Lawnchair({adaptor:'userdata'});
+	    adapter = 'userdata';
+		store = new Lawnchair({adaptor:adapter},function() {});
 	</script>
 	<script src="../lawnchair-spec.js" type="text/javascript" charset="utf-8"></script>
 </head>

spec/public/adaptors/webkit.html

@@ -11,7 +11,8 @@
 	<script src="../../../src/Lawnchair.js" type="text/javascript" charset="utf-8"></script>
 
 	<script type="text/javascript" charset="utf-8">
-		store = new Lawnchair({table:'test', adaptor:'webkit'});
+	    adapter = 'webkit';
+		store = new Lawnchair({table:'test', adaptor:adapter},function() {});
 	</script>
 	<script src="../lawnchair-spec.js" type="text/javascript" charset="utf-8"></script>
 

spec/public/index.html

@@ -14,6 +14,7 @@ <h1>Lawnchair! The spec.</h1>
     <li><a href="adaptors/air-async.html">adobe air async</a></li>
     <li><a href="adaptors/blackberrystorage.html">blackberry storage</a></li>
     <li><a href="adaptors/couch.html">couchdb</a></li>
+    <li><a href="adaptors/server.html">server</a></li>
 </ul>