Domino is a small library for the programming language Scala designed to support developers in writing bundle activators for the Java module system OSGi. It strives to make writing complex and highly-dynamic bundle activators as easy as possible without sacrificing the power of the OSGi API.

As such, Domino is a lightweight alternative to OSGi component models like iPOJO, Blueprint and Declarative Services. Especially for those who want to leverage the power of pure code instead of reverting to an XML- or annotation-based approach.

Expressive

Domino offers an expressive DSL which reflects the event-driven nature of OSGi and allows you to define very easily when your logic is made available and when it is revoked.

Unrestrictive

Some libraries just cover the most common use cases and let you fall deeply whenever you need to do something more special. Then you suddenly find yourself bypassing the library completely. Domino tries to prevent this by staying close to the low-level OSGi API.

Type safe

Most features in Domino benefit from static typing. That means the compiler and your IDE can help you write correct code. Additionally, there’s support for using generic type parameters in the service registry.

Familiar

Instead of inventing a completely foreign DSL, Domino tries to use familiar Scala data types such as Option, List etc. whenever possible so you can make use of those many nice methods like filter or map you probably fell in love with.

Extensible

If the Domino core DSL is not enough for you, simply extend it. Do you want to run a job as long as a certain service is available? Such things can be easily integrated.

Comprehensive

Many of OSGi’s core features are natively supported by the DSL (services, configuration, bundles, meta types).

Some lines of code often say more than 1000 words.

Wait for service and register service

import domino.DominoActivator
import org.osgi.service.http.HttpService

class MyService(httpService: HttpService)

class Activator extends DominoActivator {
  whenBundleActive {
    // Make service available as long as another
    // service is present
    whenServicePresent[HttpService] { httpService =>
      val myService = new MyService(httpService)
      myService.providesService[MyService]
    }
  }
}

Listen for configuration updates

import domino.DominoActivator

class KeyService(key: String)

class Activator extends DominoActivator {
  whenBundleActive {
    // Reregister service whenever configuration changes
    whenConfigurationActive("my_service") { conf =>
      val key = conf.getOrElse("key", "defaultKey")
      new KeyService(key).providesService[KeyService]
    }
  }
}

The latest stable version is 1.1.5 and can be downloaded from Maven Central.

Maven

Mill

SBT

Gradle

Manual

• User Guide

• Scaladoc (1.0.0)

• FAQ

• Gitter chat

Contribute

Building Domino

./millw clean package

Creating a Release

./millw mill.scalalib.PublishModule/publishAll \
  --release true \
  --signed true \
  --publishArtifacts __.publishArtifacts \
  --sonatypeCreds <YourSonatypeCreds>

Thanks to …​

• helgoboss for creating Domino 1.0.0

• ScalaModules for being an inspiration, in particular for the bundle and service watching functionality

• Nyenyec for creating the image from which the Domino logo is derived

Domino is licensed under the MIT License.

Domino 1.1.5 - 2020-05-05

Domino 1.1.4 - 2020-05-05

Domino 1.1.3 - 2018-10-01

Domino 1.1.2 - 2017-04-28

Domino 1.1.1 - 2016-02-03

Domino 1.1.0 - 2015-05-28

Domino 1.0.0 - 2013-03-31