Imported Upstream version 4.6.0.125

Former-commit-id: a2155e9bd80020e49e72e86c44da02a8ac0e57a4

mcs/class/referencesource/System.Web/IHttpHandlerFactory.cs

@@ -0,0 +1,51 @@
+//------------------------------------------------------------------------------
+// <copyright file="IHttpHandlerFactory.cs" company="Microsoft">
+//     Copyright (c) Microsoft Corporation.  All rights reserved.
+// </copyright>                                                                
+//------------------------------------------------------------------------------
+
+/*
+ * Handler factory interface
+ */
+namespace System.Web {
+    
+    using System.Security.Permissions;
+    /*
+     * Handler factory -- gets Handler by requestType,path,file
+     */
+
+    /// <devdoc>
+    ///    <para>
+    ///       Defines the contract that factories must implement to dynamically
+    ///       create IHttpHandler instances.
+    ///    </para>
+    /// </devdoc>
+    public interface IHttpHandlerFactory {
+
+        /// <devdoc>
+        ///    <para>
+        ///       Returns an instance of an IHttpHandler class.
+        ///    </para>
+        /// </devdoc>
+        IHttpHandler GetHandler(HttpContext context, String requestType, String url, String pathTranslated);
+
+        /// <devdoc>
+        ///    <para>
+        ///       Enables a factory to recycle or re-use an existing handler
+        ///       instance.
+        ///    </para>
+        /// </devdoc>
+        void ReleaseHandler(IHttpHandler handler);
+    }
+
+    internal interface IHttpHandlerFactory2 : IHttpHandlerFactory {
+
+        /// <devdoc>
+        ///    <para>
+        ///       Returns an instance of an IHttpHandler class. Works directly with a VirtualPath object
+        ///       to avoid unnecessary conversions and creations.
+        ///    </para>
+        /// </devdoc>
+        IHttpHandler GetHandler(HttpContext context, String requestType, VirtualPath virtualPath, String physicalPath);
+    }
+}