riverslee/jdeeco

JDEECo is a Java implementation of the DEECo component system

JDEECo is a Java implementation of the DEECo component system. For further information, please visit http://d3s.mff.cuni.cz/projects/components_and_services/deeco/.

##Requirements To compile and run the JDEECo framework, the following software has to be available on your system:

• Java SDK >= 1.8.0 (http://java.com/en/)

Compilation and Deployment

To compile the project you will need to have Apache Maven (http://maven.apache.org/) installed on your machine (version 3.1.1 was used when writing the script).

There are two ways you can compile the sources using maven:

• default - produces both simple jar and the OSGi bundle for jDEECo core library and demos
• OSGi - produces OSGi bundle for jDEECo core
• core - produces the simple jar for jDEECo

The default compilation is performed by simply executing mvn clean install command in the jdeeco-parent subfolder. In order to compile sources to have OSGi bundle of jDEECo on outcome mvn clean install command in the jdeeco-core-osgi subfolder. To get just the simple jar one needs to run mvn clean install in the jdeeco-core. All generated binaries along with dependencies needed to run jdeeco are placed in the dist folder.

Tutorial

A jDEECo tutorial featuring a simple convoy example can be found as a separate project at https://github.com/d3scomp/JDEECo-Convoy-Tutorial.

Project structure

####Binaries All binaries for jDEECo can be found in directory dist, which is created automatically in the root folder. Even if a specific part of jDEECo is built binaries will appear there (also could be found in projects target folder).

Build All

The universal build script is situated in jdeeco-parent. Running this script builds jDEECo in all available configurations along with demos.

OSGI support

To build jDEECo as an OSGi bundle, you run mvn clean install in jdeeco-core-osgi.

Core

To build jDEECo core you need to go to jdeeco-core folder and run mvn clean install. This will build jDEECo along with tests and produce the jDEECo jar.

Demos

Demo projects for jdeeco can be found in jdeeco-demos folder. There are two projects: the cloud case study based one, and one concerning firefighters case study. They can be built either by running mvn clean install in jdeeco-demos or via running the same command from jdeeco-parent (this will eventually generate all the binaries, as mentioned before). In both cases binaries cloud.jar and firefighters.jar will appear in dist folder along with an ant script to run them. There are 5 different demos out of those two projects

Cloud demos

• ant LocalLauncherCloud
• ant LocalLauncherDynamicCloud
• ant TSLauncherCloud

Firefighters demos

• ant FFLauncher
• ant FFHexacopterLauncher

Eclipse integration

All of the projects in the repository are the Eclipse projects. As such they can be easily imported to the Eclipse workspace.

In the project there are included custom formatters. One of them colors the logging output that goes into the Eclipse console using ANSI escape sequences. In order to be able to see the output correctly this plugin (ansi-in-console) needs to be installed into your Eclipse.

Our work is licensed under the Apache License. To make the process of adding the license information easier use the releng tool plugin and configure it with the following text:

Copyright ${date} Charles University in Prague

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

In order to automatically generate the copyright in newly created classes, you need to configure the code templates in Eclipse. Go to Window->Preferences->Java->Code Style->Code Templates->Comments->File and Edit it. Copy there the following text:

/*******************************************************************************
 * Copyright ${year} Charles University in Prague
 *  
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *  
 *      http://www.apache.org/licenses/LICENSE-2.0
 *  
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 *******************************************************************************/

Then check the "Automatically add comments for new methods and types" on the bottom.

CDEECo

Apart from Java version of DEECo, there is its C++ realization that can be found under: (http://github.com/d3scomp/CDEECo)