+
+ | Object (fromObj) type |
+ Obtained serializer content (return) |
+
+
+ | {@link CharSequence} |
+ {@link Serializer#LoadFrom(CharSequence)} |
+
+
+ | {@link CharSequence} (as http address) |
+ Serializer (newInstance) will open connection with url and get + deserialize the content from it if possible! |
+
+
+ | {@link File} |
+ {@link Serializer#LoadFrom(File)} |
+
+
+ | {@link Reader} |
+ {@link Serializer#LoadFrom(Reader)} |
+
+
+ | {@link InputStream} |
+ {@link Serializer#LoadFrom(InputStream)} |
+
+
+ | {@link URL} |
+ Serializer (newInstance) will open connection with {@link URL} and get + deserialize the content from it if possible! |
+
+
+ | {@link URLConnection} |
+ Serializer (newInstance) will attempt to get + deserialize the content from given {@link URLConnection} if possible! |
+
+
+ | Others (default) |
+ {@link Scope#from(Object, String...)} (return description) |
+
+
+ *
+ * @throws Exception if calling of some {@link PropertyDescriptor}s write method fails (should not happen often) or when something went very wrong during deserialization!
+ * @throws IntrospectionException when there were no PropertyDescriptor found for obj class!
+ * @throws RuntimeException in case of something went wrong during deserialization process and {@link LogProvider#isReThrowException()} is set to true!
+ *
+ * @since 1.3.5
+ */
+ public static Serializer from(Serializer newInstance, Object fromObj, String... fieldNamesToUse) throws Exception, IntrospectionException
+ {
+ if (fromObj instanceof CharSequence)
+ {
+ try
+ {
+ String fromStr;
+ if (indexOfNotInObj(fromStr = fromObj.toString(), "http") == 0)
+ return newInstance.LoadFrom(new URL(fromStr).openStream());
+ return newInstance.LoadFrom(new File(fromStr));
+ }
+ catch (Exception e)
+ {
+ if (e instanceof RuntimeException)
+ throw e;
+ }
+
+ return newInstance.LoadFrom((CharSequence) fromObj);
+ }
+
+ if (fromObj instanceof File)
+ return newInstance.LoadFrom((File) fromObj);
+ if (fromObj instanceof Reader)
+ return newInstance.LoadFrom((Reader) fromObj);
+ if (fromObj instanceof InputStream)
+ return newInstance.LoadFrom((InputStream) fromObj);
+ if (fromObj instanceof URL)
+ return newInstance.LoadFrom(((URL) fromObj).openStream());
+ if (fromObj instanceof URLConnection)
+ return newInstance.LoadFrom(((URLConnection) fromObj).getInputStream());
+
+ newInstance.addAll(Scope.from(fromObj, fieldNamesToUse));
+ return newInstance;
+ }
+}
\ No newline at end of file
diff --git a/SerialX-core/src/main/java/org/ugp/serialx/Utils.java b/SerialX-core/src/main/java/org/ugp/serialx/Utils.java
new file mode 100644
index 0000000..51c40eb
--- /dev/null
+++ b/SerialX-core/src/main/java/org/ugp/serialx/Utils.java
@@ -0,0 +1,912 @@
+package org.ugp.serialx;
+
+import static org.ugp.serialx.converters.DataParser.VOID;
+
+import java.io.BufferedReader;
+import java.io.File;
+import java.io.FileReader;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.InputStreamReader;
+import java.io.Reader;
+import java.lang.reflect.Array;
+import java.lang.reflect.Constructor;
+import java.lang.reflect.InvocationTargetException;
+import java.lang.reflect.Method;
+import java.net.HttpURLConnection;
+import java.net.URLEncoder;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+import java.util.Map;
+
+import org.ugp.serialx.converters.DataConverter;
+import org.ugp.serialx.converters.DataParser;
+import org.ugp.serialx.converters.DataParser.ParserRegistry;
+import org.ugp.serialx.protocols.SerializationProtocol;
+
+/**
+ * Provides general utility used across SerialX library, mostly string analysis/manipulation and reflection.
+ *
+ * @author PETO
+ *
+ * @since 1.3.7
+ */
+public final class Utils {
+ private Utils() {}
+
+ /**
+ * @param f | Source file.
+ *
+ * @return All lines from source file as string.
+ * @throws IOException
+ *
+ * @since 1.1.5
+ */
+ public static String LoadFileToString(File f) throws IOException
+ {
+ return LoadFileToString(f, 1);
+ }
+
+ /**
+ * @param f | Source file.
+ * @param endlMode | 0 = no line brakes, 1 = always line brakes, 2 = line break only when contains with "//"!