2014-11-10 19:43:16 +01:00
|
|
|
Synapse Architecture
|
|
|
|
|
====================
|
|
|
|
|
|
|
|
|
|
As of the end of Oct 2014, Synapse's overall architecture looks like::
|
|
|
|
|
|
2014-11-10 22:56:52 +01:00
|
|
|
synapse
|
|
|
|
|
.-----------------------------------------------------.
|
|
|
|
|
| Notifier |
|
|
|
|
|
| ^ | |
|
|
|
|
|
| | | |
|
|
|
|
|
| .------------|------. |
|
|
|
|
|
| | handlers/ | | |
|
|
|
|
|
| | v | |
|
2014-11-11 05:35:16 +01:00
|
|
|
| | Event*Handler <--------> rest/* <=> Client
|
2014-11-10 22:56:52 +01:00
|
|
|
| | Rooms*Handler | |
|
|
|
|
|
HSes <=> federation/* <==> FederationHandler | |
|
|
|
|
|
| | | PresenceHandler | |
|
|
|
|
|
| | | TypingHandler | |
|
|
|
|
|
| | '-------------------' |
|
|
|
|
|
| | | | |
|
|
|
|
|
| | state/* | |
|
|
|
|
|
| | | | |
|
|
|
|
|
| | v v |
|
|
|
|
|
| `--------------> storage/* |
|
|
|
|
|
| | |
|
|
|
|
|
'--------------------------|--------------------------'
|
2014-11-10 19:43:16 +01:00
|
|
|
v
|
|
|
|
|
.----.
|
|
|
|
|
| DB |
|
|
|
|
|
'----'
|
|
|
|
|
|
|
|
|
|
* Handlers: business logic of synapse itself. Follows a set contract of BaseHandler:
|
|
|
|
|
|
2014-11-10 23:07:08 +01:00
|
|
|
- BaseHandler gives us onNewRoomEvent which: (TODO: flesh this out and make it less cryptic):
|
2014-11-10 19:43:16 +01:00
|
|
|
|
2014-11-10 23:07:08 +01:00
|
|
|
+ handle_state(event)
|
|
|
|
|
+ auth(event)
|
|
|
|
|
+ persist_event(event)
|
|
|
|
|
+ notify notifier or federation(event)
|
2014-11-10 19:43:16 +01:00
|
|
|
|
2014-11-10 23:07:08 +01:00
|
|
|
- PresenceHandler: use distributor to get EDUs out of Federation. Very
|
|
|
|
|
lightweight logic built on the distributor
|
|
|
|
|
- TypingHandler: use distributor to get EDUs out of Federation. Very
|
|
|
|
|
lightweight logic built on the distributor
|
|
|
|
|
- EventsHandler: handles the events stream...
|
|
|
|
|
- FederationHandler: - gets PDU from Federation Layer; turns into an event;
|
|
|
|
|
follows basehandler functionality.
|
|
|
|
|
- RoomsHandler: does all the room logic, including members - lots of classes in
|
|
|
|
|
RoomsHandler.
|
|
|
|
|
- ProfileHandler: talks to the storage to store/retrieve profile info.
|
2014-11-10 19:43:16 +01:00
|
|
|
|
|
|
|
|
* EventFactory: generates events of particular event types.
|
|
|
|
|
* Notifier: Backs the events handler
|
|
|
|
|
* REST: Interfaces handlers and events to the outside world via HTTP/JSON.
|
|
|
|
|
Converts events back and forth from JSON.
|
|
|
|
|
* Federation: holds the HTTP client & server to talk to other servers. Does
|
|
|
|
|
replication to make sure there's nothing missing in the graph. Handles
|
|
|
|
|
reliability. Handles txns.
|
|
|
|
|
* Distributor: generic event bus. used for presence & typing only currently.
|
|
|
|
|
Notifier could be implemented using Distributor - so far we are only using for
|
|
|
|
|
things which actually /require/ dynamic pluggability however as it can
|
|
|
|
|
obfuscate the actual flow of control.
|
|
|
|
|
* Auth: helper singleton to say whether a given event is allowed to do a given
|
|
|
|
|
thing (TODO: put this on the diagram)
|
|
|
|
|
* State: helper singleton: does state conflict resolution. You give it an event
|
|
|
|
|
and it tells you if it actually updates the state or not, and annotates the
|
|
|
|
|
event up properly and handles merge conflict resolution.
|
|
|
|
|
* Storage: abstracts the storage engine.
|
