<?php

/**
 * @file XMLDAO.inc.php
 *
 * Copyright (c) 2000-2008 John Willinsky
 * Distributed under the GNU GPL v2. For full terms see the file docs/COPYING.
 *
 * @package db
 * @class XMLDAO
 *
 * XML Data Access Object base class.
 * Operations for retrieving and modifying objects from an XML data source.
 *
 * $Id: XMLDAO.inc.php,v 1.5 2008/04/04 17:06:45 asmecher Exp $
 */

import('xml.XMLParser');

class XMLDAO {
	/**
	 * Constructor.
	 */
	function XMLDAO() {
	}

	/**
	 * Parse an XML file and return data in an object.
	 * @see xml.XMLParser::parse()
	 */
	function &parse($file) {
		$parser = &new XMLParser();
		$data = &$parser->parse($file);
		$parser->destroy();
		return $data;
	}

	/**
	 * Parse an XML file with the specified handler and return data in an object.
	 * @see xml.XMLParser::parse()
	 * @param $handler reference to the handler to use with the parser.
	 */
	function &parseWithHandler($file, &$handler) {
		$parser = &new XMLParser();
		$parser->setHandler($handler);
		$data = &$parser->parse($file);
		$parser->destroy();
		return $data;
	}

	/**
	 * Parse an XML file and return data in an array.
	 * @see xml.XMLParser::parseStruct()
	 */
	function &parseStruct($file, $tagsToMatch = array()) {
		$parser = &new XMLParser();
		$data = &$parser->parseStruct($file, $tagsToMatch);
		$parser->destroy();
		return $data;
	}
}

?>