Changes between Version 9 and Version 10 of FDORfc6


Ignore:
Timestamp:
07/22/07 20:59:37 (18 years ago)
Author:
yangm
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • FDORfc6

    v9 v10  
    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 CS’s for a specific WMS layer, neither for image format and style information.
     24In the current design of the OSGeo OGC FDO WMS Provider(s), no mechanism exists to allow a client to retrieve all supported CS’s for a specific WMS feature class, neither for image format and style information.
    2525In 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 server.
    2626
    … …  
    4040    /// Represents the GetImageFormats command.
    4141    WmsCommandType_GetImageFormats =  FdoCommandType_FirstProviderCommand + WMS_FIRST_PROVIDER_COMMAND,
    42     WmsCommandType_GetLayerStyles,
    43     WmsCommandType_GetLayerCRSNames
     42    WmsCommandType_GetFeatureClassStyles,
     43    WmsCommandType_GetFeatureClassCRSNames
    4444};
    4545}}}
    … …  
    108108}}}
    109109
    110 The following is an example of how WMS GetLayerStyles command would be used to get the entire supported image formats list from WMS server after connection.
    111 {{{
    112 FdoPtr< FDOIGetLayerStyles > cmd = static_cast< FDOIGetLayerStyles *> (conn->CreateCommand (WmsCommandType_GetLayerStyles));
    113 cmd->SetLayerName(L”ABC”);
     110The following is an example of how WMS GetFeatureClassStyles command would be used to get the entire supported image formats list from WMS server after connection.
     111{{{
     112FdoPtr< FDOIGetFeatureStyles > cmd = static_cast< FDOIGetFeatureClassStyles *> (conn->CreateCommand (WmsCommandType_GetFeatureClassStyles));
     113cmd->SetFeatureClassName(L”ABC”);
    114114FdoPtr<FdoStringCollection> result = cmd->Execute ();
    115115}}}
    116116
    117117{{{
    118 class FdoIGetLayerStyles : public FdoICommand
     118class FdoIGetFeatureClassStyles : public FdoICommand
    119119{
    120120    friend class FdoIConnection;
    … …  
    122122public:
    123123    /// \brief
    124     /// Gets the name of the layer to get all supported styles.
    125     ///
    126     /// \return
    127     /// Returns the layer name
    128     ///
    129     FDO_API virtual FdoString* GetLayerName() = 0;
    130 
    131     /// \brief
    132     /// Sets the name of the layer to get all supported styles.
     124    /// Gets the name of the feature class to get all supported styles.
     125    ///
     126    /// \return
     127    /// Returns the featuer class name
     128    ///
     129    FDO_API virtual FdoString* GetFeatureClassName() = 0;
     130
     131    /// \brief
     132    /// Sets the name of the feature class to get all supported styles.
    133133    /// This function is mandatory; if not specified,
    134134    /// execution of the command will throw exception.
    135135    ///
    136136    /// \param value
    137     /// Input the layer name
     137    /// Input the feature class name
    138138    ///
    139139    /// \return
    140140    /// Returns nothing
    141141    ///
    142     FDO_API virtual void SetLayerName(FdoString* value) = 0;
    143 
    144     /// \brief
    145     /// Executes the GetLayerStyles command and returns a
    146     /// FdoStringCollection, which contains all styles supported by specific layer.
     142    FDO_API virtual void SetFeatureClassName(FdoString* value) = 0;
     143
     144    /// \brief
     145    /// Executes the GetFeatureClassStyles command and returns a
     146    /// FdoStringCollection, which contains all styles supported by specific feature class.
    147147    ///
    148148    /// \return
    … …  
    152152};
    153153
    154 class FdoWmsGetLayerStylesCommand : public FdoWmsCommand< FDOIGetLayerStyles >
     154class FdoWmsGetFeatureClassStylesCommand : public FdoWmsCommand< FDOIGetFeatureClassStyles >
    155155{
    156156    friend class FdoWmsConnection;
    … …  
    160160    // Prevent the use of the copy constructor by definning it and not implemeting it.
    161161    // DO NOT IMPLEMENT
    162     FdoWmsGetLayerStylesCommand  (const FdoWmsGetLayerStylesCommand  &right);
     162    FdoWmsGetFeatureClassStylesCommand  (const FdoWmsGetFeatureClassStylesCommand  &right);
    163163
    164164    // <summary>Constructs an instance of a command for the given connection. </summary>
    165165    // <returns>Returns nothing</returns>
    166     FdoWmsGetLayerStylesCommand  (FdoIConnection* connection);
     166    FdoWmsGetFeatureClassStylesCommand  (FdoIConnection* connection);
    167167
    168168    // <summary>Virtual Destructor.</summary>
    169169    // <returns>Returns nothing</returns>
    170     virtual ~ FdoWmsGetLayerStylesCommand  (void);
     170    virtual ~ FdoWmsGetFeatureClassStylesCommand  (void);
    171171
    172172    // <summary>Dispose this object.</summary>
    … …  
    178178    // Prevent the use of the Assignment Operation by definning it and not implemeting it.
    179179    // DO NOT IMPLEMENT
    180     FdoWmsGetLayerStylesCommand  & operator= (const FdoWmsGetLayerStylesCommand  &right);
    181 
    182     /// <summary> Gets the name of the layer to get all supported styles. </summary>
    183     /// <returns>Returns the layer name</returns>
    184     virtual FdoString* GetLayerName ();
    185 
    186     /// <summary> Sets the name of the layer to get all supported styles
     180    FdoWmsGetFeatureClassStylesCommand  & operator= (const FdoWmsGetFeatureClassStylesCommand  &right);
     181
     182    /// <summary> Gets the name of the feature class to get all supported styles. </summary>
     183    /// <returns>Returns the feature class name</returns>
     184    virtual FdoString* GetFeatureClassName ();
     185
     186    /// <summary> Sets the name of the FeatureClass to get all supported styles
    187187    /// This function is mandatory; if not specified,
    188188    /// execution of the command will throw exception.
    189189    /// </summary>
    190     /// <param name="value">Input the layer name</param>
    191     /// <returns>Returns nothing</returns>
    192     virtual void SetLayerName (FdoString* value);
     190    /// <param name="value">Input the FeatureClass name</param>
     191    /// <returns>Returns nothing</returns>
     192    virtual void SetFeatureClassName (FdoString* value);
    193193
    194194    /// <summary>
    195     /// Executes the GetLayerStyles command and returns a
    196     /// FdoStringCollection, which contains entire styles supported by layer.
    197     /// <returns> Returns the style collection supported by layer.
     195    /// Executes the GetFeatureClassStyles command and returns a
     196    /// FdoStringCollection, which contains entire styles supported by FeatureClass.
     197    /// <returns> Returns the style collection supported by FeatureClass.
    198198    ///</returns>
    199199    virtual FdoStringCollection* Execute ();
    200200
    201201private:
    202     FdoStringP mLayerName;
    203 };
    204 }}}
    205 
    206 The following is an example of how WMS GetLayerCRSNames command would be used to get the entire supported image formats list from WMS server after connection.
    207 {{{
    208 FdoPtr<FdoIGetLayerCRSNames> cmd = static_cast<FdoIGetLayerCRSNames*> (conn->CreateCommand (FdoCommandType_GetLayerSupportedCRSNames));
    209 cmd->SetLayerName(L“ABC”);
     202    FdoStringP mFeatureClassName;
     203};
     204}}}
     205
     206The following is an example of how WMS GetFeatureClassCRSNames command would be used to get the entire supported image formats list from WMS server after connection.
     207{{{
     208FdoPtr<FdoIGetFeatureClassCRSNames> cmd = static_cast<FdoIGetFeatureClassCRSNames*> (conn->CreateCommand (FdoCommandType_GetFeatureClassSupportedCRSNames));
     209cmd->SetFeatureClassName(L“ABC”);
    210210FdoPtr<FdoStringCollection> result = cmd->Execute ();
    211211}}}
    212212
    213213{{{
    214 class FdoIGetLayerCRSNames: public FdoICommand
     214class FdoIGetFeatureClassCRSNames: public FdoICommand
    215215{
    216216    friend class FdoIConnection;
    … …  
    218218public:
    219219    /// \brief
    220     /// Gets the name of the layer to get all supported styles.
    221     ///
    222     /// \return
    223     /// Returns the layer name
    224     ///
    225     FDO_API virtual FdoString* GetLayerName() = 0;
    226 
    227     /// \brief
    228     /// Sets the name of the layer to get all supported styles.
     220    /// Gets the name of the FeatureClass to get all supported styles.
     221    ///
     222    /// \return
     223    /// Returns the FeatureClass name
     224    ///
     225    FDO_API virtual FdoString* GetFeatureClassName() = 0;
     226
     227    /// \brief
     228    /// Sets the name of the FeatureClass to get all supported styles.
    229229    /// This function is mandatory; if not specified,
    230230    /// execution of the command will throw exception.
    231231    ///
    232232    /// \param value
    233     /// Input the layer name
     233    /// Input the FeatureClass name
    234234    ///
    235235    /// \return
    236236    /// Returns nothing
    237237    ///
    238     FDO_API virtual void SetLayerName(FdoString* value) = 0;
     238    FDO_API virtual void SetFeatureClassName(FdoString* value) = 0;
    239239
    240240    /// \brief
    … …  
    248248};
    249249
    250 class FdoWmsGetLayerCRSNamesCommand: public FdoWmsCommand< FdoIGetLayerCRSNames >
     250class FdoWmsGetFeatureClassCRSNamesCommand: public FdoWmsCommand< FdoIGetFeatureClassCRSNames >
    251251{
    252252    friend class FdoWmsConnection;
    … …  
    256256    // Prevent the use of the copy constructor by definning it and not implemeting it.
    257257    // DO NOT IMPLEMENT
    258     FdoWmsGetLayerCRSNamesCommand (const FdoWmsGetLayerCRSNamesCommand &right);
     258    FdoWmsGetFeatureClassCRSNamesCommand (const FdoWmsGetFeatureClassCRSNamesCommand &right);
    259259
    260260    // <summary>Constructs an instance of a command for the given connection. </summary>
    261261    // <returns>Returns nothing</returns>
    262     FdoWmsGetLayerCRSNamesCommand (FdoIConnection* connection);
     262    FdoWmsGetFeatureClassCRSNamesCommand (FdoIConnection* connection);
    263263
    264264    // <summary>Virtual Destructor.</summary>
    265265    // <returns>Returns nothing</returns>
    266     virtual ~ FdoWmsGetLayerCRSNamesCommand (void);
     266    virtual ~ FdoWmsGetFeatureClassCRSNamesCommand (void);
    267267
    268268    // <summary>Dispose this object.</summary>
    … …  
    274274    // Prevent the use of the Assignment Operation by defining it and not implementing it.
    275275    // DO NOT IMPLEMENT
    276     FdoWmsGetLayerCRSNamesCommand & operator= (const FdoWmsGetLayerCRSNamesCommand &right);
    277 
    278     /// <summary> Gets the name of the layer to get all supported CRS names. </summary>
    279     /// <returns>Returns the layer name</returns>
    280     virtual FdoString* GetLayerName ();
    281 
    282     /// <summary> Sets the name of the layer to get all supported CRS names.
     276    FdoWmsGetFeatureClassCRSNamesCommand & operator= (const FdoWmsGetFeatureClassCRSNamesCommand &right);
     277
     278    /// <summary> Gets the name of the FeatureClass to get all supported CRS names. </summary>
     279    /// <returns>Returns the FeatureClass name</returns>
     280    virtual FdoString* GetFeatureClassName ();
     281
     282    /// <summary> Sets the name of the FeatureClass to get all supported CRS names.
    283283    /// This function is mandatory; if not specified,
    284284    /// execution of the command will throw exception.
    285285    /// </summary>
    286     /// <param name="value">Input the layer name</param>
    287     /// <returns>Returns nothing</returns>
    288     virtual void SetLayerName (FdoString* value);
     286    /// <param name="value">Input the FeatureClass name</param>
     287    /// <returns>Returns nothing</returns>
     288    virtual void SetFeatureClassName (FdoString* value);
    289289
    290290    /// <summary>
    291     /// Executes the GetLayerCRSNames command and returns a
    292     /// FdoStringCollection, which contains entire CRS names supported by layer.
    293     /// <returns> Returns the CRS names collection supported by layer.
     291    /// Executes the GetFeatureClassCRSNames command and returns a
     292    /// FdoStringCollection, which contains entire CRS names supported by FeatureClass.
     293    /// <returns> Returns the CRS names collection supported by FeatureClass.
    294294    ///</returns>
    295295    virtual FdoStringCollection* Execute ();
    296296
    297297private:
    298     FdoStringP mLayerName;
     298    FdoStringP mFeatureClassName;
    299299};
    300300}}}