Page History

...

java/
 pom/parent/pom.xml
 ...
 sca/
   pom.xml - The maven pom that builds all of the releasable Tuscany Java SCA modules

   contrib/ - A temporary direcoty that holds modules not currently being developed or targetted for a release
     ...

   doc/ - Tuscany Java SCA documentation that will be included with the release
     ...

   itest/ - Integration tests that test system performace using combinations of Tuscany Java features
     pom.xml
     ...

   modules/ - A flat direcory structure holding all of the separate modules that make up Tuscany Java SCA. 
     pom.xml
     ...

   samples/ - Tuscany Java SCA samples which show how to use the various features of the software
     build.xml <-- Samples build with Ant as well as Maven - TBD
     pom.xml
     ...

Naming Conventions

• Use all lowercases and dashes in folder names (like in the jar names)
• Maven artifact id = tuscany-<folder name>
• Package names within modules should include the module name so that source code can be located in the source tree easily. So, for example, the module

java/sca/module/implementation-java

...

If people want to work on some new modules that won't be part of the
next release and are not included in the top-down build, that's fine, we can
just avoid listing these modules in java/sca/modules/pom.xml. So, they
can be there in the same source tree but they won't break the release
top-down build, and they won't have to be building at all times.

Maven Build Structure

• sca/pom.xml's parent will be pom/parent/pom.xml
• Other poms will use the pom from the parent folder as parent pom
• Group ids:
  org.apache.tuscany.sca
  org.apache.tuscany.sca.samples,
  org.apache.tuscany.sca.itest
• Version of our modules will be specified once in java/sca/pom.xml, child poms don't need specify a version as they get it from their parent
• pom names begin Apache Tuscany SCA
• Eclipse projects are generated for all built modules using mvn -Peclipse eclipse:eclipse

Building From The Source

First of all check out all of the java source code.

...