pl.allegro.tech.hermes.management.api.SchemaEndpoint Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of hermes-management Show documentation
Fast and reliable message broker built on top of Kafka.
There is a newer version: 2.8.0
package pl.allegro.tech.hermes.management.api;

import static jakarta.ws.rs.core.MediaType.APPLICATION_JSON;
import static pl.allegro.tech.hermes.api.TopicName.fromQualifiedName;

import io.swagger.annotations.ApiOperation;
import jakarta.annotation.security.RolesAllowed;
import jakarta.ws.rs.Consumes;
import jakarta.ws.rs.DELETE;
import jakarta.ws.rs.DefaultValue;
import jakarta.ws.rs.GET;
import jakarta.ws.rs.HttpMethod;
import jakarta.ws.rs.POST;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.PathParam;
import jakarta.ws.rs.Produces;
import jakarta.ws.rs.QueryParam;
import jakarta.ws.rs.container.ContainerRequestContext;
import jakarta.ws.rs.core.Context;
import jakarta.ws.rs.core.Response;
import java.util.Optional;
import org.springframework.beans.factory.annotation.Autowired;
import pl.allegro.tech.hermes.api.RawSchema;
import pl.allegro.tech.hermes.api.Topic;
import pl.allegro.tech.hermes.management.api.auth.HermesSecurityAwareRequestUser;
import pl.allegro.tech.hermes.management.api.auth.Roles;
import pl.allegro.tech.hermes.management.domain.auth.RequestUser;
import pl.allegro.tech.hermes.management.domain.topic.TopicService;
import pl.allegro.tech.hermes.management.domain.topic.schema.SchemaService;
import pl.allegro.tech.hermes.schema.SchemaId;
import pl.allegro.tech.hermes.schema.SchemaVersion;

@Path("topics/{topicName}/schema")
public class SchemaEndpoint {

  private final SchemaService schemaService;
  private final TopicService topicService;

  @Autowired
  public SchemaEndpoint(SchemaService schemaService, TopicService topicService) {
    this.schemaService = schemaService;
    this.topicService = topicService;
  }

  @GET
  @Produces(APPLICATION_JSON)
  @ApiOperation(value = "Get schema", httpMethod = HttpMethod.GET)
  public Response get(@PathParam("topicName") String qualifiedTopicName) {
    Optional rawSchema = schemaService.getSchema(qualifiedTopicName);
    return rawSchema
        .map(RawSchema::value)
        .map(v -> Response.ok(v).build())
        .orElse(Response.noContent().build());
  }

  @GET
  @Path("versions/{version}")
  @Produces(APPLICATION_JSON)
  @ApiOperation(value = "Get schema", httpMethod = HttpMethod.GET)
  public Response getByVersion(
      @PathParam("topicName") String qualifiedTopicName, @PathParam("version") int version) {
    Optional rawSchema =
        schemaService.getSchema(qualifiedTopicName, SchemaVersion.valueOf(version));
    return rawSchema
        .map(RawSchema::value)
        .map(v -> Response.ok(v).build())
        .orElse(Response.noContent().build());
  }

  @GET
  @Path("ids/{id}")
  @Produces(APPLICATION_JSON)
  @ApiOperation(value = "Get schema", httpMethod = HttpMethod.GET)
  public Response getById(
      @PathParam("topicName") String qualifiedTopicName, @PathParam("id") int id) {
    Optional rawSchema =
        schemaService.getSchema(qualifiedTopicName, SchemaId.valueOf(id));
    return rawSchema
        .map(RawSchema::value)
        .map(v -> Response.ok(v).build())
        .orElse(Response.noContent().build());
  }

  @POST
  @Consumes(APPLICATION_JSON)
  @RolesAllowed({Roles.TOPIC_OWNER, Roles.ADMIN})
  @ApiOperation(value = "Save schema", httpMethod = HttpMethod.POST)
  public Response save(
      @PathParam("topicName") String qualifiedTopicName,
      @DefaultValue("true") @QueryParam(value = "validate") boolean validate,
      @Context ContainerRequestContext requestContext,
      String schema) {
    Topic topic = topicService.getTopicDetails(fromQualifiedName(qualifiedTopicName));
    RequestUser user = new HermesSecurityAwareRequestUser(requestContext);
    schemaService.registerSchema(topic, schema, validate);
    notifyFrontendSchemaChanged(qualifiedTopicName, user);
    return Response.status(Response.Status.CREATED).build();
  }

  private void notifyFrontendSchemaChanged(String qualifiedTopicName, RequestUser changedBy) {
    topicService.scheduleTouchTopic(fromQualifiedName(qualifiedTopicName), changedBy);
  }

  @DELETE
  @RolesAllowed({Roles.TOPIC_OWNER, Roles.ADMIN})
  @ApiOperation(value = "Delete schema", httpMethod = HttpMethod.DELETE)
  public Response delete(@PathParam("topicName") String qualifiedTopicName) {
    schemaService.deleteAllSchemaVersions(qualifiedTopicName);
    return Response.status(Response.Status.OK).build();
  }
}