Provide sort query param for sorting attachment (#2705)

#### What type of PR is this?

/kind feature
/area core
/milestone 2.0

#### What this PR does / why we need it:

Provide sort query param for sorting attachment. By default, we use creationTimestamp(desc) to sort the attachments.

Below is an example to sort with creationTimestamp(desc) and size(asc):

```bash
curl -X 'GET' \
  'http://localhost:8090/apis/api.console.halo.run/v1alpha1/attachments?sort=creationTimestamp%2Cdesc&sort=size%2Casc' \
  -H 'accept: */*'
```

#### Which issue(s) this PR fixes:

Fixes https://github.com/halo-dev/halo/issues/2627

#### Does this PR introduce a user-facing change?

```release-note
附件列表支持排序
```
pull/2712/head
John Niang 2022-11-16 18:10:19 +08:00 committed by GitHub
parent 0c8ccecdf3
commit f1ac4e3740
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 191 additions and 7 deletions

View File

@ -1,5 +1,6 @@
package run.halo.app.core.extension.attachment.endpoint;
import static java.util.Comparator.comparing;
import static org.springdoc.core.fn.builders.apiresponse.Builder.responseBuilder;
import static org.springdoc.core.fn.builders.content.Builder.contentBuilder;
import static org.springdoc.core.fn.builders.schema.Builder.schemaBuilder;
@ -9,12 +10,17 @@ import static run.halo.app.extension.ListResult.generateGenericClass;
import static run.halo.app.extension.router.QueryParamBuildUtil.buildParametersFromType;
import static run.halo.app.extension.router.selector.SelectorUtil.labelAndFieldSelectorToPredicate;
import io.swagger.v3.oas.annotations.media.ArraySchema;
import io.swagger.v3.oas.annotations.media.Schema;
import java.util.ArrayList;
import java.util.Comparator;
import java.util.List;
import java.util.Optional;
import java.util.function.Predicate;
import lombok.extern.slf4j.Slf4j;
import org.springdoc.core.fn.builders.requestbody.Builder;
import org.springdoc.webflux.core.fn.SpringdocRouteBuilder;
import org.springframework.data.domain.Sort;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.http.codec.multipart.FilePart;
@ -30,6 +36,7 @@ import org.springframework.web.reactive.function.server.RouterFunction;
import org.springframework.web.reactive.function.server.ServerRequest;
import org.springframework.web.reactive.function.server.ServerResponse;
import org.springframework.web.server.ResponseStatusException;
import org.springframework.web.server.ServerWebExchange;
import org.springframework.web.server.ServerWebInputException;
import reactor.core.publisher.Flux;
import reactor.core.publisher.Mono;
@ -37,6 +44,8 @@ import run.halo.app.core.extension.attachment.Attachment;
import run.halo.app.core.extension.attachment.Policy;
import run.halo.app.core.extension.attachment.endpoint.AttachmentHandler.UploadOption;
import run.halo.app.core.extension.endpoint.CustomEndpoint;
import run.halo.app.core.extension.endpoint.SortResolver;
import run.halo.app.extension.Comparators;
import run.halo.app.extension.ConfigMap;
import run.halo.app.extension.ReactiveExtensionClient;
import run.halo.app.extension.Ref;
@ -139,8 +148,9 @@ public class AttachmentEndpoint implements CustomEndpoint {
}
Mono<ServerResponse> search(ServerRequest request) {
var searchRequest = new SearchRequest(request.queryParams());
return client.list(Attachment.class, searchRequest.toPredicate(), null,
var searchRequest = new SearchRequest(request);
return client.list(Attachment.class,
searchRequest.toPredicate(), searchRequest.toComparator(),
searchRequest.getPage(), searchRequest.getSize())
.flatMap(listResult -> ServerResponse.ok()
.contentType(MediaType.APPLICATION_JSON)
@ -161,12 +171,24 @@ public class AttachmentEndpoint implements CustomEndpoint {
@Schema(description = "Name of user who uploaded the attachment")
Optional<String> getUploadedBy();
@ArraySchema(uniqueItems = true,
arraySchema = @Schema(name = "sort",
description = "Sort property and direction of the list result. Supported fields: "
+ "creationTimestamp, size"),
schema = @Schema(description = "like field,asc or field,desc",
implementation = String.class,
example = "creationTimestamp,desc"))
Sort getSort();
}
public static class SearchRequest extends QueryListRequest implements ISearchRequest {
public SearchRequest(MultiValueMap<String, String> queryParams) {
super(queryParams);
private final ServerWebExchange exchange;
public SearchRequest(ServerRequest request) {
super(request.queryParams());
this.exchange = request.exchange();
}
@Override
@ -193,6 +215,11 @@ public class AttachmentEndpoint implements CustomEndpoint {
.filter(StringUtils::hasText);
}
@Override
public Sort getSort() {
return SortResolver.defaultInstance.resolve(exchange);
}
public Predicate<Attachment> toPredicate() {
var predicate = (Predicate<Attachment>) (attachment) -> getDisplayName()
.map(displayNameInParam -> {
@ -222,6 +249,37 @@ public class AttachmentEndpoint implements CustomEndpoint {
return predicate.and(selectorPredicate);
}
public Comparator<Attachment> toComparator() {
var sort = getSort();
List<Comparator<Attachment>> comparators = new ArrayList<>();
var creationOrder = sort.getOrderFor("creationTimestamp");
if (creationOrder != null) {
Comparator<Attachment> comparator = comparing(
attachment -> attachment.getMetadata().getCreationTimestamp());
if (creationOrder.isDescending()) {
comparator = comparator.reversed();
}
comparators.add(comparator);
}
var sizeOrder = sort.getOrderFor("size");
if (sizeOrder != null) {
Comparator<Attachment> comparator =
comparing(attachment -> attachment.getSpec().getSize());
if (sizeOrder.isDescending()) {
comparator = comparator.reversed();
}
comparators.add(comparator);
}
// add default comparator
comparators.add(Comparators.compareCreationTimestamp(false));
comparators.add(Comparators.compareName(true));
return comparators.stream()
.reduce(Comparator::thenComparing)
.orElse(null);
}
}
public interface IUploadRequest {

View File

@ -22,7 +22,9 @@ import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.time.Duration;
import java.util.ArrayList;
import java.util.Comparator;
import java.util.List;
import java.util.Objects;
import java.util.concurrent.atomic.AtomicReference;
import java.util.function.Predicate;
@ -47,6 +49,7 @@ import reactor.core.publisher.Mono;
import reactor.core.scheduler.Schedulers;
import reactor.util.retry.Retry;
import run.halo.app.core.extension.Plugin;
import run.halo.app.extension.Comparators;
import run.halo.app.extension.ReactiveExtensionClient;
import run.halo.app.extension.router.IListRequest.QueryListRequest;
import run.halo.app.infra.utils.FileUtils;
@ -243,14 +246,20 @@ public class PluginEndpoint implements CustomEndpoint {
public Comparator<Plugin> toComparator() {
var sort = getSort();
var ctOrder = sort.getOrderFor("creationTimestamp");
Comparator<Plugin> comparator = null;
List<Comparator<Plugin>> comparators = new ArrayList<>();
if (ctOrder != null) {
comparator = comparing(plugin -> plugin.getMetadata().getCreationTimestamp());
Comparator<Plugin> comparator =
comparing(plugin -> plugin.getMetadata().getCreationTimestamp());
if (ctOrder.isDescending()) {
comparator = comparator.reversed();
}
comparators.add(comparator);
}
return comparator;
comparators.add(Comparators.compareCreationTimestamp(false));
comparators.add(Comparators.compareName(true));
return comparators.stream()
.reduce(Comparator::thenComparing)
.orElse(null);
}
}

View File

@ -0,0 +1,20 @@
package run.halo.app.extension;
import java.time.Instant;
import java.util.Comparator;
public enum Comparators {
;
public static <E extends Extension> Comparator<E> compareCreationTimestamp(boolean asc) {
var comparator =
Comparator.<E, Instant>comparing(e -> e.getMetadata().getCreationTimestamp());
return asc ? comparator : comparator.reversed();
}
public static <E extends Extension> Comparator<E> compareName(boolean asc) {
var comparator = Comparator.<E, String>comparing(e -> e.getMetadata().getName());
return asc ? comparator : comparator.reversed();
}
}

View File

@ -0,0 +1,97 @@
package run.halo.app.extension;
import static org.junit.jupiter.api.Assertions.assertEquals;
import java.time.Instant;
import java.util.ArrayList;
import java.util.List;
import org.junit.jupiter.api.Nested;
import org.junit.jupiter.api.Test;
class ComparatorsTest {
@Nested
class CompareCreationTimestamp {
FakeExtension createFake(String name, Instant creationTimestamp) {
var metadata = new Metadata();
metadata.setName(name);
metadata.setCreationTimestamp(creationTimestamp);
var fake = new FakeExtension();
fake.setMetadata(metadata);
return fake;
}
@Test
void desc() {
var comparator = Comparators.compareCreationTimestamp(false);
var now = Instant.now();
var before = now.minusMillis(1);
var after = now.plusMillis(1);
var fakeNow = createFake("now", now);
var fakeBefore = createFake("before", before);
var fakeAfter = createFake("after", after);
var sortedFakes = new ArrayList<>(List.of(fakeNow, fakeAfter, fakeBefore));
sortedFakes.sort(comparator);
assertEquals(List.of(fakeAfter, fakeNow, fakeBefore), sortedFakes);
}
@Test
void asc() {
var comparator = Comparators.compareCreationTimestamp(true);
var now = Instant.now();
var before = now.minusMillis(1);
var after = now.plusMillis(1);
var fakeNow = createFake("now", now);
var fakeBefore = createFake("before", before);
var fakeAfter = createFake("after", after);
var sortedFakes = new ArrayList<>(List.of(fakeNow, fakeAfter, fakeBefore));
sortedFakes.sort(comparator);
assertEquals(List.of(fakeBefore, fakeNow, fakeAfter), sortedFakes);
}
}
@Nested
class CompareName {
FakeExtension createFake(String name) {
var metadata = new Metadata();
metadata.setName(name);
var fake = new FakeExtension();
fake.setMetadata(metadata);
return fake;
}
@Test
void desc() {
var comparator = Comparators.compareName(false);
var fake01 = createFake("fake01");
var fake02 = createFake("fake02");
var fake03 = createFake("fake03");
var sortedFakes = new ArrayList<>(List.of(fake02, fake01, fake03));
sortedFakes.sort(comparator);
assertEquals(List.of(fake03, fake02, fake01), sortedFakes);
}
@Test
void asc() {
var comparator = Comparators.compareName(true);
var fake01 = createFake("fake01");
var fake02 = createFake("fake02");
var fake03 = createFake("fake03");
var sortedFakes = new ArrayList<>(List.of(fake02, fake03, fake01));
sortedFakes.sort(comparator);
assertEquals(List.of(fake01, fake02, fake03), sortedFakes);
}
}
}