updated TODOs.txt
[core.git] / framework / main / classes / factories / info / class_ConnectionInfoFactory.php
1 <?php
2 // Own namespace
3 namespace CoreFramework\Factory\Connection;
4
5 // Import framework stuff
6 use CoreFramework\Factory\ObjectFactory;
7 use CoreFramework\Registry\Registry;
8
9 /**
10  * A factory class for ShareableInfo
11  *
12  * @author              Roland Haeder <webmaster@ship-simu.org>
13  * @version             0.0.0
14  * @copyright   Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2017 Core Developer Team
15  * @license             GNU GPL 3.0 or any newer version
16  * @link                http://www.ship-simu.org
17  *
18  * This program is free software: you can redistribute it and/or modify
19  * it under the terms of the GNU General Public License as published by
20  * the Free Software Foundation, either version 3 of the License, or
21  * (at your option) any later version.
22  *
23  * This program is distributed in the hope that it will be useful,
24  * but WITHOUT ANY WARRANTY; without even the implied warranty of
25  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
26  * GNU General Public License for more details.
27  *
28  * You should have received a copy of the GNU General Public License
29  * along with this program. If not, see <http://www.gnu.org/licenses/>.
30  */
31 class ConnectionInfoFactory extends ObjectFactory {
32         /**
33          * Protected constructor
34          *
35          * @return      void
36          */
37         protected function __construct () {
38                 // Call parent constructor
39                 parent::__construct(__CLASS__);
40         }
41
42         /**
43          * Returns a singleton (registry-based) ShareableInfo instance
44          *
45          * @param       $protocolName   Name of protocol (e.g. 'tcp')
46          * @param       $type                   Connection type ('listener' or 'helper')
47          * @return      $infoInstance   An instance of a ShareableInfo class
48          */
49         public static final function createConnectionInfoInstance ($protocolName, $type) {
50                 // Generate key
51                 $key = 'connection_info_' . $protocolName . '_' . $type;
52
53                 // If there is no info?
54                 if (Registry::getRegistry()->instanceExists($key)) {
55                         // Get info from registry
56                         $infoInstance = Registry::getRegistry()->getInstance($key);
57                 } else {
58                         // Get the info instance
59                         $infoInstance = self::createObjectByConfiguredName('connection_info_class');
60
61                         // Add it to the registry
62                         Registry::getRegistry()->addInstance($key, $infoInstance);
63                 }
64
65                 // Return the instance
66                 return $infoInstance;
67         }
68 }
69
70 // [EOF]
71 ?>