feat!: add archive representation to DSP-API (DEV-17)

docs/03-apis/api-v2/editing-values.md

@@ -222,6 +222,7 @@ DSP-API v2 currently supports using Sipi to store the following types of files:
 * Audio: MPEG, MP4, or Waveform audio file format (.wav, .x-wav, .vnd.wave)
 * Text files: TXT, XML, or CSV
 * Video files: MP4
+* Archive files: ZIP, TAR, GZIP
 
 Support for other types of files will be added in the future.
 
@@ -328,6 +329,10 @@ For a text file, use `knora-api:TextRepresentation`, which has the property
 `knora-api:hasTextFileValue`, pointing to a
 `knora-api:TextFileValue`.
 
+For an archive like zip, use `knora-api:ArchiveRepresentation`, which has the property
+`knora-api:hasArchiveFileValue`, pointing to a
+`knora-api:ArchiveFileValue`.
+
 ## Updating a Value
 
 To update a value, use this route:

knora-ontologies/knora-base.ttl

@@ -371,22 +371,45 @@
 
 :hasDocumentFileValue rdf:type owl:ObjectProperty ;
 
-              rdfs:label "hat Dokument"@de ,
-                         "has document"@en ,
-                         "a document"@fr ,
-                         "ha documento"@it ;
+                      rdfs:label "hat Dokument"@de ,
+                      "has document"@en ,
+                      "a document"@fr ,
+                      "ha documento"@it ;
 
-              rdfs:comment "Connects a Representation to a document"@en ;
+                      rdfs:comment "Connects a Representation to a document"@en ;
 
-              :objectClassConstraint :DocumentFileValue ;
+                      :objectClassConstraint :DocumentFileValue ;
 
-              :subjectClassConstraint :DocumentRepresentation ;
+                      :subjectClassConstraint :DocumentRepresentation ;
 
-              :isEditable true ;
+                      :isEditable true ;
 
-              salsah-gui:guiElement salsah-gui:Fileupload ;
+                      salsah-gui:guiElement salsah-gui:Fileupload ;
 
-              rdfs:subPropertyOf :hasFileValue .
+                      rdfs:subPropertyOf :hasFileValue .
+
+
+
+###  http://www.knora.org/ontology/knora-base#hasArchiveFileValue
+
+:hasArchiveFileValue rdf:type owl:ObjectProperty ;
+
+                      rdfs:label "hat Zip"@de ,
+                      "has zip"@en ,
+                      "a zip"@fr ,
+                      "ha zip"@it ;
+
+                      rdfs:comment "Connects a Representation to a zip archive"@en ;
+
+                      :objectClassConstraint :ArchiveFileValue ;
+
+                      :subjectClassConstraint :ArchiveRepresentation ;
+
+                      :isEditable true ;
+
+                      salsah-gui:guiElement salsah-gui:Fileupload ;
+
+                      rdfs:subPropertyOf :hasFileValue .
 
 
 
@@ -1041,8 +1064,8 @@
            # No :subjectClassConstraint, because this can be used with :Resource or :Value.
 
            :objectClassConstraint knora-admin:User .
-           
-           
+
+
 #################################################################
 #
 #    Datatype properties
@@ -1797,15 +1820,39 @@
 :DocumentRepresentation rdf:type owl:Class ;
 
                         rdfs:label "Repräsentation (Dokument)"@de ,
-                                   "Representation (Document)"@en ,
-                                   "Répresentation (Document)"@fr ,
-                                   "Rappresentazione (Documento)"@it ;
+                        "Representation (Document)"@en ,
+                        "Répresentation (Document)"@fr ,
+                        "Rappresentazione (Documento)"@it ;
 
                         rdfs:subClassOf :Representation ,
-                                [ rdf:type owl:Restriction ;
-                                  owl:onProperty :hasDocumentFileValue ;
-                                  owl:cardinality "1"^^xsd:nonNegativeInteger
-                                ] .
+                        [ rdf:type owl:Restriction ;
+                          owl:onProperty :hasDocumentFileValue ;
+                          owl:cardinality "1"^^xsd:nonNegativeInteger
+                                 ] .
+
+
+
+###  http://www.knora.org/ontology/knora-base#ArchiveFileValue
+
+:ArchiveFileValue rdf:type owl:Class ;
+
+                   rdfs:subClassOf :FileValue .
+
+
+###  http://www.knora.org/ontology/knora-base#ArchiveRepresentation
+
+:ArchiveRepresentation rdf:type owl:Class ;
+
+                        rdfs:label "Repräsentation (Zip)"@de ,
+                        "Representation (Zip)"@en ,
+                        "Répresentation (Zip)"@fr ,
+                        "Rappresentazione (Zip)"@it ;
+
+                        rdfs:subClassOf :Representation ,
+                        [ rdf:type owl:Restriction ;
+                          owl:onProperty :hasArchiveFileValue ;
+                          owl:cardinality "1"^^xsd:nonNegativeInteger
+                                 ] .
 
 
 

sipi/scripts/file_info.lua

@@ -11,6 +11,7 @@ IMAGE = "image"
 DOCUMENT = "document"
 AUDIO = "audio"
 VIDEO = "video"
+ARCHIVE = "archive"
 
 -------------------------------------------------------------------------------
 -- Mimetype constants
@@ -67,10 +68,7 @@ local text_mime_types = {
 
 local document_mime_types = {
     APPLICATION_PDF,
-    APPLICATION_TAR,
-    APPLICATION_ZIP,
     APPLICATION_ISO,
-    APPLICATION_GZIP,
     APPLICATION_DOC,
     APPLICATION_DOCX,
     APPLICATION_XLS,
@@ -79,6 +77,12 @@ local document_mime_types = {
     APPLICATION_PPTX
 }
 
+local archive_mime_types = {
+    APPLICATION_TAR,
+    APPLICATION_ZIP,
+    APPLICATION_GZIP
+}
+
 local video_mime_types = {
     VIDEO_MP4
 }
@@ -99,10 +103,7 @@ local text_extensions = {
 
 local document_extensions = {
     "pdf",
-    "zip",
-    "tar",
     "iso",
-    "gz",
     "doc",
     "docx",
     "xls",
@@ -111,6 +112,12 @@ local document_extensions = {
     "pptx"
 }
 
+local archive_extensions = {
+    "zip",
+    "tar",
+    "gz"
+}
+
 local video_extensions = {
     "mp4"
 }
@@ -162,6 +169,17 @@ function make_document_file_info(extension)
     end
 end
 
+function make_archive_file_info(extension)
+    if not table.contains(archive_extensions, extension) then
+        return nil
+    else
+        return {
+            media_type = ARCHIVE,
+            extension = extension
+        }
+    end
+end
+
 -------------------------------------------------------------------------------
 -- Determines the media type and file extension of a file.
 -- Parameters:
@@ -174,7 +192,7 @@ end
 function get_file_info(filename, mimetype)
 
     local extension = filename:match("^.+%.([^.]+)$")
-    
+
     if extension == nil then
         return nil
     elseif table.contains(image_mime_types, mimetype) then
@@ -187,6 +205,8 @@ function get_file_info(filename, mimetype)
         return make_text_file_info(extension)
     elseif table.contains(document_mime_types, mimetype) then
         return make_document_file_info(extension)
+    elseif table.contains(archive_mime_types, mimetype) then
+        return make_archive_file_info(extension)
     else
         -- no supported mediatype could be determined
         return nil

test_data/ontologies/books-onto.ttl

@@ -41,7 +41,7 @@
 
 :Book
     rdf:type                owl:Class ;
-    rdfs:subClassOf         knora-base:Resource;
+    rdfs:subClassOf         knora-base:Resource ;
     knora-base:resourceIcon "book.png" ;
     rdfs:label              "Buch"@de, "Book"@en ;
     rdfs:comment            """A resource describing a book."""@en .
@@ -58,7 +58,7 @@
 
 :Page
     rdf:type                owl:Class ;
-    rdfs:subClassOf         knora-base:Resource;
+    rdfs:subClassOf         knora-base:Resource ;
     knora-base:resourceIcon "page.png" ;
     rdfs:label              "Seite"@de, "Page"@en ;
     rdfs:comment            """A resource describing a page in a book."""@en .