ArcGIS Runtime SDK for Java

Feature Layer Definition Expression

Demonstrates how to set the limit of Features to display on the ArcGISMap.

How it works

To limit the Features in your FeatureLayer:

  1. Create a ServiceFeatureTable from a URL.
  2. Create a feature layer from the service feature table.
  3. Set the limit of the features on your feature layer using FeatureLayer.setDefinitionExpression(Expression).


 * 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.feature_layer_definition_expression;

import javafx.application.Application;
import javafx.geometry.Insets;
import javafx.geometry.Pos;
import javafx.scene.Scene;
import javafx.scene.control.ToggleButton;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;

import com.esri.arcgisruntime.geometry.Point;
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.view.MapView;

public class FeatureLayerDefinitionExpressionSample extends Application {

  private MapView mapView;
  private FeatureLayer featureLayer;

  private final static 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);

      // set title, size, and add scene to stage
      stage.setTitle("Feature Layer Definition Expression Sample");

      // create renderer toggle switch
      ToggleButton definitionSwitch = new ToggleButton();

      // set the definition expression
      definitionSwitch.selectedProperty().addListener((observable, oldValue, newValue) -> {
        if (definitionSwitch.isSelected()) {
          featureLayer.setDefinitionExpression("req_Type = 'Tree Maintenance or Damage'");
        } else {
          // reset the definition expression

      // create service feature table
      final ServiceFeatureTable featureTable = new ServiceFeatureTable(FEATURE_SERVICE_URL);

      // create feature layer from service feature table
      featureLayer = new FeatureLayer(featureTable);

      // create a ArcGISMap using the basemap topographic
      final ArcGISMap map = new ArcGISMap(Basemap.createTopographic());

      // add the feature layer to the ArcGISMap

      // create a view for this ArcGISMap and set map to it
      mapView = new MapView();

      // starting location for sample
      Point startPoint = new Point(-13630845, 4544861, SpatialReferences.getWebMercator());

      // set the viewpoint for the map view
      mapView.setViewpointCenterAsync(startPoint, 150000);

      // add the map view and control panel to stack pane
      stackPane.getChildren().addAll(mapView, definitionSwitch);
      StackPane.setAlignment(definitionSwitch, Pos.TOP_LEFT);
      StackPane.setMargin(definitionSwitch, new Insets(10, 0, 0, 10));

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

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

    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