Changes between Version 7 and Version 8 of MapGuideRfc25

Timestamp:

08/09/07 13:49:40 (17 years ago)

Author:

jasonchen

Comment:

--

MapGuideRfc25

@@ -35 +35 @@
 == Proposed Solution ==
 
-An additioanl OEM component has been added to the source -- jsoncpp. Jsoncpp is a C++ implementation of the JSON specification (http://sourceforge.net/projects/jsoncpp/).
+An additioanl OEM component has been added to the source -- jsoncpp. Jsoncpp is a C++ implementation of the JSON specification ([http://sourceforge.net/projects/jsoncpp/]).
+
+----
 
 Two additional classes have been added to assist the JSON implementation in !MapGuide:
 
-1) The !MgJsonDoc Class
-
+1) The !MgJsonDoc Class [[BR]]
 - !MgJsonDoc is a wrapper over the jsoncpp implementation. !MgJsonDoc provides many easy-to-use interfaces, such as Begin* and End*, for creating JSON documents from an XML perspective. For example, to create as JSON document for the corresponding XML content---<Node>Text</Node>---, one would call !BeginObject("Node"), !SetValue("Text"), and !EndObject() subsequently.
 
-2) The !MgXmlJsonConvert Class
+2) The !MgXmlJsonConvert Class [[BR]]
+- !MgXmlJsonConvert converts an XML document into a JSON formatted document.
 
-- !MgXmlJsonConvert converts an XML document into a JSON formatted document.
+----
 
 The following Web-tier to Server APIs are affected:
@@ -51 +53 @@
 Coordinate System
 
-# !EnumerateCategories (1)
-
-# !EnumerateCoordinateSystems (1)
+# !EnumerateCategories (1) [[BR]]
+# !EnumerateCoordinateSystems (1) [[BR]]
 
 Resource
 
-# !EnumerateResourceReferences (3)
-
-# !EnumerateResources (3)
-
-# !GetResourceContent (3)
-
-# !GetResourceHeader (3)
-
-# !EnumerateResourceData (3)
-
-# !GetResourceData (3)
-
-# !EnumerateUnmanagedData (3)
+# !EnumerateResourceReferences (3) [[BR]]
+# !EnumerateResources (3) [[BR]]
+# !GetResourceContent (3) [[BR]]
+# !GetResourceHeader (3) [[BR]]
+# !EnumerateResourceData (3) [[BR]]
+# !GetResourceData (3) [[BR]]
+# !EnumerateUnmanagedData (3) [[BR]]
 
 Feature
 
-# !GetFeatureProviders (3)
-
-# !GetCapabilities (3)
-
-# !GetConnectPropertyValues (1)
-
-# !DescribeSchema (4)
-
-# !SelectFeatures (2)
-
-# !SelectAggregates (1)
-
-# !GetSpatialContexts (1)
-
-# !GetLongTransactions (1)
-
-# !EnumerateDataStores (3)
-
-# !GetSchemaMapping (3)
-
-# !GetSchemas (1)
-
-# !GetClasses (1)
-
-# !GetClassDefinition (2)
-
-# !GetIdentityProperties (1)
-
-# !ExecuteSqlQuery (1)
-
-# !GetFdoCacheInfo (4)
+# !GetFeatureProviders (3) [[BR]]
+# !GetCapabilities (3) [[BR]]
+# !GetConnectPropertyValues (1) [[BR]]
+# !DescribeSchema (4) [[BR]]
+# !SelectFeatures (2) [[BR]]
+# !SelectAggregates (1) [[BR]]
+# !GetSpatialContexts (1) [[BR]]
+# !GetLongTransactions (1) [[BR]]
+# !EnumerateDataStores (3) [[BR]]
+# !GetSchemaMapping (3) [[BR]]
+# !GetSchemas (1) [[BR]]
+# !GetClasses (1) [[BR]]
+# !GetClassDefinition (2) [[BR]]
+# !GetIdentityProperties (1) [[BR]]
+# !ExecuteSqlQuery (1) [[BR]]
+# !GetFdoCacheInfo (4) [[BR]]
 
 Rendering
 
-# !GetVisibleMapExtent (1)
+# !GetVisibleMapExtent (1) [[BR]]
 
 where the appended labeling scheme indicates the different implementation considerations:
-
-(1) Web-tier changes -- every !ToXml function is matched with an !ToJson function implementation that creates a JSON document in place,
-
-(2) Web-tier changes -- utilizes the !MgXmlJsonConvert class to convert XML documents to JSON documents.
-
-(3) Server changes -- an extra parameter "CREFSTRING format" has been added to the respective API call; the !MgXmlJsonConvert class is used if format equals to the JSON MIME type.
-
+(1) Web-tier changes -- every !ToXml function is matched with an !ToJson function implementation that creates a JSON document in place, [[BR]]
+(2) Web-tier changes -- utilizes the !MgXmlJsonConvert class to convert XML documents to JSON documents. [[BR]]
+(3) Server changes -- an extra parameter "CREFSTRING format" has been added to the respective API call; the !MgXmlJsonConvert class is used if format equals to the JSON MIME type. [[BR]]
 (4) Server changes -- an extra API has been added matching the respective API call (e.g. !DescribeSchemaAsXml has !DescribeSchemaAsJson as the JSON version, and !GetFDOCacheInfo has !GetFDOCacheInfoAsJson as its JSON specific implementation); this is because the original APIs return "STRING" and could not be efficiently adapted by the conversion process within the !MgXmlJsonConvert class implementation; and for the affected APIs, the !MgByteReader* is returned instead.
-
 
 == Implications ==