Finding your way around the Marboard code: Difference between revisions

The [http://stendhal.game-host.org/hudson/job/marboard_HEAD/javadoc JavaDoc API Documentation] is generated nightly.

In order to build Marboard you can either use Eclipse or the provided Ant script.

Apache Ant is available at [http://ant.apache.org http://ant.apache.org]. After installing it, you can use this command to build the distribution .zip files:

ant dist

You can find the Java code making up the client and server in the folder "src". The folder "tests" contains Java code, too. To be more precise it contains automatic tests that ensure the quality of our software. Marboard depends on a number of libraries that we put into the folder "libs" for your convenience. The folder "build" is the home for software required for quality assurance during build time.

Let's have a closer look at the "src" folder. According to the java package naming convention the subfolders start "net/sf/arianne" with is the inversed structure of our project domain. Below the folder "marboard" you can find the folders "client" and "server" which contains specific code for either of them. In the future there might also be a folder called "commons" for shared code.

=== Client Code ===

The client code is structured in three package trees: "core" contains the stuff that holds the client together below the hood.

All objects that are transfered to or form the servers are called entities and are stored in the "entity" package tree. We are currently distinguishing two types: shapes and meta entities.

And the largest package tree "gui" is about the user interface. It has subpackages for various parts of the user interface like the menu and toolbar and more abstract concepts like the user interacting with the drawing tools.

=== Service Code ===

The server code is similarly split into a "core" and an "entity" package tree.

All commands that are sent from the client to the server are handled in the "action" package tree.

== Ohloh Statistics ==

<div style="border: dotted 1px black; float:left">{{#ohloh:p|481478|project_factoids}}</div>

{{#breadcrumbs: [[Marboard]] | [[Marboard#For_Coderss|Coding]] | [[Finding your way around the Marboard code|Code]] }}