JTableNested: Difference between revisions
From Joomla! Documentation
Bulk upload by Doxiki2 |
m preparing for archive only |
||
| (7 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
=={{JVer|11.1}} JTableNested== | |||
===Description=== | |||
JTableNested is a table class which supports modified pre-order [[wikipedia:tree traversal|tree traversal]] behaviour. This class is derived from the base JTable class and adds methods to support a binary tree structure in the database, with pre-order being the preferred method of traversal. | |||
{{ | |||
=== | |||
[[ | |||
===Methods=== | ===Methods=== | ||
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
|- | |- | ||
!Visibility | |||
!Method name | !Method name | ||
!Description | !Description | ||
|- | |- | ||
|[[JTableNested::check | |public | ||
|[[API17:JTableNested::check|check]] | |||
|Asset that the nested set data is valid. | |Asset that the nested set data is valid. | ||
|- | |- | ||
|[[JTableNested::debug | |public | ||
|[[API17:JTableNested::debug|debug]] | |||
|Sets the debug level on or off. | |Sets the debug level on or off. | ||
|- | |- | ||
|[[JTableNested::delete | |public | ||
|[[API17:JTableNested::delete|delete]] | |||
|Method to delete a node, and optionally its child nodes, from the table. | |Method to delete a node, and optionally its child nodes, from the table. | ||
|- | |- | ||
|[[JTableNested::getPath | |public | ||
|[[API17:JTableNested::getPath|getPath]] | |||
|Method to get an array of nodes from a given node to its root. | |Method to get an array of nodes from a given node to its root. | ||
|- | |- | ||
|[[JTableNested::getRootId | |public | ||
|[[API17:JTableNested::getRootId|getRootId]] | |||
|Gets the ID of the root item in the tree. | |Gets the ID of the root item in the tree. | ||
|- | |- | ||
|[[JTableNested::getTree | |public | ||
|[[API17:JTableNested::getTree|getTree]] | |||
|Method to get a node and all its child nodes. | |Method to get a node and all its child nodes. | ||
|- | |- | ||
|[[JTableNested::isLeaf | |public | ||
|[[API17:JTableNested::isLeaf|isLeaf]] | |||
|Method to determine if a node is a leaf node in the tree (has no children). | |Method to determine if a node is a leaf node in the tree (has no children). | ||
|- | |- | ||
|[[JTableNested::move | |public | ||
|[[API17:JTableNested::move|move]] | |||
|Method to move a row in the ordering sequence of a group of rows defined by an SQL WHERE clause. | |Method to move a row in the ordering sequence of a group of rows defined by an SQL WHERE clause. | ||
|- | |- | ||
|[[JTableNested::moveByReference | |public | ||
|[[API17:JTableNested::moveByReference|moveByReference]] | |||
|Method to move a node and its children to a new location in the tree. | |Method to move a node and its children to a new location in the tree. | ||
|- | |- | ||
|[[JTableNested::orderDown | |public | ||
|[[API17:JTableNested::orderDown|orderDown]] | |||
|Method to move a node one position to the right in the same level. | |Method to move a node one position to the right in the same level. | ||
|- | |- | ||
|[[JTableNested::orderUp | |public | ||
|[[API17:JTableNested::orderUp|orderUp]] | |||
|Method to move a node one position to the left in the same level. | |Method to move a node one position to the left in the same level. | ||
|- | |- | ||
|[[JTableNested::publish | |public | ||
|[[API17:JTableNested::publish|publish]] | |||
|Method to set the publishing state for a node or list of nodes in the database table. | |Method to set the publishing state for a node or list of nodes in the database table. | ||
|- | |- | ||
|[[JTableNested::rebuild | |public | ||
|[[API17:JTableNested::rebuild|rebuild]] | |||
|Method to recursively rebuild the whole nested set tree. | |Method to recursively rebuild the whole nested set tree. | ||
|- | |- | ||
|[[JTableNested::rebuildPath | |public | ||
|[[API17:JTableNested::rebuildPath|rebuildPath]] | |||
|Method to rebuild the node's path field from the alias values of the nodes from the current node to the root node of the tree. | |Method to rebuild the node's path field from the alias values of the nodes from the current node to the root node of the tree. | ||
|- | |- | ||
|[[JTableNested::saveorder | |public | ||
|[[API17:JTableNested::saveorder|saveorder]] | |||
|Method to update order of table rows. | |Method to update order of table rows. | ||
|- | |- | ||
|[[JTableNested::setLocation | |public | ||
|[[API17:JTableNested::setLocation|setLocation]] | |||
|Method to set the location of a node in the tree object. | |Method to set the location of a node in the tree object. | ||
|- | |- | ||
|[[JTableNested::store | |public | ||
|[[API17:JTableNested::store|store]] | |||
|Method to store a node in the database table. | |Method to store a node in the database table. | ||
|- | |- | ||
|[[JTableNested::_getNode | |protected | ||
|[[API17:JTableNested::_getNode|_getNode]] | |||
|Method to get nested set properties for a node in the tree. | |Method to get nested set properties for a node in the tree. | ||
|- | |- | ||
|[[JTableNested::_getTreeRepositionData | |protected | ||
|[[API17:JTableNested::_getTreeRepositionData|_getTreeRepositionData]] | |||
|Method to get various data necessary to make room in the tree at a location for a node and its children. | |Method to get various data necessary to make room in the tree at a location for a node and its children. | ||
|- | |- | ||
|[[JTableNested::_logtable | |protected | ||
|[[API17:JTableNested::_logtable|_logtable]] | |||
| | | | ||
|- | |- | ||
|[[JTableNested::_runQuery | |protected | ||
|[[API17:JTableNested::_runQuery|_runQuery]] | |||
| | | | ||
|- | |- | ||
|} | |} | ||
* '''Defined in''' libraries/joomla/database/tablenested.php | |||
* '''Extends''' [[API17:JTable|JTable]] | |||
* '''Extended by''' | |||
** [[API17:JTableAsset|JTableAsset]] | |||
** [[API17:JTableCategory|JTableCategory]] | |||
** [[API17:JTableMenu|JTableMenu]] | |||
===Importing=== | ===Importing=== | ||
<source lang="php">jimport( 'joomla.database.tablenested' );</source> | <source lang="php">jimport( 'joomla.database.tablenested' );</source> | ||
===See also=== | ===See also=== | ||
* [[ | * {{JVer|11.1}} '''JTableNested source code''' on [[jplatform:database/tablenested.php|BitBucket]] | ||
{{ | * {{JVer|11.1}} Subpackage [[API17:Subpackage Database|Database]] | ||
* [[API17:JTableNested|Other versions of JTableNested]] | |||
===Examples=== | ===User contributed notes=== | ||
=== Code Examples === | |||
<dpl> | <dpl> | ||
noresultsheader=\n | noresultsheader=\n | ||
category=JTableNested | category=JTableNested | ||
namespace=CodeExample | |||
category=ClassExample | category=ClassExample | ||
include=* | include=* | ||
namespace=CodeExample | |||
format= ,,, | format= ,,, | ||
</dpl> | </dpl> | ||
<noinclude> | <noinclude>[[Category:Platform 11.1]][[Category:Archived pages API17]]</noinclude> | ||
Latest revision as of 03:49, 25 March 2017
JTableNested
Description
JTableNested is a table class which supports modified pre-order tree traversal behaviour. This class is derived from the base JTable class and adds methods to support a binary tree structure in the database, with pre-order being the preferred method of traversal.
Methods
| Visibility | Method name | Description |
|---|---|---|
| public | check | Asset that the nested set data is valid. |
| public | debug | Sets the debug level on or off. |
| public | delete | Method to delete a node, and optionally its child nodes, from the table. |
| public | getPath | Method to get an array of nodes from a given node to its root. |
| public | getRootId | Gets the ID of the root item in the tree. |
| public | getTree | Method to get a node and all its child nodes. |
| public | isLeaf | Method to determine if a node is a leaf node in the tree (has no children). |
| public | move | Method to move a row in the ordering sequence of a group of rows defined by an SQL WHERE clause. |
| public | moveByReference | Method to move a node and its children to a new location in the tree. |
| public | orderDown | Method to move a node one position to the right in the same level. |
| public | orderUp | Method to move a node one position to the left in the same level. |
| public | publish | Method to set the publishing state for a node or list of nodes in the database table. |
| public | rebuild | Method to recursively rebuild the whole nested set tree. |
| public | rebuildPath | Method to rebuild the node's path field from the alias values of the nodes from the current node to the root node of the tree. |
| public | saveorder | Method to update order of table rows. |
| public | setLocation | Method to set the location of a node in the tree object. |
| public | store | Method to store a node in the database table. |
| protected | _getNode | Method to get nested set properties for a node in the tree. |
| protected | _getTreeRepositionData | Method to get various data necessary to make room in the tree at a location for a node and its children. |
| protected | _logtable | |
| protected | _runQuery |
- Defined in libraries/joomla/database/tablenested.php
- Extends JTable
- Extended by
Importing
jimport( 'joomla.database.tablenested' );
See also
JTableNested source code on BitBucket
Subpackage Database- Other versions of JTableNested
User contributed notes
Code Examples