Server OGC API: fix url path match

python/server/auto_generated/qgsserverapicontext.sip.in

@@ -87,6 +87,14 @@ Returns the API root path
     void setRequest( const QgsServerRequest *request );
 %Docstring
 Sets context request to ``request``
+%End
+
+    QString handlerPath( ) const;
+%Docstring
+Returns the handler component of the URL path, i.e. the part of the path that comes
+after the API path.
+
+.. versionadded:: 3.22
 %End
 
 };

python/server/auto_generated/qgsserverogcapi.sip.in

@@ -108,7 +108,8 @@ Registers an OGC API ``handler``, ownership of the handler is transferred to the
 
     static QUrl sanitizeUrl( const QUrl &url );
 %Docstring
-Returns a sanitized ``url`` with extra slashes removed
+Returns a sanitized ``url`` with extra slashes removed and the path URL component that
+always starts with a slash.
 %End
 
     static std::string relToString( const QgsServerOgcApi::Rel &rel );

src/server/qgsserverapicontext.cpp

@@ -81,3 +81,17 @@ void QgsServerApiContext::setRequest( const QgsServerRequest *request )
 {
   mRequest = request;
 }
+
+QString QgsServerApiContext::handlerPath() const
+{
+  const QUrl url { request()->url() };
+  const QString urlBasePath { matchedPath() };
+  if ( ! urlBasePath.isEmpty() )
+  {
+    return url.path().mid( urlBasePath.length() );
+  }
+  else
+  {
+    return url.path();
+  }
+}

src/server/qgsserverapicontext.h

@@ -101,6 +101,14 @@ class SERVER_EXPORT QgsServerApiContext
      */
     void setRequest( const QgsServerRequest *request );
 
+    /**
+     * Returns the handler component of the URL path, i.e. the part of the path that comes
+     * after the API path.
+     *
+     * \since QGIS 3.22
+     */
+    QString handlerPath( ) const;
+
   private:
 
     QString mApiRootPath;

src/server/qgsserverogcapi.cpp

@@ -75,13 +75,18 @@ QUrl QgsServerOgcApi::sanitizeUrl( const QUrl &url )
   {
     u.setPath( u.path().replace( QLatin1String( "//" ), QChar( '/' ) ) );
   }
+  // Make sure the path starts with '/'
+  if ( !u.path().startsWith( '/' ) )
+  {
+    u.setPath( u.path().prepend( '/' ) );
+  }
   return u;
 }
 
 void QgsServerOgcApi::executeRequest( const QgsServerApiContext &context ) const
 {
   // Get url
-  const auto path { sanitizeUrl( context.request()->url() ).path() };
+  const auto path { sanitizeUrl( context.handlerPath( ) ).path() };
   // Find matching handler
   auto hasMatch { false };
   for ( const auto &handler : mHandlers )

src/server/qgsserverogcapi.h

@@ -145,7 +145,8 @@ class SERVER_EXPORT QgsServerOgcApi : public QgsServerApi
     void registerHandler( QgsServerOgcApiHandler *handler SIP_TRANSFER );
 
     /**
-     * Returns a sanitized \a url with extra slashes removed
+     * Returns a sanitized \a url with extra slashes removed and the path URL component that
+     * always starts with a slash.
      */
     static QUrl sanitizeUrl( const QUrl &url );
 

src/server/qgsserverogcapihandler.cpp

@@ -46,7 +46,8 @@ QVariantMap QgsServerOgcApiHandler::values( const QgsServerApiContext &context )
     // value() calls the validators and throws an exception if validation fails
     result[p.name()] = p.value( context );
   }
-  const auto match { path().match( context.request()->url().toString() ) };
+  const auto sanitizedPath { QgsServerOgcApi::sanitizeUrl( context.handlerPath( ) ).path() };
+  const auto match { path().match( sanitizedPath ) };
   if ( match.hasMatch() )
   {
     const auto constNamed { path().namedCaptureGroups() };
@@ -140,7 +141,7 @@ std::string QgsServerOgcApiHandler::href( const QgsServerApiContext &context, co
 {
   QUrl url { context.request()->url() };
   QString urlBasePath { context.matchedPath() };
-  const auto match { path().match( url.path() ) };
+  const auto match { path().match( QgsServerOgcApi::sanitizeUrl( context.handlerPath( ) ).path( ) ) };
   if ( match.captured().count() > 0 )
   {
     url.setPath( urlBasePath + match.captured( 0 ) );

tests/src/python/test_qgsserver_api.py

@@ -26,6 +26,7 @@
 from qgis.server import (
     QgsBufferServerRequest,
     QgsBufferServerResponse,
+    QgsServer,
     QgsServerApi,
     QgsServerApiBadRequestException,
     QgsServerQueryStringParameter,
@@ -1749,6 +1750,36 @@ def templatePath(self, context):
             return self.templatePathOverride
 
 
+class Handler4(QgsServerOgcApiHandler):
+
+    def path(self):
+        return QtCore.QRegularExpression("/(?P<tilemapid>[^/]+)")
+
+    def operationId(self):
+        return "handler4"
+
+    def summary(self):
+        return "Fourth of its name"
+
+    def description(self):
+        return "The fourth handler ever"
+
+    def linkTitle(self):
+        return "Handler Four Link Title"
+
+    def linkType(self):
+        return QgsServerOgcApi.data
+
+    def handleRequest(self, context):
+        """Simple mirror: returns the parameters"""
+
+        self.params = self.values(context)
+        self.write(self.params, context)
+
+    def parameters(self, context):
+        return []
+
+
 class HandlerException(QgsServerOgcApiHandler):
 
     def __init__(self):
@@ -2000,6 +2031,30 @@ def testOgcApiHandlerException(self):
 
         del(project)
 
+    def test_path_capture(self):
+        """Test issue GH #45439"""
+
+        api = QgsServerOgcApi(self.server.serverInterface(),
+                              '/api4', 'apifour', 'a fourth api', '1.2')
+
+        h4 = Handler4()
+        api.registerHandler(h4)
+
+        request = QgsBufferServerRequest(
+            'http://localhost:19876/api4/france_parts.json?MAP=france_parts')
+        response = QgsBufferServerResponse()
+
+        server = QgsServer()
+        iface = server.serverInterface()
+        iface.serviceRegistry().registerApi(api)
+
+        server.handleRequest(request, response)
+
+        self.assertEqual(h4.params, {'tilemapid': 'france_parts.json'})
+
+        ctx = QgsServerApiContext(api.rootPath(), request, response, None, iface)
+        self.assertEqual(h4.href(ctx), 'http://localhost:19876/api4/france_parts?MAP=france_parts')
+
 
 if __name__ == '__main__':
     unittest.main()