fp-in-bo / jms4s

A functional wrapper for jms

Website GitHub

jms4s - a functional wrapper for jms

Build Status Maven Central Code of Consuct Mergify Status Scala Steward badge

Nobody really wants to use jms, but if you have no choice or you're not like us you may find this useful.

Supported features:

  • Consuming, returning a never-ending cancellable program that can concurrently consume from a queue

    • createQueueTransactedConsumer
    • createQueueAckConsumer
    • createQueueAutoAckConsumer
  • Publishing, returning a program which can publish messages

    • createQueuePublisher
    • createTopicPublisher
  • Consuming and Publishing within the same local transaction

Head on over to the microsite

Quick Start

To use jms4s in an existing SBT project with Scala 2.12 or a later version, add the following dependencies to your build.sbt depending on your provider:

libraryDependencies ++= Seq(
  "dev.fpinbo" %% "jms4s-active-mq-artemis" % "<version>", // if your provider is activemq-artemis
  "dev.fpinbo" %% "jms4s-ibm-mq"            % "<version>"  // if your provider is ibmmq
)

Local dev

run tests

  • docker-compose up -d
  • sbt test

site

  • build site
docker run \
  -v $PWD:/$PWD \
  -v ~/.sbt:/root/.sbt \
  -v ~/.ivy2:/root/.ivy2 \
  -v ~/.m2:/root/.m2 \
  -v ~/.coursier:/root/.coursier \
  -w /$PWD \
  -it k3vin/sbt-java8-jekyll \
  sbt site/clean site/makeMicrosite
  • run at localhost:4000/jms4s/
docker run \
  -v $PWD:/$PWD \
  -w /$PWD/site/target/site \
  -p 4000:4000 \
  -it k3vin/sbt-java8-jekyll \
  jekyll serve -b /jms4s --host 0.0.0.0