Initial version of oskari.org sample app

Author: ZakarFin

.gitignore

@@ -0,0 +1,18 @@
+*/bin/
+.DS_Store
+*/target/
+target/
+.settings/
+*/.classpath
+*/.project
+*.iml
+.classpath
+.idea
+.project
+/data/
+/test-output/
+/servlet-map/data/
+*pom.xml.versionsBackup
+*/nbactions.xml
+*/nb-configuration.xml
+.metadata

LICENSE

@@ -1,6 +1,6 @@
-MIT License
+The MIT License (MIT)
 
-Copyright (c) 2019 Oskari.org
+Copyright (c) 2016 Oskari.org
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,2 +1,72 @@
-# sample-server-extension
-Site visible in demo.oskari.org
+# Sample server-extension for Oskari
+
+This is a template for extending oskari-server functionality using Maven.
+This application is running used in demo.oskari.org and dev.oskari.org.
+
+Modify oskari-ext.properties:
+
+    db.additional.modules=myplaces, userlayer, example
+    
+    # default view is the first appsetup
+    view.default=1
+    
+    # publish template is the second appsetup
+    view.template.publish=2
+
+    # make myplaces etc baselayers have the correct projection for initial setup:
+    oskari.native.srs=EPSG:3857
+
+To enable end-user registration configure these (more information at http://oskari.org/documentation/features/usermanagement):
+
+    allow.registration=true
+    oskari.email.sender=<[email protected]>
+    oskari.email.host=<smtp.domain.com>
+
+## Modifying the initial application setup:
+ 
+1) You will need a Java migration to run your setup file like this:
+ 
+    app-resources/src/main/java/flyway/example/V1_0_0__initial_db_content.java
+
+Or you can run these as individual flyway migrations.
+
+*Note!* All database tables are created with the core migration.
+
+2) Your setup should add application specific content like layers, users, appsetups.
+
+You can reference sql files under oskari-server/content-resources like adding inspire-themes:
+
+    app-resources/src/main/resources/setup/app-example.json
+
+You can modify data providers and users as this is just another example overriding the sample setup:
+
+    app-resources/src/main/resources/sql
+
+For example if you would like to have a non-admin user you can add these lines to app-resources/src/main/resources/sql/initial-users.sql:
+
+    -- add user;
+    INSERT INTO oskari_users(user_name, first_name, last_name, uuid) VALUES('user', 'Oskari', 'Olematon', 'fdsa-fdsa-fdsa-fdsa-fdsa');
+    
+    -- add role to user;
+    INSERT INTO oskari_role_oskari_user(user_id, role_id) VALUES((SELECT id FROM oskari_users WHERE user_name = 'user'), (SELECT id FROM oskari_roles WHERE name = 'User'));
+    
+    -- add credentials user/user for non-admin user (You can use for example https://www.browserling.com/tools/bcrypt to create a password);
+    INSERT INTO oskari_jaas_users(login, password) VALUES('user', '$2a$10$0VHUAhiInPL77O12guO3lOaCdxd/Hfhz4L8qA3Jb4FAw.u8Y.3cMG');
+
+Layers can be configured in json:
+
+    app-resources/src/main/resources/json/layers
+
+And referenced in app setups like this:
+
+    app-resources/src/main/resources/json/views/geoportal-3857.json
+
+Compile with:
+
+    mvn clean install
+    
+Replace oskari-map.war under {jetty.home}/webapps/ with the one created under webapp-map/target 
+
+# Reporting issues
+
+All Oskari-related issues should be reported here: https://github.com/oskariorg/oskari-docs/issues

app-resources/pom.xml

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>org.oskari.demo</groupId>
+        <artifactId>server-extension</artifactId>
+        <version>1.0-SNAPSHOT</version>
+    </parent>
+    <artifactId>app-resources</artifactId>
+    <packaging>jar</packaging>
+    <name>Resources for application</name>
+    <dependencies>
+        <dependency>
+            <groupId>fi.nls.oskari</groupId>
+            <artifactId>content-resources</artifactId>
+        </dependency>
+    </dependencies>
+</project>

app-resources/src/main/java/flyway/example/V1_0_0__initial_db_content.java

@@ -0,0 +1,18 @@
+package flyway.example;
+
+import fi.nls.oskari.db.DBHandler;
+import org.flywaydb.core.api.migration.jdbc.JdbcMigration;
+
+import java.sql.Connection;
+
+/**
+ * Created by SMAKINEN on 30.1.2018.
+ */
+public class V1_0_0__initial_db_content implements JdbcMigration {
+
+    public void migrate(Connection connection)
+            throws Exception {
+
+        DBHandler.setupAppContent(connection, "app-example");
+    }
+}