GoDiagram Win Reference
GoXmlReader Class
Members  Example 

Read customizable XML, using class-specific IGoXmlTransformers, using an XmlDocument or just an XmlReader.
Syntax
'Declaration
 
Public Class GoXmlReader 
   Inherits GoXmlReaderWriterBase
public class GoXmlReader : GoXmlReaderWriterBase 
Remarks

Depending on which overload of Consume is called, you can either traverse an XmlDocument that you supply, you can load an XmlDocument from a Stream (if UseDOM is true), or you can just handle the elements as they are read in by an XmlReader from a Stream (if UseDOM is false). The processing of XML elements is basically done in a single pass, but there is built-in functionality for a second pass to fix up references in the objects that were constructed.

You must provide type-specific customizations by supplying instances of IGoXmlTransformer. Each transformer is associated with a Type (IGoXmlTransformer.TransformerType) and an ElementName string (IGoXmlTransformer.ElementName).

By default there are no transformers registered for this reader, so this reader is unable to actually do anything with the XML elements it sees. You will need to call GoXmlReaderWriterBase.AddTransformer for each class of object for which you want to consume XML. These calls to GoXmlReaderWriterBase.AddTransformer are sometimes done in an override of GoXmlReaderWriterBase.RegisterTransformers, but you probably do not need to define a class inheriting from GoXmlReader.

ConsumeRootBody does the bulk of the work to traverse the elements in the XmlDocument root, or (if UseDOM is false) just to read elements from the XmlReader. As this reader processes each element, it calls ConsumeObject. ConsumeObject calls InvokeAllocate to actually allocate an object, and if an object is allocated, calls InvokeConsumeAttributesInvokeConsumeBody, and InvokeConsumeObjectFinish to actually reconstruct the rest of the object.

Although most of the information that needs to be reconstructed will be held in attributes of the element representing an object, there will sometimes be references to other objects. If you can be sure that the references will be to objects that have already been read, you can call MakeShared to remember an object by a key string, and you can call FindShared to recover that object by using the same key.

However, if the reference is to something that might not yet have been read and constructed, you can make use of the delayed-references mechanism that this reader offers. You can just call AddDelayedRef to remember the referring object, the property or other identifying string of the reference in this referring object, and the reference string to the referred-to object. This reference string is the same as the key used to identify shared objects.

Then the ProcessDelayedObjects method, called as a "second pass" after all of the elements in the XML root have been read, iterates over all of those delayed references, calls FindShared to resolve the reference, and then calls InvokeUpdateReference so that the transformer gets a chance to fix up the reference.

The various Invoke... methods do the actual lookup for a transformer and invoke the respective method on the first transformer found.

Example
This reader could be used as follows: See the description of GoXmlTransformer for example transformer definitions.
public void LoadSimpleXml(String path) {
  myView.Document.Clear();  // assume we're replacing current document contents
  
  GoXmlReader xr = new GoXmlReader();
  // tell the reader how to handle two kinds of elements
  xr.AddTransformer(new SimpleXmlTransformBasicNode());
  xr.AddTransformer(new SimpleXmlTransformLink());
  xr.RootObject = myView.Document;
            
  using (StreamReader sr = new StreamReader(path)) {
    xr.Consume(sr);
  }
}
Inheritance Hierarchy

System.Object
   Northwoods.Go.Xml.GoXmlReaderWriterBase
      Northwoods.Go.Xml.GoXmlReader

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

GoXmlReader Members
Northwoods.Go.Xml Namespace

 

 


© 2015. Northwoods Software Corporation. All Rights Reserved.

Send Feedback