Changes between Version 2 and Version 3 of Future/TileServiceEnhancements

Timestamp:

06/26/13 02:29:07 (11 years ago)

Author:

jng

Comment:

--

Future/TileServiceEnhancements

@@ -40 +40 @@
 ResourceHeader. 
 
+== API additions to MgTileService ==
+
+To support HTTP cacheability we need to be able to do the following via the MgTileService:
+
+ a) Get timestamp information about a generated tile (to be able to apply expiry dates)
+
+ b) "Peek" at the timestamp for a tile that may or may not be generated (to be able to compare against dates from if-modified-since headers)
+
+An API addition to MgTileService like the one below should be able to support the above scenarios.
+
+{{{
+
+class MG_MAPGUIDE_API MgTileService : MgService
+{
+PUBLISHED_API:
+   /// Returns the timestamp of when the tile for the specified map/group/row/col was generated. Returns NULL if no such tile exists
+   ///
+   MgDateTime* GetTileCreationDate(MgMap* map, CREFSTRING baseMapLayerGroupName, INT32 tileColumn, INT32 tileRow);
+
+   /// Returns the timestamp of when the tile for the specified map/group/row/col/scale was generated. Returns NULL if no such tile exists
+   ///
+   MgDateTime* GetTileCreationDate(MgResourceIdentifier* mapDefinition, CREFSTRING baseMapLayerGroupName, INT32 tileColumn, INT32 tileRow, INT32 scaleIndex);
+
+   /// Returns the specified base map tile for the given map.  If a cached tile
+   /// image exists it will return it, otherwise the tile is rendered and added
+   /// to the cache.
+   MgTile* GetTile(MgMap* map, CREFSTRING baseMapLayerGroupName, INT32 tileColumn, INT32 tileRow);
+
+   /// Returns the specified base map tile for the given map.  If a cached tile
+   /// image exists it will return it, otherwise the tile is rendered and added
+   /// to the cache.
+   ///
+   MgTile* GetTile(MgResourceIdentifier* mapDefinition, CREFSTRING baseMapLayerGroupName, INT32 tileColumn, INT32 tileRow, INT32 scaleIndex);
+};
+}}}
+
+MgTile is defined like so.
+
+{{{
+class MG_MAPGUIDE_API MgTile : public MgSerializable
+{
+PUBLISHED_API:
+    /// Returns the tile image
+    ///
+    MgByteReader* GetImage();
+
+    /// Returns the date this tile was created
+    ///
+    MgDateTime* GetCreationDate();
+};
+
+}}}
+
+== MapAgent modifications ==
+
+TBD
+
 = WMS =
 
@@ -56 +113 @@
 
 
-
-