/home/mjc1/public_html/phpMyAdmin/libraries/navigation/NodeFactory.class.php


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
<?php
/* vim: set expandtab sw=4 ts=4 sts=4: */
/**
 * This class is responsible for creating Node objects
 *
 * @package PhpMyAdmin-navigation
 */
if (! defined('PHPMYADMIN')) {
    exit;
}

require_once 
'libraries/navigation/Nodes/Node.class.php';

/**
 * Node factory - instanciates Node objects or objects derived from the Node class
 *
 * @package PhpMyAdmin-Navigation
 */
class PMA_NodeFactory
{
    
/**
     * @var string $_path A template for generating paths to files
     *                    that contain various Node classes
     * @access private
     */
    
private static $_path 'libraries/navigation/Nodes/%s.class.php';
    
/**
     * Sanitizes the name of a Node class
     *
     * @param string $class The class name to be sanitized
     *
     * @return string
     */
    
private static function _sanitizeClass($class)
    {
        if (
$class !== 'Node' && ! preg_match('@^Node_\w+(_\w+)?$@'$class)) {
            
$class 'Node';
            
trigger_error(
                
sprintf(
                    
/* l10n: The word "Node" must not be translated here */
                    
__('Invalid class name "%1$s", using default of "Node"'),
                    
$class
                
),
                
E_USER_ERROR
            
);
        }
        return 
self::_checkFile($class);
    }
    
/**
     * Checks if a file exists for a given class name
     * Will return the default class name back if the
     * file for some subclass is not available
     *
     * @param string $class The class name to check
     *
     * @return string
     */
    
private static function _checkFile($class)
    {
        
$path sprintf(self::$_path$class);
        if (! 
is_readable($path)) {
            
$class 'Node';
            
trigger_error(
                
sprintf(
                    
__('Could not include class "%1$s", file "%2$s" not found'),
                    
$class,
                    
'Nodes/' $class '.class.php'
                
),
                
E_USER_ERROR
            
);
        }
        return 
$class;
    }
    
/**
     * Instanciates a Node object
     *
     * @param string $class    The name of the class to instanciate
     * @param string $name     An identifier for the new node
     * @param int    $type     Type of node, may be one of CONTAINER or OBJECT
     * @param bool   $is_group Whether this object has been created
     *                         while grouping nodes
     *
     * @return string
     */
    
public static function getInstance(
        
$class 'Node',
        
$name 'default',
        
$type Node::OBJECT,
        
$is_group false
    
) {
        
$class self::_sanitizeClass($class);
        include_once 
sprintf(self::$_path$class);
        return new 
$class($name$type$is_group);
    }
}

?>