ArcGIS Runtime SDK for Java

Dictionary Renderer with Graphics Overlay

Demonstrates how to apply a dictionary renderer to a graphics overlay and display mil2525d graphics. The dictionary renderer creates these graphics using a local mil2525d style file and a XML file with key, value attributes for each graphic.

How it works

To apply a DictionaryRenderer and display mil2525d graphics:

  1. Create a SymbolDicitonary, SymbolDictionary(specificationType, dictionaryPath).
    • specificationType, this will be the mil2525d.stylx local file
    • dictionaryPath, path to the mil2525d.stylx local file
  2. Load the dictionary asynchronouly, DictionarySymbol.loadAsync().
    • this will allows the application to continue working while the dictionary loads all symbol primitives found within the mil2525d specification
  3. Create a dictionary renderer, DictionaryRenderer(SymbolDictionary).
    • apply it to the GraphicsOverlay.setRenderer(DictionaryRenderer)
  4. Parse through local XML file creating a mapping of key,value pairs for each block of attributes.
    • use the name of the attribute as key and text within that attribute as the value
  5. Create a graphic for each mapping of attributes.
    • _wkid key, holds the geometry's spatial reference
    • _control_points, creates the shape of the geometry
    • other attributes explain to dictionary symbol how to display graphic
    • add graphic to GraphicsOverlay.getGraphics().add(Graphic)


 * 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.displayinformation.dictionary_renderer_graphics_overlay;

import static org.joox.JOOX.$;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

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

import com.esri.arcgisruntime.geometry.Multipoint;
import com.esri.arcgisruntime.geometry.Point;
import com.esri.arcgisruntime.geometry.PointCollection;
import com.esri.arcgisruntime.geometry.SpatialReference;
import com.esri.arcgisruntime.mapping.ArcGISMap;
import com.esri.arcgisruntime.mapping.Basemap;
import com.esri.arcgisruntime.mapping.view.Graphic;
import com.esri.arcgisruntime.mapping.view.GraphicsOverlay;
import com.esri.arcgisruntime.mapping.view.MapView;
import com.esri.arcgisruntime.symbology.DictionaryRenderer;
import com.esri.arcgisruntime.symbology.DictionarySymbolStyle;

public class DictionaryRendererGraphicsOverlaySample extends Application {

  private MapView mapView;
  private GraphicsOverlay graphicsOverlay;

  public void start(Stage stage) throws Exception {
    mapView = new MapView();
    StackPane appWindow = new StackPane(mapView);
    Scene scene = new Scene(appWindow);

    // set title, size, and add scene to stage
    stage.setTitle("Dictionary Renderer Graphics Overlay Sample");

    ArcGISMap map = new ArcGISMap(Basemap.createTopographic());

    graphicsOverlay = new GraphicsOverlay();
    // graphics no longer show after zooming passed this scale

    // create symbol dictionary from specification
    DictionarySymbolStyle symbolDictionary = new DictionarySymbolStyle("mil2525d");

    // tells graphics overlay how to render graphics with symbol dictionary attributes set
    DictionaryRenderer renderer = new DictionaryRenderer(symbolDictionary);

    // parse graphic attributes from a XML file
    List<Map<String, Object>> messages = parseMessages();

    // create graphics with attributes and add to graphics overlay
        .collect(Collectors.toCollection(() -> graphicsOverlay.getGraphics()));

    // once view has loaded
    mapView.addSpatialReferenceChangedListener(e -> {
      // set initial viewpoint

   * Parses a XML file and creates a message for each block of attributes found.
  private List<Map<String, Object>> parseMessages() throws Exception {
    final List<Map<String, Object>> messages = new ArrayList<>();
    $(getClass().getResourceAsStream("/symbols/Mil2525DMessages.xml")) // $ reads the file
        .forEach(message -> {
          Map<String, Object> attributes = new HashMap<>();
          message.children().forEach(attr -> attributes.put(attr.getNodeName(), attr.getTextContent()));

    return messages;

   * Creates a graphic using a symbol dictionary and the attributes that were passed.
   * @param attributes tells symbol dictionary what symbol to apply to graphic
  private static Graphic createGraphic(Map<String, Object> attributes) {

    // get spatial reference
    int wkid = Integer.parseInt((String) attributes.get("_wkid"));
    SpatialReference sr = SpatialReference.create(wkid);

    // get points from coordinates' string
    PointCollection points = new PointCollection(sr);
    String[] coordinates = ((String) attributes.get("_control_points")).split(";");
        .map(cs -> cs.split(","))
        .map(c -> new Point(Double.valueOf(c[0]), Double.valueOf(c[1]), sr))
        .collect(Collectors.toCollection(() -> points));

    // return a graphic with multipoint geometry
    return new Graphic(new Multipoint(points), attributes);

   * 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