ArcGIS Runtime SDK for Java

Service Feature Table Cache

Demonstrates how to use a feature service in an on-interaction-cache mode. This is the default mode for a Service Feature Table.

On-interaction-cache mode will fetch Features within current extent when needed (performing a pan or zoom) from the server and caches those Features within a table on the client's side. Any queries performed on features within that table will be performed locally, otherwise they will be requested from the server.

How it works

How to set FeatureRequestMode.ON_INTERACTION_CAHCE mode:

  1. Create a ServiceFeatureTable from a URL.
  2. Set request mode of table, ServiceFeatureTable.setFeatureRequestMode(FeatureRequestMode.ON_INTERACTION_CAHCE).


 * Copyright 2017 Esri.
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.

package com.esri.samples.featurelayers.service_feature_table_cache;

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;

import com.esri.arcgisruntime.geometry.Envelope;
import com.esri.arcgisruntime.geometry.SpatialReferences;
import com.esri.arcgisruntime.layers.FeatureLayer;
import com.esri.arcgisruntime.mapping.ArcGISMap;
import com.esri.arcgisruntime.mapping.Basemap;
import com.esri.arcgisruntime.mapping.Viewpoint;
import com.esri.arcgisruntime.mapping.view.MapView;

public class ServiceFeatureTableCacheSample extends Application {

  private MapView mapView;

  private static final String FEATURE_SERVICE_URL =

  public void start(Stage stage) {

    try {
      // create stack pane and application scene
      StackPane stackPane = new StackPane();
      Scene scene = new Scene(stackPane);

      // size the stage, add a title, and set scene to stage
      stage.setTitle("Service Feature Table Cache Sample");

      // create a view for this ArcGISMap
      mapView = new MapView();

      // create a ArcGISMap with the light Gray Canvas basemap
      ArcGISMap map = new ArcGISMap(Basemap.createLightGrayCanvas());

      // set an initial viewpoint
      map.setInitialViewpoint(new Viewpoint(new Envelope(-1.30758164047166E7, 4014771.46954516, -1.30730056797177E7,
          4016869.78617381, 0, 0, SpatialReferences.getWebMercator())));

      // create feature layer with its service feature table
      // create the service feature table
      ServiceFeatureTable serviceFeatureTable = new ServiceFeatureTable(FEATURE_SERVICE_URL);

      // explicitly set the mode to on interaction cache (which is also
      // the default mode for service feature tables)

      // create the feature layer using the service feature table
      FeatureLayer featureLayer = new FeatureLayer(serviceFeatureTable);

      // add the layer to the ArcGISMap

      // set ArcGISMap to be displayed in ArcGISMap view

      // add the map view to stack pane

    } catch (Exception e) {
      // on any error, display stack trace

   * Stops and releases all resources used in application.
  public void stop() {

    // release resources when the application closes
    if (mapView != null) {

   * Opens and runs application.
   * @param args arguments passed to this application
  public static void main(String[] args) {


In this topic
  1. How it works
  2. Code