Appandable for toString

Author: SimplyProgrammer

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

@@ -3,6 +3,8 @@
 import static java.lang.Boolean.*;
 import static org.ugp.serialx.Utils.equalsLowerCase;
 
+import java.io.IOException;
+
 /**
  * This converter is capable of converting {@link String}. 
  * Its case insensitive!
@@ -76,10 +78,14 @@ public Object parse(ParserRegistry myHomeRegistry, String str, Object... args)
 	}
 
 	@Override
-	public CharSequence toString(ParserRegistry myHomeRegistry, Object obj, Object... args) 
+	public Appendable toString(Appendable source, ParserRegistry myHomeRegistry, Object obj, Object... args) throws IOException 
 	{
 		if (obj instanceof Boolean)
-			return isShorten() ? (boolean) obj ? "T" : "F" : (boolean) obj ? "true" : "false";
+		{
+			if (isShorten())
+				return source.append((boolean) obj ? 'T' : 'F');
+			return source.append((boolean) obj ? "true" : "false");
+		}
 		return CONTINUE;
 	}
 

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

@@ -1,5 +1,7 @@
 package org.ugp.serialx.converters;
 
+import java.io.IOException;
+
 /**
  * This converter is capable of converting {@link Character}.
  * Its case sensitive!
@@ -52,10 +54,10 @@ public Object parse(ParserRegistry myHomeRegistry, String str, Object... args)
 	}
 
 	@Override
-	public CharSequence toString(ParserRegistry myHomeRegistry, Object obj, Object... args) 
+	public Appendable toString(Appendable source, ParserRegistry myHomeRegistry, Object obj, Object... args) throws IOException 
 	{
 		if (obj instanceof Character)
-			return "'"+(int) (char) obj+"'";
+			return source.append("'"+(int) (char) obj+"'");
 		return CONTINUE;
 	}
 

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

@@ -1,5 +1,7 @@
 package org.ugp.serialx.converters;
 
+import java.io.IOException;
+
 /**
  * This is DataParser with extended functionality! {@link DataConverter} can also parse data like DataParser but is also capable of converting them back to string!
  * This to string convertation is performed by {@link DataConverter#toString(Object)} and result of this convertation supposed to be parsable by {@link DataConverter#parse(String, Object...)} meaning one converter supposed to be parsing and converting via the same string format!
@@ -22,7 +24,33 @@ public interface DataConverter extends DataParser
 	 * 
 	 * @since 1.3.0
 	 */
-	CharSequence toString(ParserRegistry myHomeRegistry, Object obj, Object... args);
+	@Deprecated
+	default CharSequence toString(ParserRegistry myHomeRegistry, Object obj, Object... args)
+	{
+		try 
+		{
+			return (CharSequence) toString(new StringBuilder().append(0), myHomeRegistry, obj, args);
+		} 
+		catch (IOException e) 
+		{
+			throw new RuntimeException(e); // Rare...
+		}
+	}
+	
+	/**
+	 * @param source | Source to append the properly stringified object (obj) into. Should be treated as only and only {@link Appendable}, no casting!
+	 * @param myHomeRegistry | Registry where this parser is registered provided by {@link ParserRegistry#parse(String, boolean, Class, Object...)} otherwise it demands on implementation (it should not be null)!
+	 * @param obj | Object to convert into string!
+	 * @param args | Some additional args. This can be anything and it demands on implementation of DataConverter. Default SerialX API implementation will provide some flags about formating (2 ints)!
+	 * 
+	 * @return The source appendable after stringified object (obj) was appropriately appended into it.
+	 * Return {@link DataParser#CONTINUE} to tell that this converter is not suitable for converting this object! You most likely want to do this when obtained obj is not suitable instance!
+	 * 
+	 * @throws IOException When appending into source throws it... 
+	 * 
+	 * @since 1.3.9
+	 */
+	Appendable toString(Appendable source, ParserRegistry myHomeRegistry, Object obj, Object... args) throws IOException;
 
 	/**
 	 * @param myHomeRegistry | Registry of parsers (might be null)!

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

@@ -1,5 +1,6 @@
 package org.ugp.serialx.converters;
 
+import java.io.IOException;
 import java.util.Collection;
 
 import org.ugp.serialx.LogProvider;
@@ -29,10 +30,11 @@ public interface DataParser
 
 	/**
 	 * This is connected with {@link DataParser#parse(String, Object...)} and {@link DataParser#parseObj(String, Object...)}! And its a way to tell that this parser is not suitable for parsing obtained string and search for optimal one should continue.
+	 * Should not be modified under any circumstances, always treat as immutable!
 	 * 
 	 * @since 1.3.0
 	 */
-	public static final String CONTINUE = new String();
+	public static final Appendable CONTINUE = new StringBuilder();
 
 	/**
 	 * This is DataParser registry. Here your parser implementations should be registered in order to work properly!
@@ -165,18 +167,43 @@ public DataConverter getConverterFor(Object obj, Object... args)
 		 * 
 		 * @since 1.3.5
 		 */
+		@Deprecated
 		public CharSequence toString(Object obj, Object... args)
 		{
-			CharSequence str;
+			try 
+			{
+				return (CharSequence) toString(new StringBuilder(), obj, args);
+			} 
+			catch (IOException e) 
+			{
+				throw new RuntimeException(e);
+			}
+		}
+		
+		/**
+		 * @param source | Source to append the properly stringified object (obj) into. Should be treated as only and only {@link Appendable}, no casting!
+		 * @param obj | Object to convert into string!
+		 * @param args | Additional arguments that will be obtained in {@link DataParser#toString(String, Object...)}!
+		 * 
+		 * @return The source appendable after stringified object (obj) was appropriately appended into it.
+		 * Return {@link DataParser#CONTINUE} to tell that this converter is not suitable for converting this object! You most likely want to do this when obtained obj is not suitable instance!
+		 * 
+		 * @throws IOException When appending into source throws it... 
+		 * 
+		 * @since 1.3.9
+		 */
+		public Appendable toString(Appendable source, Object obj, Object... args) throws IOException
+		{
+			Appendable str;
 			if (convertingCache != null)
 				for (DataParser parser : convertingCache)
-					if (parser != null && (str = ((DataConverter) parser).toString(this, obj, args)) != CONTINUE)
+					if (parser != null && (str = ((DataConverter) parser).toString(source, this, obj, args)) != CONTINUE)
 						return str;
 
 			for (int i = 0, size = size(); i < size; i++) 
 			{
 				DataParser parser = get(i);
-				if (parser instanceof DataConverter && (str = ((DataConverter) parser).toString(this, obj, args)) != CONTINUE)
+				if (parser instanceof DataConverter && (str = ((DataConverter) parser).toString(source, this, obj, args)) != CONTINUE)
 				{
 					if (convertingCache != null && i < convertingCache.length)
 						convertingCache[i] = parser; 

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

@@ -2,6 +2,8 @@
 
 import static org.ugp.serialx.Utils.equalsLowerCase;
 
+import java.io.IOException;
+
 /**
  * This converter is capable of converting "nothing" otherwise known as null and {@link DataParser#VOID}.
  * Its case insensitive!
@@ -49,10 +51,10 @@ public Object parse(ParserRegistry registry, String str, Object... args)
 	}
 
 	@Override
-	public CharSequence toString(ParserRegistry myHomeRegistry, Object obj, Object... args) 
+	public Appendable toString(Appendable source, ParserRegistry myHomeRegistry, Object obj, Object... args) throws IOException 
 	{
 		if (obj == null)
-			return "null";
+			return source.append("null");
 		return CONTINUE;
 	}
 

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

@@ -2,6 +2,8 @@
 
 import static org.ugp.serialx.Utils.contains;
 
+import java.io.IOException;
+
 /**
  * This converter is capable of converting {@link Number} including all common implementations like {@link Double}, {@link Float}, {@link Integer} and others. They are determine by suffixes like in java!
  * Its case insensitive!
@@ -106,22 +108,23 @@ public Object parse(ParserRegistry myHomeRegistry, String arg, Object... args)
 	}
 
 	@Override
-	public CharSequence toString(ParserRegistry myHomeRegistry, Object obj, Object... args) 
+	public Appendable toString(Appendable source, ParserRegistry myHomeRegistry, Object obj, Object... args) throws IOException 
 	{
 		if (obj instanceof Number)
 		{
-			StringBuilder str = new StringBuilder(format((Number) obj));
+			String str;
+			source.append(str = format((Number) obj));
 			if (obj instanceof Double && !contains(str, '.'))
-				str.append('D');
+				source.append('D');
 			else if (obj instanceof Float)
-				str.append('F');
+				source.append('F');
 			else if (obj instanceof Long)
-				str.append('L');
+				source.append('L');
 			else if (obj instanceof Short)
-				str.append('S');
+				source.append('S');
 			else if (obj instanceof Byte)
-				str.append('Y');
-			return str;
+				source.append('Y');
+			return source;
 		}
 		return CONTINUE;
 	}

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

@@ -4,6 +4,7 @@
 import static org.ugp.serialx.Utils.indexOfNotInObj;
 import static org.ugp.serialx.Utils.splitValues;
 
+import java.io.IOException;
 import java.io.Serializable;
 import java.lang.reflect.InvocationTargetException;
 import java.util.ArrayList;
@@ -166,24 +167,25 @@ protected Object parse(ParserRegistry myHomeRegistry, Class<?> objClass, String
 	}
 
 	@Override
-	public CharSequence toString(ParserRegistry myHomeRegistry, Object obj, Object... args)
+	public Appendable toString(Appendable source, ParserRegistry myHomeRegistry, Object obj, Object... args) throws IOException
 	{
-		return toString(myHomeRegistry, obj, null, args);
+		return toString(source, myHomeRegistry, obj, null, args);
 	}
 
 	/**
+	 * @param source | Source to append the properly stringified object (obj) into. Should be treated as only and only {@link Appendable}, no casting!
 	 * @param myHomeRegistry | Registry where this parser is registered provided by {@link ParserRegistry#parse(String, boolean, Class, Object...)} otherwise it demands on implementation (it should not be null)!
 	 * @param obj | Object to convert into string!
 	 * @param preferedProtocol | Protocol to use preferably.
 	 * @param args | Some additional args. This can be anything and it demands on implementation of DataConverter. Default SerialX API implementation will provide some flags about formating (2 ints)!
 	 * 
-	 * @return Object converted to string. Easiest way to do this is obj.toString() but you most likely want some more sofisticated formating.
+	 * @return The source appendable after stringified object (obj) was appropriately appended into it.
 	 * Return {@link DataParser#CONTINUE} to tell that this converter is not suitable for converting this object! You most likely want to do this when obtained obj is not suitable instance!
 	 * 
 	 * @since 1.3.5
 	 */
 	@SuppressWarnings("unchecked")
-	public CharSequence toString(ParserRegistry myHomeRegistry, Object obj, SerializationProtocol<Object> preferedProtocol, Object... args) 
+	public Appendable toString(Appendable source, ParserRegistry myHomeRegistry, Object obj, SerializationProtocol<Object> preferedProtocol, Object... args) 
 	{
 		if (obj == null)
 			return CONTINUE;
@@ -205,42 +207,45 @@ public CharSequence toString(ParserRegistry myHomeRegistry, Object obj, Serializ
 			{
 				Object[] objArgs = preferedProtocol.serialize(obj);
 				final int len = objArgs.length;
+				
+				boolean wrap;
+				if (wrap = index > 0 && len != 0)
+					source.append('{');
 
-				StringBuilder sb = new StringBuilder(ImportsProvider.getAliasFor(args[0], obj.getClass()));
+				source.append(ImportsProvider.getAliasFor(args[0], obj.getClass()));
 				args = args.clone();
 				if (args[5] instanceof Byte && (byte) args[5] != 0) // Format
 				{
-					for (int i = 0, sizeEndl = 10000; i < len; i++) 
+					for (int i = 0; i < len; i++) 
 					{
-						if (sb.length() > sizeEndl)
+						if (i != 0 && i % 1000 == 0)
 						{
-							sb.append('\n'); 
+							source.append('\n'); 
 							for (int j = 0; j < tabs+1; j++) 
-								sb.append('\t');
-							sizeEndl += 10000;
+								source.append('\t');
 						}
 						else 
-							sb.append(' ');
+							source.append(' ');
 
 						if (args.length > 2)
 							args[2] = index + 1; // DO NOT TOUCH
-						sb.append(myHomeRegistry.toString(objArgs[i], args));
+						myHomeRegistry.toString(source, objArgs[i], args);
 					}
 				}
 				else
 				{
 					for (int i = 0; i < len; i++)
 					{
-						sb.append(' ');
+						source.append(' ');
 
 						if (args.length > 2)
 							args[2] = index + 1; // DO NOT TOUCH
-						sb.append(myHomeRegistry.toString(objArgs[i], args));
+						myHomeRegistry.toString(source, objArgs[i], args);
 					}
 				}
 
 				args[4] = oldObjectClass;
-				return index > 0 && len != 0 ? sb.insert(0, '{').append('}') : sb;
+				return wrap ? source.append('}') : source;
 			}
 			catch (Exception e)
 			{

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

@@ -65,7 +65,7 @@ public Object parse(ParserRegistry myHomeRegistry, String arg, Object... args)
 			}
 			catch (Exception e) 
 			{
-				LogProvider.instance.logErr("Looks like there appear some problems with unserializing some object, the instance of java.io.Serializable from string \"" + arg + "\"! This string is most likely corrupted! See error below:", e);
+				LogProvider.instance.logErr("Looks like there were some problems with unserializing some object, the instance of java.io.Serializable from string \"" + arg + "\"! This string is most likely corrupted! See error below:", e);
 				e.printStackTrace();
 				return null;
 			}
@@ -74,16 +74,16 @@ public Object parse(ParserRegistry myHomeRegistry, String arg, Object... args)
 	}
 
 	@Override
-	public CharSequence toString(ParserRegistry myHomeRegistry, Object arg, Object... args) 
+	public Appendable toString(Appendable source, ParserRegistry myHomeRegistry, Object obj, Object... args)
 	{
-		if (arg instanceof Serializable)
+		if (obj instanceof Serializable)
 			try
 			{
-				return "#" + URLEncoder.encode(SerializeClassic((Serializable) arg), "UTF-8").replace('%', '#');
+				return source.append('#').append(URLEncoder.encode(SerializeClassic((Serializable) obj), "UTF-8").replace('%', '#'));
 			}
 			catch (Exception e)
 			{
-				LogProvider.instance.logErr("Looks like there appear some problems with serializing \"" + arg + "\", the instance of java.io.Serializable. This could happen when certain object contains non-transient unserializable objects. Use custom valid protocol for serializing \"" + arg + "\" might solve the problem!", e);
+				LogProvider.instance.logErr("Looks like there were some problems with serializing \"" + obj + "\", the instance of java.io.Serializable. This could happen when certain object contains non-transient unserializable objects. Using custom valid protocol for serializing \"" + obj + "\" might solve the problem!", e);
 				e.printStackTrace();
 				return null;
 			}

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

@@ -3,6 +3,7 @@
 import static org.ugp.serialx.Utils.contains;
 import static org.ugp.serialx.Utils.indexOfNotInObj;
 
+import java.io.IOException;
 import java.util.Map;
 
 import org.ugp.serialx.Registry;
@@ -48,7 +49,7 @@ public class StringConverter implements DataConverter
 	protected Map<String, String> parsingCache;
 
 	@Override
-	public String parse(ParserRegistry myHomeRegistry, String str, Object... args) 
+	public Object parse(ParserRegistry myHomeRegistry, String str, Object... args) 
 	{	
 		String result;
 		int len;
@@ -67,24 +68,24 @@ public String parse(ParserRegistry myHomeRegistry, String str, Object... args)
 	}
 
 	@Override
-	public CharSequence toString(ParserRegistry myHomeRegistry, Object arg, Object... args) 
+	public Appendable toString(Appendable source, ParserRegistry myHomeRegistry, Object obj, Object... args) throws IOException 
 	{
-		if (arg instanceof String)
+		if (obj instanceof String)
 		{
-			String str = arg.toString();
+			String str = (String) obj;
 			if (str.startsWith("${") && str.endsWith("}"))
 			{
 				str = str.substring(2, str.length()-1);
 				if (str.contains("::") && indexOfNotInObj(str, ' ') > -1)
-					str = "{"+str+"}";
-				return str;
+					return source.append('{').append(str).append('}');
+				return source.append(str);
 			}
 
 			if (serializeStringNormally)
 			{
 				if (contains(str, '\"', '\n', '\r'))
 					return CONTINUE;
-				return "\""+str+"\"";
+				return source.append('"').append(str).append('"');
 			}
 		}
 		return CONTINUE;