Wir haben für die Kommunikation mit unseren Servern ein simples Protokoll entwickelt: Anfragen und Ergebnisse werden als einzeilige Strings (newline terminiert) verschickt. Die einzelnen Attribute einer Annotation werden als ,,key/value`` Paare repräsentiert und sind voneinander durch Semikola getrennt. Probleme könnte es dadurch aber mit einigen Firewalls geben, die nur HTTP-Verbindungen zulassen.
Annotationen werden dem Server mit folgender Anweisung übergeben, wobei die Reihenfolge der Attribute beliebig ist:
SPMquotANNOTATE to: <URL>; Author: <Autor>; Date: <Datum>;SPMquotPos: <Textstelle>; Annotation: <Text>;SPMquotrefersTo: <Bezug ID>;endquoteDer eindeutige Bezeichner wird vom Annotations-Server bestimmt und die gesamte Annotation gespeichert. Bisher wird als Bezeichner die Anzahl der Sekunden seit dem 1.1.1970 genommen. Falls einmal nicht nur ein Server für die Annotationen zuständig sein sollte, müßte diese Zahl z.B. noch um die Rechner IP erweitert werden.
SPMquotRETRIEVE for: <URL>;endquoteliefert, so vorhanden, alle Annotationen in der Form
SPMquotANNO Author: <Autor>; Date: <Datum>; Pos: <Textstelle>;SPMquotAnnotation: <Text>; Name: <Annotations ID>;SPMquotrefersTo: <Bezug ID>;endquote
SPMquotANNO Author: <Autor>; Date: <Datum>; Pos: <Textstelle>;SPMquotAnnotation: <Text>; Name: <Annotations ID>;SPMquotrefersTo: <Bezug ID>;endquote
SPMquotRETRIEVE for: <URL>;endquoteliefert, so vorhanden, alle Annotationen in der Form
SPMquotANNO Author: <Autor>; Date: <Datum>; Pos: <Textstelle>;SPMquotAnnotation: <Text>; Name: <Annotations ID>;SPMquotrefersTo: <Bezug ID>;endquote
SPMquotANNO Author: <Autor>; Date: <Datum>; Pos: <Textstelle>;SPMquotAnnotation: <Text>; Name: <Annotations ID>;SPMquotrefersTo: <Bezug ID>;endquote
SPMquotANNOTATE to: <URL>; Author: <Autor>; Date: <Datum>;
SPMquot Pos: <Textstelle>; Annotation: <Text>;
SPMquot refersTo: <Bezug ID>;endquote
Der eindeutige Bezeichner wird vom Annotations-Server bestimmt und die gesamte Annotation gespeichert. Bisher wird als Bezeichner die Anzahl der Sekunden seit dem 1.1.1970 genommen. Falls einmal nicht nur ein Server für die Annotationen zuständig sein sollte, müßte diese Zahl z.B. noch um die Rechner IP erweitert werden.
SPMquotRETRIEVE for: <URL>;endquoteliefert, so vorhanden, alle Annotationen in der Form
SPMquotANNO Author: <Autor>; Date: <Datum>; Pos: <Textstelle>;SPMquotAnnotation: <Text>; Name: <Annotations ID>;SPMquotrefersTo: <Bezug ID>;endquote
SPMquotANNO Author: <Autor>; Date: <Datum>; Pos: <Textstelle>;SPMquotAnnotation: <Text>; Name: <Annotations ID>;SPMquotrefersTo: <Bezug ID>;endquote
SPMquotRETRIEVE for: <URL>;endquote
liefert, so vorhanden, alle Annotationen in der Form
SPMquotANNO Author: <Autor>; Date: <Datum>; Pos: <Textstelle>;SPMquotAnnotation: <Text>; Name: <Annotations ID>;SPMquotrefersTo: <Bezug ID>;endquote
SPMquotANNO Author: <Autor>; Date: <Datum>; Pos: <Textstelle>;
SPMquot Annotation: <Text>; Name: <Annotations ID>;
SPMquot refersTo: <Bezug ID>;endquote