make it 1.3.8

Author: SimplyProgrammer

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

@@ -209,7 +209,7 @@ public ValT put(KeyT variableKey, ValT variableValue)
 	 * 
 	 * @return Array of values previously at keys from kv array.
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	@SuppressWarnings("unchecked")
 	public ValT[] putAllKv(Object... kVkVkV)
@@ -303,7 +303,7 @@ public <V extends ValT> V get(KeyT variableKey, V defaultValue)
 	 * If there is no other variable called "value" in the scope tree then you can also simplify it to <code>scope.get("value")</code>, but make sure that there is no equally-named variable!<br>
 	 * Note: Make sure that you are not calling {@link GenericScope#get(Object, Object)} by accident when you are using inline vargas array (unspecified count of arguments)!
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	@SuppressWarnings("unchecked")
 	public <V extends ValT> V get(KeyT... pathToValue)
@@ -341,7 +341,7 @@ public <V extends ValT> V get(KeyT... pathToValue)
 	 * 
 	 * @throws Exception | If converting to object of cls failed from some reason! This can differ from implementation to implementation! By default it uses {@link GenericScope#toObject(cls)}
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	public <V extends ValT> V get(KeyT variableKey, Class<? extends V> cls, V defaultValue) throws Exception
 	{
@@ -370,7 +370,7 @@ public boolean containsVariable(KeyT variableKey)
 	 * 
 	 * @return True if independent value was found in this scope.
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	@Override
 	public boolean contains(Object value) 
@@ -415,7 +415,7 @@ public <V extends ValT> V get(int valueIndex)
 	 * 
 	 * @throws Exception | If converting to object of cls failed from some reason! This can differ from implementation to implementation!
      *
-     * @since 1.3.7
+     * @since 1.3.8
 	 */
 	public <V extends ValT> V get(int valueIndex, Class<V> cls) throws Exception
 	{
@@ -475,7 +475,7 @@ public boolean addAll(@SuppressWarnings("unchecked") ValT... values)
 	 * 
 	 * @return True all provided values are contained in this scope as independent values!
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	@Override
 	public boolean containsAll(Collection<?> values)
@@ -488,7 +488,7 @@ public boolean containsAll(Collection<?> values)
 	 * 
 	 * @return {@link Collection#removeAll(Collection)} for the independent values,,,
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	@Override
 	public boolean removeAll(Collection<?> values)
@@ -501,7 +501,7 @@ public boolean removeAll(Collection<?> values)
 	 * 
 	 * @return {@link Collection#retainAll(Collection)} for the independent values,,,
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	@Override
 	public boolean retainAll(Collection<?> values)
@@ -774,7 +774,7 @@ public ValT remove(int valueIndex)
 	 * 
 	 * @return Value of variable that was removed!
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	@Override
 	public boolean remove(Object independentValue)
@@ -787,7 +787,7 @@ public boolean remove(Object independentValue)
 	 * 
 	 * @return Value of variable that was removed!
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	public ValT removeVariable(KeyT variableKey)
 	{
@@ -869,7 +869,7 @@ public int variablesCount()
 	/**
 	 * @return Total number of variables and independent values of this scope! (<code>vvaluesCount() + variablesCount()</code>)
 	 * 
-	 * @since 1.3.7 (before 1.3.7 known as totalSize)
+	 * @since 1.3.8 (before 1.3.8 known as totalSize)
 	 */
 	@Override
 	public int size()
@@ -948,7 +948,7 @@ public List<? extends ValT> toValList()
 	 * @return Primitive array with independent values of this {@link GenericScope}. These values have nothing to do with values of variables, they are independent!
 	 * Modifying this list will not affect this {@link GenericScope} object!
 	 * 
-	 * @since 1.3.7 (before 1.3.7 known as toValArray)
+	 * @since 1.3.8 (before 1.3.8 known as toValArray)
 	 */
 	@Override
 	public Object[] toArray() 
@@ -962,7 +962,7 @@ public Object[] toArray()
 	 * @return Primitive array with independent values of this {@link GenericScope}. These values have nothing to do with values of variables, they are independent!
 	 * Modifying this list will not affect this {@link GenericScope} object!
 	 * 
-	 * @since 1.3.7 (before 1.3.7 known as toValArray)
+	 * @since 1.3.8 (before 1.3.8 known as toValArray)
 	 */
 	@Override
 	public <T> T[] toArray(T[] vals) 
@@ -1088,7 +1088,7 @@ public static <K, V, S extends GenericScope<K, V>> S intoBidirectional(S scopeTo
 	 * 
 	 * @return Same map populated with kV array.
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	@SuppressWarnings("unchecked")
 	public static <K, V, M extends Map<K, V>> M mapKvArray(M map, Object... kVkVkV)

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

@@ -1291,7 +1291,7 @@ public static <T> T into(T obj, GenericScope<? super String, ?> fromScope, List<
 	 * 
 	 * @throws Exception if Scope#intoNew(Type, GenericScope, String...) fails...
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	@SuppressWarnings("unchecked")
 	public static <T> List<T> intoGeneric(List<?> listToGenerify, ParameterizedType genericType) throws Exception
@@ -1331,7 +1331,7 @@ public static <T> List<T> intoGeneric(List<?> listToGenerify, ParameterizedType
 	* 
 	* @throws Exception if Scope#intoNew(Type, GenericScope, String...) fails...
 	* 
-	* @since 1.3.7
+	* @since 1.3.8
 	*/
 	@SuppressWarnings("unchecked")
 	public static <T> Map<?, T> intoGeneric(Map<?, ?> mapToGenerify, ParameterizedType genericType) throws Exception
@@ -1400,7 +1400,7 @@ public static List<PropertyDescriptor> getPropertyDescriptorsOf(Class<?> cls, Ma
 	 * 
 	 * @see PropertyDescriptor
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	public static List<PropertyDescriptor> getPropertyDescriptorsOf(Class<?> cls, Map<Class<?>, List<PropertyDescriptor>> cache, int modifiersToIgnore, String... fieldNames) throws IntrospectionException
 	{

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

@@ -605,7 +605,7 @@ public <A extends Appendable> A SerializeAsSubscope(A source, char[] wrappingBra
 	 * 
 	 * @return Object that was parsed from string at given index, using parsers of this {@link Serializer}!
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	@SuppressWarnings("unchecked")
 	public <T> T getParsed(int indexWithStringValue, Object... args)
@@ -619,7 +619,7 @@ public <T> T getParsed(int indexWithStringValue, Object... args)
 	 * 
 	 * @return Object that was parsed from value of given variable, using parsers of this {@link Serializer}!
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	@SuppressWarnings("unchecked")
 	public <T> T getParsed(String variableWithStringValue, Object... args)

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

@@ -30,7 +30,7 @@
  * 
  * @author PETO
  * 
- * @since 1.3.7
+ * @since 1.3.8
  */
 public final class Utils {
 	private Utils() {}
@@ -522,7 +522,7 @@ public static String[] splitValues(String s, int limit, int splittingStrategy, c
 	 * 
 	 * @return String splitted after splitters according to arguments. Each resulting token will be {@link String#trim() trim}<code>med</code>!
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	public static String[] splitValues(String s, int i, int limit, int splittingStrategy, char[] splitBreaks, char... splitter)
 	{
@@ -784,7 +784,7 @@ public static boolean contains(CharSequence str, char... oneOf)
 	 * Note that this function was designed for non-blank ASCII strings and may not work properly for others...<br>
 	 * Also sufficient length of both strings is not checked so adjust from and to accordingly.
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	public static boolean equalsLowerCase(CharSequence str, CharSequence lowerCaseOther, int from, int to)
 	{
@@ -852,7 +852,7 @@ public static Object[] mergeArrays(Object arr1, Object arr2)
 	 * 
 	 * @throws IllegalArgumentException if the specified object is not an array!
 	 * 
-	 * @since 1.3.2 (since 1.3.7 moved from ArrayConverter)
+	 * @since 1.3.2 (since 1.3.8 moved from ArrayConverter)
 	 */
 	public static Object[] fromAmbiguousArray(Object array)
 	{
@@ -912,7 +912,7 @@ public static void post(Serializer serializer, HttpURLConnection conn) throws IO
 	 *
 	 * @since 1.2.2
 	 * 
-	 * @deprecated (in 1.3.7) NO LONGER NEEDED, DO NOT USE THIS! You were never supposed to...
+	 * @deprecated (in 1.3.8) NO LONGER NEEDED, DO NOT USE THIS! You were never supposed to...
 	 */
 	public static final class NULL //TODO: REMOVE IN NEXT V!!!!
 	{

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

@@ -199,7 +199,7 @@ public CharSequence toString(Object obj, Object... args)
 		 * 
 		 * @see DataParser#parseObj(String, Object...)
 		 * 
-		 * @since 1.3.7
+		 * @since 1.3.8
 		 */
 		@Override
 		public Object parse(ParserRegistry parentRegistry, String str, Object... args) 

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

@@ -155,7 +155,7 @@ public CharSequence getDescription(ParserRegistry myHomeRegistry, Object obj, Ob
 	 * 
 	 * @return Number formated to string!
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	public String format(Number num) 
 	{
@@ -174,7 +174,7 @@ public String format(Number num)
 	 * @return {@link Number} parsed from str with rules specified above. This function was designed to act as more optimized merger of {@link Byte#valueOf(String, int)}, {@link Short#valueOf(String, int)}, {@link Integer#valueOf(String, int)}, {@link Long#valueOf(String, int)} and {@link Float#valueOf(String)}, {@link Double#valueOf(String)} all encapsulated in 1 universal function.<br>
 	 * Note: This function will not check for incorrect number formats in order to save performance. Only incorrect format is when inserted string contains space, in this case it will return null!
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	public static Number numberOf(CharSequence str, char ch0, int end, int base, int type)
 	{

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

@@ -54,7 +54,7 @@
  *  
  * @author PETO
  * 
- * @since 1.3.0 (separated from ObjectConverter since 1.3.7)
+ * @since 1.3.0 (separated from ObjectConverter since 1.3.8)
  */
 public class ProtocolConverter implements DataConverter 
 {
@@ -96,7 +96,7 @@ public Object parse(ParserRegistry myHomeRegistry, String str, Object... compile
 	 * 
 	 * @return Object od objClass parsed from str in accordance with compilerArgs!
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	protected Object parse(ParserRegistry myHomeRegistry, Class<?> objClass, String str, Object... compilerArgs)
 	{
@@ -284,7 +284,7 @@ public void setUseBase64IfCan(boolean useBase64IfCan)
 	/**
 	 * @return True if invocation of static members (:: operator) is allowed (false by default)!
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	public boolean isAllowStaticMemberInvocation()
 	{
@@ -294,7 +294,7 @@ public boolean isAllowStaticMemberInvocation()
 	/**
 	 * @param allowStaticMemberInvocation | Enable/disable the invocation of static members (:: operator) (false by default)!
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	public void setAllowStaticMemberInvocation(boolean allowStaticMemberInvocation) 
 	{
@@ -407,7 +407,7 @@ public static char[] secondarySubscopeWrappers()
 	 * @return {@link Utils#InvokeStaticFunc(Class, String, Object...)} or null if {@link InvocationTargetException} occurred. <br>
 	 * Note: If you are not sure what this does, preferably use {@link Utils#InvokeStaticFunc(Class, String, Object...)}!
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	public static Object InvokeStaticFunc(Class<?> cls, Class<?> oldCls, String name, Object[] args, Object... compilerArgs) {
 		try

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

@@ -108,7 +108,7 @@ public CharSequence getDescription(ParserRegistry myHomeRegistry, Object obj, Ob
 	 * Recommended: Enable this when parsing a lot of strings that are the same, otherwise this will not have a big impact.<br>
 	 * Rule of thumb, is that this cache should be modified only by this converter however adding some pre-cached entries is possible but should be performed with caution!
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	public void setParsingCache(Map<String, String> cache)
 	{
@@ -120,7 +120,7 @@ public void setParsingCache(Map<String, String> cache)
 	 * Null will be returned if caching is disabled, which is by default...<br>
 	 * Note: Rule of thumb, is that this cache should be modified only by this converter however adding some pre-cached entries is possible but should be performed with caution!
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	public Map<String, String> getParsingCache()
 	{
@@ -130,7 +130,7 @@ public Map<String, String> getParsingCache()
 	/**
 	 * @return Will return value of {@link StringConverter#serializeStringNormally}!
 	 * 
-	 * @since 1.3.7 (it was static before = not good)
+	 * @since 1.3.8 (it was static before = not good)
 	 */
 	public boolean isSerializeStringNormally() 
 	{
@@ -140,7 +140,7 @@ public boolean isSerializeStringNormally()
 	/**
 	 * @param serializeStringNormally | Set value of {@link StringConverter#serializeStringNormally}!
 	 * 
-	 * @since 1.3.7 (it was static before = not good)
+	 * @since 1.3.8 (it was static before = not good)
 	 */
 	public void setSerializeStringNormally(boolean serializeStringNormally) 
 	{

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

@@ -18,7 +18,7 @@
  * 
  * @author PETO
  *	
- * @since 1.3.7
+ * @since 1.3.8
  */
 public class VariableParser implements DataParser
 {
@@ -40,7 +40,7 @@ public Object parse(ParserRegistry myHomeRegistry, String str, Object... args)
 	 * @return The value of member from given source. You can think about this as ekvivalent to <code>source.member</code> in Java. If member with provided name/key is not present in the source or its value is not possible to get, {@link VOID} has to be returned! If source can't be accessed/dereferenced, <code>null</code> has to be returned!<br>
 	 * Note: This method is meant to be overridden in order to add support for accessing multiple sources because by default it supports only {@link GenericScope}
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	@SuppressWarnings("unchecked")
 	public Object getMemberOperator(Object source, Object member)
@@ -58,7 +58,7 @@ public Object getMemberOperator(Object source, Object member)
 	 * 
 	 * @return Value of variable read from scope is str was suitable. Special return types are {@link DataParser#VOID} and {@link DataParser#CONTINUE}. Continue will ignore this parser and jump to another one in registry.
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	protected Object parse(ParserRegistry myHomeRegistry, String str, GenericScope<?, Object> scope, Object... args)
 	{

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

@@ -22,7 +22,7 @@ public interface ImportsProvider
 	 * Cache of Classes to their respective names/aliases.<br>
 	 * Note: Treat as read only if possible!
 	 * 
-	 * @since 1.3.7
+	 * @since 1.3.8
 	 */
 	public static final Map<String, Class<?>> CLASS_CACHE = new HashMap<String, Class<?>>();