A Java SE 5 is required to build the project. Make sure that the JDK used to build camel-jonas5 is compliant with the new Java 5 features.

The maven tool is used with pom.xml files. This tool is available at http://maven.apache.org. The 2.0.7 or later version is recommanded

The camel-jonas5 project provides .project and .classpath for Eclipse 3.1 or greater. A project is ready to use once the source has been imported using the Eclipse tool. Eclipse tool is available at http://www.eclipse.org.

All files should have a header that contains the LGPL and the date.

If a file is modified, the modification year should be appended to the existing year, which is the year it was initially created. For example, if the create date is '1999' or '2004' it should be edited to '1999-2006' or '2004-2006', respectively.

Also, the tag $Id: code_convention.xml 314 2006-04-04 09:39:43Z pinheirg $ should be added. The following is a header example:

        /** 
        * JOnAS: Java(TM) Open Application Server 
        * Copyright (C) 2010 Bull S.A.S. 
        * Contact: jonas-team@ow2.org 
        * This library is free software; you can redistribute it and/or 
        * modify it under the terms of the GNU Lesser General Public 
        * License as published by the Free Software Foundation; either 
        * version 2.1 of the License, or any later version. 
        * This library is distributed in the hope that it will be useful, 
        * but WITHOUT ANY WARRANTY; without even the implied warranty of 
        * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 
        * Lesser General Public License for more details.
        * You should have received a copy of the GNU Lesser General Public 
        * License along with this library; if not, write to the Free Software 
        * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 
        * *
        --------------------------------------------------------------------------
        * $Id: code_convention.xml 19620 2010-04-01 14:13:01Z eyindanga $ *
        --------------------------------------------------------------------------
        */

Imports should reference a valid class name, instead of using wildcard imports. Wildcard imports are not authorized.

For example, if the interface and class List and ArrayList are used, the imports should not be as follows:

 import java.util.*; 

The imports should have each class as follow:

 import java.util.List; import java.util.ArrayList;
        

The classes should not have an unused import.

	Note
	The Eclipse IDE provides facilities to do this job. There is the option Organize Imports (Shift+Ctrl+O) in the menu Source that correctly inserts the imports and removes the unused imports. However, this option does not work well with 'import static'.

The class and interface names should begin with an uppercase letter. Also, each class and interface has an @author tag in the comment. For example:

 
        /** 
        * This is an example that shows a class/interface declaration. 
        * @author Loris Bouzonnet 
        * @author Stephane Zeng 
        */
        public class ClassExample implements InterfaceExample { }
        

The space character is used instead of the tab character. The number of spaces for an indent is 4 spaces.

Wrapping a single source line into multiple lines should follow the Java code convention.

Any trailing spaces should be removed. Eclipse provides a plugin that removes the trailing spaces and converts the tab into spaces. The plugin is AnyEdit.

Use whitespaces in for() loop, while(), when concatenating strings. One space should be added before the operator and another after the operator. For example, the correct syntax is:

 for (int i = 0; i < arTest.length; i++) { String
        strResult = "The element " + i + " has the value " + arTest[i]; }
        

The following code does not adhere to the convention:

 for (int i = 0; i< arTest.length; i++) { String
        strResult = "The element "+ i+" has the value "+arTest[i]; }
        

Braces must be used in the if/else blocks, even if there is a single statement. To illustrate:

 if (true) { doThis(); } 

The following is not allowed:

 if (true) doThis(); 

The position of the braces should be the same as in the first example. The following format is incorrect:

 if (true) { test1(); test2(); } 

All exceptions require a statement; no silent catching is allowed. For example:

 try { doThis(); } catch (Exception e) { // should not
        occur } 

A logger can be used:

 try { doThis(); } catch (Exception e) {
        logger.logDebug("Exception while doing .....", e); }