基于spring-boot+java实现的一个云笔记系统源码

/* * Copyright (c) 2021, Otstar Lin ([email protected]). All Rights Reserved. */ package me.ixk.hoshi.common.result; import java.net.URI; import java.time.Instant; import java.time.ZonedDateTime; import java.util.Arrays; import java.util.LinkedHashSet; import java.util.List; import java.util.Set; import java.util.function.Consumer; import java.util.stream.Collectors; import org.jetbrains.annotations.NotNull; import org.jetbrains.annotations.Nullable; import org.springframework.context.support.DefaultMessageSourceResolvable; import org.springframework.data.domain.Page; import org.springframework.http.*; import org.springframework.util.Assert; import org.springframework.util.MultiValueMap; import org.springframework.util.ObjectUtils; import org.springframework.validation.BindException; import org.springframework.validation.BindingResult; /** * 统一响应（构造器） * <p> * 用于构造统一响应，可以设置 HttpHeader 或响应码，响应信息等等 * * @author Otstar Lin * @date 2021/5/17 下午 9:46 */ public class ApiResult<T> { /** * 响应状态码或者 Api 信息实体，必须不能为空 */ @NotNull private final Object status; /** * 响应信息，可以为空，若未设置则使用响应码对应的 {@link ApiMessage} 信息 */ @Nullable private final String message; /** * 响应头 */ private final HttpHeaders headers; /** * 响应数据 */ @Nullable private final T data; public ApiResult(@NotNull final ApiMessage status) { this(status, null); } public ApiResult(@NotNull final ApiMessage status, @Nullable final String message) { this(null, null, status, message); } public ApiResult(@Nullable final T data, @NotNull final ApiMessage status, @Nullable final String message) { this(data, null, status, message); } public ApiResult( final MultiValueMap<String, String> headers, final ApiMessage status, @Nullable final String message ) { this(null, headers, status, message); } public ApiResult( @Nullable final T data, @Nullable final MultiValueMap<String, String> headers, final ApiMessage status, @Nullable final String message ) { this(data, headers, (Object) status, message); } public ApiResult( @Nullable final T data, @Nullable final MultiValueMap<String, String> headers, final int rawStatus, @Nullable final String message ) { this(data, headers, (Object) rawStatus, message); } private ApiResult( @Nullable final T data, @Nullable final MultiValueMap<String, String> headers, @NotNull final Object status, @Nullable final String message ) { Assert.notNull(status, "Status 必须不为空"); this.status = status; this.message = message; this.data = data; this.headers = HttpHeaders.readOnlyHttpHeaders(headers != null ? headers : new HttpHeaders()); } /** * 获取 {@link ApiMessage} * * @return {@link ApiMessage} */ public ApiMessage getApiMessage() { if (this.status instanceof ApiMessage) { return (ApiMessage) this.status; } else { return ApiMessage.valueOf((Integer) this.status); } } /** * 获取状态码 * <p> * 若是 {@link ApiMessage} 则取出对应的状态码 {@link ApiMessage#value()} * <p> * 否则就是 {@link Integer} 类型的状态码，直接返回 * * @return 状态码 */ public int getStatus() { if (this.status instanceof ApiMessage) { return ((ApiMessage) this.status).value(); } else { return (Integer) this.status; } } /** * 获取响应信息 * <p> * 如果响应信息已设置，则返回设置的响应信息 * <p> * 如果没有设置则获取对应状态码对应的响应信息 * * @return 响应信息 */ public String getMessage() { return this.message == null ? this.getApiMessage().message() : this.message; } public HttpHeaders getHeaders() { return this.headers; } @Nullable public T getData() { return this.data; } public boolean hasData() { return (this.data != null); } @Override public boolean equals(@Nullable final Object other) { if (this == other) { return true; } if (other == null || other.getClass() != this.getClass()) { return false; } final ApiResult<?> otherEntity = (ApiResult<?>) other; return ( ObjectUtils.nullSafeEquals(this.headers, otherEntity.headers) && ObjectUtils.nullSafeEquals(this.data, otherEntity.data) && ObjectUtils.nullSafeEquals(this.status, otherEntity.status) ); } @Override public int hashCode() { return ( 29 * (ObjectUtils.nullSafeHashCode(this.headers) * 29 + ObjectUtils.nullSafeHashCode(this.data)) + ObjectUtils.nullSafeHashCode(this.status) ); } @Override public String toString() { final StringBuilder builder = new StringBuilder("<"); builder.append(this.status); if (this.status instanceof ApiMessage) { builder.append(' '); builder.append(((ApiMessage) this.status).message()); } builder.append(','); final T data = this.getData(); final HttpHeaders headers = this.getHeaders(); if (data != null) { builder.append(data); builder.append(','); } builder.append(headers); builder.append('>'); return builder.toString(); } /** * 转换为 {@link ApiEntity} * * @return ApiEntity */ public ApiEntity<T> toEntity() { return new ApiEntity<>(this.getStatus(), this.getMessage(), this.getData()); } // Static builder methods public static DataBuilder status(@NotNull final ApiMessage status) { Assert.notNull(status, "Status 必须不为空"); return new DefaultBuilder(status); } public static DataBuilder status(@NotNull final ApiMessage status, @Nullable final String message) { return status(status).message(message); } public static DataBuilder status(final int status) { return new DefaultBuilder(status); } public static DataBuilder status(final int status, @Nullable final String message) { return status(status).message(message); } public static DataBuilder status(@NotNull final HttpStatus status) { Assert.notNull(status, "Status 必须不为空"); return status(status.value()); } public static DataBuilder status(@NotNull final HttpStatus status, @Nullable final String message) { Assert.notNull(status, "Status 必须不为空"); return status(status).message(message); } public static DataBuilder ok() { return ok(null); } public static DataBuilder ok(@Nullable final String message) { return status(ApiMessage.OK, message); } public static <T> ApiResult<T> ok(@Nullable final T data) { return ok().data(data); } public static <T> ApiResult<T> ok(@Nullable final T data, @Nullable final String message) { return ok(message).data(data); } public static <T> ApiResult<ApiPage<T>> page(@NotNull final List<T> records) { return page(records, null); } public static <T> ApiResult<ApiPage<T>> page(@NotNull final List<T> records, @Nullable final String message) { Assert.notNull(records, "Records 必须不为空"); return page(new ApiPage<>(records), message); } public static <T> ApiResult<ApiPage<T>> page(@NotNull final Pag