Changes between Version 2 and Version 3 of MapGuideRfc9

Timestamp:

02/10/07 22:08:22 (18 years ago)

Author:

robertbray

Comment:

--

MapGuideRfc9

@@ -23 +23 @@
 == Overview ==
 
-This section brefly describes the problem set, and the proposed solution in general terms.  It should be deliberately short, a couple of sentences or so.
+In writing sample applications for !MapGuide I have noticed a few reoccurring patterns in the application code. In particular when querying or updating feature data typically you have to get the feature source information from the !MgLayer and then turn around and pass all of that information on to Feature Service operations. This RFC aims to clean up this particular reoccurring pattern. 
 
 == Motivation ==
 
-This is the most important part of the RFC.  It describes the problem domain in detail.  Focusing on this will allow reviewers to fully understand why the proposed change is being made, and potentially suggest different/better ways of accomplishing the desired results.  The more time we spend on understanding the problem, the better our solution will be.
+Here is a simplified pattern that occurs frequently in !MapGuide applications:
+
+{{{
+$resourceService = $site->CreateService(MgServiceType::ResourceService);
+$featureService = $site->CreateService(MgServiceType::FeatureService);
+
+$map = new MgMap();
+$map->Open($resourceService, $_POST['MAPNAME']);
+$layer = $map->GetLayers()->GetItem($_POST['LAYERNAME']);
+
+$resId = new MgResourceIdentifier($layer->GetFeatureSourceId());
+$featureClass = $layer->GetFeatureClassName();
+
+$featureService = $this->site->CreateService(MgServiceType::FeatureService);
+
+$reader = $featureService->SelectFeatures($resId, $featureClass, null);
+}}}
+
+With the API enhancements recommended by this RFC, a more convenient and compact form might be written like this:
+
+{{{
+
+$map = new MgMap($site);
+$map->Open($_POST['MAPNAME']);
+$layer = $map->GetLayers()->GetItem($_POST['LAYERNAME']);
+
+$reader = $layer->SelectFeatures(null);
+}}}
+
 
 == Proposed Solution ==