feat(projectsADM): add possibility to get project and members by UUID (DEV-1408)

docs/03-apis/api-admin/projects.md

@@ -13,7 +13,7 @@
 
 - `POST: /admin/projects` : create a new project  
 
-- `GET: /admin/projects/[iri | shortname | shortcode]/<identifier>` : returns a single project identified either through iri, shortname, or shortcode  
+- `GET: /admin/projects/[iri | shortname | shortcode | UUID]/<identifier>` : returns a single project identified either through iri, shortname, shortcode or UUID
 
 - `PUT: /admin/projects/iri/<identifier>` : update a project identified by iri  
 
@@ -23,7 +23,7 @@
 
 **Project Member Operations:**  
 
-- `GET: /admin/projects/[iri | shortname | shortcode]/<identifier>/members` : returns all members part of a project identified through iri, shortname or shortcode  
+- `GET: /admin/projects/[iri | shortname | shortcode | UUID]/<identifier>/members` : returns all members part of a project identified through iri, shortname, shortcode or UUID
 
 **Project Admin Member Operations:**  
 

webapi/src/main/scala/org/knora/webapi/routing/admin/ProjectsRouteADM.scala

@@ -49,12 +49,14 @@ class ProjectsRouteADM(routeData: KnoraRouteData)
       addProject() ~
       getKeywords() ~
       getProjectKeywords() ~
-      getProjectByIri() ~
+      getProjectByIriOrUuid("iri") ~
+      getProjectByIriOrUuid("uuid") ~
       getProjectByShortname() ~
       getProjectByShortcode() ~
       changeProject() ~
       deleteProject() ~
-      getProjectMembersByIri() ~
+      getProjectMembersByIriOrUuid("iri") ~
+      getProjectMembersByIriOrUuid("uuid") ~
       getProjectMembersByShortname() ~
       getProjectMembersByShortcode() ~
       getProjectAdminMembersByIri() ~
@@ -173,18 +175,23 @@ class ProjectsRouteADM(routeData: KnoraRouteData)
     }
 
   /**
-   * returns a single project identified through iri
+   * Returns a single project identified through IRI or UUID
    */
-  private def getProjectByIri(): Route =
-    path(projectsBasePath / "iri" / Segment) { value =>
+  private def getProjectByIriOrUuid(routeResolver: String): Route =
+    path(projectsBasePath / routeResolver / Segment) { value =>
+      val iri: String = if (routeResolver == "uuid") s"http://rdfh.ch/projects/$value" else value
+
       get { requestContext =>
         val requestMessage: Future[ProjectGetRequestADM] = for {
           requestingUser <- getUserADM(
                               requestContext = requestContext,
                               routeData.appConfig
                             )
           checkedProjectIri =
-            stringFormatter.validateAndEscapeProjectIri(value, throw BadRequestException(s"Invalid project IRI $value"))
+            stringFormatter.validateAndEscapeProjectIri(
+              iri,
+              throw BadRequestException(s"Invalid project ${routeResolver.toUpperCase}: $value")
+            )
 
         } yield ProjectGetRequestADM(
           identifier = ProjectIdentifierADM(maybeIri = Some(checkedProjectIri)),
@@ -325,18 +332,23 @@ class ProjectsRouteADM(routeData: KnoraRouteData)
     }
 
   /**
-   * returns all members part of a project identified through iri
+   * Returns all members part of a project identified through IRI or UUID
    */
-  private def getProjectMembersByIri(): Route =
-    path(projectsBasePath / "iri" / Segment / "members") { value =>
+  private def getProjectMembersByIriOrUuid(routeResolver: String): Route =
+    path(projectsBasePath / routeResolver / Segment / "members") { value =>
+      val iri: String = if (routeResolver == "uuid") s"http://rdfh.ch/projects/$value" else value
+
       get { requestContext =>
         val requestMessage: Future[ProjectMembersGetRequestADM] = for {
           requestingUser <- getUserADM(
                               requestContext = requestContext,
                               routeData.appConfig
                             )
           checkedProjectIri =
-            stringFormatter.validateAndEscapeProjectIri(value, throw BadRequestException(s"Invalid project IRI $value"))
+            stringFormatter.validateAndEscapeProjectIri(
+              iri,
+              throw BadRequestException(s"Invalid project ${routeResolver.toUpperCase}: $value")
+            )
 
         } yield ProjectMembersGetRequestADM(
           identifier = ProjectIdentifierADM(maybeIri = Some(checkedProjectIri)),

webapi/src/test/scala/org/knora/webapi/responders/admin/ProjectsResponderADMSpec.scala

@@ -53,7 +53,6 @@ class ProjectsResponderADMSpec extends CoreSpec with ImplicitSender {
       }
 
       "return information about a project identified by IRI" in {
-        /* Incunabula project */
         appActor ! ProjectGetRequestADM(
           identifier = ProjectIdentifierADM(maybeIri = Some(SharedTestDataADM.incunabulaProject.id)),
           requestingUser = SharedTestDataADM.rootUser
@@ -449,7 +448,6 @@ class ProjectsResponderADMSpec extends CoreSpec with ImplicitSender {
      */
 
     "used to query members" should {
-
       "return all members of a project identified by IRI" in {
         appActor ! ProjectMembersGetRequestADM(
           ProjectIdentifierADM(maybeIri = Some(SharedTestDataADM.imagesProject.id)),

webapi/src/test/scala/org/knora/webapi/sharedtestdata/SharedTestDataADM.scala

@@ -202,7 +202,8 @@ object SharedTestDataADM {
   /**
    * **********************************
    */
-  val IMAGES_PROJECT_IRI = "http://rdfh.ch/projects/MTvoB0EJRrqovzRkWXqfkA"
+  val imagesProjectUuid  = "MTvoB0EJRrqovzRkWXqfkA"
+  val IMAGES_PROJECT_IRI = s"http://rdfh.ch/projects/$imagesProjectUuid"
 
   /* represents 'user01' as found in admin-data.ttl  */
   def imagesUser01: UserADM =