Options
All
  • Public
  • Public/Protected
  • All
Menu

Class UrlStore<TFeature>

A read-only store that retrieves a collection of objects from a URL. The response content is decoded to LuciadRIA Feature instances by using a Codec.

Type parameters

  • TFeature: Feature

    Represents the type of Feature instances that are handled by the store. Default type is Feature without restrictions on shape and properties.

Hierarchy

  • UrlStore

Implements

Overview

Constructors

constructor

  • Creates a new UrlStore instance. This is typically a file on the network, but can also point to the Url of a webservice which dynamically generates the data.

    The default implementation uses a GeoJsonCodec to parse the server response. If you want to support another format, you can pass another Codec.

    Parameters

    Returns UrlStore

Accessors

credentials

  • get credentials(): boolean
  • set credentials(value: boolean): void
  • Indicates whether or not credentials should be included with HTTP requests.

    Set this to true if the server requires credentials, like HTTP basic authentication headers or cookies. You should disable credentials if the server is configured to allow cross-origin requests from all domains (Access-Control-Allow-Origin=*). If the server allows CORS requests from all domains, the browser will block all requests where credentials=true.

    Once set, all subsequent HTTP requests will use the newly set value.

    The default value is false.

    Returns boolean

  • Indicates whether or not credentials should be included with HTTP requests.

    Set this to true if the server requires credentials, like HTTP basic authentication headers or cookies. You should disable credentials if the server is configured to allow cross-origin requests from all domains (Access-Control-Allow-Origin=*). If the server allows CORS requests from all domains, the browser will block all requests where credentials=true.

    Once set, all subsequent HTTP requests will use the newly set value.

    The default value is false.

    Parameters

    • value: boolean

    Returns any

requestHeaders

  • get requestHeaders(): {} | null
  • set requestHeaders(value: {} | null): void
  • Headers to send with every HTTP request.

    An object literal that represents the headers to send with every HTTP request. The property names represent HTTP header names, the property values represent the HTTP header values. This property can be set dynamically (post-construction). Once set, all subsequent HTTP requests will use the newly set headers.

    Note that when custom headers are being sent to a server on another domain, the server will have to properly respond to pre-flight CORS requests (a HTTP OPTION request sent by the browser before doing the actual request). The server has to indicate that the header can be used in the actual request, by including it in the pre-flight's Access-Control-Allow-Headers response header.

    The default value is null.

    Returns {} | null

  • Headers to send with every HTTP request.

    An object literal that represents the headers to send with every HTTP request. The property names represent HTTP header names, the property values represent the HTTP header values. This property can be set dynamically (post-construction). Once set, all subsequent HTTP requests will use the newly set headers.

    Note that when custom headers are being sent to a server on another domain, the server will have to properly respond to pre-flight CORS requests (a HTTP OPTION request sent by the browser before doing the actual request). The server has to indicate that the header can be used in the actual request, by including it in the pre-flight's Access-Control-Allow-Headers response header.

    The default value is null.

    Parameters

    • value: {} | null

    Returns any

requestParameters

  • get requestParameters(): {} | null
  • set requestParameters(value: {} | null): void
  • Custom request parameters to send along with requests. The object literal can contain simple key/value pairs. Accepted values are strings, numbers and booleans. A ProgrammingError will be thrown if values of another type are used. Values must not be URL encoded.

    Assignments of other values than object literals to requestParameters will throw an Error. Clearing the parameters can be done by assigning null or an empty object literal to requestParameters. In order to trigger a refresh of the visualization on the map use layer.loadingStrategy.queryProvider.invalidate() (QueryProvider.invalidate).

    since

    2021.1.03

    Returns {} | null

  • Custom request parameters to send along with requests. The object literal can contain simple key/value pairs. Accepted values are strings, numbers and booleans. A ProgrammingError will be thrown if values of another type are used. Values must not be URL encoded.

    Assignments of other values than object literals to requestParameters will throw an Error. Clearing the parameters can be done by assigning null or an empty object literal to requestParameters. In order to trigger a refresh of the visualization on the map use layer.loadingStrategy.queryProvider.invalidate() (QueryProvider.invalidate).

    since

    2021.1.03

    Parameters

    • value: {} | null

    Returns any

Methods

query

  • Query the store for objects. The response of the server will be passed to the Codec of this Store.

    Parameters

    • Optional query: any

      An object which represents a query which may be understood and satisfied by the store. This object is ignored by the current implementation.

    • Optional options: { abortSignal?: AbortSignal; reference?: CoordinateReference }

      An optional object specifying options specific to this <Store

      • Optional abortSignal?: AbortSignal

        used by LuciadRIA to signal that a query was aborted. For example when the queried region is no longer visible on the map.

      • Optional reference?: CoordinateReference

        The reference, which will be passed to the Codec when specified

    Returns Promise<Cursor<TFeature>>

    a Cursor of Feature instances corresponding to the server response or a promise for that Cursor.

Legend

  • Module
  • Object literal
  • Variable
  • Function
  • Function with type parameter
  • Index signature
  • Type alias
  • Type alias with type parameter
  • Enumeration
  • Enumeration member
  • Property
  • Method
  • Interface
  • Interface with type parameter
  • Constructor
  • Property
  • Method
  • Index signature
  • Class
  • Class with type parameter
  • Constructor
  • Property
  • Method
  • Accessor
  • Index signature
  • Inherited constructor
  • Inherited property
  • Inherited method
  • Inherited accessor
  • Protected property
  • Protected method
  • Protected accessor
  • Private property
  • Private method
  • Private accessor
  • Static property
  • Static method