[gxml] StreamReader: simplified API for read()

[Daniel Espinosa Ortiz <despinosa src gnome org>]

commit 9ff5aa80ec6aac72265ad271bc75af16131fb8fd
Author: Daniel Espinosa <esodan gmail com>
Date:   Sun May 31 10:41:58 2020 -0500

    StreamReader: simplified API for read()

 gxml/StreamReader.vala | 50 ++++++++++++++++++++++++++++++++++----------------
 1 file changed, 34 insertions(+), 16 deletions(-)
---
diff --git a/gxml/StreamReader.vala b/gxml/StreamReader.vala
index 4a85eee..b971ecc 100644
--- a/gxml/StreamReader.vala
+++ b/gxml/StreamReader.vala
@@ -65,13 +65,46 @@ public class GXml.StreamReader : GLib.Object {
    */
   public DomDocument document { get { return _document; } }
   /**
-   * Create a new {@link StreamReader} object.
+   * Creates a new {@link StreamReader} object.
    */
   public StreamReader (InputStream istream) {
     _stream = new DataInputStream (istream);
     buf[0] = '\0';
     buf[1] = '\0';
   }
+  /**
+   * Creates a new {@link StreamReader} object and
+   * initialize {@link document} with given document
+   */
+  public StreamReader.for_document (InputStream istream, DomDocument document) {
+    _stream = new DataInputStream (istream);
+    buf[0] = '\0';
+    buf[1] = '\0';
+    _document = document;
+  }
+  /**
+   * Reads the content of a stream to {@link document}.
+   *
+   * If {@link document} was not set, treates a new {@link DomDocument}
+   *
+   * Returns: {@link document}'s value
+   */
+  public DomDocument read () throws GLib.Error {
+    if (_document == null) {
+        _document = new Document ();
+    }
+
+    internal_read ();
+    return _document;
+  }
+  /**
+   * Use a {@link DomDocument} to initialize {@link document}
+   * and parse its contents to
+   */
+  public void read_document (DomDocument doc) throws GLib.Error {
+    _document = doc;
+    internal_read ();
+  }
   private inline uint8 read_byte () throws GLib.Error {
     buf[0] = stream.read_byte (cancellable);
     return buf[0];
@@ -86,21 +119,6 @@ public class GXml.StreamReader : GLib.Object {
   private inline uint8 cur_byte () {
     return buf[0];
   }
-  /**
-   * Creates a new {@link DomDocument} and parse the stream to.
-   */
-  public DomDocument read () throws GLib.Error {
-    _document = new Document ();
-    internal_read ();
-    return document;
-  }
-  /**
-   * Use a {@link DomElement} to initialize {@link document}
-   */
-  public void read_document (DomDocument doc) throws GLib.Error {
-    _document = doc;
-    internal_read ();
-  }
   private void internal_read () throws GLib.Error {
     read_byte ();
     if (cur_char () != '<') {