Changes between Version 2 and Version 3 of FDORfc34

Timestamp:

Apr 15, 2009, 1:08:36 PM (15 years ago)

Author:

gregboone

Comment:

--

FDORfc34

@@ -22 +22 @@
 == Motivation ==
 
+To Provide faster access to data returned from readers in the FDO API. 
+
 == Overview ==
+
+Currently, data returned in Feature readers or Data readers can only be accessed using named properties. For example, in the following example, the feature reader returned from the select command has to be accessed using the !GetDouble method, with an input parameter that is the property name. In such an implementation, there is an associated cost to determining which property is being requested. Such a cost is typically encountered in performing a lookup based on the name, which inevitably results in some form of a string comparison.
+
+{{{
+FdoPtr<FdoISelect> spSelectCmd = static_cast<FdoISelect>(mConnection->CreateCommand(FdoCommandType_Select));
+spSelectCmd->SetFeatureClassName (L"Foo");
+
+FdoPtr<FdoIdentifierCollection> spIds = spSelectCmd->GetPropertyNames ();
+FdoPtr<FdoIdentifier> spId = FdoComputedIdentifier::Create(L"AVG_ID", FdoPtr<FdoExpression>(FdoExpression::Parse(L"Avg(ID)")));
+spIds->Add(spId);
+
+FdoPtr<FdoIFeatureReader> spReader = spSelectCmd->Execute ();
+while (spReader->ReadNext())
+{
+    double avg = spReader->GetDouble(L"AVG_ID");
+}
+}}}
+
+The goal of this RFC is to add overloaded methods to the various FDO reader interfaces that accept an integer argument representing the indexed location of the property in the reader's in-memory representation of the feature. It is expected that this will speed up processing and provide a better end-user experience. User would be able to access their data using an index into the feature reader collection as follows:
+
+{{{
+FdoPtr<FdoISelect> spSelectCmd = static_cast<FdoISelect>(mConnection->CreateCommand(FdoCommandType_Select));
+spSelectCmd->SetFeatureClassName (L"Foo");
+
+FdoPtr<FdoIdentifierCollection> spIds = spSelectCmd->GetPropertyNames ();
+FdoPtr<FdoIdentifier> spId = FdoComputedIdentifier::Create(L"AVG_ID", FdoPtr<FdoExpression>(FdoExpression::Parse(L"Avg(ID)")));
+spIds->Add(spId);
+
+FdoPtr<FdoIFeatureReader> spReader = spSelectCmd->Execute ();
+while (spReader->ReadNext())
+{
+    double avg = spReader->GetDouble(0); // 0 is the index of the AVG_ID property
+}
+}}}
+
 
 == Requirements ==