Assembly64Servlet.java

package server.restful.servlets;

import com.beust.jcommander.Parameter;
import com.beust.jcommander.ParameterException;
import com.beust.jcommander.Parameters;
import jakarta.servlet.annotation.HttpConstraint;
import jakarta.servlet.annotation.ServletSecurity;
import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import server.restful.common.JSIDPlay2Servlet;
import server.restful.common.parameter.ServletParameterParser;
import server.restful.common.parameter.UsageParameter;
import ui.assembly64.Assembly64Client;

import java.io.IOException;
import java.util.ResourceBundle;

import static java.lang.Integer.MIN_VALUE;
import static server.restful.JSIDPlay2Server.*;
import static server.restful.common.ContentTypeAndFileExtensions.MIME_TYPE_JSON;
import static server.restful.common.ServletUtil.error;

@WebServlet(name = "Assembly64Servlet", displayName = "Assembly64Servlet", urlPatterns = CONTEXT_ROOT_SERVLET
        + "/assembly64/*", description = "Browse Assembly64 public servers")
@ServletSecurity(value = @HttpConstraint(rolesAllowed = {ROLE_USER, ROLE_ADMIN}))
public class Assembly64Servlet extends JSIDPlay2Servlet {

    @SuppressWarnings("unused")
    @Parameters(resourceBundle = "server.restful.servlets.Assembly64ServletParameters")
    public static class Assembly64ServletParameters extends UsageParameter {

        private Integer serverId;

        public Integer getServerId() {
            return serverId;
        }

        @Parameter(names = {"--serverId"}, descriptionKey = "SERVER_ID", order = MIN_VALUE + 1)
        public void setServerId(Integer serverId) {
            this.serverId = serverId;
        }

        private String itemId;

        public String getItemId() {
            return itemId;
        }

        @Parameter(names = {"--itemId"}, descriptionKey = "ITEM_ID", order = MIN_VALUE + 2)
        public void setItemId(String itemId) {
            this.itemId = itemId;
        }

        private String categoryId;

        public String getCategoryId() {
            return categoryId;
        }

        @Parameter(names = {"--categoryId"}, descriptionKey = "CATEGORY_ID", order = MIN_VALUE + 3)
        public void setCategoryId(String categoryId) {
            this.categoryId = categoryId;
        }

        private String query;

        public String getQuery() {
            return query;
        }

        @Parameter(names = {"--query"}, descriptionKey = "QUERY", order = MIN_VALUE + 4)
        public void setQuery(String query) {
            this.query = query;
        }

        private String operation;

        public String getOperation() {
            return operation;
        }

        @Parameter(descriptionKey = "OPERATION", required = true)
        public void setOperation(String operation) {
            this.operation = operation;
        }

        public void validate(ServletParameterParser parser) {
            if (getHelp() || parser.hasException()) {
                return;
            }
            ResourceBundle bundle = ResourceBundle.getBundle("server.restful.servlets.Assembly64ServletParameters");
            switch (getOperation()) {
                case "/servers", "/presets":
                    break;
                case "/search":
                    if (getQuery() == null || getQuery().isBlank()) {
                        parser.setException(new ParameterException(bundle.getString("QUERY_REQUIRED")));
                    }
                    break;
                case "/entries":
                    if (getItemId() == null || getItemId().isBlank()
                            || getCategoryId() == null || getCategoryId().isBlank()) {
                        parser.setException(new ParameterException(bundle.getString("RELEASE_REQUIRED")));
                    }
                    break;
                default:
                    parser.setException(new ParameterException(bundle.getString("UNKNOWN_OPERATION")));
                    break;
            }
        }
    }

    /**
     * Browse registered Assembly64 servers through the same origin, including HTTP-only homeservers.
     * <p>
     * E.g. {@code http://haendel.ddns.net:8080/jsidplay2service/JSIDPlay2REST/assembly64/servers }
     */
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response) {
        try {
            final Assembly64ServletParameters servletParameters = new Assembly64ServletParameters();

            ServletParameterParser parser = new ServletParameterParser(request, response, servletParameters);
            servletParameters.validate(parser);

            if (servletParameters.getHelp() || parser.hasException()) {
                parser.usage();
                return;
            }
            if ("/servers".equals(servletParameters.getOperation())) {
                setOutput(MIME_TYPE_JSON, response, Assembly64Client.getServers(configuration, true, request.isUserInRole(ROLE_ADMIN)));
                return;
            }
            Assembly64Client client = new Assembly64Client(configuration, servletParameters.getServerId(), request.isUserInRole(ROLE_ADMIN));
            Object result = switch (servletParameters.getOperation()) {
                case "/presets" -> client.getPresets();
                case "/search" -> client.search(servletParameters.getQuery(), 0, 200);
                case "/entries" -> client.entries(servletParameters.getItemId(), servletParameters.getCategoryId());
                default -> throw new IllegalStateException(servletParameters.getOperation());
            };
            setOutput(MIME_TYPE_JSON, response, result);

        } catch (IOException e) {
            response.setStatus(HttpServletResponse.SC_BAD_GATEWAY);
            error(getServletContext(), e);
            setOutput(response, e);
        } catch (Throwable t) {
            response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
            error(getServletContext(), t);
            setOutput(response, t);
        }
    }
}