Point plug-in data source

Purpose
This sample implements a plug-in data source for a simple point data format that provides direct read-only ArcGIS support for the format. The data in this sample follows a simple format. An ASCII text file contains data for each new point on a new line. The first six characters are the x-coordinate, the next six characters contain the y-coordinate, and the remaining characters contain an attribute value. You can use the sample data from the SDK samples folder or use your own data according to the above specification.
 
This extension can be consumed from ArcMap or from an Engine application.

How to use

See How to use ArcGIS samples for help on running the sample. If the sample has associated data, you will find that the sample's zip file includes a "data" folder alongside the language folders. However, you will need to update the sample to point to the location of the data once you have extracted all the files.

Consuming the extension in ArcMap
  1. Navigate to this sample's lib folder (pointplugindatasource\lib) and copy the PointPluginDataSourceExt.jar file into the ArcGIS Install Dir\java\lib\ext folder to deploy. The sample functionality is available when you start ArcMap.
  2. Start ArcMap and add the custom data points.spt from pointplugindatasource\src\data. This custom data has appeared in ArcMap as a point layer, which is a read-only layer.

Consuming the extension in an Engine application
  1. Navigate to the sample's lib folder (pointplugindatasource\lib) and copy the PointPluginDataSourceExt.jar file into the ArcGIS Install Dir\java\lib\ext folder to deploy. The sample functionality is available when you start the Engine application.
  2. Navigate to this sample's bin folder (pointplugindatasource\bin) and execute the PointPluginDataSource.jar to start the application. The frame is loaded with a map, TOC, toolbar, and the Add Custom Data button.
  3. Click the Add Custom Data button and navigate to pointplugindatasource\src\data.
  4. Get points.spt from this folder and click Open. This file is added to the map as a point layer.


Download the files for Java
geodatabase/PluginDatasourceMain.java
(view code)
 Main Java class that consumes the simple point plug-in data source in an Engine application.
geodatabase/simplepointdatasource/SimplePointWorkspaceFactoryHelper.java
(view code)
 Must implement the IPlugInWorkspaceFactoryHelper interface. This helper class works in conjunction with the existing ArcGIS PlugInWorkspaceFactory class.
geodatabase/simplepointdatasource/SimplePointWorkspaceHelper.java
(view code)
 Must implement the IPlugInWorkspaceHelper interface and represents a single workspace for datasets of your data source type. This class does not need to be publicly creatable, because the plug-in workspace factory helper is responsible for creating it in its OpenWorkspace method.
geodatabase/simplepointdatasource/SimplePointDatasetHelper.java
(view code)
 Must implement the IPlugInDatasetInfo and IPlugInDatasetHelper interfaces. This class does not need to be publicly creatable, because the plug-in workspace helper is responsible for creating it.
geodatabase/simplepointdatasource/SimplePointDatasetHelper.java
(view code)
 Must implement the IPlugInCursorHelper interface. This class deals with raw data and is normally the class for which you will write the most code. The cursor helper represents the results of a query on the dataset. This class does not need to be publicly creatable, because the plug-in dataset helper is responsible for creating it.



Development licensing Deployment licensing
Engine Developer Kit Engine Runtime