NAME

XML::XMetaL::Factory - XMetaL factory class

SYNOPSIS

use XML::XMetaL::Factory;
my $factory = XML::XMetaL::Factory->new();
my $xml_doc_1 = '...';# A serialized XML document
my $xml_doc_2 = 'd:\documents\xml\my_doc.xml';# Path to XML file
my $xmetal = $factory->create_xmetal($xml_doc_1, $xml_doc_2);

DESCRIPTION

XML::XMetaL::Factory is a factory class for creating XMetaL instances.

XML::XMetaL::Factory creates XMetaL instances, ensures that processing does not continue until initialization is complete, and provides XMetaL with a basic lean-up routine that will be implemented automatically when XMetaL is closed.

XML::XMetaL::Factory is meant for use by external scripts that need to instantiate an XMetaL application object. The most obvious use is by test scripts.

Using XML::XMetaL::Factory it is possible to write unit and function tests for XMetaL customization packages. This is important for more reasons than good programming style. Coupled with the capability to do object oriented development, it becomes possible to develop XMetaL applications using agile development methodologies such as Extreme Programming. You can find out more about Extreme Programming at http://www.xprogramming.com.

Public methods

Constructor and initialization

my $factory = XML::XMetaL::Factory->new()

The constructor takes no arguments. It returns a factory object that can be used to create XMetaL application objects.

create_xmetal

my $xmetal_application = $factory->create_xmetal(@document_list);

The create_xmetal method takes a list of scalar variables as arguments. An element in the list must either contain an XML document as a string, or a file path.

There is currently no support for filehandles, URLs, filepaths, or DOM document objects of any kind.

The create_xmetal method returns an XMetaL Application object.

Private Methods

None you want to mess with. The implementation is likely to change in future versions.

ENVIRONMENT

The Corel XMetaL XML editor must be installed.

BUGS

Currently, the XMetaL application object is created when the factory object is created. The create_xmetal method merely opens documents and returns the already existing application object.

Please send bug reports to <henrik.martensson@bostream.nu>.

SEE ALSO

See XML::XMetaL.

AUTHOR

Henrik Martensson, <henrik.martensson@bostream.nu<gt>

COPYRIGHT AND LICENSE

Copyright 2003 by Henrik Martensson

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.