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/.
To compile and run the JDEECo framework, the following software has to be available on your system:
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).
default
- produces both simple jar and the OSGi bundle for jDEECo core library and demosOSGi
- produces OSGi bundle for jDEECo corecore
- produces the simple jar for jDEECoThe 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.
A jDEECo tutorial featuring a simple convoy example can be found as a separate project at https://github.com/d3scomp/JDEECo-Convoy-Tutorial.
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).
The universal build script is situated in jdeeco-parent
. Running this script builds jDEECo in all available configurations along with demos.
To build jDEECo as an OSGi bundle, you run mvn clean install
in jdeeco-core-osgi
.
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.
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
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.
Apart from Java version of DEECo, there is its C++ realization that can be found under: (http://github.com/d3scomp/CDEECo)