Changes between Version 13 and Version 14 of FDORfc6

Timestamp:

07/23/07 21:31:40 (17 years ago)

Author:

yangm

Comment:

--

FDORfc6

@@ -45 +45 @@
 }}}
 
-3 new commands will be added to the FDO WMS Providers, individually for getting image formats, style and CS. The usage and the new classes and interfaces are listed as follows.
+
+3 new commands will be added to the FDO WMS Providers, individually for getting image formats, styles and CS names. The usage and the new classes and interfaces are listed as follows.
 
 The following is an example of how WMS GetImageFormats command would be used to get the entire supported image formats list from WMS server after connection.
@@ -108 +109 @@
 }}}
 
-The 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.
+The following is an example of how WMS GetFeatureClassStyles command would be used to get all styles supported by specific layer on WMS server after connection.
+''Note: FeatureClass is a FDO conception, one feature class is correspond with one layer name in the WMS service. We use feature class, instead of layer here, in order to avoid the confusion of FDO user.''
 {{{
 FdoPtr< FDOIGetFeatureStyles > cmd = static_cast< FDOIGetFeatureClassStyles *> (conn->CreateCommand (WmsCommandType_GetFeatureClassStyles));
-cmd->SetFeatureClassName(L”ABC”);
+cmd->SetFeatureClassName(L”ABC”);    
 FdoPtr<FdoStringCollection> result = cmd->Execute ();
 }}}
@@ -144 +146 @@
     /// \brief
     /// Executes the GetFeatureClassStyles command and returns a 
-    /// FdoStringCollection, which contains all styles supported by specific feature class.
-    /// 
-    /// \return
-    /// Returns the styles collection supported by server
+    /// FdoStringCollection, which contains all styles supported by specific feature class
+    /// and all styles supported by its ancestors, because WMS service supports Style 
+    /// declarations are inherited by child Layers. 
+    /// 
+    /// \return
+    /// Returns the styles collection supported by specific feature class
     /// 
     FDO_API virtual FdoStringCollection * Execute() = 0;
@@ -180 +184 @@
 public:
     //
-    /// <summary> Gets the name of the feature class to get all supported styles. </summary>
+    /// <summary>Gets the name of the feature class to get all supported styles. </summary>
     /// <returns>Returns the feature class name</returns> 
     virtual FdoString* GetFeatureClassName ();
 
-    /// <summary> Sets the name of the FeatureClass to get all supported styles 
+    /// <summary>Sets the name of the FeatureClass to get all supported styles 
     /// This function is mandatory; if not specified, 
     /// execution of the command will throw exception. 
@@ -194 +198 @@
     /// <summary> 
     /// Executes the GetFeatureClassStyles command and returns a 
-    /// FdoStringCollection, which contains entire styles supported by FeatureClass.
-    /// <returns> Returns the style collection supported by FeatureClass.
-    ///</returns> 
+    /// FdoStringCollection, which contains entire styles supported by feature class.
+    /// and all styles supported by its ancestors, because WMS service supports Style 
+    /// declarations are inherited by child Layers. 
+    /// 
+    /// </summary>
+    /// <returns> Returns the style collection supported by FeatureClass. </returns> 
     virtual FdoStringCollection* Execute ();
 
@@ -204 +211 @@
 }}}
 
-The 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.
+The following is an example of how WMS GetFeatureClassCRSNames command would be used to get the all CRS names supported by specifc layer on WMS server after connection.
+''Note: FeatureClass is a FDO conception, one feature class is correspond with one layer name in the WMS service. We use feature class, instead of layer here, in order to avoid the confusion of FDO user.''
 {{{
 FdoPtr<FdoIGetFeatureClassCRSNames> cmd = static_cast<FdoIGetFeatureClassCRSNames*> (conn->CreateCommand (FdoCommandType_GetFeatureClassSupportedCRSNames));
@@ -218 +226 @@
 public:
     /// \brief
-    /// Gets the name of the FeatureClass to get all supported styles. 
+    /// Gets the name of the FeatureClass to get all supported CRS names. 
     /// 
     /// \return
@@ -226 +234 @@
 
     /// \brief
-    /// Sets the name of the FeatureClass to get all supported styles.
+    /// Sets the name of the FeatureClass to get all supported CRS names.
     /// This function is mandatory; if not specified, 
     /// execution of the command will throw exception. 
@@ -241 +249 @@
     /// Executes the GetCRSNames command and returns a 
     /// FdoStringCollection, which contains entire CRS names supported by server.
+    /// and all CRS names supported by its ancestors, because WMS service supports CRS
+    /// declarations are inherited by child Layers. 
     /// 
     /// \return
@@ -290 +300 @@
     /// <summary> 
     /// Executes the GetFeatureClassCRSNames command and returns a 
-    /// FdoStringCollection, which contains entire CRS names supported by FeatureClass.
-    /// <returns> Returns the CRS names collection supported by FeatureClass.
-    ///</returns> 
+    /// FdoStringCollection, which contains entire CRS names supported by feature class.
+    /// and all CRS names supported by its ancestors, because WMS service supports CRS
+    /// declarations are inherited by child Layers. 
+    /// </summary>
+    /// <returns> Returns the CRS names collection supported by FeatureClass.</returns> 
     virtual FdoStringCollection* Execute ();