The 3D City Database WFS is shipped as a Java WAR (web archive) file. Please download the WFS distribution package from http://www.3dcitydb.org/ or from the GitHub release section. Besides the WAR file, the distribution package also contains Java libraries that render mandatory dependencies for the WFS service and that must be installed as shared libraries in your servlet container.
Alternatively, you may build your own WAR file from the source code provided on GitHub. This requires that you are experienced in building Java web applications from source using Gradle. No further documentation is provided here.
Please follow the following installation steps:
ojdbc8-188.8.131.52.jar(Oracle JDBC driver)
postgresql-42.2.10.jar(PostgreSQL JDBC driver)
postgis-jdbc-2.3.0.jar(PostGIS JDBC extension)
The libraries must be installed as shared libs or common libs (terminology may differ) in your servlet container. For Apache Tomcat 7 (or higher), this simply means placing the JAR files into the lib folder of the Tomcat installation directory. Afterwards, you need to restart Tomcat. Please refer to the documentation of your servlet container for more information.
You may, for instance, use the Java command-line option
for this purpose.
If you use the automatic deployment feature of Tomcat as
described above, the name of the WAR file will be used as context path
in the URL for accessing the application. For example, if the WFS WAR
file is named
citydb-wfs.war, then the context path of the WFS service
http://[host][:port]/citydb-wfs/. To pick a different context
path, simply rename the WAR file or change Tomcat’s default behavior.
config.xmlof the service. Please check the next chapter for how to configure the WFS.
Changes to the
config.xml file typically require a reload or
restart of the WFS web application (a restart of the servlet container
itself is, of course, not required). Please check to documentation of
your favorite servlet container for how to do so. In case of Apache
Tomcat, you can simply use the manager application to reload web
WEB-INF/ade-extensionsdirectory of your deployed WFS application. The
WEB-INFdirectory is typically located in the application folder, which is generally named after the WAR file and itself is a subfolder of the webapps folder in the Tomcat installation directory (see Fig. 4.1).
The CityGML ADE must also be registered in the 3DCityDB instance to which your WFS service shall connect.