Singleton.php
3.13 KB
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
98
99
100
101
<?php
/**
* i-Educar - Sistema de gestão escolar
*
* Copyright (C) 2006 Prefeitura Municipal de Itajaí
* <ctima@itajai.sc.gov.br>
*
* Este programa é software livre; você pode redistribuí-lo e/ou modificá-lo
* sob os termos da Licença Pública Geral GNU conforme publicada pela Free
* Software Foundation; tanto a versão 2 da Licença, como (a seu critério)
* qualquer versão posterior.
*
* Este programa é distribuído na expectativa de que seja útil, porém, SEM
* NENHUMA GARANTIA; nem mesmo a garantia implícita de COMERCIABILIDADE OU
* ADEQUAÇÃO A UMA FINALIDADE ESPECÍFICA. Consulte a Licença Pública Geral
* do GNU para mais detalhes.
*
* Você deve ter recebido uma cópia da Licença Pública Geral do GNU junto
* com este programa; se não, escreva para a Free Software Foundation, Inc., no
* endereço 59 Temple Street, Suite 330, Boston, MA 02111-1307 USA.
*
* @author Eriksen Costa Paixão <eriksen.paixao_bs@cobra.com.br>
* @category i-Educar
* @license @@license@@
* @package CoreExt_Singleton
* @since Arquivo disponível desde a versão 1.1.0
* @version $Id$
*/
/**
* CoreExt_Singleton abstract class.
*
* Funciona como uma interface de atalho para minimizar a duplicação de código
* para criar instâncias singleton. Internamente, entretanto, funciona como um
* {@link http://martinfowler.com/eaaCatalog/registry.html Registry} já que
* todas as suas subclasses estarão armazenadas em um array estático desta
* classe.
*
* @author Eriksen Costa Paixão <eriksen.paixao_bs@cobra.com.br>
* @category i-Educar
* @license @@license@@
* @link http://martinfowler.com/eaaCatalog/registry.html Registry pattern
* @package CoreExt_Singleton
* @since Classe disponível desde a versão 1.1.0
* @version @@package_version@@
*/
abstract class CoreExt_Singleton
{
/**
* A instância singleton de CoreExt_Singleton
* @var array
*/
private static $_instance = array();
/**
* Construtor.
*/
private function __construct()
{
}
/**
* Sobrescreva esse método para garantir que a subclasse possa criar um
* singleton. Esta deve fazer uma chamada ao método _getInstance, passando
* uma string que tenha como valor o nome da classe. Uma forma conveniente
* de fazer isso é chamando _getInstance passando como parâmetro a constante
* mágica __CLASS__.
*
* Exemplo:
* <code>
* <?php
* ... // extends CoreExt_Singleton
* public static function getInstance()
* {
* return self::_getInstance(__CLASS__);
* }
* </code>
*
* @return CoreExt_Singleton
*/
public static function getInstance()
{
require_once 'CoreExt/Exception.php';
throw new CoreExt_Exception('É necessário sobrescrever o método "getInstance()" de CoreExt_Singleton.');
}
/**
* Retorna uma instância singleton, instanciando-a quando necessário.
*
* @param string $self Nome da subclasse de CoreExt_Singleton que será instanciada
* @return CoreExt_Singleton
*/
protected static function _getInstance($self)
{
if (!isset(self::$_instance[$self])) {
self::$_instance[$self] = new $self();
}
return self::$_instance[$self];
}
}