Merge branch 'main' into bugfix/ESMF-316-json-generator-fails-index-out-of-bounds

# Conflicts:
#	core/esmf-aspect-meta-model-java/src/main/java/org/eclipse/esmf/metamodel/impl/DefaultComplexType.java

Author: RaMisess

AUTHORS.md

@@ -1,19 +1,19 @@
-# Authors 
+# Authors
 
 The following people have contributed to this repository:
 
 * Birgit Boss, Robert Bosch GmbH
 * Daniel Ewert, Robert Bosch GmbH, [email protected]
-* Dennis Melzer, Robert Bosch GmbH, georg.schmidt-dumont@de.bosch.com
+* Dennis Melzer, Robert Bosch GmbH, Dennis.Melzer@de.bosch.com
 * Misecka Rastislav, Systecs Informationssysteme GmbH
 * Fethuallah Misir, Robert Bosch GmbH, [email protected]
 * Michele Santoro
 * Andreas Schilling, [email protected]
-* Georg Schmidt-Dumont, Robert Bosch GmbH, [email protected] 
-* David Schmitt, Systecs Informationssysteme GmbH
+* Georg Schmidt-Dumont, Robert Bosch GmbH, [email protected]
+* David Schmitt, Robert Bosch GmbH, [email protected]
 * Andreas Textor, [email protected]
 * Peter Triebe, [email protected]
-* Julian Walbrecht,  ulian[email protected]
+* Julian Walbrecht, Julian[email protected]
 * Sven Walter, [email protected]
 * Sven Erik Jeroschewski, Bosch.IO GmbH
 * Lukas Römer, Bosch.IO GmbH, [email protected]

README.md

@@ -11,7 +11,7 @@
     - [esmf-aspect-static-meta-model](#esmf-aspect-static-meta-model)
     - [esmf-aspect-model-validator](#esmf-aspect-model-validator)
 - [Version Handling](#version-handling)
-    - [SAMM Versioning](#samm-versioning)
+    - [esmf-sdk Versioning](#esmf-sdk-versioning)
     - [SAMM Java Implementation Packaging](#samm-java-implementation-packaging)
 - [SAMM CLI](#samm-cli)
 - [Artifact Generation facilities](#artifact-generation-facilities)
@@ -37,17 +37,18 @@ code generators, validators etc.
 This document provides an overall overview of the SDK, and the concepts applied throughout it.
 Detailed documentation and concepts for each component can be found in the respective subfolders.
 
-This repository contains a detailed developer documentation written in AsciiDoc. The source files
-(AsciiDoc) are located [here](documentation/developer-guide) and are built using
-[Antora](https://antora.org/) which generates the documentation as HTML files.
+This repository contains a detailed developer documentation written in AsciiDoc. 
+The source files (AsciiDoc) are located [here](documentation/developer-guide) and are built using
+[Antora](https://antora.org/) which generates the documentation as HTML files. A site generated using Antora is self-contained and can be viewed entirely offline via a web browser without setting up a web server.
+To build the documentation locally, please check out and follow the instructions in [ESMF documentation repository](https://github.com/eclipse-esmf/eclipse-esmf.github.io).
 
 ## Getting help
 
 Are you having trouble with ESMF SDK? We want to help!
 
-* Check the [ESMF SDK developer documentation](https://openmanufacturingplatform.github.io/sds-documentation/sds-developer-guide/index.html)
+* Check the [ESMF SDK developer documentation](https://eclipse-esmf.github.io/esmf-developer-guide/index.html)
 * Ask a question the [community forum](https://www.eclipse.org/forums/index.php/f/617/).
-* Check the SAMM [specification](https://openmanufacturingplatform.github.io/sds-documentation/bamm-specification/snapshot/index.html)
+* Check the SAMM [specification](https://eclipse-esmf.github.io/samm-specification/snapshot/index.html)
 * Having issues with the ESMF SDK? Open a [GitHub issue](https://github.com/eclipse-esmf/esmf-sdk/issues).
 
 ## Build and contribute
@@ -124,30 +125,27 @@ The model validator is also available through the [SAMM CLI](#samm-cli).
 
 ## Version Handling
 
-SAMM does evolve over time. While measures are made to do this in a non-breaking manner, some
-changes cannot be carried out without the need to define a new, breaking version. Due to this fact
-it is important to understand the versioning concept that is applied to the SAMM, APIs and SDK
+SAMM and its SDKs evolve over time. While measures are taken to do this in a non-breaking manner,
+some changes cannot be carried out without the need to define a new, breaking version. Due to this
+fact it is important to understand the versioning concept that is applied to the SAMM, APIs and SDK
 components that are derived from them.
 
-In case of a prerelease there will be a postfix added and it will be released on Github. The way to
-access the artifact is described in [Github-Installing a
-package](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry#installing-a-package)
+In case of a prerelease a postfix will be added to the version, such as `-M1`, and it will be
+released on Github. The way to access the artifact is described in the [Java Aspect Tooling
+Guide](https://eclipse-esmf.github.io/esmf-developer-guide/tooling-guide/java-aspect-tooling.html#versioning).
 
-### SAMM Versioning
+### esmf-sdk Versioning
 
-For SAMM, semantic versioning (`major.minor.micro`) is applied with the following rules:
+For the esmf-sdk, semantic versioning (`major.minor.micro`) is applied with the following rules:
 
-* A breaking change increases the `major` part
-* Backwards compatible new features increase the `minor` part
-* Changes to existing features or bug fixes increase the `micro` part
+* The `major` part designates the supported SAMM major version
+* A breaking change increases the `minor` part
+* Backwards compatible new features, changes to existing features or bugfixes increase the `minor` part
 
-A new SAMM version always comprises new releases of the SDK components that depend on SAMM, however
-not the other way round. New releases of SDK components may be crafted that are built on the
+A new SAMM version implies new releases of the SDK components that depend on this SAMM version,
+however not the other way round. New releases of SDK components may be released that are built on an
 existing SAMM version.
 
-The SDK component versions are otherwise not tied to the SAMM version, i.e., they may differ in any
-part of the version.
-
 ### SAMM Java Implementation Packaging
 
 Complex applications might have the need to be implemented against different versions of the SAMM,
@@ -238,7 +236,7 @@ GitHub](https://github.com/eclipse-esmf/esmf-sdk/releases).
 
 For information regarding running the command line tool, the available commands and their
 description, please have a look at the
-[documentation](https://openmanufacturingplatform.github.io/sds-documentation/sds-developer-guide/tooling-guide/bamm-cli.html).
+[documentation](https://eclipse-esmf.github.io/esmf-developer-guide/tooling-guide/samm-cli.html).
 
 ## License
 

core/esmf-aspect-meta-model-java/src/main/java/org/eclipse/esmf/metamodel/Property.java

@@ -53,7 +53,7 @@ default boolean isOptional() {
     *       By default Properties are included in the runtime data.
     *
     * @see
-    * <a href="https://openmanufacturingplatform.github.io/sds-bamm-aspect-meta-model/bamm-specification/snapshot/modeling-guidelines.html#declaring-enumerations">BAMM Aspect Meta Model
+    * <a href="https://eclipse-esmf.github.io/samm-specification/2.0.0/modeling-guidelines.html#declaring-enumerations">Semantic Aspect Meta Model
     *       Specification - Declaring Enumerations</a>
     * @since SAMM 1.0.0
     */

core/esmf-aspect-meta-model-java/src/main/java/org/eclipse/esmf/metamodel/loader/instantiator/ComplexTypeInstantiator.java

@@ -78,8 +78,6 @@ public T apply( final Resource resource ) {
 
       extending.addAll( modelElementFactory.getExtendingElements( getExtending( resource ) ) );
 
-      creatingElements.remove( resource );
-
       return entity;
    }
 

core/esmf-aspect-meta-model-resolver/pom.xml

@@ -29,7 +29,9 @@
    <packaging>jar</packaging>
 
    <properties>
-      <samm-revision>https://raw.githubusercontent.com/eclipse-esmf/esmf-semantic-aspect-meta-model/5c097dd7357b129ba1771985a9ab1d29fcc32bcd</samm-revision>
+      <samm-revision>
+         https://raw.githubusercontent.com/eclipse-esmf/esmf-semantic-aspect-meta-model/bf9196547384bf072095cc8300d45ca7117a3211/esmf-semantic-aspect-meta-model
+      </samm-revision>
    </properties>
 
    <dependencies>
@@ -144,8 +146,6 @@
 
          <!-- Download updated meta model shape files -->
          <!-- This refers to the state of the shape files after merging of https://github.com/eclipse-esmf/esmf-semantic-aspect-meta-model/pull/176 -->
-         <!-- TODO: Enable this section once https://github.com/eclipse-esmf/esmf-semantic-aspect-meta-model/pull/186 has been merged -->
-         <!--
          <plugin>
             <groupId>com.googlecode.maven-download-plugin</groupId>
             <artifactId>download-maven-plugin</artifactId>
@@ -221,7 +221,6 @@
                </execution>
             </executions>
          </plugin>
-         -->
 
       </plugins>
    </build>

core/esmf-aspect-meta-model-resolver/src/main/java/org/apache/jena/graph/AnyNode.java

@@ -0,0 +1,33 @@
+/*
+ * Copyright (c) 2023 Robert Bosch Manufacturing Solutions GmbH
+ *
+ * See the AUTHORS file(s) distributed with this work for additional
+ * information regarding authorship.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ *
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+package org.apache.jena.graph;
+
+import org.eclipse.esmf.aspectmodel.resolver.parser.SmartToken;
+
+/**
+ * Because of some internal implementation details in Jena library, it was not possible
+ * to extend all node types via one wrapper node; as a workaround each node type must have its own extension.
+ */
+public class AnyNode extends Node_ANY {
+   private final SmartToken token;
+
+   public AnyNode( final SmartToken token ) {
+      super();
+      this.token = token;
+   }
+
+   public SmartToken getToken() {
+      return token;
+   }
+}

core/esmf-aspect-meta-model-resolver/src/main/java/org/apache/jena/graph/BlankNode.java

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2023 Robert Bosch Manufacturing Solutions GmbH
+ *
+ * See the AUTHORS file(s) distributed with this work for additional
+ * information regarding authorship.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ *
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+package org.apache.jena.graph;
+
+import org.eclipse.esmf.aspectmodel.resolver.parser.SmartToken;
+
+/**
+ * Because of some internal implementation details in Jena library, it was not possible
+ * to extend all node types via one wrapper node; as a workaround each node type must have its own extension.
+ */
+public class BlankNode extends Node_Blank {
+
+   private final SmartToken token;
+
+   public BlankNode( final Node_Blank original, final SmartToken token ) {
+      super( original.getBlankNodeId() );
+      this.token = token;
+   }
+
+   public SmartToken getToken() {
+      return token;
+   }
+}

core/esmf-aspect-meta-model-resolver/src/main/java/org/apache/jena/graph/LiteralNode.java

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2023 Robert Bosch Manufacturing Solutions GmbH
+ *
+ * See the AUTHORS file(s) distributed with this work for additional
+ * information regarding authorship.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ *
+ * SPDX-License-Identifier: MPL-2.0
+ */
+
+package org.apache.jena.graph;
+
+import org.eclipse.esmf.aspectmodel.resolver.parser.SmartToken;
+
+/**
+ * Because of some internal implementation details in Jena library, it was not possible
+ * to extend all node types via one wrapper node; as a workaround each node type must have its own extension.
+ */
+public class LiteralNode extends Node_Literal {
+
+   private final SmartToken token;
+
+   public LiteralNode( final Node_Literal node, final SmartToken token ) {
+      super( node.getLiteral() );
+      this.token = token;
+   }
+
+   public SmartToken getToken() {
+      return token;
+   }
+}