TimeseriesRestImpl.java
package de.dlr.shepard.endpoints;
import java.io.IOException;
import java.io.InputStream;
import java.util.ArrayList;
import org.glassfish.jersey.media.multipart.FormDataContentDisposition;
import org.glassfish.jersey.media.multipart.FormDataParam;
import de.dlr.shepard.exceptions.InvalidRequestException;
import de.dlr.shepard.filters.Subscribable;
import de.dlr.shepard.influxDB.FillOption;
import de.dlr.shepard.influxDB.SingleValuedUnaryFunction;
import de.dlr.shepard.influxDB.Timeseries;
import de.dlr.shepard.influxDB.TimeseriesPayload;
import de.dlr.shepard.neo4Core.io.PermissionsIO;
import de.dlr.shepard.neo4Core.io.TimeseriesContainerIO;
import de.dlr.shepard.neo4Core.orderBy.ContainerAttributes;
import de.dlr.shepard.neo4Core.services.PermissionsService;
import de.dlr.shepard.neo4Core.services.TimeseriesContainerService;
import de.dlr.shepard.security.PermissionsUtil;
import de.dlr.shepard.util.Constants;
import de.dlr.shepard.util.QueryParamHelper;
import io.swagger.v3.oas.annotations.Parameter;
import jakarta.validation.Valid;
import jakarta.ws.rs.Consumes;
import jakarta.ws.rs.DELETE;
import jakarta.ws.rs.GET;
import jakarta.ws.rs.POST;
import jakarta.ws.rs.PUT;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.PathParam;
import jakarta.ws.rs.Produces;
import jakarta.ws.rs.QueryParam;
import jakarta.ws.rs.core.Context;
import jakarta.ws.rs.core.MediaType;
import jakarta.ws.rs.core.Response;
import jakarta.ws.rs.core.Response.Status;
import jakarta.ws.rs.core.SecurityContext;
@Consumes(MediaType.APPLICATION_JSON)
@Produces(MediaType.APPLICATION_JSON)
@Path(Constants.TIMESERIES)
public class TimeseriesRestImpl implements TimeseriesRest {
private TimeseriesContainerService timeseriesContainerService = new TimeseriesContainerService();
private PermissionsService permissionsService = new PermissionsService();
@Context
private SecurityContext securityContext;
@GET
@Override
public Response getAllTimeseriesContainers(@QueryParam(Constants.QP_NAME) String name,
@QueryParam(Constants.QP_PAGE) Integer page, @QueryParam(Constants.QP_SIZE) Integer size,
@QueryParam(Constants.QP_ORDER_BY_ATTRIBUTE) ContainerAttributes orderBy,
@QueryParam(Constants.QP_ORDER_DESC) Boolean orderDesc) {
var params = new QueryParamHelper();
if (name != null)
params = params.withName(name);
if (page != null && size != null)
params = params.withPageAndSize(page, size);
if (orderBy != null)
params = params.withOrderByAttribute(orderBy, orderDesc);
var containers = timeseriesContainerService.getAllContainers(params,
securityContext.getUserPrincipal().getName());
var result = new ArrayList<TimeseriesContainerIO>(containers.size());
for (var container : containers) {
result.add(new TimeseriesContainerIO(container));
}
return Response.ok(result).build();
}
@GET
@Path("/{" + Constants.TIMESERIES_CONTAINER_ID + "}")
@Override
public Response getTimeseriesContainer(@PathParam(Constants.TIMESERIES_CONTAINER_ID) long timeseriesId) {
var result = timeseriesContainerService.getContainer(timeseriesId);
return Response.ok(new TimeseriesContainerIO(result)).build();
}
@POST
@Override
public Response createTimeseriesContainer(TimeseriesContainerIO timeseriesContainer) {
var result = timeseriesContainerService.createContainer(timeseriesContainer,
securityContext.getUserPrincipal().getName());
return Response.ok(new TimeseriesContainerIO(result)).status(Status.CREATED).build();
}
@DELETE
@Path("/{" + Constants.TIMESERIES_CONTAINER_ID + "}")
@Subscribable
@Override
public Response deleteTimeseriesContainer(@PathParam(Constants.TIMESERIES_CONTAINER_ID) long timeseriesId) {
var result = timeseriesContainerService.deleteContainer(timeseriesId,
securityContext.getUserPrincipal().getName());
return result ? Response.status(Status.NO_CONTENT).build()
: Response.status(Status.INTERNAL_SERVER_ERROR).build();
}
@POST
@Path("/{" + Constants.TIMESERIES_CONTAINER_ID + "}/" + Constants.PAYLOAD)
@Subscribable
@Override
public Response createTimeseries(@PathParam(Constants.TIMESERIES_CONTAINER_ID) long timeseriesId,
TimeseriesPayload payload) {
var result = timeseriesContainerService.createTimeseries(timeseriesId, payload);
return result != null ? Response.status(Status.CREATED).entity(result).build()
: Response.status(Status.INTERNAL_SERVER_ERROR).build();
}
@GET
@Path("/{" + Constants.TIMESERIES_CONTAINER_ID + "}/" + Constants.AVAILABLE)
@Override
public Response getTimeseriesAvailable(@PathParam(Constants.TIMESERIES_CONTAINER_ID) long timeseriesContainerId) {
return Response.ok(timeseriesContainerService.getTimeseriesAvailable(timeseriesContainerId)).build();
}
@GET
@Path("/{" + Constants.TIMESERIES_CONTAINER_ID + "}/" + Constants.PAYLOAD)
@Override
public Response getTimeseries(@PathParam(Constants.TIMESERIES_CONTAINER_ID) long timeseriesContainerId,
@QueryParam(Constants.MEASUREMENT) @Parameter(required = true) String measurement,
@QueryParam(Constants.LOCATION) @Parameter(required = true) String location,
@QueryParam(Constants.DEVICE) @Parameter(required = true) String device,
@QueryParam(Constants.SYMBOLICNAME) @Parameter(required = true) String symbolicName,
@QueryParam(Constants.FIELD) @Parameter(required = true) String field,
@QueryParam(Constants.START) @Parameter(required = true) long start,
@QueryParam(Constants.END) @Parameter(required = true) long end,
@QueryParam(Constants.FUNCTION) SingleValuedUnaryFunction function,
@QueryParam(Constants.GROUP_BY) Long groupBy, @QueryParam(Constants.FILLOPTION) FillOption fillOption) {
if (measurement == null || location == null || device == null || symbolicName == null || field == null) {
throw new InvalidRequestException("Some query params are missing");
}
var timeseries = new Timeseries(measurement, device, location, symbolicName, field);
var result = timeseriesContainerService.getTimeseriesPayload(timeseriesContainerId, timeseries, start, end,
function, groupBy, fillOption);
return result != null ? Response.ok(result).build() : Response.status(Status.NOT_FOUND).build();
}
@GET
@Produces({ MediaType.APPLICATION_OCTET_STREAM, MediaType.APPLICATION_JSON })
@Path("/{" + Constants.TIMESERIES_CONTAINER_ID + "}/" + Constants.EXPORT)
@Override
public Response exportTimeseries(@PathParam(Constants.TIMESERIES_CONTAINER_ID) long timeseriesContainerId,
@QueryParam(Constants.MEASUREMENT) @Parameter(required = true) String measurement,
@QueryParam(Constants.LOCATION) @Parameter(required = true) String location,
@QueryParam(Constants.DEVICE) @Parameter(required = true) String device,
@QueryParam(Constants.SYMBOLICNAME) @Parameter(required = true) String symbolicName,
@QueryParam(Constants.FIELD) @Parameter(required = true) String field,
@QueryParam(Constants.START) @Parameter(required = true) long start,
@QueryParam(Constants.END) @Parameter(required = true) long end,
@QueryParam(Constants.FUNCTION) SingleValuedUnaryFunction function,
@QueryParam(Constants.GROUP_BY) Long groupBy, @QueryParam(Constants.FILLOPTION) FillOption fillOption)
throws IOException {
if (measurement == null || location == null || device == null || symbolicName == null || field == null) {
throw new InvalidRequestException("Some query params are missing");
}
var timeseries = new Timeseries(measurement, device, location, symbolicName, field);
var result = timeseriesContainerService.exportTimeseriesPayload(timeseriesContainerId, timeseries, start, end,
function, groupBy, fillOption);
return result != null
? Response.ok(result, MediaType.APPLICATION_OCTET_STREAM)
.header("Content-Disposition", "attachment; filename=\"timeseries-export.csv\"").build()
: Response.status(Status.NOT_FOUND).build();
}
@POST
@Consumes(MediaType.MULTIPART_FORM_DATA)
@Path("/{" + Constants.TIMESERIES_CONTAINER_ID + "}/" + Constants.IMPORT)
@Subscribable
@Override
public Response importTimeseries(@PathParam(Constants.TIMESERIES_CONTAINER_ID) long timeseriesId,
@FormDataParam(Constants.FILE) InputStream fileInputStream,
@FormDataParam(Constants.FILE) FormDataContentDisposition fileMetaData) throws IOException {
var result = timeseriesContainerService.importTimeseries(timeseriesId, fileInputStream);
return result ? Response.ok().build() : Response.status(Status.INTERNAL_SERVER_ERROR).build();
}
@GET
@Path("/{" + Constants.TIMESERIES_CONTAINER_ID + "}/" + Constants.PERMISSIONS)
@Override
public Response getTimeseriesPermissions(@PathParam(Constants.TIMESERIES_CONTAINER_ID) long timeseriesContainerId) {
var perms = permissionsService.getPermissionsByEntity(timeseriesContainerId);
return perms != null ? Response.ok(new PermissionsIO(perms)).build()
: Response.status(Status.NOT_FOUND).build();
}
@PUT
@Path("/{" + Constants.TIMESERIES_CONTAINER_ID + "}/" + Constants.PERMISSIONS)
@Override
public Response editTimeseriesPermissions(@PathParam(Constants.TIMESERIES_CONTAINER_ID) long timeseriesContainerId,
@Valid PermissionsIO permissions) {
var perms = permissionsService.updatePermissions(permissions, timeseriesContainerId);
return perms != null ? Response.ok(new PermissionsIO(perms)).build()
: Response.status(Status.NOT_FOUND).build();
}
@GET
@Path("/{" + Constants.TIMESERIES_CONTAINER_ID + "}/" + Constants.ROLES)
@Override
public Response getTimeseriesRoles(@PathParam(Constants.TIMESERIES_CONTAINER_ID) long timeseriesContainerId) {
var roles = new PermissionsUtil().getRoles(timeseriesContainerId, securityContext.getUserPrincipal().getName());
return roles != null ? Response.ok(roles).build() : Response.status(Status.NOT_FOUND).build();
}
}