Kor Common

Basics of Kor Architecture

License	The Apache Software License, Version 2.0
GroupId	com.sefford
ArtifactId	kor-common
Last Version	3.0.2
Release Date	Apr 25, 2018
Type	aar
Description	Kor Common Basics of Kor Architecture
Project URL	https://github.com/Sefford/kor
Source Code Management	https://github.com/Sefford/kor

Download kor-common

Filename	Size
kor-common-3.0.2.pom
kor-common-3.0.2.aar	8 KB
kor-common-3.0.2-sources.jar	19 KB
kor-common-3.0.2-javadoc.jar	165 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.sefford/kor-common/ -->
<dependency>
    <groupId>com.sefford</groupId>
    <artifactId>kor-common</artifactId>
    <version>3.0.2</version>
    <type>aar</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.sefford/kor-common/
implementation 'com.sefford:kor-common:3.0.2'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.sefford/kor-common/
implementation ("com.sefford:kor-common:3.0.2")

Apache Buildr

'com.sefford:kor-common:aar:3.0.2'

Apache Ivy

<dependency org="com.sefford" name="kor-common" rev="3.0.2">
  <artifact name="kor-common" type="aar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.sefford', module='kor-common', version='3.0.2')
)

Scala SBT

libraryDependencies += "com.sefford" % "kor-common" % "3.0.2"

Leiningen

[com.sefford/kor-common "3.0.2"]

Dependencies

compile (6)

Group / Artifact	Type	Version
com.sefford : commons	jar	1.1.0
io.arrow-kt : arrow-core	jar	0.6.1
io.arrow-kt : arrow-data	jar	0.6.1
io.arrow-kt : arrow-effects	jar	0.6.1
org.jetbrains.kotlinx : kotlinx-coroutines-core	jar	0.22.5
org.jetbrains.kotlin : kotlin-stdlib-jdk8	jar	1.2.31

test (5)

Group / Artifact	Type	Version
junit : junit	jar	4.12
org.mockito : mockito-core	jar	2.17.0
org.hamcrest : hamcrest-core	jar	1.3
com.nhaarman : mockito-kotlin	jar	1.5.0
com.google.code.gson : gson	jar	2.8.1

Project Modules

There are no modules declared in this project.

Kor

A Clean Architecture Implementation core library.

What is Kor?

Kor is the skeleton of a clean-ish architecture implementation. There are many ways of implementing a clean architecture:

• Ports and adapters
• Hexagonal Architecture
• VIPER Architecture

The aim of Kor is to provide a fast implementation of a proper architecture where the developer can iterate quickly and and with the ability to use good practices as SOLID and TDD from day 0.

Kor is not meant to be a canonical implementation of such architecture, but a personal interpretation of how it should be.

Basic Setup

Make sure to have the latest version of JDK 1.8 installed.

Add the dependencies into the project's build.gradle

dependencies {
    compile 'com.sefford:kor-usecases:4.3.2'
    compile 'com.sefford:kor-repositories:4.3.2'
    compile 'com.sefford:kor-repositories-extensions:4.3.2' // optional 
    compile 'com.sefford:kor-repositories-gson-converter:4.3.2' 
    compile 'com.sefford:kor-repositories-moshi-converter:4.3.2'
}

How is Kor structured?

Read more particular documentation in any of the modules that Kor provides

• Use Cases: Abstractions to apply use cases and interactors concepts to your architecture
• Repositories: Repository pattern to abstract cache and persistence
• Repositories Extensions: Basic implementations of policies for specialized repositories (optional)
• Repositories Gson Converter: Simple Gson Json converter for json-based repositories (optional)
• Repositories Moshi Converter: Simple Gson Moshi converter for json-based repositories (optional)

Migrating to 4.0.0

Many breaking changes were done in 4.0.0, mostly related to how the core works.

• Now all Kor is separated in individual modules
• All old Interactor system got deprecated. All delegates must be chopped and separated on each phase.
• Now Use cases can return Either<Error,Response>. If you use the Postable-compatible method, your Postable will keep receiving these separated response.
• Save and Get Repository methods will receive an Either<RepositoryError, V> response instead of a null; so the receiving class can have a little information of what went wrong.
• In order to ease the long signatures and known problems with the error log grouping, you will need to log manually each of the errors.

Interesting literature

Martin, Robert Cecil: The Clean Architecture

Cockburn, Alistair: Hexagonal Architecture

VIPER Architecture

License

Copyright 2014 Sefford.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Versions

Version
3.0.2 Apr 25, 2018
3.0.1 Apr 24, 2018
3.0.0 Feb 14, 2018
2.8.0 Dec 14, 2017
2.6.0 Jul 13, 2017
2.5.5 Jun 23, 2017
2.5.4 Jun 21, 2017
2.5.1 Jun 5, 2017
2.5.0 Jun 5, 2017
2.4.3 Apr 21, 2017
2.4.2 Feb 27, 2017
2.4.1 Feb 27, 2017
2.4.0 Feb 27, 2017
2.3.0 Mar 29, 2016
2.2.1 Mar 3, 2016
2.2.0 Sep 24, 2015
2.1.3 Aug 6, 2015
2.1.2 Jul 11, 2015
2.1.1 Jul 11, 2015
2.1 May 16, 2015
2.0 Nov 7, 2014
1.31 Oct 24, 2014
1.3 Sep 2, 2014
1.2 Aug 24, 2014
1.0.2 Jul 1, 2014
1.0 Jun 30, 2014