Changes between Version 2 and Version 3 of MapGuideRfc182


Ignore:
Timestamp:
Aug 6, 2020, 5:03:22 AM (4 years ago)
Author:
jng
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • MapGuideRfc182

    v2 v3  
    99||RFC Template Version||(1.0)||
    1010||Submission Date||4 Aug 2020||
    11 ||Last Modified||||
     11||Last Modified||6 Aug 2020||
    1212||Author||Jackie Ng||
    1313||RFC Status||draft||
    14 ||Implementation Status||||
     14||Implementation Status||Pending||
    1515||Proposed Milestone||4.0||
    1616||Assigned PSC guide(s)||(when determined)||
     
    2424== Overview ==
    2525
    26 This RFC proposes to add a new `MgInitializeLibrary` API for properly initializing the MapGuide API when used in a class library context.
     26This RFC proposes to add a new `MgInitializeLibrary` and `MgUnintializeLibrary` APIs for properly initializing and tearing down the MapGuide API respectively when used in a class library context.
    2727
    2828== Motivation ==
     
    3434 * `PlatformBase` (exposed to .net via the `OSGeo.MapGuide.PlatformBase.dll` assembly)
    3535
    36 An example of this usage is FDO Toolbox, where this subset of the MapGuide API is used to provide coordinate system lookup and transfomration services through the `MgCoordinateSystem` family of APIs.
     36An example of this usage is FDO Toolbox, where this subset of the MapGuide API is used to provide coordinate system lookup and transformation services through the `MgCoordinateSystem` family of APIs.
    3737
    3838However, usage of the MapGuide API in this context reveals a major teething issue around exceptions. Namely any exceptions thrown in this context will not have localizable error messages because the MapGuide API has not initialized with an appropriate string bundle. As a result, exceptions thrown from the MapGuide API in this particular context will not contain any useful error messages.
     
    6464 * `static void OSGeo.MapGuide.FoundationApi.MgUnitializeLibrary()`
    6565
     66This is already implemented in the [https://trac.osgeo.org/mapguide/browser/sandbox/jng/library_init library_init sandbox]. Upon adoption of this RFC, it will be merged into trunk.
     67
    6668== Implications ==
    6769