Changes between Initial Version and Version 1 of MapGuideRfc131

Feb 7, 2013, 3:53:56 AM (9 years ago)



  • MapGuideRfc131

    v1 v1  
     2= !MapGuide RFC 131 - Deprecate eMap Mapping Service APIs =
     4This page contains a change request (RFC) for the !MapGuide Open Source project.
     5More !MapGuide RFCs can be found on the [wiki:MapGuideRfcs RFCs] page.
     7== Status ==
     9||RFC Template Version||(1.0)||
     10||Submission Date||7 Feb 2013||
     11||Last Modified||7 Feb 2013||
     12||Author||Jackie Ng||
     13||RFC Status||draft||
     14||Implementation Status||draft||
     15||Proposed Milestone||2.5||
     16||Assigned PSC guide(s)||(when determined)||
     17||'''Voting History'''||(vote date)||
     22||no vote||||
     24== Overview ==
     26This RFC proposes to deprecate some public Mapping Service APIs related to eMap DWF functionality.
     28== Motivation ==
     30MapGuide uses a somewhat ancient version of the DWF Toolkit (7.1). While we are still using this version of the DWF Toolkit, we lack the ability to support DWFx files, 64-bit Linux and possibly fix many DWF-related issues in MapGuide. While putting in a newer DWF Toolkit will solve these problems, it will break our eMap-related Mapping Service APIs as this support has been removed in versions of the DWF Toolkit since 7.1
     32As such, we should give application developers some heads-up that eMap support will be going away in the future before going ahead with such a move.
     34While such notice of DWF Viewer/eMap deprecation has been informal (evidenced by the various discussions on the matter on the mailing list), it has never been formalized in the API documentation. This RFC addresses that.
     36== Proposed Solution ==
     38Mark the following public APIs as deprecated:
     40 * MgMappingService::GenerateMap
     41 * MgMappingService::GenerateMapUpdate
     43Due to work on [wiki:MapGuideRfc129 MapGuide RFC 129], doxygen {{{\deprecated}}} markers applied to these methods will transfer down to .net and Java and trigger necessary .net/Java compiler warnings.
     45If/when we do upgrade our internal copy of the DWF Toolkit, these APIs will have to be removed as they will no longer function.
     47== Implications ==
     49This RFC is just an official warning to application developers that eMap support is ending and will be removed in a future release of MapGuide. No actual APIs are removed.
     51== Test Plan ==
     55== Funding / Resources ==