STILServlet.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 libsidplay.sidtune.SidTuneError;
import libsidutils.stil.STIL.STILEntry;
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.File;
import java.io.IOException;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import static server.restful.JSIDPlay2Server.*;
import static server.restful.common.ContentTypeAndFileExtensions.MIME_TYPE_JSON;
import static server.restful.common.IServletSystemProperties.StilServlet.MAX_STIL_IN_PARALLEL;
import static server.restful.common.IServletSystemProperties.StilServlet.STIL_ASYNC_TIMEOUT;
import static server.restful.common.ServletUtil.error;
@WebServlet(name = "STILServlet", displayName = "STILServlet", asyncSupported = true, urlPatterns = CONTEXT_ROOT_SERVLET
+ "/stil/*", description = "Get SID tune information list (STIL)")
@ServletSecurity(value = @HttpConstraint(rolesAllowed = {ROLE_USER, ROLE_ADMIN}))
public class STILServlet extends JSIDPlay2Servlet {
@Parameters(resourceBundle = "server.restful.servlets.STILServletParameters")
public static class STILServletParameters extends FileRequestPathServletParameters {
}
private ExecutorService executorService;
@Override
public void init() {
executorService = Executors.newFixedThreadPool(MAX_STIL_IN_PARALLEL, new DefaultThreadFactory("/stil"));
}
@Override
public void destroy() {
executorService.shutdown();
}
/**
* Get SID tune information list (STIL).
* <p>
* E.g.
* {@code http://haendel.ddns.net:8080/jsidplay2service/JSIDPlay2REST/stil/C64Music/MUSICIANS/D/DRAX/Acid.sid }
*/
@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response) {
AsyncContext asyncContext = request.startAsync(request, response);
asyncContext.setTimeout(STIL_ASYNC_TIMEOUT);
executorService.execute(new HttpAsyncContextRunnable(asyncContext, getServletContext()) {
public void run(HttpServletRequest request, HttpServletResponse response) {
try {
final STILServletParameters servletParameters = new STILServletParameters();
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;
}
STILEntry stilEntry = createSTIL(file);
if (!isComplete()) {
setOutput(MIME_TYPE_JSON, response, stilEntry);
}
} catch (Throwable t) {
error(getServletContext(), t, parentThread);
if (!isComplete()) {
response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
setOutput(response, t);
}
}
}
});
}
private STILEntry createSTIL(File file) throws IOException, SidTuneError {
return stil != null ? stil.getSTILEntry(getCollectionName(file)) : null;
}
}