Introduces ObjectStorageService (#49)

* Introduces `ObjectStorageService`

Represents the service to access an object storage. Moved http endpoint from storage service to this specific one, as only this one has an HTTP endpoint.

* Use 'rdfs:comment' instead of 'dc:description'

* Added more comments to storage services

Co-authored-by: Angelika Schneider <angelika.schneider@aisec.fraunhofer.de>

Author: oxisto

cloudpg/src/main/java/io/clouditor/graph/passes/Azure.kt

@@ -427,7 +427,7 @@ class AzurePass : CloudResourceDiscoveryPass() {
         // specific to the Storage containers, e.g., authenticity, url,
         // For now we fill it out as good as we can with the current ontology
         val storageAccount =
-            StorageService(
+            ObjectStorageService(
                 HttpEndpoint(
                     auth,
                     null,

cloudpg/src/main/java/io/clouditor/graph/passes/KubernetesPass.kt

@@ -151,7 +151,6 @@ class KubernetesPass : CloudResourceDiscoveryPass() {
         if (service?.name == "postgres") {
             val db =
                 RelationalDatabaseService(
-                    null,
                     mutableListOf<Storage>(),
                     container,
                     service.ips,
@@ -168,7 +167,6 @@ class KubernetesPass : CloudResourceDiscoveryPass() {
         if (service?.name == "mongo") {
             val db =
                 DocumentDatabaseService(
-                    null,
                     mutableListOf<Storage>(),
                     container,
                     service.ips,

cloudpg/src/main/java/io/clouditor/graph/testing/LocalTestingPass.kt

@@ -116,7 +116,6 @@ class LocalTestingPass : Pass() {
             if (service.name == "postgres") {
                 val db =
                     RelationalDatabaseService(
-                        null,
                         mutableListOf<Storage>(),
                         null,
                         null,
@@ -132,7 +131,6 @@ class LocalTestingPass : Pass() {
             if (service.name == "mongo") {
                 val db =
                     DocumentDatabaseService(
-                        null,
                         mutableListOf<Storage>(),
                         null,
                         null,

owl2java/resources/urn_webprotege_ontology_e4316a28-d966-4499-bd93-6be721055117.owx

@@ -242,6 +242,9 @@
     <Declaration>
         <Class IRI="http://graph.clouditor.io/classes/ObjectStorageRequest"/>
     </Declaration>
+    <Declaration>
+        <Class IRI="http://graph.clouditor.io/classes/ObjectStorageService"/>
+    </Declaration>
     <Declaration>
         <Class IRI="http://graph.clouditor.io/classes/Operation"/>
     </Declaration>
@@ -1572,6 +1575,17 @@
             <Literal>xsd:de.fraunhofer.aisec.cpg.graph.Node</Literal>
         </DataHasValue>
     </SubClassOf>
+    <SubClassOf>
+        <Class IRI="http://graph.clouditor.io/classes/ObjectStorageService"/>
+        <Class IRI="http://graph.clouditor.io/classes/StorageService"/>
+    </SubClassOf>
+    <SubClassOf>
+        <Class IRI="http://graph.clouditor.io/classes/ObjectStorageService"/>
+        <ObjectSomeValuesFrom>
+            <ObjectProperty abbreviatedIRI="prop:offers"/>
+            <Class IRI="http://graph.clouditor.io/classes/HttpEndpoint"/>
+        </ObjectSomeValuesFrom>
+    </SubClassOf>
     <SubClassOf>
         <Class IRI="http://graph.clouditor.io/classes/Operation"/>
         <Class IRI="http://graph.clouditor.io/classes/Functionality"/>
@@ -1697,13 +1711,6 @@
             <Class IRI="http://graph.clouditor.io/classes/Storage"/>
         </ObjectSomeValuesFrom>
     </SubClassOf>
-    <SubClassOf>
-        <Class IRI="http://graph.clouditor.io/classes/StorageService"/>
-        <ObjectSomeValuesFrom>
-            <ObjectProperty abbreviatedIRI="prop:offers"/>
-            <Class IRI="http://graph.clouditor.io/classes/HttpEndpoint"/>
-        </ObjectSomeValuesFrom>
-    </SubClassOf>
     <SubClassOf>
         <Class IRI="http://graph.clouditor.io/classes/TransportEncryption"/>
         <Class IRI="http://graph.clouditor.io/classes/Confidentiality"/>
@@ -2403,6 +2410,11 @@ name = metadata.name</Literal>
         <IRI>http://graph.clouditor.io/classes/DatabaseQuery</IRI>
         <Literal>DatabaseQuery</Literal>
     </AnnotationAssertion>
+    <AnnotationAssertion>
+        <AnnotationProperty abbreviatedIRI="rdfs:comment"/>
+        <IRI>http://graph.clouditor.io/classes/DatabaseService</IRI>
+        <Literal>This class represents a database service. For example, a postgres SQL server would be modelled as a database service (with a host and IP) and the individual tables or collections would be modelled as a DatabaseStorage entity.</Literal>
+    </AnnotationAssertion>
     <AnnotationAssertion>
         <AnnotationProperty abbreviatedIRI="rdfs:label"/>
         <IRI>http://graph.clouditor.io/classes/DatabaseService</IRI>
@@ -2614,7 +2626,7 @@ name = metadata.name</Literal>
         <Literal xml:lang="english">NetworkSecurityGroup</Literal>
     </AnnotationAssertion>
     <AnnotationAssertion>
-        <AnnotationProperty IRI="http://purl.org/dc/elements/1.1/description"/>
+        <AnnotationProperty abbreviatedIRI="rdfs:comment"/>
         <IRI>http://graph.clouditor.io/classes/NetworkService</IRI>
         <Literal>A NetworkService is an application (on the network layer) running on a Compute resource. It provides access to a resource</Literal>
     </AnnotationAssertion>
@@ -2653,6 +2665,16 @@ name = metadata.name</Literal>
         <IRI>http://graph.clouditor.io/classes/ObjectStorageRequest</IRI>
         <Literal xml:lang="english">ObjectStorageRequest</Literal>
     </AnnotationAssertion>
+    <AnnotationAssertion>
+        <AnnotationProperty abbreviatedIRI="rdfs:comment"/>
+        <IRI>http://graph.clouditor.io/classes/ObjectStorageService</IRI>
+        <Literal>An object storage service represents the network service that is used to access a list of object storage containers. The storage itself is modelled as a ObjectStorage. The service has an http endpoint.</Literal>
+    </AnnotationAssertion>
+    <AnnotationAssertion>
+        <AnnotationProperty abbreviatedIRI="rdfs:label"/>
+        <IRI>http://graph.clouditor.io/classes/ObjectStorageService</IRI>
+        <Literal>ObjectStorageService</Literal>
+    </AnnotationAssertion>
     <AnnotationAssertion>
         <AnnotationProperty abbreviatedIRI="rdfs:label"/>
         <IRI>http://graph.clouditor.io/classes/Operation</IRI>
@@ -2728,6 +2750,11 @@ name = metadata.name</Literal>
         <IRI>http://graph.clouditor.io/classes/Storage</IRI>
         <Literal xml:lang="english">Storage</Literal>
     </AnnotationAssertion>
+    <AnnotationAssertion>
+        <AnnotationProperty abbreviatedIRI="rdfs:comment"/>
+        <IRI>http://graph.clouditor.io/classes/StorageService</IRI>
+        <Literal>This entity represents a network-based service that can be used to access a particular storage backend. It has multiple subclasses, e.g., for databases or object stores. It has a list of storage resources associated to it.</Literal>
+    </AnnotationAssertion>
     <AnnotationAssertion>
         <AnnotationProperty abbreviatedIRI="rdfs:label"/>
         <IRI>http://graph.clouditor.io/classes/StorageService</IRI>

owl2java/src/main/kotlin/io/clouditor/graph/OWLCloudOntology.kt

@@ -583,7 +583,7 @@ class OWLCloudOntology(filepath: String, private val resourceNameFromOwlFile: St
         for (elem in nce.classesInSignature) {
             for (item in EntitySearcher.getAnnotationObjects(elem, ontology!!)) {
                 if (item != null) {
-                    if (item.property.iri.remainder.get().toString() == "description") {
+                    if (item.property.iri.remainder.get() == "comment") {
                         var description = item.value.toString()
                         return  description.substring(1, description.length-1)
                     }