PhotoServlet.java

package server.restful.servlets;

import com.beust.jcommander.Parameters;
import jakarta.servlet.AsyncContext;
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 jsidplay2.Photos;
import libsidplay.sidtune.SidTune;
import libsidplay.sidtune.SidTuneError;
import libsidplay.sidtune.SidTuneInfo;
import server.restful.common.JSIDPlay2Servlet;
import server.restful.common.async.DefaultThreadFactory;
import server.restful.common.async.HttpAsyncContextRunnable;
import server.restful.common.parameter.ServletParameterParser;
import server.restful.common.parameter.requestpath.FileRequestPathServletParameters;

import java.io.ByteArrayInputStream;
import java.io.File;
import java.io.IOException;
import java.util.Iterator;
import java.util.Optional;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;

import static server.restful.JSIDPlay2Server.*;
import static server.restful.common.ContentTypeAndFileExtensions.MIME_TYPE_JPG;
import static server.restful.common.IServletSystemProperties.PhotoServlet.MAX_PHOTO_IN_PARALLEL;
import static server.restful.common.IServletSystemProperties.PhotoServlet.PHOTO_ASYNC_TIMEOUT;
import static server.restful.common.ServletUtil.error;

@WebServlet(name = "PhotoServlet", displayName = "PhotoServlet", asyncSupported = true, urlPatterns = CONTEXT_ROOT_SERVLET
        + "/photo/*", description = "Get photo of composer")
@ServletSecurity(value = @HttpConstraint(rolesAllowed = {ROLE_USER, ROLE_ADMIN}))
public class PhotoServlet extends JSIDPlay2Servlet {

    @Parameters(resourceBundle = "server.restful.servlets.PhotoServletParameters")
    public static class PhotoServletParameters extends FileRequestPathServletParameters {

    }

    private ExecutorService executorService;

    @Override
    public void init() {
        executorService = Executors.newFixedThreadPool(MAX_PHOTO_IN_PARALLEL, new DefaultThreadFactory("/photo"));
    }

    @Override
    public void destroy() {
        executorService.shutdown();
    }

    /**
     * Get a photo of the composer.
     * <p>
     * E.g.
     * {@code http://haendel.ddns.net:8080/jsidplay2service/JSIDPlay2REST/photo/C64Music/MUSICIANS/D/DRAX/Acid.sid }
     */
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response) {

        AsyncContext asyncContext = request.startAsync(request, response);
        asyncContext.setTimeout(PHOTO_ASYNC_TIMEOUT);

        executorService.execute(new HttpAsyncContextRunnable(asyncContext, getServletContext()) {

            public void run(HttpServletRequest request, HttpServletResponse response) {
                try {
                    final PhotoServletParameters servletParameters = new PhotoServletParameters();

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

                    final File file = servletParameters.fetchFile(configuration, directoryProperties, parser,
                            hasAdminAccess(request));
                    if (file == null || servletParameters.getHelp() || parser.hasException()) {
                        parser.usage();
                        return;
                    }
                    byte[] photo = getPhoto(file);

                    if (!isComplete()) {
                        response.setContentLength(photo.length);
                        setOutput(MIME_TYPE_JPG, response, new ByteArrayInputStream(photo));
                    }
                } catch (Throwable t) {
                    error(getServletContext(), t, parentThread);
                    if (!isComplete()) {
                        response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
                        setOutput(response, t);
                    }
                }
            }
        });
    }

    private byte[] getPhoto(File file) throws IOException, SidTuneError {
        String authorDirectory = getCollectionName(file);

        if (!authorDirectory.isEmpty()) {
            authorDirectory = new File(authorDirectory).getParent();
        }

        String author = null;
        if (file != null) {
            SidTuneInfo info = SidTune.load(file).getInfo();
            if (info.getInfoString().size() > 1) {
                Iterator<String> iterator = info.getInfoString().iterator();
                /* title = */
                iterator.next();
                author = iterator.next();
            }
        }
        return Optional.ofNullable(Photos.getPhoto(authorDirectory, author)).orElse(new byte[0]);
    }

}