Stendhal code design: Difference between revisions
Jump to navigation
Jump to search
Content deleted Content added
imported>Durkham No edit summary |
imported>Hendrik Brummermann No edit summary |
||
| (150 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
{{Stendhal code design}}{{Navigation for Stendhal Top|Developing}}__NOTOC__ |
|||
== Client == |
|||
This page gives a little overview about the Stendhal code. |
|||
== Development Environment == |
|||
Stendhal is completely open source. So you can [http://arianne.sourceforge.net/download/stendhal-src.tar.gz download the source code] and have a look. If you plan to modify it and contribute to the project, we suggest that you use the Eclipse IDE and checkout the latest development state from our version control system. |
|||
The base client ([ideally] free of any specific UI) is '''StendhalClient'''. It is responsible for interacting with the server, maintaining private user information/state, and dispatching object events. |
|||
There are good [[Configure a development environment (IDE)|tutorials]] to get you started with Eclipse. |
|||
== Finding your way around the Code == |
|||
=== Entities === |
|||
The next step is to find your way around the code. The Stendhal code base is roughly divided into the server, client and a little code that is used by both: |
|||
Entity's are created using '''EntityFactory.createEntity()'''. In this method, the appropriete implementation class is created, and initialize. |
|||
* [[Finding your way around the Stendhal Server Code]] |
|||
'''Example:''' |
|||
* [[Finding your way around the Stendhal Client Code]] |
|||
* [[Finding your way around the Stendhal Web Client Code]] (early development) |
|||
RPObject object = ... |
|||
| ⚫ | |||
Entity entity = EntityFactory.createEntity(object); |
|||
// Force the view to be created |
|||
entity.getView(); |
|||
| ⚫ | |||
// Done with entity - free up resources |
|||
entity.release(); |
|||
| ⚫ | |||
The design is being transitioned to a Model-View-Controller (MVC) like framework. This will allow different visual implementations (like 2D, 3D, 4D?) to be plugged in with minimal (or no) changes of the model class. |
|||
| ⚫ | |||
| ⚫ | |||
'''Model/Controller''' |
|||
* We use tab for all indentation. (One tab is equivalent to 4 spaces for display purpose.) |
|||
This contains all logical entity data, and is responsible for tracking all entity specific attribute changes in the RPObject that it wraps. Currently this also handles some of the UI controller functions. |
|||
| ⚫ | |||
* We always use blocks in if-statements and loops, even if the block only consists of one single statement: |
|||
The '''initialize()''' method is called with the RPObject that it will represent. This method is called after the constructor returns, but before anything else is [externally] called. |
|||
<code> |
|||
When the client no longer needs the entity, it should call '''release()''', which should handling any cleanup that garbage collection only is insufficient. |
|||
if (condition) { |
|||
method(); |
|||
| ⚫ | |||
</code> |
|||
Avoid evaluation and assignment in the same line like: |
|||
The class gets notified of object changes via the '''RPObjectChangeListener''' interface that it implements. This will be called for all changes to it's object (and immediate slot objects). |
|||
* ternary operators, for example in: |
|||
Methods |
|||
<code>String y = x==null ? "NULL": x.toString();</code> |
|||
* post-increment/decrement operators as in: |
|||
* getArea() |
|||
if (idx++ == 10) { |
|||
| ⚫ | |||
This returns the "ground" area that the entity occupies, as it is in the server (with real-time motion adjustments made by the client). |
|||
} |
|||
* update(delta) |
|||
This is called periodically so that the entity can update any active state. It is passed the number of milliseconds since the last call. |
|||
'''View''' |
|||
The current view implementation is Entity2DView. This is responsible for rendering an entity in a 2D view. |
|||
=== Sound System === |
|||
''TBW''... |
|||
=== UI === |
|||
The user interface (UI) is responsible for bringing together the base client and user interaction. The base class is '''StendhalUI''', and is extended by an appropriete implementation (currently j2DClient). |
|||
---- |
|||
== Server == |
|||
| ⚫ | |||
| ⚫ | |||
| ⚫ | |||
* We use tab for all indentation. |
|||
| ⚫ | |||