acs::SiteNodesCache method get_children (public)

 <instance of acs::SiteNodesCache> get_children -node_id node_id  \
    [ -all ] [ -package_type package_type ] \
    [ -package_key package_key ] [ -filters filters ] \
    [ -element element ]

Defined in packages/acs-tcl/tcl/site-nodes-procs.tcl

Cache get_children operations, except, when "-all" was specified. The underlying operation can be quite expensive, when huge site-node trees are explored. Since the argument list influences the results, we cache for every parameter combination. Since this cache contains subtrees, we have to flush trees, which is implemented via pattern flushes. So we use a separate cache to avoid long locks on site-nodes in general.

Switches:

-node_id (required, integer)

-all (optional)

-package_type (optional)

-package_key (optional)

-filters (optional)

-element (optional)

Testcases:

No testcase defined.

Source code:

if {$all} {
    #
    # Don't cache when $all is specified - seldom
    # used, a pain for invalidating.
    #
    next
} else {
    ::acs::site_nodes_children_cache eval -partition_key $node_id  get_children-$node_id-$all-$package_type-$package_key-$filters-$element {
            next
        }
}

Generic XQL file:

packages/acs-tcl/tcl/site-nodes-procs.xql

PostgreSQL XQL file:

packages/acs-tcl/tcl/site-nodes-procs-postgresql.xql

Oracle XQL file:

packages/acs-tcl/tcl/site-nodes-procs-oracle.xql