Provide some documentation as to what each of the 4 Connection classes are for.
authorAndy Allan <gravitystorm@gmail.com>
Tue, 12 Oct 2010 15:25:05 +0000 (15:25 +0000)
committerAndy Allan <gravitystorm@gmail.com>
Tue, 12 Oct 2010 15:25:05 +0000 (15:25 +0000)
net/systemeD/halcyon/connection/AMFConnection.as
net/systemeD/halcyon/connection/OSMConnection.as
net/systemeD/halcyon/connection/XMLBaseConnection.as
net/systemeD/halcyon/connection/XMLConnection.as

index c1d25b51a4611f2f167e586c4f45ce7dea128058..6ea9bcbf7de1d560d93f2feddf9a3e213a92f1cc 100755 (executable)
@@ -7,6 +7,12 @@ package net.systemeD.halcyon.connection {
        import flash.system.Security;
        import flash.net.*;
 
+    /**
+    * AMFConnection provides read-write access to an AMF server. The read/write
+    * methods bear little resemblance to the standard OSM server XML API methods,
+    * but are similar (the same?) as that used by Potlatch 1.
+    * For a lightweight AMF server see resources/tinyamf.cgi
+    */
        public class AMFConnection extends Connection {
 
                public var readConnection:NetConnection;
index 252c4bd382699ee69a020e6437780f92eea27433..c38bdc1bddcbdfadb9d8b54d3af586751c56e8b0 100644 (file)
@@ -8,7 +8,11 @@ package net.systemeD.halcyon.connection {
        import net.systemeD.halcyon.ExtendedURLLoader;
        import net.systemeD.halcyon.Globals;
 
-       // Read-only connection from local files (for Halcyon)
+    /**
+    * Read-only connection from local OSM-XML format (.osm) files.
+    * This is used by Halcyon; Potlatch 2 needs a full server connection
+    * of the type provided by XMLConnection
+    */
 
        // For a limited set of arbitrary files, invoke it like this:
        //              fo.addVariable("api","http://127.0.0.1/~richard/potlatch2");            // base URL
index 6f67b5f7ab972c99a39bb96cdcf4affccccb7dd2..dc5ae5befe7a2425cad728b7cba3df7b298a99c6 100644 (file)
@@ -8,6 +8,11 @@ package net.systemeD.halcyon.connection {
 
        import net.systemeD.halcyon.Globals;
 
+    /**
+    * XMLBaseConnection is the common code between connecting to an OSM server
+    * (i.e. XMLConnection) and connecting to a standalone .osm file (i.e. OSMConnection)
+    * and so mainly concerns itself with /map -call-ish related matters
+    */
        public class XMLBaseConnection extends Connection {
 
                public function XMLBaseConnection() {
index 0c521c53a775b72b243d9cd98191da5aff94ab99..4044ad51b870fda578b530b4de42c6f215c1b8dd 100644 (file)
@@ -8,6 +8,10 @@ package net.systemeD.halcyon.connection {
 
        import net.systemeD.halcyon.MapEvent;
 
+    /**
+    * XMLConnection provides all the methods required to connect to a live
+    * OSM server. See OSMConnection for connecting to a read-only .osm file
+    */
        public class XMLConnection extends XMLBaseConnection {
 
         //public var readConnection:NetConnection;