FDO RFC 32 - GetSpatialContexts cleanup

This page contains a request for comments document (RFC) for the FDO Open Source project. More FDO RFCs can be found on the RFCs page.

Status

RFC Template Version	(1.0)
Submission Date	April 4, 2009
Last Modified	Steve Dang Timestamp
Author	Steve Dang
RFC Status	draft (draft, proposed, frozen for vote, adopted, retracted, or rejected)
Implementation Status	pending (pending, under development, completed)
Proposed Milestone	3.5
Assigned PSC guide(s)	Orest Halustchak
Voting History	(vote date)
+1
+0
-0
-1
no vote

Overview

This RFC is to deprecate the Spatial Context active flag that is obsolete and no longer in use by:

• The FdoIGetSpatialContexts derived classes (to retrieve the spatial contexts in the feature source).
• The FdoISpatialContextReader derived classes (to retrieve the spatial context data).

Motivation

• Make the GetSpatialContexts API consistently reliable across all providers.
• Clean up legacy code and make existing code more readable.

Proposed Solution

• Update existing code to discontinue usages of the obsolete Spatial Context active flag where applicable.

Implications

• The following APIs will be deprecated in the future, and therefore, should be avoided to be used:

    FDO_API virtual const bool FdoIGetSpatialContexts::GetActiveOnly() = 0;

    FDO_API virtual void FdoIGetSpatialContexts::SetActiveOnly(const bool value) = 0;

    FDO_API virtual const bool FdoISpatialContextReader::IsActive() = 0;

• The documentation will be updated accordingly.

Test Plan

• The existing GetSpatialContexts API should work as before.
• Existing unit tests should all pass.

Funding/Resources

Autodesk