JDEECo is a Java implementation of the DEECo component system
Java Xtend Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
jdeeco-adaptation-plugin Updated Pom file for project deployment. Jun 5, 2017
jdeeco-architecture Merge remote-tracking branch 'origin/uncertain-architectures' Feb 18, 2016
jdeeco-concepts Merge remote-tracking branch 'origin/uncertain-architectures' Feb 18, 2016
jdeeco-core-osgi Merge remote-tracking branch 'origin/uncertain-architectures' Feb 18, 2016
jdeeco-core Increased version of DEECo to 3.0.4 Jun 5, 2017
jdeeco-edl-model Added model and syntax support for scheduling information. No corresp… Jul 25, 2016
jdeeco-edl-tests Minor cleanup, EDL test project removed as a dependency of Z3 project. Jul 21, 2016
jdeeco-edl-ui Added all the unversioned EDL classes. While they have the default im… Oct 26, 2016
jdeeco-edl Minor bugfixing in Intelligent Ensemble projects, removed WIP feature… Jan 12, 2017
jdeeco-ensembles-intelligent-z3 Increased version of DEECo to 3.0.4 Jun 5, 2017
jdeeco-matsim-omnet-plugin Increased version of DEECo to 3.0.4 Jun 5, 2017
jdeeco-matsim-plugin Increased version of DEECo to 3.0.4 Jun 5, 2017
jdeeco-modes Updated Pom file for project deployment. Jun 5, 2017
jdeeco-network-plugin Increased version of DEECo to 3.0.4 Jun 5, 2017
jdeeco-omnet-plugin Increased version of DEECo to 3.0.4 Jun 5, 2017
jdeeco-parent Increased version of DEECo to 3.0.4 Jun 5, 2017
jdeeco-ros Add missing repositories, fix compile Aug 15, 2018
jdeeco-turtlebot Adding name to events fired in Timer in order to log more information Jul 20, 2015
.gitignore Merge remote-tracking branch 'origin/uncertain-architectures' Feb 18, 2016
LICENSE-2.0.html Merge remote-tracking branch 'origin/uncertain-architectures' Feb 18, 2016
README.md Update README.md Nov 19, 2015

README.md

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:

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)