Granite Data Services

---

Overview

GraniteDS provides server and client libraries that can be used to connect desktop and mobile applications to a server using the AMF3 or JMF serialization protocols, through RPC (remoting) and different messaging technologies (Comet, WebSocket, UDP).

It also provides comprehensive data management features for use with Flex, JavaFX and Android applications.

Download

Artifacts are available on Maven central or on GraniteDS web site.

Licensing

The core GraniteDS libraries and clients (granite-server, granite-client-flex, granite-client-java) are released under the GNU Lesser General Public License, version 2.1.

Advanced libraries (granite-client-flex-advanced, granite-client-javafx, granite-client-android and granite-client-java-advanced) are released under the GNU General Public License, version 3.0. Commercial licenses are also available for these libraries, visit http://www.granitedataservices.com/license for more details.

Documentation

• Java server javadoc

• Flex client javadoc

• Java client javadoc

• JavaFX client javadoc

• Android client javadoc

• Flex Reference documentation is here.

• JavaFX Reference documentation is here.

Support

You can get community support on the GraniteDS user forums.

A dedicated Commercial support is also available.

Issues

You can report issues via the GraniteDS JIRA.

If you are not sure that what you get is a bug, please ask on the forums before submitting an issue.

Building from sources

GraniteDS uses Gradle as build system. You can use the gradle wrapper ./gradlew at the root of the project to run the build.

Requirements

JDK 6+ (JDK 7+ recommended for JavaFX), JavaFX 2+ (optional if using JDK 7+). When using JavaFX 2 on a JDK 6, you will have to copy jfxrt.jar in JAVA_HOME/jre/lib.

Adobe/Apache Flex requirements

The build of the Flex libraries is optional and requires Flex SDKs 3.6 and 4.5. Unfortunately due to licensing issues we can’t redistribute them or even publish them on a remote repository so you will have to download them manually and install them in the local maven repository (a Maven 3.x installation is thus also required):

• Download Flex 3.6

• Download Flex 4.5

Then zip them and install them like this:

cd /path/to/flex-sdk-3.6-parent-directory
zip -r flex-sdk-3.6.zip flex-sdk-3.6    // Note: on Windows use any GUI zip tool
mvn install:install-file -DgroupId=com.adobe -DartifactId=flex-sdk -Dversion=3.6 -Dpackaging=zip -Dfile=flex-sdk-3.6.zip

cd /path/to/flex-sdk-4.5-parent-directory
zip -r flex-sdk-4.5.zip flex-sdk-4.5    // Note: on Windows use any GUI zip tool
mvn install:install-file -DgroupId=com.adobe -DartifactId=flex-sdk -Dversion=4.5 -Dpackaging=zip -Dfile=flex-sdk-4.5.zip

Note	You can install any compatible version the Flex SDKs (for example Apache Flex 4.10 for SDK 4.5) but you must use the version numbers 3.6 and 4.5.

Clone GitHub repository

git clone git://github.com/graniteds/graniteds.git

Import projects in a IDE

Projects configuration are provided for Eclipse, you can directly import all subprojects in Eclipse. Note that the provided project files use Gradle-managed dependencies build path containers and suppose that you are using the Eclipse Gradle IDE plugin.

Quick build (just the libraries, skip tests and API docs)

cd graniteds
./gradlew clean build -x test -x javadoc -x asdoc

Full build

cd graniteds
./gradlew clean build

Specifics for the Adobe/Apache Flex build

The unit tests for Flex require a Flash Player and are skipped when the player path is not defined. You can define the path to the player with:

./gradlew clean build -PflexUnitCommand=/path/to/flashplayer

Install to local repository

./gradlew install