Updating readme and build.gradle. All portable classes are serializable as well (JSON, XML,YAML, Binary etc).

Author: SubiyaCryolite

README.md

@@ -50,14 +50,14 @@ Maven
 <dependency>
     <groupId>io.github.subiyacryolite</groupId>
     <artifactId>jds</artifactId>
-    <version>19.1-SNAPSHOT</version>
+    <version>20.4-SNAPSHOT</version>
 </dependency>
 ```
 
 Gradle
 
 ```groovy
-compile 'io.github.subiyacryolite:jds:19.1-SNAPSHOT'
+compile 'io.github.subiyacryolite:jds:20.4-SNAPSHOT'
 ```
 
 # Dependencies
@@ -86,7 +86,7 @@ Classes that use JDS need to extend Entity.
 ```kotlin
 import io.github.subiyacryolite.jds.Entity;
 
-public class Address extends Entity(){}
+public class Address : Entity
 ```
 
 However, if you plan on using interfaces they must extend IEntity. Concrete classes can then extend Entity
@@ -95,19 +95,20 @@ However, if you plan on using interfaces they must extend IEntity. Concrete clas
 import io.github.subiyacryolite.jds.Entity;
 import io.github.subiyacryolite.jds.IEntity;
 
-public interface IAddress extends IEntity{}
-public class Address extends Entity implements IAddress{}
+public interface IAddress : IEntity
+
+public class Address : IAddress
 ```
 
 Following that the following steps need to be taken.
 
 ### 1.1.1 Annotating Classes
 
-Every class that extends Entity must have its own unique Entity Id as well as an Entity Name. This is done by annotating the class in the following manner
+Every class that extends Entity must have its own unique Entity Id as well as an Entity Name. This is done by annotating the class, or its parent interface, in the following manner
 
 ```kotlin
 @EntityAnnotation(id = 1, name = "address", description = "An entity representing address information")
-class Address : Entity() {}
+class Address : Entity()
 ```
 
 Entity IDs MUST be unique in your application, any value of type long is valid. Entity Names do not enforce unique constraints but its best to use a unique name regardless. These values can be referenced to mine data.
@@ -332,17 +333,28 @@ import io.github.subiyacryolite.jds.beans.property.NullableShortValue
 import io.github.subiyacryolite.jds.tests.constants.Fields
 import java.time.LocalDateTime
 
-@EntityAnnotation(id = 1, name = "address", description = "An entity representing address information")
-class Address : Entity() {
-
-    private val _streetName = map(Fields.StreetName, "", "streetName")
-    private val _plotNumber = map(Fields.PlotNumber, NullableShortValue(), "plotNumber")
-    private val _area = map(Fields.ResidentialArea, "", "area")
-    private val _city = map(Fields.City, "", "city")
-    private val _provinceOrState = map(Fields.ProvinceOrState, "provinceOrState")
-    private val _country = map(Fields.Country, "", "country")
-    private val _primaryAddress = map(Fields.PrimaryAddress, NullableBooleanValue(), "primaryAddress")
-    private val _timestamp = map(Fields.TimeStamp, LocalDateTime.now(), "timestamp")
+data class Address(
+        private val _streetName: IValue<String> = StringValue(),
+        private val _plotNumber: IValue<Short?> = NullableShortValue(),
+        private val _area: IValue<String> = StringValue(),
+        private val _city: IValue<String> = StringValue(),
+        private val _provinceOrState: IValue<String> = StringValue(),
+        private val _country: IValue<String> = StringValue(),
+        private val _primaryAddress: IValue<Boolean?> = NullableBooleanValue(),
+        private val _timestamp: IValue<LocalDateTime> = LocalDateTimeValue()
+) : Entity(), IAddress {
+
+    override fun bind() {
+        super.bind()
+        map(Fields.StreetName, _streetName, "streetName")
+        map(Fields.PlotNumber, _plotNumber, "plotNumber")
+        map(Fields.ResidentialArea, _area, "area")
+        map(Fields.City, _city, "city")
+        map(Fields.ProvinceOrState, _provinceOrState, "provinceOrState")
+        map(Fields.Country, _country, "country")
+        map(Fields.PrimaryAddress, _primaryAddress, "primaryAddress")
+        map(Fields.TimeStamp, _timestamp, "timestamp")
+    }
 
     var primaryAddress: Boolean?
         get() = _primaryAddress.get()
@@ -409,10 +421,11 @@ import io.github.subiyacryolite.jds.tests.constants.Entities
 
 @EntityAnnotation(id = 2, name = "address_book")
 data class AddressBook(
-        val addresses: MutableCollection<Address> = ArrayList()
+        val addresses: MutableCollection<IAddress> = ArrayList()
 ) : Entity() {
 
-    init {
+    override fun bind() {
+        super.bind()
         map(Entities.Addresses, addresses, "addresses")
     }
 }
@@ -673,10 +686,10 @@ Once you have defined your class you can initialise them. A dynamic **id** is cr
     primaryAddress.primaryAddress = PrimaryAddress.YES
 ```
 
-### 1.2.4 Saving objects
+### 1.2.4 Saving objects (Portable Format)
 ...
 
-### 1.2.5 Loading objects
+### 1.2.5 Loading objects (Portable Format)
 ...
 
 # Development

build.gradle

@@ -25,7 +25,7 @@ apply plugin: "org.jetbrains.dokka"
 apply plugin: "io.codearte.nexus-staging"
 
 group = "io.github.subiyacryolite"
-version = "20.3-SNAPSHOT"
+version = "20.4-SNAPSHOT"
 archivesBaseName = project.name
 description = "A dynamic, cross platform and high performance data-mapper. JDS is designed to assist in rapid development and the creation of robust, strongly typed, field dictionaries"
 [compileJava, compileTestJava]*.options*.encoding = "UTF-8"

src/main/kotlin/io/github/subiyacryolite/jds/portable/EntityOverview.kt

@@ -2,6 +2,7 @@ package io.github.subiyacryolite.jds.portable
 
 import com.fasterxml.jackson.annotation.JsonProperty
 import io.github.subiyacryolite.jds.interfaces.IOverview
+import java.io.Serializable
 
 /**
  *
@@ -26,6 +27,6 @@ data class EntityOverview(
         @get:JsonProperty("f")
         @set:JsonProperty("f")
         var fieldId: Int? = null
-) {
+): Serializable {
     constructor(overview: IOverview, fieldId: Int?) : this(overview.id, overview.editVersion, overview.entityId, fieldId)
 }

src/main/kotlin/io/github/subiyacryolite/jds/portable/PortableContainer.kt

@@ -17,6 +17,7 @@ import com.fasterxml.jackson.annotation.JsonProperty
 import io.github.subiyacryolite.jds.Entity
 import io.github.subiyacryolite.jds.annotations.EntityAnnotation
 import io.github.subiyacryolite.jds.context.DbContext
+import java.io.Serializable
 import java.util.*
 
 /**
@@ -25,7 +26,7 @@ import java.util.*
 data class PortableContainer(
         @get:JsonProperty("e")
         val portableEntities: MutableCollection<PortableEntity> = ArrayList()
-) {
+) : Serializable {
     /**
      * @param dbContext an instance of [DbContext]
      * @param entities a collection of [Entity] objects to store in the embedded format

src/main/kotlin/io/github/subiyacryolite/jds/portable/PortableEntity.kt

@@ -17,6 +17,7 @@ import com.fasterxml.jackson.annotation.JsonProperty
 import io.github.subiyacryolite.jds.Entity
 import io.github.subiyacryolite.jds.context.DbContext
 import io.github.subiyacryolite.jds.interfaces.IEntity
+import java.io.Serializable
 
 /**
  * Class used to represent [JdsEntity][Entity] objects in a portable manner
@@ -125,7 +126,7 @@ data class PortableEntity(
 
         @get:JsonProperty("h1")
         val mapStringKeyValues: MutableCollection<StoreMapStringKey> = ArrayList()
-) {
+): Serializable {
 
     @Throws(Exception::class)
     fun init(dbContext: DbContext, entity: IEntity) {

src/main/kotlin/io/github/subiyacryolite/jds/portable/StoreBlob.kt

@@ -15,6 +15,7 @@ package io.github.subiyacryolite.jds.portable
 
 import com.fasterxml.jackson.annotation.JsonProperty
 import io.github.subiyacryolite.jds.Field
+import java.io.Serializable
 import java.util.*
 
 /**
@@ -30,7 +31,7 @@ data class StoreBlob(
         @get:JsonProperty("v")
         @set:JsonProperty("v")
         var value: ByteArray? = null
-) {
+): Serializable {
     override fun equals(other: Any?): Boolean {
         if (this === other) return true
         if (javaClass != other?.javaClass) return false

src/main/kotlin/io/github/subiyacryolite/jds/portable/StoreBoolean.kt

@@ -15,6 +15,7 @@ package io.github.subiyacryolite.jds.portable
 
 import com.fasterxml.jackson.annotation.JsonProperty
 import io.github.subiyacryolite.jds.Field
+import java.io.Serializable
 
 /**
  * Used to store values of type in a portable manner
@@ -29,4 +30,4 @@ data class StoreBoolean(
         @get:JsonProperty("v")
         @set:JsonProperty("v")
         var value: Int? = null
-)
+): Serializable

src/main/kotlin/io/github/subiyacryolite/jds/portable/StoreDate.kt

@@ -15,6 +15,7 @@ package io.github.subiyacryolite.jds.portable
 
 import com.fasterxml.jackson.annotation.JsonProperty
 import io.github.subiyacryolite.jds.Field
+import java.io.Serializable
 import java.sql.Timestamp
 
 /**
@@ -30,4 +31,4 @@ data class StoreDate(
         @get:JsonProperty("v")
         @set:JsonProperty("v")
         var value: Long? = null
-)
+): Serializable

src/main/kotlin/io/github/subiyacryolite/jds/portable/StoreDateTime.kt

@@ -15,6 +15,7 @@ package io.github.subiyacryolite.jds.portable
 
 import com.fasterxml.jackson.annotation.JsonProperty
 import io.github.subiyacryolite.jds.Field
+import java.io.Serializable
 import java.sql.Timestamp
 
 /**
@@ -30,4 +31,4 @@ data class StoreDateTime(
         @get:JsonProperty("v")
         @set:JsonProperty("v")
         var value: Long? = null
-)
+): Serializable

src/main/kotlin/io/github/subiyacryolite/jds/portable/StoreDateTimeCollection.kt

@@ -15,6 +15,7 @@ package io.github.subiyacryolite.jds.portable
 
 import com.fasterxml.jackson.annotation.JsonProperty
 import io.github.subiyacryolite.jds.Field
+import java.io.Serializable
 import java.sql.Timestamp
 import java.util.ArrayList
 
@@ -31,4 +32,4 @@ data class StoreDateTimeCollection(
         @get:JsonProperty("v")
         @set:JsonProperty("v")
         var values: Collection<Timestamp> = ArrayList()
-)
+): Serializable