...

Author: SimplyProgrammer

SerialX-core/src/main/java/org/ugp/serialx/Serializer.java

@@ -36,7 +36,7 @@
 
 /**
  * {@link org.ugp.serialx.Serializer} is powerful utility class that allows you to serialize any object in Java using custom data format compiled by recursive descent parser consisting of {@link DataParser}s.
- * This class itself is responsible for utility, formating and managing input-output (IO) of content obtained from parsers and protocols as well as their management of their usage!
+ * This class itself is responsible for formating and managing input-output (IO) of content obtained from parsers and protocols as well as their management of their usage!
  * It is instance of {@link Scope} so we can say that this is scope that can serialize itself using system of already mentioned {@link DataParser} and {@link SerializationProtocol}!
  * 
  * @author PETO

SerialX-core/src/main/java/org/ugp/serialx/converters/DataParser.java

@@ -7,7 +7,7 @@
 import org.ugp.serialx.Scope;
 
 /**
- * This class supposed to be used to parse strings back to java objects using {@link DataParser#parse(String, Object...)}!
+ * This interface is supposed to be used to parse strings back to java objects using {@link DataParser#parse(String, Object...)}!
  * Instance of DataParser should be registered into {@link DataParser#REGISTRY} or other external registry in order to work, also only one instance of each DataParser should be used and accessed via this registry! <br>
  * Static method {@link DataParser#parseObj} is used to walk this registry and parse inserted string in process, in other words we can say that this interface contains <a href = "https://en.wikipedia.org/wiki/Recursive_descent_parser">recursive descent parse</a> that uses its own implementations!
  * 

SerialX-core/src/main/java/org/ugp/serialx/protocols/EnumProtocol.java

@@ -1,9 +1,7 @@
  package org.ugp.serialx.protocols;
 
-import java.util.Collection;
-
 /**
- * EnumProtocol is universal protocol to serialize any enumerator ({@link Collection} instance).
+ * EnumProtocol is universal protocol to serialize any enumerator ({@link Enum} instance).
  * 
  * @author PETO
  *

SerialX-core/src/main/java/org/ugp/serialx/protocols/SerializationProtocol.java

@@ -30,7 +30,7 @@ public abstract class SerializationProtocol<T>
 	 * 
 	 * @since 1.3.0
 	 */
-	public static final ProtocolRegistry REGISTRY = new ProtocolRegistry(/*This might be unsafe: new UniversalObjectInstantiationProtocol<>(Object.class),*/ new ListProtocol(), new MapProtocol(), new StringProtocol(), new ScopeProtocol(), new SelfSerializableProtocol(), new EnumProtocol());
+	public static final ProtocolRegistry REGISTRY = new ProtocolRegistry(/*This might be unsafe: new UniversalObjectInstantiationProtocol<>(Object.class), new SelfSerializableProtocol(SelfSerializable.class),*/ new ListProtocol(), new MapProtocol(), new StringProtocol(), new ScopeProtocol(), new EnumProtocol());
 
 	/**
 	 * This mode is for protocols that are used for serialization only!

SerialX-juss/src/main/java/org/ugp/serialx/juss/protocols/AutoProtocol.java

@@ -1,4 +1,6 @@
-package org.ugp.serialx.protocols;
+package org.ugp.serialx.juss.protocols;
+
+import static org.ugp.serialx.Utils.Instantiate;
 
 import java.beans.IntrospectionException;
 import java.beans.PropertyDescriptor;
@@ -8,7 +10,7 @@
 
 import org.ugp.serialx.Scope;
 import org.ugp.serialx.Serializer;
-import org.ugp.serialx.Utils;
+import org.ugp.serialx.protocols.SerializationProtocol;
 
 /**
  * This is automatic protocol that will automatically serialize every or selected field in object that has valid and public getter and setter!
@@ -128,7 +130,7 @@ public AutoProtocol(Class<T> applicableFor, boolean useScope, List<PropertyDescr
 	 */
 	public T createBlankInstance(Class<? extends T> objectClass) throws Exception
 	{
-		return Utils.Instantiate(objectClass);
+		return Instantiate(objectClass);
 	}
 
 	@Override

SerialX-juss/src/main/java/org/ugp/serialx/juss/protocols/SelfSerializable.java

@@ -1,9 +1,7 @@
-package org.ugp.serialx.protocols;
-
-import java.io.Serializable;
+package org.ugp.serialx.juss.protocols;
 
 /**
- * This is based on pretty similar concept as regular {@link Serializable} is! However this interface is meant to create its instance programmatically via constructor!
+ * This is based on pretty similar concept as regular {@link java.io.Serializable} is! However this interface is meant to create its instance programmatically via constructor!
  * So condition of using this is that array of objects returned by {@link SelfSerializable#serialize()} must be applicable for some public constructor of certain class implementing this!
  * Specific instances of this interface will be created by calling that public constructor! This is done reflectively by {@link SelfSerializableProtocol}!
  * 

SerialX-juss/src/main/java/org/ugp/serialx/juss/protocols/SelfSerializableProtocol.java

@@ -1,4 +1,4 @@
-package org.ugp.serialx.protocols;
+package org.ugp.serialx.juss.protocols;
 
 /**
  * SelfSerializableProtocol is universal protocol to serialize any {@link SelfSerializable} instance. The condition of use is implementation of {@link SelfSerializable} interface and public constructor that can be called with content returned by specific {@link SelfSerializable#serialize()}!
@@ -11,13 +11,19 @@
  */
 public class SelfSerializableProtocol extends UniversalObjectInstantiationProtocol<SelfSerializable> 
 {
-	public SelfSerializableProtocol() 
+	/**
+	 * @param applicableFor | Class implementing {@link SelfSerializable} that can be serialized using this protocol.<br>
+	 * Note: Passing {@link SelfSerializable#getClass()} will make this protocol universal and work for any {@link SelfSerializable} instance, this can be considered unsafe in some cases...
+	 * 
+	 * @since 1.3.7
+	 */
+	public SelfSerializableProtocol(Class<? extends SelfSerializable> applicableFor) 
 	{
-		super(SelfSerializable.class);
+		super(applicableFor);
 	}
 
 	@Override
-	public Object[] serialize(SelfSerializable object) 
+	public Object[] serialize(SelfSerializable object)
 	{
 		return object.serialize();
 	}
@@ -28,3 +34,4 @@ public byte getMode()
 		return MODE_ALL;
 	}
 }
+ 

SerialX-juss/src/main/java/org/ugp/serialx/juss/protocols/UniversalObjectInstantiationProtocol.java

@@ -1,10 +1,11 @@
-package org.ugp.serialx.protocols;
+package org.ugp.serialx.juss.protocols;
 
 import java.lang.reflect.Constructor;
 import java.util.Arrays;
 
 import org.ugp.serialx.LogProvider;
 import org.ugp.serialx.Utils;
+import org.ugp.serialx.protocols.SerializationProtocol;
 
 /**
  * Universal protocol for deserializing any object using its constructor. Args array of {@link UniversalObjectInstantiationProtocol#unserialize(Class, Object...)} must have elements applicable as arguments for some constructor of required objects class!
@@ -18,14 +19,15 @@
  */
 public class UniversalObjectInstantiationProtocol<T> extends SerializationProtocol<T> {
 
-	protected final Class<T> applicableFor;
+	protected final Class<? extends T> applicableFor;
 
 	/**
 	 * @param applicableFor | Class that can be serialized using this protocol.
+	 * Note: Passing {@link Object#getClass()} will make this protocol universal and work for any {@link Object} instance, this can be considered unsafe in some cases...
 	 * 
 	 * @since 1.3.7
 	 */
-	public UniversalObjectInstantiationProtocol(Class<T> applicableFor)
+	public UniversalObjectInstantiationProtocol(Class<? extends T> applicableFor)
 	{
 		this.applicableFor = applicableFor;
 	}