Refactor the WWSK Explorer packaging

emxsys commented 6 years ago

The Explorer should be packaged and distributed as an standard HTML5/JavaScript web app instead of a GeoServer jar. This would allow easy customization of the Explorer without the need to compile WWSK modules.

Serve the WWSK Explorer web app via GeoServer's static web pages

[x] Add Explorer resources to distribution assemblies
[x] Add Explorer resources to integration tests
[x] Add Explorer resources to war file
[x] Update Explorer link in GeoServer admin
[x] Update Explorer link in About WWSK page

@TrilliumLearning

emxsys commented 6 years ago

Options

The WWSK Explorer is an HTML5/JavaScript single-page web app accessed via index.html in a folder named explorer. We want to serve this content.

Option 1. Serve the WWSK Explorer web app via Jetty

Place the explorer web app folder in the Jetty webapps folder alongside geoserver

worldwind-geoserver/
    webapps/
        explorer
        geoserver

The URL would be: http://host:8080/explorer/

Option 2. Serve the WWSK Explorer web app via GeoServer

Copy the explorer web app folder into a www folder under the data_dir folder

worldwind-geoserver/
    data_dir/
        www/
            explorer

The URL would be: http://host:8080/geoserver/www/explorer

See GeoServer docs: Serving Static Files

You can place static files in the www subdirectory of the GeoServer data directory, and they will be served at http:/myhost:8080/geoserver/www. This means you can deploy HTML, images, or JavaScript, and have GeoServer serve them directly on the web.

emxsys commented 6 years ago

Tasks

[x] Distribute Explorer to worldwind-geoserver/data_dir/www/explorer
[x] Redirect Explorer menu entry to /geoserver/www/explorer.index.html

emxsys commented 6 years ago

The WWSK Explorer now resides in the GEOSERVER_DATA_DIR/www/explorer folder. The web app source code in this folder can be now be modified and updated by GeoServer admins outside the WWSK build process.

emxsys commented 6 years ago

The integration tests are failing to find /geoserver/www/explorer/index.html whereas the functional test are working fine.

emxsys commented 6 years ago

Fixed:

Added Explorer resources to distribution assemblies
Added Explorer resources to integration tests
Added Explorer resources to war file
Updated Explorer link in GeoServer admin
Updated Explorer link in About WWSK page

NASAWorldWind / WorldWindServerKit