2016/05/28 - Apache Tuscany has been retired.

For more information, please explore the Attic.

 Apache Tuscany > Home > Java SCA > Java SCA Menu > Java SCA Architecture
Added by jmarino, last edited by jmarino on Mar 03, 2007  (view change)


The SCA Java runtime is composed of a kernel and extensions. The kernel is essentially a multi-VM wiring engine that connects components together using the principles of Dependency Injection, or Inversion of Control.


The kernel is designed to be simple and limited in its capabilities: it wires functional units together. Capabilities such as service discovery, reliability, support for transport protocols, etc. are provided through extensions. The kernel extension model is based on the SCA 1.0 Java programming and assembly model. In otherwords, the kernel uses SCA to bootstrap itself. The mechanics of how this is done are described in detail elsewhere Kernel Architecture.

The kernel is divided into a number of modules: api, host_api, spi and core. The api module defines Tuscany proprietary programming model annotations and APIs. The host_api module defines APIs for interacting with the kernel. The spi module defines extension points and abstract helper classes. The core module contains the kernel implementation.


Extensions enhance the kernel with specific sets of functionality. Extension types are not fixed and the kernel is designed to be as flexible as possible by providing an open-ended extension model. From the kernel perspective, extensions are just a set of SCA components. However, there are a number of known extension types defined by the spi module, including:

  • Component implementation types, e.g. Spring, Groovy, and JavaScript
  • Binding types, e.g. Axis, CXF, AMQP, ActiveMQ, JXTA
  • DataBinding types, e.g. JAXB, SDO, XmlBeans

There are also a number of add-on extensions that do not correspond to a well-know type:

  • The JPA extension for O/R mapping
  • The Geronimo Transaction Manager extension for transactional support in the runtime
  • The HOWL-based Persistent Store extension for high-throughput persistence of conversational state

More detail can be found in the Extensions Guide section, but a few high-level best practices for designing extensions are listed here:

  • Make sure you are familiar with SCA 1.0 Assembly and the SCA Java 1.0 programming model. Specifications can be found at www.osoa.org.
  • Never reference any classes in core. These classes are implementation-specific and subject to change; they are not part of the public SPI contract.
  • Use autowire when assembling extension components.
  • Do not mess with classloaders such as setting the current context classloader unless it is absolutely necessary, i.e. a library used by an extension makes assumptions about context classloaders. Ideally the library can be refactored to not make these assumptions. If not, make sure the extension properly resets the current context classloader.
  • Preferrably use EasyMock for mocking kernel functionality during extension unit testing.
  • Preferrably use EasyMock for mocking kernel functionality during extension unit testing.


The kernel is designed to be embedded in, or provisioned to, a number of different host environments. For example, the kernel may be provisioned to an OSGi container, a standalone runtime, a servlet engine, or JEE application server. There is even a Maven runtime that embeds kernel for integration testing. Runtime capabilities may vary based on the host environment.