Create resource collection endpoint for get

scm-webapp/src/main/java/sonia/scm/api/v2/resources/RepositoryCollectionResource.java

@@ -0,0 +1,54 @@
+package sonia.scm.api.v2.resources;
+
+import com.webcohesion.enunciate.metadata.rs.ResponseCode;
+import com.webcohesion.enunciate.metadata.rs.StatusCodes;
+import com.webcohesion.enunciate.metadata.rs.TypeHint;
+import sonia.scm.repository.Repository;
+import sonia.scm.repository.RepositoryException;
+import sonia.scm.repository.RepositoryManager;
+import sonia.scm.web.VndMediaType;
+
+import javax.inject.Inject;
+import javax.ws.rs.DefaultValue;
+import javax.ws.rs.GET;
+import javax.ws.rs.POST;
+import javax.ws.rs.Path;
+import javax.ws.rs.Produces;
+import javax.ws.rs.QueryParam;
+import javax.ws.rs.core.Response;
+
+public class RepositoryCollectionResource {
+
+  private final CollectionResourceManagerAdapter<Repository, RepositoryDto, RepositoryException> adapter;
+  private final RepositoryCollectionToDtoMapper repositoryCollectionToDtoMapper;
+
+  @Inject
+  public RepositoryCollectionResource(RepositoryManager manager, RepositoryCollectionToDtoMapper repositoryCollectionToDtoMapper) {
+    this.adapter = new CollectionResourceManagerAdapter<>(manager);
+    this.repositoryCollectionToDtoMapper = repositoryCollectionToDtoMapper;
+  }
+
+  @GET
+  @Path("")
+  @Produces(VndMediaType.REPOSITORY_COLLECTION)
+  @TypeHint(UserDto[].class)
+  @StatusCodes({
+    @ResponseCode(code = 200, condition = "success"),
+    @ResponseCode(code = 401, condition = "not authenticated / invalid credentials"),
+    @ResponseCode(code = 403, condition = "not authorized, the current user does not have the \"repository\" privilege"),
+    @ResponseCode(code = 500, condition = "internal server error")
+  })
+  public Response getAll(@DefaultValue("0") @QueryParam("page") int page,
+    @DefaultValue("10") @QueryParam("pageSize") int pageSize,
+    @QueryParam("sortBy") String sortBy,
+    @DefaultValue("false") @QueryParam("desc") boolean desc) {
+    return adapter.getAll(page, pageSize, sortBy, desc,
+      pageResult -> repositoryCollectionToDtoMapper.map(page, pageSize, pageResult));
+  }
+
+  @POST
+  @Path("")
+  public Response create() {
+    throw new UnsupportedOperationException();
+  }
+}

scm-webapp/src/main/java/sonia/scm/api/v2/resources/RepositoryCollectionToDtoMapper.java

@@ -0,0 +1,34 @@
+package sonia.scm.api.v2.resources;
+
+import sonia.scm.repository.Repository;
+import sonia.scm.repository.RepositoryPermissions;
+
+import javax.inject.Inject;
+
+// Mapstruct does not support parameterized (i.e. non-default) constructors. Thus, we need to use field injection.
+@SuppressWarnings("squid:S3306")
+public class RepositoryCollectionToDtoMapper extends BasicCollectionToDtoMapper<Repository, RepositoryDto> {
+
+  private final ResourceLinks resourceLinks;
+
+  @Inject
+  public RepositoryCollectionToDtoMapper(RepositoryToRepositoryDtoMapper repositoryToDtoMapper, ResourceLinks resourceLinks) {
+    super("repositories", repositoryToDtoMapper);
+    this.resourceLinks = resourceLinks;
+  }
+
+  @Override
+  String createCreateLink() {
+    return resourceLinks.repositoryCollection().create();
+  }
+
+  @Override
+  String createSelfLink() {
+    return resourceLinks.repositoryCollection().self();
+  }
+
+  @Override
+  boolean isCreatePermitted() {
+    return RepositoryPermissions.create().isPermitted();
+  }
+}

scm-webapp/src/main/java/sonia/scm/api/v2/resources/RepositoryRootResource.java

@@ -12,14 +12,21 @@ public class RepositoryRootResource {
   static final String REPOSITORIES_PATH_V2 = "v2/repositories/";
 
   private final Provider<RepositoryResource> repositoryResource;
+  private final Provider<RepositoryCollectionResource> repositoryCollectionResource;
 
   @Inject
-  public RepositoryRootResource(Provider<RepositoryResource> repositoryResource) {
+  public RepositoryRootResource(Provider<RepositoryResource> repositoryResource, Provider<RepositoryCollectionResource> repositoryCollectionResource) {
     this.repositoryResource = repositoryResource;
+    this.repositoryCollectionResource = repositoryCollectionResource;
   }
 
   @Path("{namespace}/{name}")
   public RepositoryResource getRepositoryResource() {
     return repositoryResource.get();
   }
+
+  @Path("")
+  public RepositoryCollectionResource getRepositoryCollectionResource() {
+    return repositoryCollectionResource.get();
+  }
 }

scm-webapp/src/main/java/sonia/scm/api/v2/resources/ResourceLinks.java

@@ -125,6 +125,26 @@ class ResourceLinks {
     }
   }
 
+  RepositoryCollectionLinks repositoryCollection() {
+    return new RepositoryCollectionLinks(uriInfoStore.get());
+  }
+
+  static class RepositoryCollectionLinks {
+    private final LinkBuilder collectionLinkBuilder;
+
+    RepositoryCollectionLinks(UriInfo uriInfo) {
+      collectionLinkBuilder = new LinkBuilder(uriInfo, RepositoryRootResource.class, RepositoryCollectionResource.class);
+    }
+
+    String self() {
+      return collectionLinkBuilder.method("getRepositoryCollectionResource").parameters().method("getAll").parameters().href();
+    }
+
+    String create() {
+      return collectionLinkBuilder.method("getRepositoryCollectionResource").parameters().method("create").parameters().href();
+    }
+  }
+
   public TagCollectionLinks tagCollection() {
     return new TagCollectionLinks(uriInfoStore.get());
   }