X-Git-Url: https://dreyeck.freedombox.rocks/gitweb/topic-maps.git/blobdiff_plain/fb60afd548d679d83fd8ec76bc5ff384c1e23e5f..66664dbff6275d60dab1bc6a232fa70f7b916b8c:/src/tmdm/items.lisp?ds=inline diff --git a/src/tmdm/items.lisp b/src/tmdm/items.lisp index 65fc13a..b3d90f8 100644 --- a/src/tmdm/items.lisp +++ b/src/tmdm/items.lisp @@ -1,15 +1,42 @@ (in-package #:topic-maps.tmdm) -;;; Only the information-item properties used by Slice 1 are materialized. +;;; Only Topic Map, Topic and unscoped Name properties are materialized. ;;; Omitted set-valued properties are implicitly empty, single-valued ones null ;;; (CTM 3.2). In particular all supported names have empty scope and variants. -(defstruct topic-map topics) -(defstruct (topic (:constructor %make-topic (parent))) - (parent nil :read-only t) item-identifiers subject-identifiers subject-locators names) -(defstruct (topic-name (:constructor %make-topic-name (value type parent))) +(defstruct (topic-map (:constructor make-topic-map ()) (:conc-name %topic-map-)) topics) +(defstruct (topic (:constructor %make-topic (parent)) (:conc-name %topic-)) + (parent nil :read-only t) item-identifiers subject-identifiers subject-locators names + ;; Implementation bookkeeping, not a TMDM property or another information item. + forward) +(defstruct (topic-name (:constructor %make-topic-name (value type parent)) (:conc-name %topic-name-)) (value "" :type string :read-only t) - (type nil :type topic :read-only t) - (parent nil :type topic :read-only t)) + (type nil :type topic) + (parent nil :type topic) + forward) + +(defun canonical-topic (topic) + "Resolve a retained reference to a Topic replaced by same-map merging. +EQ on obsolete objects does not change; compare their canonical representatives." + (check-type topic topic) + (loop for current = topic then (%topic-forward current) + unless (%topic-forward current) return current)) +(defun canonical-topic-name (name) + "Resolve a retained reference to a Name replaced during duplicate removal." + (check-type name topic-name) + (loop for current = name then (%topic-name-forward current) + unless (%topic-name-forward current) return current)) + +;; Public readers resolve obsolete handles and expose copies of set storage. +;; Mutations must use the identity/merge API to maintain model invariants. +(defun topic-map-topics (map) (copy-list (%topic-map-topics map))) +(defun topic-parent (topic) (%topic-parent (canonical-topic topic))) +(defun topic-item-identifiers (topic) (copy-list (%topic-item-identifiers (canonical-topic topic)))) +(defun topic-subject-identifiers (topic) (copy-list (%topic-subject-identifiers (canonical-topic topic)))) +(defun topic-subject-locators (topic) (copy-list (%topic-subject-locators (canonical-topic topic)))) +(defun topic-names (topic) (copy-list (%topic-names (canonical-topic topic)))) +(defun topic-name-value (name) (%topic-name-value (canonical-topic-name name))) +(defun topic-name-type (name) (%topic-name-type (canonical-topic-name name))) +(defun topic-name-parent (name) (%topic-name-parent (canonical-topic-name name))) ;; Avoid recursive printing through parent/type links; DESCRIBE remains useful. (defmethod print-object ((item topic-map) stream) @@ -23,51 +50,5 @@ (print-unreadable-object (item stream :type t :identity t) (format stream "~S" (topic-name-value item)))) -(defun identifiers (topic kind) - (ecase kind - (:item-identifier (topic-item-identifiers topic)) - (:subject-identifier (topic-subject-identifiers topic)) - (:subject-locator (topic-subject-locators topic)))) - -(defun intern-topic (map kind iri) - "Within one map, reuse an equal identity reference (TMDM 5.3.5). -This restricted interning does not implement general merge or cross-map merge." - (unless (and (typep map 'topic-map) (stringp iri) (plusp (length iri))) - (error "A map and a nonempty locator string are required.")) - (let* ((kinds (ecase kind - ((:item-identifier :subject-identifier) - '(:item-identifier :subject-identifier)) - (:subject-locator '(:subject-locator)))) - (existing - (find-if (lambda (topic) - (some (lambda (property) - (member iri (identifiers topic property) :test #'string=)) - kinds)) - (topic-map-topics map))) - (topic (or existing (%make-topic map)))) - (unless existing - ;; Private storage mutation: list order is observational, not TMDM semantics. - (setf (topic-map-topics map) (append (topic-map-topics map) (list topic)))) - (ecase kind - (:item-identifier (pushnew iri (topic-item-identifiers topic) :test #'string=)) - (:subject-identifier (pushnew iri (topic-subject-identifiers topic) :test #'string=)) - (:subject-locator (pushnew iri (topic-subject-locators topic) :test #'string=))) - topic)) - (defun default-name-type-identifier () "http://psi.topicmaps.org/iso13250/model/topic-name") - -(defun add-default-name (topic value) - "CTM 3.11 default type; unscoped name equality per TMDM 5.4." - (check-type topic topic) - (check-type value string) - (let* ((type (intern-topic (topic-parent topic) :subject-identifier - (default-name-type-identifier))) - (existing (find-if (lambda (name) - (and (string= value (topic-name-value name)) - (eq type (topic-name-type name)))) - (topic-names topic)))) - (or existing - (let ((name (%make-topic-name value type topic))) - (setf (topic-names topic) (append (topic-names topic) (list name))) - name))))