3
* $Id: Interface.php 4706 2008-07-23 21:21:13Z guilhermeblanco $
5
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
6
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
7
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
8
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
9
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
10
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
11
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
12
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
13
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
14
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
15
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
17
* This software consists of voluntary contributions made by many individuals
18
* and is licensed under the LGPL. For more information, see
19
* <http://www.phpdoctrine.org>.
23
* Doctrine_Tree_Interface
27
* @license http://www.opensource.org/licenses/lgpl-license.php LGPL
28
* @link www.phpdoctrine.org
30
* @version $Revision: 4706 $
31
* @author Joe Simms <joe.simms@websites4.com>
33
interface Doctrine_Tree_Interface {
36
* creates root node from given record or from a new record
38
* @param object $record instance of Doctrine_Record
40
public function createRoot(Doctrine_Record $record = null);
45
* @return object $record instance of Doctrine_Record
47
public function findRoot($root_id = 1);
50
* optimised method to returns iterator for traversal of the entire tree from root
52
* @param array $options options
53
* @param integer $fetchmode One of the Doctrine::HYDRATE_* constants.
54
* @return object $iterator instance of Doctrine_Node_<Implementation>_PreOrderIterator
56
public function fetchTree($options = array(), $hydrationMode = null);
59
* optimised method that returns iterator for traversal of the tree from the given record primary key
61
* @param mixed $pk primary key as used by table::find() to locate node to traverse tree from
62
* @param array $options options
63
* @param integer $fetchmode One of the Doctrine::HYDRATE_* constants.
64
* @return iterator instance of Doctrine_Node_<Implementation>_PreOrderIterator
66
public function fetchBranch($pk, $options = array(), $hydrationMode = null);
b'\\ No newline at end of file'