Architecture overview: Difference between revisions
(Created page with "== Overview of the Diaspora* Network == == Overview of used technologies == For D*. background processing of jobs is important, because we do a lot of network communication ...") |
No edit summary |
||
Line 1: | Line 1: | ||
== Overview of the Diaspora* Network == | == Overview of the Diaspora* Network == | ||
[[File:Network.png]] | |||
== Overview of used technologies == | == Overview of used technologies == |
Revision as of 18:03, 12 January 2013
Overview of the Diaspora* Network
Overview of used technologies
For D*. background processing of jobs is important, because we do a lot of network communication with other servers, and we can't have the UI block while that is taking place his is taken care of by Resque (another Gem, https://github.com/blog/542-introducing-resque) and Redis (a key-value store) so, when you write a post, your server saves it to the database and hands processing (e.g. sending your post to users on different servers) over to Resque, which then takes place in the background as a separate process
Application Structure
Every request goes throug the Rails routing mechanism (http://guides.rubyonrails.org/routing.html) - every URL is mapped to an action inside a controller.
e.g. When a user requests the stream page with the Browser:
GET yourpod.net/stream -> StreamsController#multi
When a user writes a new post from the Browser:
POST yourpod.net/status_messages -> StatusMessagesController#create
The Diaspora* protocol uses HTTPS as transfer mechanism, so receiving messages from other Server also get routed via Rails to a controller action:
e.g. When a user receives a message from another Server:
POST yourpod.net/receive/public -> PublicsController#receive
Rails enforces a Model-View-Controller based approach for application design (http://guides.rubyonrails.org/getting_started.html#the-mvc-architecture) and encourages the developers to stick to REST-ful routes as much as possible (http://guides.rubyonrails.org/getting_started.html#rest).
Controllers
Controllers can be divided into two basic use-cases: Web UI handling and protocol handling. Web UI contains the normal HTML responses, AJAX responses and some special cases like ATOM feeds or Webfinger for user discovery. The protocol handlers are the entry points for the Diaspora* server-to-server protocol, where messages from other servers are received.
Automated Testing
Also, there are many automated Tests written for Rspec (another Gem, automated Testing framework for Ruby), Jasmine (JavaScript testing Framework) and Cucumber (Integration Tests using a remote-controlled Browser session, that acutally interacts with the site like a user would). See also: http://wiki.diaspora-project.org/wiki/Testing_Workflow