Changes between Version 12 and Version 13 of MapGuideRfc78

Timestamp:

07/09/09 23:24:11 (15 years ago)

Author:

klain

Comment:

--

MapGuideRfc78

@@ -73 +73 @@
 };
 }}}
+
+Changes to Feature Service
+{{{
+/// \brief
+/// Provides an abstraction layer for the storage and retrieval
+/// of feature data in a technology-independent way. The API
+/// lets you determine what storage technologies are available
+/// and what capabilities they have. Access to the storage
+/// technology is modeled as a connection. For example, you can
+/// connect to a file and do simple insertions or connect to a
+/// relational database and do transaction-based operations.
+class MgFeatureService : public MgService 
+{
+PUBLISHED_API:
+    /// \brief
+    /// Begins a transaction and return it.
+    ///
+    /// \param resource (MgResourceIdentifier)
+    /// A resource identifier referring to a feature source.
+    ///
+    /// \return
+    /// Returns an MgTransaction instance.
+    ///
+virtual MgTransaction* BeginTransaction(MgResourceIdentifier* resource) = 0;
+};
+}}}
+
+One example using the new API
+{{{
+MgTransaction tran = AcMapFeatureService::StartTransaction(resourceId);
+AcMapFeatureService::ExecuteSql(resourceId, sql statement1); 
+AcMapFeatureService::ExecuteSql(resourceId, sql statement2); 
+AcMapFeatureService::UpdateFeatures(resourceId, standard commands, false);  // NOTE: you have to pass in false for useTransaction here.
+tran->Commit() // or tran->Rollback(); 
+}}}
+
+
 == Implications ==