TXMLToRODL

Overview

The TXMLToRODL class is a specialization of the TRODLReader class for decoding

streamed RODL data in the XML format into a TRODLLibrary instance. You may use it to load

RODL files, resources, etc.

Use case

Take a look at this excerpt from the 'uRODL.pas' file:

function ReadRODLFromFile(aReaderClass: TRODLReaderClass; const aFileName: string): TRODLLibrary;
begin
  

with aReaderClass.Create do try
    result := ReadFromFile(aFileName);
  finally
    Free;
  end;
end;

It

may be used as

//...
var
  lib: TRODLLibrary;
begin
  lib :=  ReadRODLFromFile(TXMLToRODL, 

'...');
//...

Location


Instance Methods

constructor Create  virtual    (declared in TRODLReader)

Creates a new instance.

constructor Create

constructor Create (TRODLLibrary, Boolean)  reintroduce overload

Implements a TRODLReader abstract method by loading aStream into an existing (iAddToExisting<>Nil when Create) or a new TRODLLibrary instance.

constructor Create(aAddToExisting: TRODLLibrary; aRecreateGuids: Boolean)

Parameters:

  • aAddToExisting: Source data
  • aRecreateGuids: RODL's name to resolve using chains

IntReadFromStream  protected override

Implements a TRODLReader abstract method by loading aStream into an existing (iAddToExisting<>Nil when Create) or a new TRODLLibrary instance.

function IntReadFromStream(Source: TStream; aFilename: string): TRODLLibrary

Parameters:

  • Source: Source data
  • aFilename: RODL's name to resolve using chains

LoadFileToLibrary

Implements a TRODLReader abstract method by loading aStream into an existing (iAddToExisting<>Nil when Create) or a new TRODLLibrary instance.

procedure LoadFileToLibrary(aFilename: string; aLibrary: TRODLLibrary; aRodlUse: TRODLUse)

Parameters:

  • aFilename: Name of the source file
  • aLibrary: Target instance to load data
  • aRodlUse: Represents a reference to an existing RODL file

Read    (declared in TRODLReader)

function Read(Source: TStream; const aFilename: string): TRODLLibrary

Parameters:

  • Source:
  • aFilename:

ReadFromFile    (declared in TRODLReader)

function ReadFromFile(const aFileName: string): TRODLLibrary

Parameters:

  • aFileName:

ReadFromString (ROUTF8String, string): TRODLLibrary  overload

Loads XML data from the aString in-memory data and returns a new TRODLLibrary instance.

function ReadFromString(const anUTF8String: ROUTF8String; const aFilename: string): TRODLLibrary

Parameters:

  • anUTF8String: XML data
  • aFilename: RODL's name to resolve using chains