Merge pull request #218 from Esri/feature-layer-shapefile

implement feature layer shapefile sample

Author: tschie

src/main/java/com/esri/samples/featurelayers/feature_layer_shapefile/FeatureLayerShapefile.png

@@ -0,0 +1,108 @@
+/*
+ * Copyright 2018 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
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * 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_shapefile;
+
+import java.io.File;
+
+import javafx.application.Application;
+import javafx.scene.Scene;
+import javafx.scene.control.Alert;
+import javafx.scene.layout.StackPane;
+import javafx.stage.Stage;
+
+import com.esri.arcgisruntime.data.ShapefileFeatureTable;
+import com.esri.arcgisruntime.layers.FeatureLayer;
+import com.esri.arcgisruntime.loadable.LoadStatus;
+import com.esri.arcgisruntime.mapping.ArcGISMap;
+import com.esri.arcgisruntime.mapping.Basemap;
+import com.esri.arcgisruntime.mapping.view.MapView;
+
+public class FeatureLayerShapefileSample extends Application {
+
+  private MapView mapView;
+
+  @Override
+  public void start(Stage stage) throws Exception {
+
+    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 Shapefile Sample");
+      stage.setWidth(800);
+      stage.setHeight(700);
+      stage.setScene(scene);
+      stage.show();
+
+      // create a map with a basemap
+      ArcGISMap map = new ArcGISMap(Basemap.createStreetsVector());
+
+      // set the map to the map view
+      mapView = new MapView();
+      mapView.setMap(map);
+
+      // create a shapefile feature table from the local file
+      File shapefile = new File("./samples-data/auroraCO/Public_Art.shp");
+      ShapefileFeatureTable shapefileFeatureTable = new ShapefileFeatureTable(shapefile.getAbsolutePath());
+
+      // use the shapefile feature table to create a feature layer
+      FeatureLayer featureLayer = new FeatureLayer(shapefileFeatureTable);
+      featureLayer.addDoneLoadingListener(() -> {
+        if (featureLayer.getLoadStatus() == LoadStatus.LOADED) {
+          // zoom to the area containing the layer's features
+          mapView.setViewpointGeometryAsync(featureLayer.getFullExtent());
+        } else {
+          Alert alert = new Alert(Alert.AlertType.ERROR, featureLayer.getLoadError().getMessage());
+          alert.show();
+        }
+      });
+
+      // add the feature layer to the map
+      map.getOperationalLayers().add(featureLayer);
+
+      // add the map view to the stack pane
+      stackPane.getChildren().add(mapView);
+    } catch (Exception e) {
+      // on any error, display the stack trace.
+      e.printStackTrace();
+    }
+  }
+
+  /**
+   * Stops and releases all resources used in application.
+   */
+  @Override
+  public void stop() {
+
+    if (mapView != null) {
+      mapView.dispose();
+    }
+  }
+
+  /**
+   * Opens and runs application.
+   *
+   * @param args arguments passed to this application
+   */
+  public static void main(String[] args) {
+
+    Application.launch(args);
+  }
+
+}

src/main/java/com/esri/samples/featurelayers/feature_layer_shapefile/FeatureLayerShapefileSample.java

@@ -0,0 +1,23 @@
+<h1>Feature Layer Shapefile</h1>
+
+<p>Demonstrates how display a shapefile as a feature layer.</p>
+  
+<p><img src="FeatureLayerShapefile.png"/></p>
+
+<h2>How it works</h2>
+
+<p>To show a shapefile as a feature layer:</p>
+
+<ol>
+  <li>Create a <code>ShapefileFeatureTable</code> passing in the URI of a shapefile.</li>
+  <li>Create a <code>FeatureLayer</code> using the <code>ShapefileFeatureTable</code>.</li>
+  <li>Add the layer to the map with <code>map.getOperationalLayers().add(featureLayer)</code>.</li>
+</ol>
+
+<h2>Features</h2>
+
+<ul>
+  <li>FeatureLayer</li>
+  <li>ShapefileFeatureTable</li>
+</ul>
+