X-Git-Url: https://dreyeck.freedombox.rocks/gitweb/topic-maps.git/blobdiff_plain/7f4aa941293e555ccb9d96f0c05c651b0549a866..1418be83ad013fe6d69e6036e6786be8100b9355:/src/xtm/reader.lisp diff --git a/src/xtm/reader.lisp b/src/xtm/reader.lisp index 069ced3..56d5785 100644 --- a/src/xtm/reader.lisp +++ b/src/xtm/reader.lisp @@ -177,8 +177,7 @@ constructs' complete subgrammars is made. XML errors have already been checked." ((string= name "occurrence") (attributes node '("reifier") nil) (when (attr node "reifier") - (resolve-iri (attr node "reifier") *document-iri* node) - (reject :unsupported-construct "XTM occurrence reification is not implemented in this subset." node 'xtm-unsupported)) + (resolve-iri (attr node "reifier") *document-iri* node)) (let ((phase 0) (type-seen nil) (scope-seen nil) (resource-seen nil)) (dolist (child (elements node)) (check-namespace child) @@ -191,9 +190,7 @@ constructs' complete subgrammars is made. XML errors have already been checked." (when (< next phase) (reject :element-order "occurrence child order is invalid." child)) (setf phase next) (cond - ((string= kind "itemIdentity") - (validate child '("itemIdentity")) - (reject :unsupported-construct "XTM occurrence item identifiers are not implemented in this subset." child 'xtm-unsupported)) + ((string= kind "itemIdentity") nil) ((string= kind "type") (when type-seen (reject :duplicate-occurrence-type "Only one occurrence type is allowed." child)) (setf type-seen t)) @@ -205,9 +202,46 @@ constructs' complete subgrammars is made. XML errors have already been checked." (unless type-seen (reject :missing-occurrence-type "occurrence requires type before its resource." child)) (when resource-seen (reject :occurrence-resource-cardinality "occurrence requires exactly one resource." child)) (setf resource-seen t))) - (validate child '("type" "scope" "resourceData" "resourceRef")))) + (validate child '("itemIdentity" "type" "scope" "resourceData" "resourceRef")))) (unless type-seen (reject :missing-occurrence-type "occurrence requires a type element." node)) (unless resource-seen (reject :missing-occurrence-resource "occurrence requires a resource element." node)))) + ((member name '("association" "role") :test #'string=) + (attributes node '("reifier") nil) + (when (attr node "reifier") + (resolve-iri (attr node "reifier") *document-iri* node)) + (let ((association-p (string= name "association")) + (phase 0) (type-seen nil) (scope-seen nil) (participants 0)) + (dolist (child (elements node)) + (check-namespace child) + (let* ((kind (node-name child)) + (next (cond ((string= kind "itemIdentity") 0) + ((string= kind "type") 1) + ((and association-p (string= kind "scope")) 2) + ((string= kind (if association-p "role" "topicRef")) 3)))) + (unless next (reject :unexpected-element (format nil "Unexpected ~A element." kind) child)) + (when (< next phase) (reject :element-order (format nil "~A child order is invalid." name) child)) + (setf phase next) + (cond + ((string= kind "itemIdentity") nil) + ((string= kind "type") + (when type-seen (reject :duplicate-type (format nil "Only one ~A type is allowed." name) child)) + (setf type-seen t)) + (t + (unless type-seen + (reject :missing-type (format nil "~A requires type before ~A." name kind) child)) + (if (string= kind "scope") + (progn + (when scope-seen (reject :duplicate-scope "Only one association scope is allowed." child)) + (setf scope-seen t)) + (progn + (incf participants) + (when (and (not association-p) (> participants 1)) + (reject :role-player-cardinality "role requires exactly one topicRef player." child)))))) + (validate child (if association-p '("itemIdentity" "type" "scope" "role") '("itemIdentity" "type" "topicRef"))))) + (unless type-seen (reject :missing-type (format nil "~A requires a type element." name) node)) + (when (zerop participants) + (reject (if association-p :missing-roles :missing-role-player) + (if association-p "association requires at least one role." "role requires a topicRef player.") node)))) ((string= name "resourceRef") (leaf-href node)) ((string= name "resourceData") (attributes node '("datatype") nil) @@ -277,6 +311,45 @@ constructs' complete subgrammars is made. XML errors have already been checked." (topic-maps.tmdm:make-association map (core-topic map "type-instance") (list (list (core-topic map "type") type) (list (core-topic map "instance") (topic-maps.tmdm:canonical-topic owner))))))) +(defun read-item-identities (node item) + ;; XTM 4.6: assign locators to the actual canonical item, never intern Topics. + ;; ADD-ITEM-IDENTIFIER owns set semantics and cross-item conflict checks. + (dolist (child (elements node) item) + (when (string= (node-name child) "itemIdentity") + (setf item (topic-maps.tmdm:add-item-identifier item (leaf-href child)))))) +(defun read-association (node map) + ;; Resolve references in source order, then construct the complete native + ;; Association. The constructor may already merge Associations AND Roles. + (let ((type nil) (scope nil) (roles nil) (role-nodes nil)) + (labels ((reference (ref) (find-reference-topic map (reference-iri ref))) + (type-reference (node) (reference (first (elements node))))) + (dolist (child (elements node)) + (cond ((string= (node-name child) "type") (setf type (type-reference child))) + ((string= (node-name child) "scope") (setf scope (mapcar #'reference (elements child)))) + ((string= (node-name child) "role") + (let ((children (elements child))) + (push (list (type-reference (find "type" children :key #'node-name :test #'string=)) + (reference (find "topicRef" children :key #'node-name :test #'string=))) roles) + (push child role-nodes))))) + (let ((association (read-item-identities node + (topic-maps.tmdm:make-association map type (reverse roles) :scope scope)))) + ;; Match source metadata to the native Role by its complete signature + ;; within THIS canonical Parent. Role order/II are not equality keys. + (loop for pair in (reverse roles) for source in (reverse role-nodes) do + ;; A preceding Role Reifier may have merged Topics and this Parent. + (setf association (topic-maps.tmdm:canonical-association association)) + (let ((role (find-if (lambda (role) + (and (eq (topic-maps.tmdm:association-role-type role) + (topic-maps.tmdm:canonical-topic (first pair))) + (eq (topic-maps.tmdm:association-role-player role) + (topic-maps.tmdm:canonical-topic (second pair))))) + (topic-maps.tmdm:association-roles association)))) + (setf role (read-item-identities source role)) + (read-item-reifier source (topic-maps.tmdm:canonical-association-role role) map))) + ;; Role metadata is now on the native canonical Parent. Reifier merging + ;; may normalize it again; return the resulting Association handle. + (topic-maps.tmdm:canonical-association + (read-item-reifier node association map)))))) (defun read-resource-value (resource) "Return value and datatype for a validated resource node (XTM 4.16/4.17). This operation neither looks up Topics nor fetches resources. ANYTYPE is rejected @@ -299,9 +372,7 @@ by source validation before model construction. Preserve other datatype IRIs." ;; ADD-VARIANT owns canonicalization and the proper-superset constraint. (let ((variant (topic-maps.tmdm:add-variant name value :datatype datatype :scope (append (topic-maps.tmdm:topic-name-scope name) explicit)))) - (dolist (child children) - (when (string= (node-name child) "itemIdentity") - (setf variant (topic-maps.tmdm:add-item-identifier variant (leaf-href child))))) + (setf variant (read-item-identities node variant)) ;; Reification may normalize again; retain the native canonical handle. (topic-maps.tmdm:canonical-variant (read-item-reifier node variant map)))))) (defun read-name (node owner map) @@ -322,9 +393,7 @@ by source validation before model construction. Preserve other datatype IRIs." (topic-maps.tmdm:add-default-name owner value :scope scope)))) ;; Item identifiers belong to the canonical Name, never its owner/type. ;; Use the shared model API for set semantics and global conflicts. - (dolist (child children) - (when (string= (node-name child) "itemIdentity") - (setf name (topic-maps.tmdm:add-item-identifier name (leaf-href child))))) + (setf name (read-item-identities node name)) ;; ADD-NAME may have returned an existing canonical Name. Reifier ;; resolution/merging can normalize it again: retain the native result ;; before processing Variants and return the current Name handle. @@ -344,7 +413,11 @@ by source validation before model construction. Preserve other datatype IRIs." (resource (find-if (lambda (child) (member (node-name child) '("resourceData" "resourceRef") :test #'string=)) children))) (multiple-value-bind (value datatype) (read-resource-value resource) (topic-maps.tmdm:canonical-occurrence - (topic-maps.tmdm:add-occurrence owner type value :datatype datatype :scope scope))))) + ;; Resolve Reifier by II only after native Occurrence normalization and + ;; II assignment. Reifier merging can normalize again: return its handle. + (read-item-reifier node + (read-item-identities node + (topic-maps.tmdm:add-occurrence owner type value :datatype datatype :scope scope)) map))))) (defun read-topic (node map) (let ((topic (topic-maps.tmdm:intern-topic map :item-identifier (concatenate 'string *document-iri* "#" (collapse-space (attr node "id")))))) @@ -440,5 +513,6 @@ is mutated. Each public call has its own resource recursion context." ((string= (node-name child) "mergeMap") (read-mergemap child map resource-resolver max-resource-depth (cons document-iri active-iris))) + ((string= (node-name child) "association") (read-association child map)) (t (read-topic child map)))) map)))