Fix overriding semantics messaging version in newer openjdk 8 versions (#252)

* Fix overriding semantics messaging version in newer openjdk 8 versions

* Added how to run application and override eiffel-semantic version documentation

Author: tobiasake

README.md

@@ -46,6 +46,7 @@ Visit [Eiffel Community](https://eiffel-community.github.io) to get started and
 2. [**Installation**](wiki/markdown/installation.md)
 
 3. [**Running RemRem-Publish service**](wiki/markdown/running-remrem-publish.md)
+    - [**Run Application**](wiki/markdown/run.md)
     - [**Run in Docker**](wiki/markdown/docker.md)
     - [**Configuration**](wiki/markdown/configuration.md)
 

publish-service/src/main/java/com/ericsson/eiffel/remrem/publish/controller/VersionService.java

@@ -79,7 +79,9 @@ public Map<String, Map<String, String>> getMessagingVersions() {
                             if (version != null) {
 
                                 if (mainAttribs.getValue(IS_ENDPOINT_VERSION) != null) {
-                                    endpointVersions.put(versionKey, version);
+                                    if(endpointVersions.get(versionKey) == null) {
+                                        endpointVersions.put(versionKey, version);
+                                    }
                                 } else {
                                     serviceVersion.put(versionKey, version);
                                 }

wiki/markdown/run.md

@@ -0,0 +1,61 @@
+# Run RemRem-Publish Applciation
+
+RemRem-Publish application can be executed with Maven command or with the maven built war file.
+
+## Requirements
+
+- Java
+- Maven
+
+## Run RemRem-Publish With Maven Command
+
+1. Change to service directory: 
+`cd publish-service`
+
+2. Execute maven command to build and run RemRem-Publish:
+`mvn spring-boot:run`
+
+
+## Run RemRem-Publish With Java Command
+
+1. Go to RemRem-Publish git root directory
+
+2. Execute maven package command to build the RemRem-Publish war file:
+`mvn package -DskipTests`
+
+This will produce a war file in the "target" folder.
+The RemRem-Publish released war file can be downloaded from JitPack.
+
+3. Run RemRem-Publish application war file
+There is some alternatives to execute the war file with java command.
+`java -classpath publish-service/target/publish-service-2.0.26.war org.springframework.boot.loader.WarLauncher`
+or
+`java -jar publish-service/target/publish-service-2.0.26.war`
+
+
+Provide customized RemRem-Publish application.properties configuration via the spring.config.location java flag which need to be appended to the java command line:
+`-Dspring.config.location=/path/to/application.properties`
+
+
+## Override RemRem-Publish Eiffel Protocol Version
+
+Eiffel-RemRem Protocol versions is developed and released by Github project:
+https://github.com/eiffel-community/eiffel-remrem-semantics
+
+Eiffel-RemRem-Semantic versions is released in Jitpack and can be downloaded as jar file.
+Eiffel-Remrem-Semantic releases version jar files:
+https://jitpack.io/com/github/eiffel-community/eiffel-remrem-semantics
+
+Example of one Eiffel-Semantic-version Jitpack download url address:
+https://jitpack.io/com/github/eiffel-community/eiffel-remrem-semantics/2.2.1/eiffel-remrem-semantics-2.2.1.jar
+
+Eiffel-RemRem-Publish is released with a built-in eiffel-semantic protocol version which can be overridden with a different eiffel-semantic version by adding the external eiffel-semantic version jar file to classpath.
+
+Execute RemRem-Publish application with external eiffel-semantic version jar file to classpath:
+`java -classpath /path/to/protocol/eiffel-remrem-semantics-2.2.2.jar:publish-service/target/publish-service-2.0.26.war org.springframework.boot.loader.WarLauncher`
+
+Another alternative (works only with Java 8):
+`java -Djava.ext.dirs=/path/to/protocol/eiffel-remrem-semantics-2.2.2.jar -jar publish-service/target/publish-service-2.0.26.war`
+
+Go to http://localhost:8080/versions and "semanticsVersion" field should show the overridden eiffel-semantic version.
+