Package com.inductiveautomation.ignition.gateway.dataroutes

Interface RouteGroup.RouteMounter

Enclosing interface:
RouteGroup
public static interface RouteGroup.RouteMounter

  • Method Details

    • method

      RouteGroup.RouteMounter method(HttpMethod method)
      The HTTP method that triggers this route. Default is GET

    • type

      RouteGroup.RouteMounter type(String contentType)
      The content type of the response. Default is "text/plain"

    • handler

      RouteGroup.RouteMounter handler(RouteHandler handler)
      The handler that fetches the information from this route.

    • renderer

      RouteGroup.RouteMounter renderer(ResponseRenderer renderer)
      An optional renderer that will transform the model result of the RouteHandler into a body string

    • restrict

      RouteGroup.RouteMounter restrict(RouteAccessControl accessControl)
      An optional access control object that can require security for this route

    • concurrency

      RouteGroup.RouteMounter concurrency(int concurrencyLimit, int waitTime)
      Sets the maximum number of concurrent instances of this route that may be handled at one time. Additional incoming requests will receive an HTTP 503. Default setting is count=5, wait=2000ms
      Parameters:
      concurrencyLimit - Number of concurrent instances allowed to be executing at a time
      waitTime - Amount of time, in milliseconds, to wait for a slot to become available before a 503

    • cache

      default RouteGroup.RouteMounter cache(long time, TimeUnit timeUnit)
      Enables caching. This version assumes that the route does not look at any arguments (i.e. the route's return value does not depend on any arguments, and so only a single value needs to be cached.)
      Parameters:
      time - Amount of time for items in the cache to be held. Not a guarantee, as values will be soft.
      timeUnit - unit for the time argument.

    • cache

      RouteGroup.RouteMounter cache(long time, TimeUnit timeUnit, RouteGroup.CacheKeyGen keyGen)
      Enables caching. This version takes a CacheKeyGen, which should calculate a hashable key representing the set of params that make each request unique so that cached values can be cached based on keys. Consider using something like Multikey for this purpose.

    • nocache

      RouteGroup.RouteMounter nocache()
      Will set the `Cache-Control: no-cache, no-store` header on the response. Will also set the `Pragma: no-cache` header on the response for HTTP/1.0 backwards-compatibility.

    • gzip

      RouteGroup.RouteMounter gzip()
      Delegates to gzip(boolean) with a param of false

    • gzip

      RouteGroup.RouteMounter gzip(boolean withContentLength)
      Will encode the result in a gzip output stream if the incoming request specifies that it accepts gzip in the Accept-Encoding header.
      Parameters:
      withContentLength - if true, the response will include the Content-Length header with the length of the gzipped response. if false, the content length will not be calculated and the length will be indeterminate from the client's perspective

    • mount

      void mount()
      Call this at the end to mount the route