Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tzolov/narayana-jta-geode-support
Apache Geode (Gemfire) and Narayana JTA integration utilities that enable global transactions between XA (e.g. JPA, JMS) and non-XA (e.g. Apache Geode) resources. The Last Resource Commit Optimization is configured to ensure transaction atomicity and data consistency
https://github.com/tzolov/narayana-jta-geode-support
Last synced: 4 days ago
JSON representation
Apache Geode (Gemfire) and Narayana JTA integration utilities that enable global transactions between XA (e.g. JPA, JMS) and non-XA (e.g. Apache Geode) resources. The Last Resource Commit Optimization is configured to ensure transaction atomicity and data consistency
- Host: GitHub
- URL: https://github.com/tzolov/narayana-jta-geode-support
- Owner: tzolov
- Created: 2017-06-28T17:53:37.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2017-07-04T10:03:29.000Z (over 7 years ago)
- Last Synced: 2023-12-21T01:49:57.134Z (11 months ago)
- Language: Java
- Homepage:
- Size: 93.8 KB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Narayana (e.g. JBoss) JTA with Geode/GemFire
[  ](https://bintray.com/big-data/maven/narayana-jta-geode-support/_latestVersion)
Use Narayana JTA provider as global transaction manager to coordinate Geode/GemFire cache transactions along with JPA/JDBC and/or JMS resources.
[Narayana](http://narayana.io//docs/project/index.html) is light-weight (e.g. out-of-container), embeddable global transaction manager. Narayana is JTA compliant and can be integrated with Geode/GemFire to perform XA transaction across Geode, JPA/JDBC and JMS operations.
Also Narayana supports [Last Resource Commit Optiomization](http://narayana.io//docs/project/index.html#d0e1859) allowing with Geode/GemFire transactions to be run as last resources.
The `narayana-geode` extends the existing Geode JTA support by integrating a standalone (open-source) JTA provider and
enabling LRCO for transaction-atomicity and data-consistency. The utility includes two sub-projects:
The [Apache Geode(GemFire) + Narayana JTA = Global Transactions with Last-Resource Optimization](http://blog.tzolov.net/2017/07/apache-geode-gemfire-narayana-jta.html?view=sidebar)
explains the problem, the implemented solution and provides some how-use tips.
## Narayana Geode/Gemfire Core
The [narayana-geode-core](./narayana-geode-core) library uses minimal external dependencies. Only Narayana and the
Apache Geode/Gemfire APIs are needed (e.g. no dependencies on Spring or Spring Data Gemfire and so.)
The [narayana-geode-core](./narayana-geode-core) README explains how to use the core utility.
## Narayana Geode/Gemfire SpringBoot
The [narayana-geode-springboot](./narayana-geode-springboot) library extends `narayana-geode-core` to provide seamless
integration with `Spring Boot` and `Spring Data Gemfire` (SDG).
The [narayana-geode-springboot](./narayana-geode-springboot) README explains how to use the core utility.
## Quick Start
Show how to bootstrap a Spring Boot application that uses `Narayana` to manage global transactions between `JPA` and
`Gemfire (8.2.x)`.
* Use the [start.spring.io](http://bit.ly/2ugGK5U) link to generate new `Spring Boot` application, pre-configured with `Narayana`, `JPA`, `H2` and `Gemfire 8.2.x` starters.
* Add `narayana-gemfire82-springboot` to the POM to enable the Narayana/Gemfire 8.2.x integration. The dependency are resolved from Maven Central
```xml
io.datalake.geode.jta
narayana-gemfire82-springboot
0.1.11
```
* Enable the Transaction Management and Geode Narayana JTA.
```java
@SpringBootApplication
@EnableGeodeNarayanaJta
@EnableTransactionManagement(order = 1)
public class SampleNarayanaApplication implements CommandLineRunner { ... }
```
* Use the `Spring Data` idioms to create and configure `JPA` and `Geode` repositories.
```java
public interface MyJpaRepository extends CrudRepository {...}
public interface MyGeodeRepository extends CrudRepository {...}
```
```java
@SpringBootApplication
@EnableJpaRepositories(basePackageClasses = JpaCustomer.class)
@EnableGemfireRepositories(basePackageClasses = GeodeCustomer.class)
...
```
* Use the [@Transactional](https://docs.spring.io/spring/docs/current/javadoc-api/org/springframework/transaction/annotation/Transactional.html) Spring idioms to participate in a distributed transactions
```java
@Transactional
public void addNewCustomer(String firstName, String lastName) {
jpaRepository.save(new JpaCustomer(firstName, lastName));
geodeRepository.save(new GeodeCustomer(666L, firstName, lastName));
}
```
## POM dependencies
All `narayana-geode` dependencies can be resolved from Maven Central: [io.datalake.geode.jta](https://search.maven.org/#search%7Cga%7C1%7Cg%3A%22io.datalake.geode.jta%22)
Currently `narayana-geode` support `Gemfire 8.2.x`, `Gemfire 9.0.x` and `Geode 1.1.x`. See matrix for details:
| POM Group | POM Artifact | POM Version | Compatible Apache Geode/Gemfire Versions |
| --------------------- | ----------------------------- | ----------- | ------------------------------------------- |
| io.datalake.geode.jta | narayana-geode-core | 0.1.11+ | Apache Geode 1.1.x or newer, Gemfire 9.0.4 or newer |
| io.datalake.geode.jta | narayana-geode-springboot | 0.1.11+ | Apache Geode 1.1.x or newer, Gemfire 9.0.4 or newer, SpringBoot 1.5.4 or newer. No SDG GA for this Geode/Gemfire version yet. |
| io.datalake.geode.jta | narayana-gemfire82-core | 0.1.11+ | Gemfire 8.2.x |
| io.datalake.geode.jta | narayana-gemfire82-springboot | 0.1.11+ | Gemfire 8.2.x, SpringBoot 1.5.4 or newer, Spring Data Gemfire 1.9.4 |
## Build
To build the projects run
```
./mvn clean install
```