Fix multiple routes of same template in attribute-based routing

[tchowice]

Changes

ASP.NET instrumentation fails to extract route for attribute-based routing, if multiple HTTP methods use the same route template--a common scenario for RESTful APIs. For example:

public class WidgetsController : ApiController
{
    [Route("api/widgets/{id}")]
    public string Get(int id) {...}

    [Route("api/widgets/{id}")]
    public void Put(int id, [FromBody]string value) {...}

    [Route("api/widgets/{id}")]
    public void Delete(int id) {...}
}

In this case, the MS_Subroutes array will have multiple elements, each corresponding to a different HTTP method.

The original code only extracts the route template if there's only one element in the array. The correct thing to do is to just extract the template from the first subroute, since all subroutes have the same template.

It's not possible for MS_Subroutes array to have different templates in its elements. WebAPI would fail to route and throw an exception, if you declare multiple actions for the same method/template

Merge requirement checklist

• CONTRIBUTING guidelines followed (license requirements, nullable enabled, static analysis, etc.)
• Unit tests added/updated
• Appropriate CHANGELOG.md files updated for non-trivial changes
• Changes in public API reviewed (if applicable)

[linux-foundation-easycla]

The committers listed above are authorized under a signed CLA.

• ✅ login: tchowice (7b8023c, 1d5b33d, 4340ca2)
• ✅ login: Kielek / name: Piotr Kiełkowicz (7eac47d, cf4b953)

[Kielek]

Please sign EasyCLA. It is hard requirement to accept any contribution to this repository.

[tchowice]

Please sign EasyCLA. It is hard requirement to accept any contribution to this repository.

Thanks. Working with my company to figure this out.

[tchowice]

Please sign EasyCLA. It is hard requirement to accept any contribution to this repository.

Thanks. Working with my company to figure this out.

[tchowice]

Please sign EasyCLA. It is hard requirement to accept any contribution to this repository.

Okay, I finally got my company to sign the CLA. Please proceed with reviewing!

[github-actions]

This PR was marked stale due to lack of activity. It will be closed in 7 days.

[ysolomchenko]

Add an entry to the Changelog

[ysolomchenko]

Update the PR title to start with [Instrumentation.AspNet]

[ysolomchenko]

I think we can simplify to:

    routeData = new RouteData();
    var httpMethods = new[] { HttpMethod.Get, HttpMethod.Put, HttpMethod.Delete };

    var multiMethodSubroutes = httpMethods.Select(method => new
    {
        Route = new
        {
            RouteTemplate = routeTemplate,
            DataTokens = new Dictionary<string, object>
            {
                ["actions"] = new[]
                {
                    new
                    {
                        SupportedHttpMethods = new[] { method }
                    }
                }
            }
        }
    }).ToArray();

    routeData.Values.Add("MS_SubRoutes", multiMethodSubroutes);