Routing: Added method to IDocumentUrlService for retrieving document key from URI (closes #20666)

[AndyButland]

Prerequisites

• I have added steps to test this contribution in the description below

Addresses: #20666

Description

This PR looks to provide a solution to the concern raised in the linked issue that it's not so easy with the IDocumentUrlService to get a document's key from it's path when domains are involved.

See the discussion #20666 (comment) and #20666 (comment) for why that's currently the case and a suggestion to resolve, which is what I've done in this PR.

IDocumentUrlService now has a GetDocumentKeyByUri (to go with the existing GetDocumentKeyByRoute) that can be called providing a Uri. The domain will be parsed as is done during routing to then be able to delegate to GetDocumentKeyByRoute.

Testing

The following code for a document with or without domains associated should now successfully retrieve the document's key.

@using Microsoft.AspNetCore.Http.Extensions
@using Umbraco.Cms.Core.Services
@using Umbraco.Cms.Web.Common.PublishedModels;
@inject IDocumentUrlService DocumentUrlService
@inherits Umbraco.Cms.Web.Common.Views.UmbracoViewPage
@{
	Layout = null;
}

@{
    var currentRequest = Context.Request;
    var currentUri = new Uri(currentRequest.GetDisplayUrl());
}
<p>Current path: @currentRequest.Path</p>
<p>Found page guid: @DocumentUrlService.GetDocumentKeyByRoute(currentRequest.Path, null, null, false)</p>
<p>Current URL: @currentUri</p>
<p>Found page guid: @DocumentUrlService.GetDocumentKeyByUri(currentUri, false)</p>

Integration tests have also been added to verify the functionality.

[Copilot]

Pull Request Overview

This PR adds a new GetDocumentKeyByUri method to the IDocumentUrlService interface to enable retrieval of document keys from URIs when domains are involved. This addresses the limitation where GetDocumentKeyByRoute alone was insufficient when working with domains.

Key Changes:

• Added GetDocumentKeyByUri method that parses domains from URIs and delegates to GetDocumentKeyByRoute
• Updated constructor to inject WebRoutingSettings and IDefaultCultureAccessor dependencies needed for domain resolution
• Added comprehensive integration tests covering both domain and non-domain scenarios

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
src/Umbraco.Core/Services/IDocumentUrlService.cs	Adds GetDocumentKeyByUri method signature with default implementation
src/Umbraco.Core/Services/DocumentUrlService.cs	Implements GetDocumentKeyByUri method and updates constructor with required dependencies
src/Umbraco.Core/Routing/DomainUtilities.cs	Removes unused imports
tests/Umbraco.Tests.Integration/Umbraco.Core/Services/DocumentUrlServiceTests.cs	Adds integration tests for the new method covering domain and non-domain scenarios
tests/Umbraco.Tests.Common/Builders/TemplateBuilder.cs	Makes template name parameter configurable

[nikolajlauridsen]

Looks good, tests good 👍