Adding/improving some docs, fixing some bugs (CharConv...), Improving

SerializationDebuger (OUT, it shows exceptions...), Improving
LogProvider, Refactoring/improivng operators, Logical, Comparasional,
adding numeric and logical negation... ConditionalAsigment. Improving
some other things...

Author: SimplyProgrammer

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

@@ -36,8 +36,8 @@ public void logErr(Object obj, Throwable ex)
 	{
 		if (reThrowException)
 		{
-			if (ex == null)
-				throw new RuntimeException(obj.toString());
+			if (ex == null || ex.getMessage() == null || ex.getMessage().isEmpty())
+				throw new RuntimeException(String.valueOf(obj));
 			throw new RuntimeException(ex);
 		}
 

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

@@ -590,40 +590,42 @@ else if (quote % 2 != 0)
 	 * @param s | CharSequence to search!
 	 * @param oneOf | Characters to find!
 	 * 
-	 * @return Index of first found character that is not in object meaning it is not in string nor between '{' or '[' and ']' or '}', otherwise -1!
+	 * @return Index of first character found that is not in object meaning it is not in string nor between '{' or '[' and ']' or '}', otherwise -1!
 	 * 
 	 * @since 1.3.0
 	 */
 	public static int indexOfNotInObj(CharSequence s, char... oneOf)
 	{
-		return indexOfNotInObj(s, true, oneOf);
+		return indexOfNotInObj(s, 0, s.length(), true, oneOf);
 	}
 
 	/**
 	 * @param s | CharSequence to search!
+	 * @param from | The beginning index, where to start the search (should be 0 in most cases).
+	 * @param to | Ending index of search (exclusive, should be s.length()).
 	 * @param firstIndex | If true, first index will be returned, if false last index will be returned.
 	 * @param oneOf | Characters to find!
 	 * 
-	 * @return Index of first found character that is not in object meaning it is not in string nor between '{' or '[' and ']' or '}', otherwise -1!
+	 * @return Index of first character found that is not in object meaning it is not in string nor between '{' or '[' and ']' or '}', otherwise -1!
 	 * 
 	 * @since 1.3.5
 	 */
-	public static int indexOfNotInObj(CharSequence s, boolean firstIndex, char... oneOf)
+	public static int indexOfNotInObj(CharSequence s, int from, int to, boolean firstIndex, char... oneOf)
 	{
-		int found = -1;
-		for (int i = 0, brackets = 0, quote = 0, len = s.length(); i < len; i++)
+		int index = -1;
+		for (int brackets = 0, quote = 0; from < to; from++)
 		{
-			char ch = s.charAt(i);
+			char ch = s.charAt(from);
 			if (ch == '"')
 				quote++;
 
 			if (quote % 2 == 0)
 			{
 				if (brackets == 0 && /*oneOf.length == 0 ? ch == oneOf[0] :*/ isOneOf(ch, oneOf))
 				{
-					found = i;
 					if (firstIndex)
-						return found;
+						return from;
+					index = from;
 				}
 				else if ((ch | ' ') == '{')
 					brackets++;
@@ -636,7 +638,7 @@ else if ((ch | ' ') == '}')
 				}
 			}
 		}
-		return found;
+		return index;
 	}
 
 	/**
@@ -663,8 +665,11 @@ public static int indexOfNotInObj(CharSequence s, CharSequence sequenceToFind)
 	 */
 	public static int indexOfNotInObj(CharSequence s, CharSequence sequenceToFind, boolean firstIndex)
 	{
+		int len = s.length(), lenToFind = sequenceToFind.length();
+		if (len < lenToFind)
+			return -1;
 		int found = -1;
-		for (int i = 0, brackets = 0, quote = 0, match = 0, len = s.length(), lenToFind = sequenceToFind.length(); i < len; i++)
+		for (int i = 0, brackets = 0, quote = 0, match = 0; i < len; i++)
 		{
 			char ch = s.charAt(i);
 			if (ch == '"')
@@ -885,7 +890,7 @@ public static void post(Serializer serializer, HttpURLConnection conn) throws IO
 
         for (Object param : serializer) 
         {
-            if (postData.length() != 0) 
+            if (postData.length() != 0)
             	postData.append('&');
             postData.append(URLEncoder.encode(serializer.getParsers().toString(param).toString(), "UTF-8"));
         }

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

@@ -44,13 +44,18 @@
  */
 public class BooleanConverter implements DataConverter
 {
-	public boolean shorten;
+	protected boolean shorten;
 
 	public BooleanConverter() 
 	{
 		this(true);
 	}
 
+	/**
+	 * @param shorten | If true, shortened format (T/F) will be serialized. If false, true/false will be serialized...
+	 * 
+	 * @since 1.3.5
+	 */
 	public BooleanConverter(boolean shorten) 
 	{
 		setShorten(shorten);
@@ -84,11 +89,21 @@ public CharSequence getDescription(ParserRegistry myHomeRegistry, Object obj, Ob
 		return new StringBuilder().append("Primitive data type: \"").append(obj).append("\" the ").append(obj.getClass().getSimpleName().toLowerCase()).append(" value!");
 	}
 
+	/**
+	 * @return If true, shortened format (T/F) will be serialized. If false, true/false will be serialized...
+	 * 
+	 * @since 1.3.5
+	 */
 	public boolean isShorten() 
 	{
 		return shorten;
 	}
 
+	/**
+	 * @param shorten | If true, shortened format (T/F) will be serialized. If false, true/false will be serialized...
+	 * 
+	 * @since 1.3.5
+	 */
 	public void setShorten(boolean shorten) 
 	{
 		this.shorten = shorten;

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

@@ -46,7 +46,7 @@ public Object parse(ParserRegistry myHomeRegistry, String str, Object... args)
 			}
 			catch (Exception e) 
 			{
-				return str.charAt(0);
+				return str.charAt(1);
 			}
 		return CONTINUE;
 	}

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

@@ -31,7 +31,7 @@ public interface DataConverter extends DataParser
 	 * @param objToDescribe | Object to generate description for!
 	 * @param argsUsedConvert | Array of arguments that were used for converting described object!
 	 * 
-	 * @return Description for object (should not contains endlines)!
+	 * @return Description for object (should not contain endlines)!
 	 * 
 	 * @since 1.3.0
 	 */

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

@@ -247,7 +247,9 @@ public Object parse(String str, boolean returnAsStringIfNotFound, Class<?>[] ign
 		/**
 		 * @param classOfParserToPrecache | Class of parser to precache!
 		 * 
-		 * @return Int array of 2 signifying the index of where the parser was inserted in parsing cache and converting cache (index 0 = parsing cache index, index 1 = converting cache index)
+		 * @return Int array of 2 signifying the index of where the parser was inserted in parsing cache and converting cache (index 0 = parsing cache index, index 1 = converting cache index). These 2 values should be the same.
+		 * 
+		 * @since 1.3.5
 		 */
 		public int[] preCache(Class<? extends DataParser> classOfParserToPrecache)
 		{
@@ -303,8 +305,8 @@ public void resetCache()
 		/**
 		 * You can use this to manually set caching arrays. Doing this might give you a solid performance boost when parsing or converting large amount of objects with this registry! But sometimes, this might cause some unexpected behavior especially when you have multiple parsers that are dependent on each other!
 		 * 
-		 * @param parsingCache | Array of specific parsing cache to use (it can contains some preached parsers to use preferably). This array is supposed to be as long as this registry!
-		 * @param convertingCache | Array of specific converter cache to use (it can contains some preached converters to use preferably). This array is supposed to be as long as this registry!
+		 * @param parsingCache | Array of specific parsing cache to use (it can contains some preached parsers to use preferably). This array is supposed to be as long as this registry and instances and their indexes (order) in cache should be same as in this registry!
+		 * @param convertingCache | Array of specific converter cache to use (it can contains some preached converters to use preferably). This array is supposed to be as long as this registry and instances and their indexes (order) in cache should be same as in this registry!
 		 * 
 		 * @since 1.3.5
 		 */

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

@@ -259,7 +259,7 @@ else if (ch != 127 && ch != '+')
 	}
 
 	/**
-	 * @deprecated THIS IS NO LONGER NECESSARY BECAUSE BECAUSE {@link NumberConverter#numberOf(CharSequence, char, int, int, int)} CAN DO THE SAME THING MUCH FASTET!
+	 * @deprecated THIS IS OBSOLET, SLOW AND NO LONGER NECESSARY BECAUSE {@link NumberConverter#numberOf(CharSequence, char, int, int, int)} CAN DO THE SAME THING MUCH FASTET!
 	 * 
 	 * @param num | Number string to format!
 	 * 

SerialX-devtools/src/main/java/org/ugp/serialx/devtools/converters/DebugParserRegistry.java renamed to SerialX-devtools/src/main/java/org/ugp/serialx/devtools/DebugParserRegistry.java

@@ -1,4 +1,4 @@
-package org.ugp.serialx.devtools.converters;
+package org.ugp.serialx.devtools;
 
 import java.util.Map;
 import java.util.TreeMap;
@@ -7,7 +7,6 @@
 import org.ugp.serialx.converters.DataConverter;
 import org.ugp.serialx.converters.DataParser;
 import org.ugp.serialx.converters.DataParser.ParserRegistry;
-import org.ugp.serialx.devtools.SerializationDebugger;
 
 /**
  * Special {@link ParserRegistry} that keeps track of its actions! Use only for debugging!
@@ -115,13 +114,21 @@ public Object parse(String str, boolean returnAsStringIfNotFound, Class<?>[] ign
 				DataParser parser = parsingCache[i];
 				if (parser != null)
 				{
-					double t0 = System.nanoTime();
-					obj = parser.parse(this, str, args);
-					double t = System.nanoTime();
-					if (obj != SerializationDebugger.CONTINUE)
+					try 
 					{
-						iterationStackTrace.put(iterationIndex, "[" + i + "] " + parser + " " + (t-t0)/1000000 + "ms (from cache)\n>>\t\"" + str + "\"\t -->\t" + SerializationDebugger.toStringAndCls(obj));
-						return obj; 
+						double t0 = System.nanoTime();
+						obj = parser.parse(this, str, args);
+						double t = System.nanoTime();
+						if (obj != SerializationDebugger.CONTINUE)
+						{
+							iterationStackTrace.put(iterationIndex, "[" + i + "] " + parser + " " + (t-t0)/1000000 + "ms (from cache)\n>>\t\"" + str + "\"\t -->\t" + SerializationDebugger.toStringAndCls(obj));
+							return obj; 
+						}
+					}
+					catch (Exception ex)
+					{
+						iterationStackTrace.put(iterationIndex, "[" + i + "] " + parser + " (from cache)\n>>\t\"" + str + "\"\tthrew\t" + ex);
+						return null;
 					}
 				}
 			}
@@ -134,15 +141,23 @@ public Object parse(String str, boolean returnAsStringIfNotFound, Class<?>[] ign
 					if (cls == parser.getClass())
 						continue registryLoop;
 
-			double t0 = System.nanoTime();
-			obj = parser.parse(this, str, args);
-			double t = System.nanoTime();
-			if (obj != SerializationDebugger.CONTINUE)
+			try 
+			{
+				double t0 = System.nanoTime();
+				obj = parser.parse(this, str, args);
+				double t = System.nanoTime();
+				if (obj != SerializationDebugger.CONTINUE)
+				{
+					if (parsingCache != null && i < parsingCache.length)
+						parsingCache[i] = parser;
+					iterationStackTrace.put(iterationIndex, "[" + i + "] " + parser + " " + (t-t0)/1000000 + "ms\n>>\t\"" + str + "\"\t -->\t" + SerializationDebugger.toStringAndCls(obj));
+					return obj;
+				}
+			}
+			catch (Exception ex)
 			{
-				if (parsingCache != null && i < parsingCache.length)
-					parsingCache[i] = parser; 
-				iterationStackTrace.put(iterationIndex, "[" + i + "] " + parser + " " + (t-t0)/1000000 + "ms\n>>\t\"" + str + "\"\t -->\t" + SerializationDebugger.toStringAndCls(obj));
-				return obj;
+				iterationStackTrace.put(iterationIndex, "[" + i + "] " + parser + "\n>>\t\"" + str + "\"\tthrew\t" + ex);
+				return null;
 			}
 		}