org.heigit.ohsome.ohsomeapi.inputprocessing.ResourceParameters Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of ohsome-api Show documentation

A public Web-RESTful-API for "ohsome" OpenStreetMap history data.

There is a newer version: 1.10.4

package org.heigit.ohsome.ohsomeapi.inputprocessing;

import java.util.Arrays;
import java.util.LinkedList;
import java.util.List;
import javax.servlet.http.HttpServletRequest;
import org.heigit.ohsome.ohsomeapi.executor.MetadataRequestExecutor;

public class ResourceParameters {
  private ResourceParameters() {
    throw new IllegalStateException("Utility class");
  }

  /**
   * Checks the resource of the request and gives back a list of available parameters for this
   * resource.
   *
   * 
   * Note that some resources don't use this method, but implement their own checks. One example for
   * this is the metadata request in
   * {@link MetadataRequestExecutor#executeGetMetadata(HttpServletRequest) executeGetMetadata}.
   * 
   * @return a list of of available parameters for the given resource.
   * @param servletRequest
   */
  public static List getResourceSpecificParams(HttpServletRequest servletRequest) {
    String uri = servletRequest.getRequestURI();
    List possibleParams = new LinkedList<>(Arrays.asList("bboxes", "bcircles", "bpolys",
        "types", "keys", "values", "timeout", "time", "showMetadata", "filter"));
    if (uri.contains("/count") || uri.contains("/length") || uri.contains("/area")
        || uri.contains("/perimeter")) {
      possibleParams.add("format");
    }
    if (uri.contains("/groupBy/tag")) {
      possibleParams.add("groupByKey");
      possibleParams.add("groupByValues");
      return possibleParams;
    } else if (uri.contains("/groupBy/key")) {
      possibleParams.add("groupByKeys");
      return possibleParams;
    } else if (uri.contains("/ratio")) {
      possibleParams.add("filter2");
      possibleParams.add("keys2");
      possibleParams.add("types2");
      possibleParams.add("values2");
      return possibleParams;
    } else if (uri.contains("/bbox") || uri.contains("/centroid") || uri.contains("/geometry")) {
      possibleParams.add("properties");
      possibleParams.add("clipGeometry");
      // removing deprecated params from newly implemented endpoint
      if (uri.contains("/contributions")) {
        possibleParams.remove("types");
        possibleParams.remove("keys");
        possibleParams.remove("values");
      }        
      return possibleParams;
    } else {
      return possibleParams;
    }
  }

  /**
   * Checks, if the request contains unexpected parameters for this resource.
   * 
   * @return a list of unexpected parameters
   * @param servletRequest
   * @param resourceParams
   */
  public static List checkUnexpectedParams(HttpServletRequest servletRequest,
      List resourceParams) {
    List unexpectedParams = new LinkedList<>();
    for (String param : servletRequest.getParameterMap().keySet()) {
      if (!resourceParams.contains(param)) {
        unexpectedParams.add(param);
      }
    }
    return unexpectedParams;
  }
}