21

我正在从原始 http 处理程序中移动一个 API 项目,我在路径中使用句点:

http://server/collection/id.format

我想在 Web Api(自托管)版本中遵循相同的 URL 架构,并尝试了这个:

var c = new HttpSelfHostConfiguration(b);
c.Routes.MapHttpRoute(
    name: "DefaultApiRoute",
    routeTemplate: "{controller}/{id}.{format}",
    defaults: new { id = RouteParameter.Optional, format = RouteParameter.Optional },
    constraints: null
);

不幸的是,这似乎没有解决(/foo、/foo/bar 和 /foo/bar.txt 上的一致 404)。在“格式”之前使用斜线的类似模式可以正常工作:

var c = new HttpSelfHostConfiguration(b);
c.Routes.MapHttpRoute(
    name: "DefaultApiRoute",
    routeTemplate: "{controller}/{id}/{format}",
    defaults: new { id = RouteParameter.Optional, format = RouteParameter.Optional },
    constraints: null
);

我还没有深入研究 Web Api 的代码,在我想到之前我会在这里询问这是否是 Web Api 中的已知限制,或者甚至是合理的限制。

更新:我没有提到“id”和“format”是字符串,这对于解决这个问题很重要。添加约束以从“id”标记中排除句点可以解决 404 问题。

4

5 回答 5

29

我可以通过执行以下操作来实现这一点:在 web.config 中的 system.webServer.handlers 中替换"*.""*",即删除句点。

<add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="*" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0" />
于 2013-11-09T00:07:11.497 回答
17

小心在 web.config 的 modules 属性中设置 runAllManagedModulesForAllRequests 选项

<modules runAllManagedModulesForAllRequests="true">..</modules>

否则它将无法在 IIS 中工作(可能会由非托管处理程序处理)。

于 2012-07-31T11:35:09.033 回答
16

我无法重现该问题。这应该有效。这是我的设置:

  1. 创建一个新的 .NET 4.0 控制台应用程序
  2. 切换到 .NET Framework 4.0 配置文件
  3. 安装Microsoft.AspNet.WebApi.SelfHostNuGet
  4. 定义一个Product

    public class Product
    {
        public int Id { get; set; }
        public string Name { get; set; }
    }
    
  5. 对应的 API 控制器:

    public class ProductsController : ApiController
    {
        public Product Get(int id)
        {
            return new Product
            {
                Id = id,
                Name = "prd " + id
            };
        }
    }
    
  6. 还有一个主持人:

    class Program
    {
        static void Main(string[] args)
        {
            var config = new HttpSelfHostConfiguration("http://localhost:8080");
    
            config.Routes.MapHttpRoute(
                name: "DefaultApiRoute",
                routeTemplate: "{controller}/{id}.{format}",
                defaults: new { id = RouteParameter.Optional, format = RouteParameter.Optional },
                constraints: null
            );
    
            using (var server = new HttpSelfHostServer(config))
            {
                server.OpenAsync().Wait();
                Console.WriteLine("Press Enter to quit.");
                Console.ReadLine();
            }
        }
    }
    

现在,当您运行此控制台应用程序时,您可以导航到http://localhost:8080/products/123.xml. 但是当然您可以导航到http://localhost:8080/products/123.json并且您仍然会得到 XML。所以问题是:如何使用路由参数启用内容协商?

您可以执行以下操作:

    class Program
    {
        static void Main(string[] args)
        {
            var config = new HttpSelfHostConfiguration("http://localhost:8080");
            config.Formatters.XmlFormatter.AddUriPathExtensionMapping("xml", "text/html");
            config.Formatters.JsonFormatter.AddUriPathExtensionMapping("json", "application/json");

            config.Routes.MapHttpRoute(
                name: "DefaultApiRoute",
                routeTemplate: "{controller}/{id}.{ext}",
                defaults: new { id = RouteParameter.Optional, formatter = RouteParameter.Optional },
                constraints: null
            );

            using (var server = new HttpSelfHostServer(config))
            {
                server.OpenAsync().Wait();
                Console.WriteLine("Press Enter to quit.");
                Console.ReadLine();
            }
        }
    }

现在您可以使用以下网址:

http://localhost:8080/products/123.xml
http://localhost:8080/products/123.json

现在您可能想知道{ext}我们在路由定义中使用的路由参数和AddUriPathExtensionMapping方法之间的关系是什么,因为我们没有在任何地方指定它。好吧,你猜怎么着:它在UriPathExtensionMapping类中被硬编码ext,你不能修改它,因为它是只读的:

public class UriPathExtensionMapping
{
    public static readonly string UriPathExtensionKey;

    static UriPathExtensionMapping()
    {
        UriPathExtensionKey = "ext";
    }

    ...
}

这一切都是为了回答你的问题:

可以在 Asp.Net Web Api 路由中使用句点吗?

是的。

于 2012-07-15T18:54:37.863 回答
12

我接受了 Darin 的回答(是的,句点可以在路由 url 中使用),因为它对我的示例特别正确,但对我没有帮助。这是我的错,因为没有明确指出“id”是一个字符串,而不是一个整数。

要在字符串参数之后使用句点,路由引擎需要约束形式的提示:

var c = new HttpSelfHostConfiguration(b);
c.Routes.MapHttpRoute(
    name: "DefaultApiRoute",
    routeTemplate: "{controller}/{id}.{format}",
    defaults: new { id = RouteParameter.Optional, format = RouteParameter.Optional },
    constraints: new { id = "[^\\.]+" } // anything but a period
);

将约束添加到前面的标记可以正确分解和处理入站 URL。如果没有提示,“id”标记可以被解释为匹配 URL 的剩余范围。这只是通常需要约束来描绘字符串参数之间的边界的特定情况。

是的,句点可以在 Asp.Net Web API 中的 URL 路由中使用,但如果它们遵循字符串参数,请确保对路由应用正确的约束。

于 2012-07-16T18:06:34.330 回答
0

IIS 以文件下载的形式截取带有句点的请求。在您的 web.config 中,您可以将 IIS 配置为忽略特定的 URL 路径,因为 webapi 将改为处理请求。如果您希望 IIS 处理文件下载以及处理 webapi 调用,您可以在 web.config 中将 ManagedDllExtension 配置添加到 system.webServer.handlers。

      <add name="ManagedDllExtension" path="collection/*.*" verb="GET" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0" />
于 2014-07-31T13:41:49.430 回答