9Cards Service

This section explains how to start working with the 9Cards game service project.

Getting started

You need to check out the 9Cards Service as well as the Mobilis Server, which needs to be referenced in your IDE because the service uses some of it's classes. The server, in turn, is dependent on the project MobilisXMPP. It is recommended to checkout the Mobilis Console Client, too, which enables you to upload your game service to the Mobilis Server. The Console Client is dependent on the MXJ project, so you should check this out, too. For checking out projects from GitHub with Eclipse, you can use the EGit Plugin. See here for more information about how to setup the server and how to deploy services.

Besides referencing the Mobilis Server project in the build path of the 9Cards Service, you should also make sure to include the additional lib which is located in the service project's lib folder.

To build the service, you have to copy the file 'sample.local.properties' and rename it to 'local.properties'. Then you have to open it and adapt the value for the 'mobilis.root' key, it should point to the root of your local Mobilis repository. Make sure to use forward slashes ('/') even if you are working on a Windows system. All other values are already set up correctly.

Then you can run the file build_MobilisNineCardsService.xml as an ant script and upload the resulting .jar to the Mobilis Server by launching the Console Client and typing 'send multi path_to_jar' into the command line.

Packages

ninecards

This package contains the main class named 'NineCardsService' which is derived from the Mobilis Server project class 'MobilisService' and technically represents the 9Cards service. The package also contains some classes for holding the settings or representing the players.

communication

Contains the classes needed for sending and processing IQ type messages as well as chat messages which are being sent via the multiuser chat room (MUC), respectively those which are being sent as private chat message to the game service.

proxy

Contains the classes representing the particular message types. Usually these classes are created automatically by using the msdl file and the xslt scripts for transformation of msdl to code.

---

Up: Home