XML Interface using MS XMLDOM
Description

The Microsoft XML Document Object Model (DOM) as provided with Internet Explorer 5.0 is a set of interfaces and objects designed for managing XML documents.  This library provides a framework in VS/VSE to use the MS XMLDOM through its COM interfaces.

Files

T4XMLDOM.sll 
T4XMLDOM.sml		 MS XMLDOM interface library.
Requires VOLEA31W, VOLEB31W.
TCT4XMLDOM.sll 
TCT4XMLDOM.sml		 XMLDOM interface test framework. 
Requires T4XMLDOM, SUNIT.
vsrvw.ini VS/VSE Service Manager install tags. Append to existing vsrvw.ini file.
ReadMe.txt Notes on use and requirements.

Requirements

VS/VSE 3.1.3 for Win32 and Microsoft XMLDOM 1.0 distributed with Internet Explorer 5.0.  Requires the following additional libraries:
 
Vreg31w.sll,
VREG3DW.sll		 Registration Database Support
VOLDB31W.sll OLE COM Development
VOLEA3DW.sll,
volea31w.sll		 OLE Automation Support 

Installation

Unzip the archive to a subdirectory of your VS/VSE installation or to a new directory.  From the Visual Smalltalk menu bar select File-Install and select T4XMLDOM.sll.  Loading this library will automatically bind the OLE automation and basic COM support libraries.

A framework to test the interface classes based on Kent Beck's SUNIT testing framework is available in the form of TCT4XMLDOM.sll. It requires as a prerequisite the sunit.sll library from the Testing Framework goodie to be installed.  Once TCT4XMLDOM.sll is installed evaluate TestRunner new open to open the test console.

Alternately, one can install the libraries in a VS/VSE development image using the Service Manager.  Append the contents of the vsrvw.ini file that accompanies this package with the vsrvw.ini file in your VS/VSE development directory.  Or, to include SUNIT as a requirement for the XMLDOM Test Library, append the text below to the vsrvw.ini file  in the Service Manager.

[XMLDOM Library]
description=Interfaces to Microsoft's XMLDOM (Requires IE5.0)
category=Class Libraries
libraryNames=t4xmldom
requiredServices=OLE Automation Support
mapCategory=bas
postInstallExpression=T4XMLDOMDocument initializeAndDisplayExample

[XMLDOM Test Library]
description=Test Cases for XMLDOM Library
category=Class Libraries
libraryNames=tct4xmldom
requiredServices=XMLDOM Library, SUNIT Test Framework
mapCategory=bas

[SUNIT Test Framework]
description=Kent Beck's SUNIT Test Framework
category=Class Libraries
libraryNames=sunit
mapCategory=bas

Examples

The class method #example of  T4XMLDOMDocument in the XMLDOM interface library, T4XMLDOM.sll, composes a sample XML document using element, text, and comment objects created from the XMLDOM IXMLDOMElement, IXMLDOMText, and IXMLDOMComment interfaces.  To read the document composed as an XML string evaluate:

    |aT4XMLDOMDocument|
  aT4XMLDOMDocument := T4XMLDOMDocument example.
  aT4XMLDOMDocument getXML inspect.
  aT4XMLDOMDocument free.

The TCT4XMLDOM library exercises the methods of each XMLDOM interface.  Look to the methods of each class in this library for example assertions that use each method.

Additional info

The file ReadMe.txt provides additional details regarding installation and use of the XMLDOM interface.

See also the DOM World Wide Web Consortium (W3C) recommendation page for general information, the Microsoft XMLDOM interface page for specifications of its COM interfaces, and the MS XMLDOM user guide.

Contact

tec4 systems inc.
"The right tools to manage your commercial insurance lines."
#1-215A 10th Street NW
Calgary, Alberta
Canada T2N 1V5
(403) 283-8876
www.tec4.ca

Ivar Maeland
ivar@tec4.ca

Links to:
The ObjectShare web site
VisualSmalltalk Product Support
ObjectShare's Online Documentation Site