Meetify - Meeting Assistance Application

Der Server ist ein einziges C-Programm welches in einzelne Module aufgeteilt ist und mithilfe eines Makefile zusammengefügt wird. Er wurde zum größten Teil mit Notepad++ und Atom entwickelt, jedoch könnten in der Zukunft beliebige IDEs genutzt werden. Es müsste jedoch immer eine Möglichkeit bestehen die Quellcodedateien für die jeweilige Serverarchitektur (ajax-der-kleine) zu cross-kompilieren.
Die Module haben eine Quellcodedatei (.c) welche die eigentlichen Funktionen enthält, einen Header (.h) welcher Includes, Datenstrukturen und Funktionsköpfe beinhaltet. Das Makefile erstellt zu jedem Teilmodul ein kompiliertes Object-File (.o), diese sind maschinenspezifisch und sollten niemals per Hand editiert werden. Der Server besteht aus den folgenden Modulen.

-Server.c:

Das Servermodul ist das Herzstück des Servers und enthält das Big-Picture was die Logik betrifft. Er besteht im Wesentlichen aus dem Haupt-Thread welcher durchgehend mit accept() auf neue Anfragen (REQUEST) wartet und diese bearbeitet. Und dem MeetingThread welcher immer jeweils ein Meeting verwaltet und sich um alle Änderungen kümmert. Innerhalb des MeetingThread warten wir auf Änderungen (CMD) von den Clients, z.B. neues Agenda-Item. Er verarbeitet diese und leitet die Änderungen an alle Clients weiter die sich aktuell in dem Meeting befinden. Zum Überwachen von allen aktuellen Client-Verbindungen wird der Systemaufruf poll() verwendet.

- Network.c:

Das Netzwerkmodul stellt 2 wichtige Funktionalitäten bereit:

1. Das Initialisieren eines neuen Server-Socket welches auf eingehende Verbindungsanfragen von Endgeräten wartet.
2. Ein passendes Recv/Send Gegenstück zu den Send/Recv Methoden des ConnectorSocket

Die im C-Standard verfügbaren Funktionen arbeiten nur mit Byte-Arrays und garantieren
nicht, dass alle Bytes aus einem gegebenen Buffer verschickt werden. Um diesen beiden
Probleme einzukapseln stellt das Netzwerkmodul neue Send/Recv Funktionen bereit welche
einen MemBuf komplett verschicken, und empfangene Daten korrekt in einem gegebenen MemBuf speichern. Es wird eine Symmetrie zwischen einem Send und einem Recv-Aufruf, insofern dies möglich ist, garantiert.

- MemBuf.c:

Da häufig das Problem auftritt komplexere Daten wie Integer und Strings als Bytes zu speichern werden diese Funktionen von dem MemBuf bereitgestellt. Dieser bietet die Möglichkeit Strings beliebiger Länge und Integer beliebiger Wortbreite zu speichern, ohne über Bufferüberläufe oder Endianness nachdenken zu müssen. Der Buffer wächst bei Bedarf automatisch, alle Integer werden als Big-Endian gespeichert und alle Strings im UTF-8 Format.

-ArrayList.c:

Das Speichern und Verwalten von einer großen Menge Daten variabler Größe und Zahl wird über eine ArrayList realisiert. Diese ist im Prinzip nichts weiter als ein Array, stellt jedoch die für eine Liste typischen Funktionen (add, insert, remove, etc.) zusätzlich zu Verfügung. So kann die Effizienz eines Arrays mit der Bedienbarkeit einer Liste verbunden werden. Darüber hinaus werden oft sogenannte flexible array members genutzt um in einer C-struct zusätzlich einen String zu speichern, so z.B. bei einem AgendaItem oder einer ChatMessage, dadurch verbessert sich die Speicherlokalität des Servers.

- Meeting.c:

Alle wichtigen Datenstrukturen für ein Meeting sind hier definiert, zusätzlich gibt es noch einige Hilfsmethoden zu Umgang mit diesen.

- Security.c:
Alle sicherheitstechnischen Funktionen werden in diesem Modul implementiert. Zurzeit ist das nur die ChallengeResponse, alle weiteren Funktionen, z.B. zur Verschlüsselung sollten hier platziert werden.

- Protocol.h:

Hier sind alle wichtigen Konstanten die im Protokoll verwendet werden definiert, die meisten Änderungen in dieser Datei sollten Änderungen in Protocol.java nach sich ziehen.

- Support.h:

Einige nützliche Funktionen sind hier untergebracht, z.B die malloc-Familie mit bereits geprüften Rückgabewerten. Es können weitere allgemeine Funktionen hier eingebaut werden.

- ManagedMemoryArrayList.c:

Eine modifizierte ArrayList welche, anstatt nur Referenzen zu verwalten, ihren Inhalt kopiert und bei einem remove/delete wieder löscht. Das kann hilfreich sein um Memory-Leaks zu vermeiden. Im Moment ist diese Modul aber noch ungenutzt.