Changes between Version 5 and Version 6 of MapGuideRfc25

Timestamp:

Aug 9, 2007, 1:40:03 PM (17 years ago)

Author:

jasonchen

Comment:

--

MapGuideRfc25

@@ -39 +39 @@
 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
-- 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.
+Two additional classes have been added to assist the JSON implementation in !MapGuide:
+1) The !MgJsonDoc Class
+- !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
-- 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:
@@ -50 +50 @@
 Coordinate System
 
-# EnumerateCategories (1)
-# EnumerateCoordinateSystems (1)
-
+# !EnumerateCategories (1)
+# !EnumerateCoordinateSystems (1)
 
 Resource
 
-# EnumerateResourceReferences (3)
-# EnumerateResources (3)
-# GetResourceContent (3)
-# GetResourceHeader (3)
-# EnumerateResourceData (3)
-# GetResourceData (3)
-# EnumerateUnmanagedData (3)
+# !EnumerateResourceReferences (3)
+# !EnumerateResources (3)
+# !GetResourceContent (3)
+# !GetResourceHeader (3)
+# !EnumerateResourceData (3)
+# !GetResourceData (3)
+# !EnumerateUnmanagedData (3)
 
 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)
+# !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)
 
 Rendering
 
-# GetVisibleMapExtent (1)
+# !GetVisibleMapExtent (1)
 
 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.
-(4) Server changes -- an extra API has been added matching the respective API call (e.g. DescribeSchemaAsXml has DescribeSchemaAsJson as its counter part, 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.
+(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.
+(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 ==