Skip to content

Latest commit

 

History

History
131 lines (120 loc) · 4.68 KB

README.md

File metadata and controls

131 lines (120 loc) · 4.68 KB
Raw

splitet

Build Status Gitter chat

Enterprise-Scale Eventually Consistent CQRS Framework by kloia.com

Splitet is a Java based Event Sourcing framework which can be benefited by the teams who are planning to make CQRS transitions with minimum learning curve and ease of adaptation.

It has a unique architecture called Operation Store™ together with the stack elements including Docker, Kafka, Hazelcast and Cassandra.

You can reach ECommerce samples from this link Demo and more examples are coming, please follow Splitet

Installation

If you're using MAVEN, you have to add these properties to super pom file.

.m2/settings.xml

<?xml version="1.0" encoding="UTF-8" ?>
<settings xsi:schemaLocation='http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd'
          xmlns='http://maven.apache.org/SETTINGS/1.0.0' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'>
    <profiles>
        <profile>
            <repositories>
                <repository>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                    <id>bintray-kloia-eventapis</id>
                    <name>bintray</name>
                    <url>https://dl.bintray.com/kloia/eventapis</url>
                </repository>
            </repositories>
            <pluginRepositories>
                <pluginRepository>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                    <id>bintray-kloia-eventapis</id>
                    <name>bintray-plugins</name>
                    <url>https://dl.bintray.com/kloia/eventapis</url>
                </pluginRepository>
            </pluginRepositories>
            <id>bintray</id>
        </profile>
    </profiles>
    <activeProfiles>
        <activeProfile>bintray</activeProfile>
    </activeProfiles>
</settings>

If you're using gradle add this property to gradle file

repositories {
    maven {
        url  "https://dl.bintray.com/kloia/eventapis" 
    }
}

for another using options you can visit Bintray Repo

Usage

You have to add these dependencies to pom.xml

<dependencies>
    <dependency>
        <groupId>io.splitet.core</groupId>
        <artifactId>spring-integration</artifactId>
        <version>0.8.0-SNAPSHOT</version>
    </dependency>
    <dependency>
        <groupId>io.splitet.core</groupId>
        <artifactId>spring-jpa-view</artifactId>
        <version>0.8.0-SNAPSHOT</version>
    </dependency>
    <dependency>
        <groupId>io.splitet.core</groupId>
        <artifactId>java-api</artifactId>
        <version>0.8.0-SNAPSHOT</version>
    </dependency>
</dependencies>

External Dependencies

You have to add these dependencies to pom.xml, too.

<dependencies>
	<dependency>
		<groupId>org.apache.commons</groupId>
		<artifactId>commons-lang3</artifactId>
		<version>3.9</version>
	</dependency>
	<dependency>
		<groupId>org.apache.commons</groupId>
		<artifactId>commons-collections4</artifactId>
		<version>4.4</version>
	</dependency>
	<dependency>
		<groupId>com.datastax.cassandra</groupId>
		<artifactId>cassandra-driver-core</artifactId>
		<version>3.8.0</version>
	</dependency>
	<dependency>
		<groupId>pl.touk</groupId>
		<artifactId>throwing-function</artifactId>
		<version>1.3</version>
	</dependency>
	<dependency>
		<groupId>org.springframework.cloud</groupId>
		<artifactId>spring-cloud-starter-openfeign</artifactId>
	</dependency>
	<dependency>
		<groupId>org.springframework.kafka</groupId>
		<artifactId>spring-kafka</artifactId>
	</dependency>
</dependencies>

Prerequisites

Before run your built services you have to run Docker Compose it will run minimum external resources Cassandra, Kafka etc.

Build

If you're using different java versions you have to set in bash prompt before run at bottom of commands, you can use SDKMAN

  $ mvn clean install
  $ mvn clean compile

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Please make sure to update tests as appropriate.

License

Apache License