File: myXTree/README

NAME:

    myXTree - interface to a SQL-tree.

VERSION: 1.0 beta2


AUTHORS:
    
    Tereshchenko Andrey <tereshchenko@anter.com.ua>

    
INTRODUCTION: 

    This class allows to save the DOM-document in a SQL-tree and back. For a
    choice of the data from a SQL-tree are used XPath expressions. Data reading
    of a SQL-tree can be carried out by two ways: by one SQL-query and
    recursive way. 
    
REQUIREMENTS:
 
    The myXTree class use object PEAR::DB and object Document from package
    myDOM, which goes into package myXML (http://phpmyxml.sourceforge.net/). 


DESCRIPTION:

    Attached to realization of this class used a database mySQL and object
    PEAR::DB, but this, to regretting does not do a class lightly bearable
    on other databases, because in class are used the specialized features
    mySQL. Because supposed, in the main, use of this class for little renewed
    data, then was select a tables type MyISAM (unsupported transaction). 
    
    A class does not support full features of XPath language:
    - does not support an objects selection on namespace prefix;
    - in base saved only the elements, text and attributes;
    - principled is impossible use of operator '¦' (union) in selfjoin method;
    - do not work such functions as position() and last() because mySQL does not
      support subqueries;
    - the rest of functions I while does not necessary to implementation.
    
    Minimum explanations on functions work brought immediately in code.
    Detailed explanations will be on claiming measure. On all of questions
    write on terechenko@anter.com.ua.
    
    NOTE: A class primordially wrote for little renewed data and in such
    applications as forum not tested. Attached to addition of data in tree uses
    a tables locking and as this to reverberate at work in multiuser routine I
    do not know.

COPYRIGHT:
    Copyright (c) 2002-2003 Tereshchenko Andrey. All rights reserved.
    This software is released under the GNU Lesser General Public License.
    Please read the disclaimer at the top of the myXTree.php file.