Changes between Version 25 and Version 26 of FDORfc6


Ignore:
Timestamp:
Jul 30, 2007, 4:00:06 PM (17 years ago)
Author:
gregboone
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • FDORfc6

    v25 v26  
    2222== Overview ==
    2323
    24 In the current design of the OSGeo OGC FDO WMS Provider(s), no mechanism exists to allow a client to retrieve all supported CRS/style names supported by specific WMS layer, neither for image format types supported by WMS service.
     24In the current design of the OSGeo FDO WMS Provider, no mechanism exists to allow a client to retrieve the supported CRS and Style names supported by specific WMS layer. In addition, no mechanism exists to allow an application to retrieve all the image format types supported by a WMS service.
    2525
    26 In order to resolve this issue, the WMS providers should be enhanced to add 3 new commands for retrieving all supported image format, style and CS information from WMS service individually.
     26In order to resolve this oversight, the OSGeo WMS provider will be enhanced to provide an application with the ability to use the FDO command invocation system to retrieve the supported image formats, styles and CRS information from the WMS service.
    2727
    2828== Proposed Solution ==
    2929
    30 In order not to impact the standard FDO command interface, we plan just adding those 3 commands interface for WMS only. Thus, we also declare a new enum type: WmsCommandType for WMS provider.
    31 The following shows the new enumeration.
     30In order not to impact the existing FDO command interface, the three new command interface will be designated as WMS specific and be implemented only by the WMS provider. In order to facilitate the implemntation, a new enum type, !FdoWmsCommandType, will be defined for the OSGeo WMS provider.
     31
     32The following section defines the WMS command enumerations.
    3233{{{
    3334// This number is defined so our custom command would not clash with other
    … …  
    4647}}}
    4748
    48 3 new commands will be added to the FDO WMS Providers, individually for getting image formats, styles and CS names.
     493 new commands will be added to the FDO WMS Provider specification, allowing an application to request image format, style and CRS name information. These commands willonly be able to be invoked once a connection has successfully been made to the WMS provider and in turn to the specified WMS service.
    4950
    5051=== Get Image Formats Command ===
    … …  
    5556public:
    5657    /// \brief
    57     /// Executes the GetImageFormats command and returns a
    58     /// FdoStringCollection, which contains all image formats supported by WMS service.
     58    /// Executes the GetImageFormats command and returns a FdoStringCollection
     59    /// which contains all the image formats supported by the current WMS service.
    5960    ///
    6061    /// \return
    6162    /// Returns the image format collection supported by WMS service
    62      ///
     63    ///
    6364    FDO_API virtual FdoStringCollection * Execute() = 0;
    6465};
    … …  
    7576public:
    7677    /// \brief
    77     /// Gets the name of the feature class to get all supported styles.
     78    /// Gets the name of the feature class from which to retrieve all supported styles.
    7879    ///
    7980    /// \return
    80     /// Returns the featuer class name
     81    /// Returns the feature class name
    8182    ///
    8283    FDO_API virtual FdoString* GetFeatureClassName() = 0;
    8384
    8485    /// \brief
    85     /// Sets the name of the feature class to get all supported styles.
    86     /// This function is mandatory; if not specified,
    87     /// execution of the command will throw exception.
     86    /// Sets the name of the feature class from which to retrieve all supported styles.
     87    /// Invocation of this function is mandatory; if not specified, execution of the
     88    /// command will throw an exception.
    8889    ///
    8990    /// \param value
    … …  
    9697
    9798    /// \brief
    98     /// Executes the GetFeatureClassStyles command and returns a
    99     /// FdoStringCollection, which contains all styles supported by specific feature class
    100     /// and all styles supported by its ancestors, because WMS service supports Style
    101     /// declarations are inherited by child Layers.
     99    /// Executes the GetFeatureClassStyles command and returns a FdoStringCollection
     100    /// which contains all styles supported by specified feature class
     101    /// and all styles supported by its ancestors. WMS services support Style
     102    /// declarations inherited by child Layers.
    102103    ///
    103104    /// \return
    … …  
    126127
    127128    /// \brief
    128     /// Sets the name of the FeatureClass to get all supported CRS names.
    129     /// This function is mandatory; if not specified,
    130     /// execution of the command will throw exception.
     129    /// Sets the name of the FeatureClass for which to retrived all supported CRS names.
     130    /// Invocation of this function is mandatory; if not specified, execution of the
     131    /// command will throw an exception.
    131132    ///
    132133    /// \param value
    … …  
    139140
    140141    /// \brief
    141     /// Executes the GetCRSNames command and returns a 
    142     /// FdoStringCollection, which contains entire CRS names supported by specific feature class.
    143     /// and all CRS names supported by its ancestors, because WMS service supports CRS
    144     /// declarations are inherited by child Layers.
     142    /// Executes the GetCRSNames command and returns an FdoStringCollection
     143    /// which contains all the CRS names supported by specified feature class.
     144    /// and all CRS names supported by its ancestors. WMS services supports CRS
     145    /// declarations inherited by child Layers.
    145146    ///
    146147    /// \return
    … …  
    158159== Test Plan ==
    159160
    160 Existing unit tests will be expanded to test those changes.
     161Existing unit tests will be expanded to test the proposed enhancements defined above.
    161162
    162163== Funding/Resources ==