README.md

shallow-copy

📚 Introduction

shallow-copy is a copy library for java which copies explicid non-final fields marked with @Expose to a new object. To be more precise, it sets the field of the copy to the value of the parent. This means that values that are called by reference are not realy copied and the reference is the same - only primitive types that are called by value and thus copied.

Motivation

Copying an object with either the provided copy function or a so called "deep copy" by serializing the object into json and back to an object using e.g. gson was to slow for my needs. Therefore I investigated what types of copy could be faster and ended up implementing a short, easy to use shallow copy library.

📝 Getting started

Given this is you class you want to copy (often):

import me.micartey.shallowcopy.Expose;

public class TestClass {
    
    @Expose private boolean isCoding, isSleeping, isDebuging, isNotEating;

}

You can copy it's instance by following the example:

TestClass test = new TestClass(...);
TestClass copy = new ShallowCopy<>(TestClass.class).copy(test);