PressKeyServlet.java

package server.restful.servlets.rtmp;

import com.beust.jcommander.Parameter;
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 libsidplay.components.keyboard.KeyTableEntry;
import server.restful.common.JSIDPlay2Servlet;
import server.restful.common.parameter.ServletParameterParser;
import server.restful.common.parameter.requestparam.VideoRequestParamServletParameters;

import java.util.UUID;

import static java.lang.Integer.MIN_VALUE;
import static server.restful.JSIDPlay2Server.*;
import static server.restful.common.ServletUtil.error;
import static server.restful.common.ServletUtil.info;
import static server.restful.common.rtmp.PlayerCleanupTimerTask.update;

@WebServlet(name = "PressKeyServlet", displayName = "PressKeyServlet", urlPatterns = CONTEXT_ROOT_STATIC
        + "/press_key", description = "Press key for emulator running as a RTMP live video stream")
@ServletSecurity(value = @HttpConstraint(rolesAllowed = {ROLE_USER, ROLE_ADMIN}))
public class PressKeyServlet extends JSIDPlay2Servlet {

    @SuppressWarnings("unused")
    @Parameters(resourceBundle = "server.restful.servlets.rtmp.PressKeyServletParameters")
    public static class PressKeyServletParameters extends VideoRequestParamServletParameters {

        @Parameter(names = {"--type"}, descriptionKey = "TYPE", order = MIN_VALUE + 2)
        private KeyTableEntry type;

        @Parameter(names = {"--press"}, descriptionKey = "PRESS", order = MIN_VALUE + 3)
        private KeyTableEntry press;

        @Parameter(names = {"--release"}, descriptionKey = "RELEASE", order = MIN_VALUE + 4)
        private KeyTableEntry release;

    }

    /**
     * Press a key for Player running as a RTMP live video stream.
     * <p>
     * E.g. {@code http://haendel.ddns.net:8080/static/press_key?name=<uuid>&type=KEY }
     *
     */
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response) {
        try {
            final PressKeyServletParameters servletParameters = new PressKeyServletParameters();

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

            if (servletParameters.getHelp() || parser.hasException()) {
                parser.usage();
                return;
            }
            UUID uuid = servletParameters.getUuid();

            if (servletParameters.type != null) {
                info(getServletContext(),
                        String.format("typeKey: RTMP stream of: %s, key=%s", uuid, servletParameters.type.name()));
                update(uuid, rtmpPlayerWithStatus -> rtmpPlayerWithStatus.typeKey(servletParameters.type));

            } else if (servletParameters.press != null) {
                info(getServletContext(),
                        String.format("pressKey: RTMP stream of: %s, key=%s", uuid, servletParameters.press.name()));
                update(uuid, rtmpPlayerWithStatus -> rtmpPlayerWithStatus.pressKey(servletParameters.press));

            } else if (servletParameters.release != null) {
                info(getServletContext(), String.format("releaseKey: RTMP stream of: %s, key=%s", uuid,
                        servletParameters.release.name()));
                update(uuid, rtmpPlayerWithStatus -> rtmpPlayerWithStatus.releaseKey(servletParameters.release));
            }
        } catch (Throwable t) {
            response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
            error(getServletContext(), t);
            setOutput(response, t);
        }
    }

}