FDO RFC 7 - Add New Methods to FdoClassDefinition

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	July 25, 2007
Last Modified	Barbara Zoladek Timestamp
Author	Barbara Zoladek
RFC Status	draft
Implementation Status	under development
Proposed Milestone
Assigned PSC guide(s)	Greg Boone
Voting History
	Bob, Mateusz
	Frank
	Orest
	Greg

Overview

The purpose of this RFC is to enhance the FdoClassDefinition class by adding new methods GetIsViewBased() and SetIsViewBased().

Motivation

The motivation for this RFC is to expose classes based on virtual objects. The significat differenece between classes based on real and virtual objects is that the later do not contain any data themselves. An RDBMS view is an exmaple of the virtual object. It is really an SQL query. An FDO class based on that query exposes data that is contained in other objects referenced in the query. The class schema characterists like property types and constraints tightly depends on the these objects. Data exposed by the class is more dynamic as it can be edited or deleted from the objects that contain it.

How these classes can be used? Classes based on virtual objects can be used for limiting or restricting access to some data, for analysis where a class exposes data that is combination of many classes joined in certain way with sometimes complex conditions.

Why is it important to distinguish these classes in FDO? These classes virtuality cannot be expressed by any existing methods of FdoClassdefinition. In fact, their characteristics are somewhat unpredictable and depend on the underlying virtual object definition.

Proposed Solution

The following shows the proposed changes to FdoClassDefinition:

     class FdoClassDefinition : public FdoSchemaElement
     {
        ...
        public:
            ...
            /// \brief
            /// Gets the value of m_IsViewBased. It is true if a class is based on view; otherwise is false.
            /// 
            /// \return
            /// Returns bool
            /// 
	        FDO_API bool GetIsViewBased();

	    /// \brief
            /// Sets the value of m_IsViewBased. It is true if a class is based on view; otherwise is false.
            /// This is an internal method that can only be called by providers. Application should not use this method.
            /// 
            /// \return
            /// Returns nothing
            /// 
	        FDO_API void SetIsViewBased( bool value );
            ...
        
         private:
            ...
            FdoBoolean	m_isViewBased;
            ...
       }

Implications

This change will not cause any functional or performance side effects.

Test Plan

Exisitng unit tests will be enhanced.