Skip to content

Commit d29ca22

Browse files
authored
[New Sample] Create Mobile Geodatabase (#700)
* [New Sample] Create Mobile Geodatabase * Fixing metadata issue. * Fixing metadata issue. * Sorting readme tags * Implemented changes from first review. * Fixing readme file issues * Converted to MVC layout * Converted to MVC layout - Fixing metadata * adding FXML file to metadata * initialize method is now private * Implemented review changes after conversion to fxml * Fixed issue when creating geodatabase * Sample now resets when geodatabase has been closed. * Removed code for default tableView properties * Improved table handling and addition of features * Implemented changes from second review * Name changes to exception type variables
1 parent 4cf3098 commit d29ca22

File tree

15 files changed

+984
-0
lines changed

15 files changed

+984
-0
lines changed

.gitignore

+1
Original file line numberDiff line numberDiff line change
@@ -37,3 +37,4 @@ samples-data/
3737
ehthumbs.db
3838
/arcgis-runtime-samples-java.iws
3939
/arcgis-runtime-samples-java.iml
40+
/feature_layers/create-mobile-geodatabase/LocationHistory.geodatabase
Loading
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
# Create mobile geodatabase
2+
3+
Create a mobile geodatabase.
4+
5+
![CreateMobileGeodatabase](CreateMobileGeodatabase.png)
6+
7+
## Use case
8+
9+
A mobile geodatabase is a collection of various types of GIS datasets contained in a single file (.geodatabase) on disk that can store, query, and manage spatial and non-spatial data. Mobile geodatabases are stored in a SQLite database and can contain up to 2 TB of portable data. Users can create, edit and share mobile geodatabases across ArcGIS Pro, ArcGIS Runtime, or any SQL software. These mobile geodatabases support both viewing and editing and enable new offline editing workflows that don’t require a feature service.
10+
11+
For example, a user would like to track the location of their device at various intervals to generate a heat map of the most visited locations. The user can add each location as a feature to a table and generate a mobile geodatabase. The user can then instantly share the mobile geodatabase to ArcGIS Pro to generate a heat map using the recorded locations stored as a geodatabase feature table.
12+
13+
## How to use the sample
14+
15+
Click "Create geodatabase" to create the geodatabase and its feature table. Click on the map to add new features to the geodatabase. Click "View Table" to view the contents of the geodatabase feature table. Once you have added the features to the map, click on "Close Geodatabase" to save the .geodatabase file which can then be imported into ArcGIS Pro or opened in an ArcGIS Runtime application.
16+
17+
## How it works
18+
19+
1. Create an empty mobile geodatabase with `Geodatabase.createAsync(String path)` and pass in a specific path as the parameter.
20+
2. Create a new `TableDescription` and add a list of new `FieldDescription`s to its collection of field descriptions with `tableDescription.getFieldDescriptions().addAll()`.
21+
3. Create a new table in the geodatabase from the table description with `geodatabase.createTableAsync()`. Once the listenable future has completed, get the newly created geodatabase feature table with `geodatabaseFeatureTableFuture.get()`.
22+
4. Create a feature on the selected map point using `geodatabaseFeatureTable.createFeature()`, passing a map of feature attributes and a geometry as parameters.
23+
5. Add the feature to the table using `geodatabaseFeatureTable.addFeatureAsync(feature)`.
24+
6. Each feature added to the geodatabase feature table is committed to the mobile geodatabase file.
25+
7. Close the mobile geodatabase with `geodatabase.close()`.
26+
27+
## Relevant API
28+
29+
* ArcGISFeature
30+
* FeatureLayer
31+
* FieldDescription
32+
* Geodatabase
33+
* GeodatabaseFeatureTable
34+
* TableDescription
35+
36+
## Additional information
37+
38+
Learn more about mobile geodatabases and how to utilize them on the [ArcGIS Pro documentation](https://pro.arcgis.com/en/pro-app/latest/help/data/geodatabases/manage-mobile-gdb/mobile-geodatabases.htm) page. The following mobile geodatabase behaviors are supported in ArcGIS Runtime: annotation, attachments, attribute rules, contingent values, dimensions, domains, feature-linked annotation, subtypes, utility network and relationship classes.
39+
40+
Learn more about the types of fields supported with mobile geodatabases on the [ArcGIS Pro documentation](https://pro.arcgis.com/en/pro-app/latest/help/data/geodatabases/manage-mobile-gdb/mobile-geodatabases.htm) page.
41+
42+
## Tags
43+
44+
arcgis pro, database, feature, feature table, geodatabase, mobile geodatabase, sqlite
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
{
2+
"category": "Feature layers",
3+
"description": "Create a mobile geodatabase.",
4+
"ignore": false,
5+
"images": [
6+
"CreateMobileGeodatabase.png"
7+
],
8+
"keywords": [
9+
"arcgis pro",
10+
"database",
11+
"feature",
12+
"feature table",
13+
"geodatabase",
14+
"mobile geodatabase",
15+
"sqlite",
16+
"ArcGISFeature",
17+
"FeatureLayer",
18+
"FieldDescription",
19+
"Geodatabase",
20+
"GeodatabaseFeatureTable",
21+
"TableDescription"
22+
],
23+
"redirect_from": "",
24+
"relevant_apis": [
25+
"ArcGISFeature",
26+
"FeatureLayer",
27+
"FieldDescription",
28+
"Geodatabase",
29+
"GeodatabaseFeatureTable",
30+
"TableDescription"
31+
],
32+
"snippets": [
33+
"src/main/java/com/esri/samples/create_mobile_geodatabase/CreateMobileGeodatabaseController.java",
34+
"src/main/java/com/esri/samples/create_mobile_geodatabase/CreateMobileGeodatabaseSample.java",
35+
"src/main/java/com/esri/samples/create_mobile_geodatabase/FeatureAttributeField.java",
36+
"src/main/resources/create_mobile_geodatabase/main.fxml"
37+
],
38+
"title": "Create mobile geodatabase"
39+
}
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
plugins {
2+
id 'application'
3+
id 'org.openjfx.javafxplugin' version '0.0.13'
4+
}
5+
6+
group = 'com.esri.samples'
7+
8+
ext {
9+
arcgisVersion = '100.14.1'
10+
}
11+
12+
javafx {
13+
version = "17.0.2"
14+
modules = [ 'javafx.controls', 'javafx.fxml' ]
15+
}
16+
17+
compileJava.options.encoding = 'UTF-8'
18+
19+
repositories {
20+
mavenCentral()
21+
maven {
22+
url 'https://esri.jfrog.io/artifactory/arcgis'
23+
}
24+
maven {
25+
url 'https://olympus.esri.com/artifactory/arcgisruntime-repo'
26+
}
27+
}
28+
29+
configurations {
30+
natives
31+
}
32+
33+
dependencies {
34+
implementation "com.esri.arcgisruntime:arcgis-java:$arcgisVersion"
35+
natives "com.esri.arcgisruntime:arcgis-java-jnilibs:$arcgisVersion"
36+
natives "com.esri.arcgisruntime:arcgis-java-resources:$arcgisVersion"
37+
// handle SLF4J http://www.slf4j.org/codes.html#StaticLoggerBinder
38+
runtimeOnly 'org.slf4j:slf4j-nop:1.7.32'
39+
}
40+
41+
task createGradlePropertiesAndWriteApiKey {
42+
description = "Creates a new gradle.properties file with an empty API key variable in the user home ./gradle folder, if the file doesn't already exist."
43+
group = "build"
44+
def propertiesFile = new File("${System.properties.getProperty("user.home")}/.gradle/gradle.properties")
45+
if (!propertiesFile.exists()) {
46+
print("Go to " + new URL("https://developers.arcgis.com/dashboard") + " to get an API key.")
47+
print(" Add your API key to ${System.properties.getProperty("user.home")}\\.gradle\\gradle.properties.")
48+
propertiesFile.write("apiKey = ")
49+
}
50+
}
51+
52+
task copyNatives(type: Copy) {
53+
description = "Copies the arcgis native libraries into the project build directory for development."
54+
group = "build"
55+
configurations.natives.asFileTree.each {
56+
from(zipTree(it))
57+
}
58+
// store native libraries in a common location shared with other samples
59+
into "${System.properties.getProperty("user.home")}/.arcgis/$arcgisVersion"
60+
}
61+
62+
run {
63+
doFirst {
64+
// sets the API key from the gradle.properties file as a Java system property
65+
systemProperty 'apiKey', apiKey
66+
}
67+
dependsOn copyNatives
68+
mainClassName = 'com.esri.samples.create_mobile_geodatabase.CreateMobileGeodatabaseLauncher'
69+
}
70+
71+
jar {
72+
duplicatesStrategy = DuplicatesStrategy.EXCLUDE
73+
manifest {
74+
attributes("Main-Class": "$mainClassName")
75+
}
76+
from {
77+
configurations.runtimeClasspath.collect { it.isDirectory() ? it : zipTree(it) }
78+
}
79+
80+
// exclude signing files that come from dependencies
81+
exclude "META-INF/*.SF"
82+
exclude "META-INF/*.DSA"
83+
exclude "META-INF/*.RSA"
84+
}
85+
86+
task productionZip(type: Zip) {
87+
group = 'distribution'
88+
from copyNatives
89+
from jar.destinationDirectory
90+
into (project.name)
91+
archiveBaseName = project.name
92+
}
93+
94+
wrapper {
95+
gradleVersion = '7.3'
96+
}
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
distributionBase=GRADLE_USER_HOME
2+
distributionPath=wrapper/dists
3+
distributionUrl=https\://services.gradle.org/distributions/gradle-7.3-bin.zip
4+
zipStoreBase=GRADLE_USER_HOME
5+
zipStorePath=wrapper/dists
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,185 @@
1+
#!/usr/bin/env sh
2+
3+
#
4+
# Copyright 2015 the original author or authors.
5+
#
6+
# Licensed under the Apache License, Version 2.0 (the "License");
7+
# you may not use this file except in compliance with the License.
8+
# You may obtain a copy of the License at
9+
#
10+
# https://www.apache.org/licenses/LICENSE-2.0
11+
#
12+
# Unless required by applicable law or agreed to in writing, software
13+
# distributed under the License is distributed on an "AS IS" BASIS,
14+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15+
# See the License for the specific language governing permissions and
16+
# limitations under the License.
17+
#
18+
19+
##############################################################################
20+
##
21+
## Gradle start up script for UN*X
22+
##
23+
##############################################################################
24+
25+
# Attempt to set APP_HOME
26+
# Resolve links: $0 may be a link
27+
PRG="$0"
28+
# Need this for relative symlinks.
29+
while [ -h "$PRG" ] ; do
30+
ls=`ls -ld "$PRG"`
31+
link=`expr "$ls" : '.*-> \(.*\)$'`
32+
if expr "$link" : '/.*' > /dev/null; then
33+
PRG="$link"
34+
else
35+
PRG=`dirname "$PRG"`"/$link"
36+
fi
37+
done
38+
SAVED="`pwd`"
39+
cd "`dirname \"$PRG\"`/" >/dev/null
40+
APP_HOME="`pwd -P`"
41+
cd "$SAVED" >/dev/null
42+
43+
APP_NAME="Gradle"
44+
APP_BASE_NAME=`basename "$0"`
45+
46+
# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
47+
DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
48+
49+
# Use the maximum available, or set MAX_FD != -1 to use that value.
50+
MAX_FD="maximum"
51+
52+
warn () {
53+
echo "$*"
54+
}
55+
56+
die () {
57+
echo
58+
echo "$*"
59+
echo
60+
exit 1
61+
}
62+
63+
# OS specific support (must be 'true' or 'false').
64+
cygwin=false
65+
msys=false
66+
darwin=false
67+
nonstop=false
68+
case "`uname`" in
69+
CYGWIN* )
70+
cygwin=true
71+
;;
72+
Darwin* )
73+
darwin=true
74+
;;
75+
MINGW* )
76+
msys=true
77+
;;
78+
NONSTOP* )
79+
nonstop=true
80+
;;
81+
esac
82+
83+
CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
84+
85+
86+
# Determine the Java command to use to start the JVM.
87+
if [ -n "$JAVA_HOME" ] ; then
88+
if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
89+
# IBM's JDK on AIX uses strange locations for the executables
90+
JAVACMD="$JAVA_HOME/jre/sh/java"
91+
else
92+
JAVACMD="$JAVA_HOME/bin/java"
93+
fi
94+
if [ ! -x "$JAVACMD" ] ; then
95+
die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
96+
97+
Please set the JAVA_HOME variable in your environment to match the
98+
location of your Java installation."
99+
fi
100+
else
101+
JAVACMD="java"
102+
which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
103+
104+
Please set the JAVA_HOME variable in your environment to match the
105+
location of your Java installation."
106+
fi
107+
108+
# Increase the maximum file descriptors if we can.
109+
if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
110+
MAX_FD_LIMIT=`ulimit -H -n`
111+
if [ $? -eq 0 ] ; then
112+
if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
113+
MAX_FD="$MAX_FD_LIMIT"
114+
fi
115+
ulimit -n $MAX_FD
116+
if [ $? -ne 0 ] ; then
117+
warn "Could not set maximum file descriptor limit: $MAX_FD"
118+
fi
119+
else
120+
warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
121+
fi
122+
fi
123+
124+
# For Darwin, add options to specify how the application appears in the dock
125+
if $darwin; then
126+
GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
127+
fi
128+
129+
# For Cygwin or MSYS, switch paths to Windows format before running java
130+
if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then
131+
APP_HOME=`cygpath --path --mixed "$APP_HOME"`
132+
CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
133+
134+
JAVACMD=`cygpath --unix "$JAVACMD"`
135+
136+
# We build the pattern for arguments to be converted via cygpath
137+
ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
138+
SEP=""
139+
for dir in $ROOTDIRSRAW ; do
140+
ROOTDIRS="$ROOTDIRS$SEP$dir"
141+
SEP="|"
142+
done
143+
OURCYGPATTERN="(^($ROOTDIRS))"
144+
# Add a user-defined pattern to the cygpath arguments
145+
if [ "$GRADLE_CYGPATTERN" != "" ] ; then
146+
OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
147+
fi
148+
# Now convert the arguments - kludge to limit ourselves to /bin/sh
149+
i=0
150+
for arg in "$@" ; do
151+
CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
152+
CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option
153+
154+
if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition
155+
eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
156+
else
157+
eval `echo args$i`="\"$arg\""
158+
fi
159+
i=`expr $i + 1`
160+
done
161+
case $i in
162+
0) set -- ;;
163+
1) set -- "$args0" ;;
164+
2) set -- "$args0" "$args1" ;;
165+
3) set -- "$args0" "$args1" "$args2" ;;
166+
4) set -- "$args0" "$args1" "$args2" "$args3" ;;
167+
5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
168+
6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
169+
7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
170+
8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
171+
9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
172+
esac
173+
fi
174+
175+
# Escape application args
176+
save () {
177+
for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
178+
echo " "
179+
}
180+
APP_ARGS=`save "$@"`
181+
182+
# Collect all arguments for the java command, following the shell quoting and substitution rules
183+
eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
184+
185+
exec "$JAVACMD" "$@"

0 commit comments

Comments
 (0)