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

* Fix overriding semantics messaging version in newer openjdk 8 versions

* Added how to run app and override Eiffel-protocol version docs

Author: tobiasake

README.md

@@ -34,11 +34,13 @@ Eiffel REMReM Generate takes a partial message in JSON format, validates it and
 
 3. [**Installation**](wiki/markdown/installation.md)
 
-4. [**Run in Docker**](wiki/markdown/docker.md)
+4. [**Run Application**](wiki/markdown/run.md)
 
-5. [**Usage**](wiki/markdown/usage.md)
+5. [**Run in Docker**](wiki/markdown/docker.md)
 
-6. [**Logging**](wiki/markdown/logging.md)
+6. [**Usage**](wiki/markdown/usage.md)
+
+7. [**Logging**](wiki/markdown/logging.md)
 
 # About this repository
 The contents of this repository are licensed under the [Apache License 2.0](./LICENSE).

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

@@ -63,7 +63,6 @@ public class VersionService {
      */
     public Map<String, Map<String, String>> getMessagingVersions() {
         Enumeration<?> resEnum;
-        
         try {
             resEnum = Thread.currentThread().getContextClassLoader().getResources(JarFile.MANIFEST_NAME);
             while (resEnum.hasMoreElements()) {
@@ -77,9 +76,10 @@ public Map<String, Map<String, String>> getMessagingVersions() {
                         if (versionKey != null) {
                             String version = mainAttribs.getValue(versionKey);
                             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,62 @@
+# Run RemRem-Generate Applciation
+
+RemRem-Generate application can be executed with Maven command or with the maven built war file.
+
+## Requirements
+
+- Java
+- Maven
+
+
+## Run RemRem-Generate With Maven Command
+
+1. Change to service directory: 
+`cd service`
+
+2. Execute maven command to build and run RemRem-Generate:
+`mvn spring-boot:run`
+
+
+## Run RemRem-Generate With Java Command
+
+1. Go to remrem-generate git root directory
+
+2. Execute maven package command to build the RemRem-Generate war file:
+`mvn package -DskipTests`
+
+This will produce a war file in the "target" folder.
+The RemRem-Generate released war file can be downloaded from JitPack.
+
+3. Run RemRem-Generate application war file
+There is some alternatives to execute the war file with java command.
+`java -classpath service/target/generate-service-2.1.5.war org.springframework.boot.loader.WarLauncher`
+or
+`java -jar service/target/generate-service-2.1.5.war`
+
+
+Provide customized RemRem-Generate 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-Generate 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-Generate 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-Generate application with external eiffel-semantic version jar file to classpath:
+`java -classpath /path/to/protocol/eiffel-remrem-semantics-2.2.2.jar:service/target/generate-service-2.1.5.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 service/target/generate-service-2.1.5.war`
+
+Go to http://localhost:8080/versions and "semanticsVersion" field should show the overridden eiffel-semantic version.
+