The repository contains a set of quickstart projects which provide working example for specific Narayana transaction manager capabilities. The quickstarts can be used as a reference for your own project.
The list of all available quickstart can be found down at this page. Each quickstart is categorized with tags that depict areas the quickstart is connected with.
- List of quickstarts
- Quickstarts by tag
- Contacting us
- Quickstarts in CI environment
- Running a single quickstart
- Running all quickstarts in a single command
TODO: link here quickstarts from WildFly!!!
List of quickstarts
|Project name||Description||Maven coordinates||Tags|
|ArjunaCore/txoj||Showing how to use the Transactional Object for Java (TXOJ) which is the core implementation concept of the Narayana state machine||o.j.n.quickstart.arjunacore :txoj||arjuna.core, standalone|
|ArjunaJTA/maven||Minimalistic maven project showing how to configure maven to use the Narayana JTA implementation||o.j.n.quickstart.jta :maven||jta, standalone|
|ArjunaJTA/javax_transaction||basics on using JTA API in your application, you can check how to obtain the
||o.j.n.quickstart.jta :javax_transaction||jta, standalone_|
|ArjunaJTA/jee_transactional_app||WildFly application which shows use of the transaction management in EJB when invoked from CDI bean||o.j.n.quickstart.jta: jee_transactional_app||jta, wildfly|
|ArjunaJTA/object_store||How to configure Narayana to run different types of object stores in standalone mode||org.jboss.narayana.quickstart.jta: object_store||jta, narayana.configuration, standalone|
|ArjunaJTA/recovery||Example of running periodic recovery in Narayana standalone. The setup shows multiple implementation of the recovery storage for could be configured by user.||o.j.n.quickstart.jta: recovery||jta, narayana.configuration, standalone|
|ArjunaJTS/interop||Transactional EJB calls between GlassFish and WildFly||o.j.n.quickstart.jts :jts-interop-quickstart||jts,wildfly,glassfish|
|ArjunaJTS/jts||Demonstration of setting up JTS transactions in WildFly and how to use EJB2 beans to pass the transactional context over the remote IIOP call||o.j.n.quickstart.jts :jboss-as-jts-parent||jts,wildfly|
|ArjunaJTS/recovery||Setting up the Narayana recovery manager for JTS in standalone mode||o.j.n.quickstart.jts :jts-recovery||jts, narayana.configuration, standalone|
|ArjunaJTS/standalone||Example of using Narayana JTS and in second part the example of using ORB API to manage remote JTS transaction manager with IIOP calls||o.j.n.quickstart.jts :jts-standalone||jts, iiop, standalone|
|atsintegration||How to integrate Narayana with and arbitrary Java EE application server||o.j.n.quickstart.jta :application-server-integration||narayana.configuration|
|agroal||How to integrate Narayana with Agroal jdbc pooling library||o.j.n.quickstart.jta :agroal||jta, standalone, jdbc|
- arjuna.core : demonstrating capabilities of Narayana API, it's helpful for developers want to write a transaction state machine and don't want to start on a green field but rather used battle tested library
- narayana.configuration : depicting aspects of Narayana configuration and showing options of such configurations
- jta : using JTA API to demonstrate transaction processing
- jts : using JTS API to demonstrate how the Narayana transaction system could be run and configured to run distributed JTS transactions
- standalone : running as standalone Java SE application
- wildfly : running as deployment on WildFly application server
- glassfish : running on GlassFish application server
- iiop : showing how to use ORB API with transaction manager
- jdbc : using JDBC api and showing integration with that
We are always happy to talk transactions and how-to use Narayana in exotic and not so exotic environments. If you have ideas for what we can add to the quickstarts to make them more useful please do reach out to us at: http://narayana.io/community
Quickstarts in CI environment
If you want to see how we run the quickstarts in our continuous integration environment, take a look at scripts/hudson/quickstart.sh.
Running a single quickstart
Change directory into the required quickstart and follow the instructions in the README.md file.
Running all quickstarts in a single command
To run the quickstarts:
WORKSPACE(to the root of the quickstart checkout)
JBOSS_HOME(to the path of WildFly server, you can download the server at http://wildfly.org/downloads)
mvn clean install
NOTE: One of the BlackTie quickstarts requires the Oracle driver to be downloaded and configured, see blacktie/test/initializeBlackTie.xml for more details.
It is disabled by default but running
./blacktie/run_all_quickstarts.[sh|bat] tx will execute it.
NOTE: As the scope of Narayana quickstart is broad - it shows integration with many platform – you need to expect a big amount of data to be downloaded from Maven repository.
If you want to prepare the quickstarts by installing them without running any test
then run the
mvn clean install -DskipTests
If you want to run the quickstart with specific Narayana version you can use
command line option