Changes between Version 26 and Version 27 of MapGuideRfc86

Timestamp:

Oct 14, 2009, 8:09:08 PM (15 years ago)

Author:

leaf

Comment:

--

MapGuideRfc86

@@ -88 +88 @@
 == Proposed Solution ==
 
-In this RFC, we extend Feature Service to add the ability to use the same FDO connection for calls to Feature Service. The following two methods will be added to class !MgFeatureService to allow users to pin/unpin an FDO connection to the current session. Method !PinConnection(...) will select an FDO connection from FDO connection pool for the specified feature source if there is one FDO connection available. Otherwise, create a new FDO connection and add it to FDO connection pool. Then this FDO connection is pinned to current session. It means this FDO connection becomes an exclusive connection and can’t be used by other sessions. Since then, any call to Feature Service for the feature source and the session, which needs an FDO connection, will always use the pinned FDO connection till users call method !UnpinConnection(...) to unpin this FDO connection or current session is time-out. By default, one session will be time-out after 20 minutes. Users can modify this setting through property [!SiteServiceProperties]->!SessionTimeOut in !MapGuide Server configuration file "serverconfig.ini".
+In this RFC, we extend Feature Service to add the ability to use the same FDO connection for calls to Feature Service. The following two methods will be added to class !MgFeatureService to allow users to pin/unpin an FDO connection to the current session. Method !PinConnection(...) will select an FDO connection from FDO connection pool for the specified feature source if there is one FDO connection available. Otherwise, create a new FDO connection and add it to FDO connection pool. Then this FDO connection is pinned to current session. It means this FDO connection becomes an exclusive connection and can’t be used by other sessions. Since then, any call to Feature Service for the feature source and the session, which needs an FDO connection, will always use the pinned FDO connection till users call method !UnpinConnection(...) to unpin this FDO connection or current session or the pinned connection is time-out. By default, one session will be time-out after 20 minutes. Users can modify this setting through property [!SiteServiceProperties]->!SessionTimeOut in !MapGuide Server configuration file "serverconfig.ini".
 
 {{{
@@ -117 +117 @@
 Some of methods in !MgFeatureService don’t depend on an existing feature source and an FDO connection. So this change will not affect them. For example, MgFeatureService::!GetFeatureProviders, MgFeatureService::!XmlToSchema, and so on.
 
-To avoid exhausting the avaiable FDO connections through pinned connections, the following two properties will be added into serverconfig.ini to set a limitation of pinned connections per FDO providers.
+To avoid exhausting the avaiable FDO connections through pinned connections, properties 'PinnedDataConnectionSize' and 'PinnedDataConnectionSizeCustom' will be added into serverconfig.ini to set a limitation of pinned connections per FDO providers. Moreover, users can set time duration in seconds for when an idle pinned FDO connection is dropped.
 
 {{{
@@ -124 +124 @@
     # F E A T U R E  S E R V I C E
     #
-    # Property Name                    Description
+    # Property Name                      Description
     # -----------------------------------------------------------------------------
-    # PinnedDataConnectionSize         Default # of pinned FDO connections per provider. 
+    # PinnedDataConnectionSize           Default # of pinned FDO connections per provider. 
     #                                       Value < 0  The default number of pinned connection is 
     #                                                  same as value of DataConnectionPoolSize.
@@ -132 +132 @@
     #                                       Value > 0  Its value has to be less than or equal to
     #                                                  the value of DataConnectionPoolSize.
-    # PinnedDataConnectionSizeCustom   Custom # of pinned FDO connections for specified provider
+    # PinnedDataConnectionSizeCustom     Custom # of pinned FDO connections for specified provider
     #                                       0 <= Length <= 1024
     #                                       Example: OSGeo.SDF:5,OSGeo.SHP:5
+    # PinnedDataConnectionTimeout        Time duration in seconds for when an idle pinned FDO 
+    #                                    connection is dropped.
+    #                                       0 < Value <= 1800 
+    # PinnedDataConnectionTimerInterval  Time interval in seconds for when the server 
+    #                                    checks for idle pinned FDO connection. 
+    #                                       0 < Value <= 1800 
     # *****************************************************************************
     PinnedDataConnectionSize           = 20
     PinnedDataConnectionSizeCustom     = 
+    PinnedDataConnectionTimeout        = 360
+    PinnedDataConnectionTimerInterval  = 60
 }}}