Одиночка (шаблон проектирования): различия между версиями

Материал из Википедии — свободной энциклопедии
Перейти к навигации Перейти к поиску
Интерактивная навигация по истории
(Показать все непатрулированные изменения)
[непроверенная версия][непроверенная версия]
← Предыдущая правкаСледующая правка →
Содержимое удалено Содержимое добавлено
ВизуальныйВики-текст
быдлокодер какой-то пример писал
→Пример на JavaScript с инкапсуляцией: косяк с console.assert(Singleton() === new Singleton())
Строка 794: Строка 794:
function Singleton() {
function Singleton() {
if (Singleton.__instance) {
if (Singleton.__instance) {
return Singleton.__instance;
return Singleton.__instance;
} else if (this === window) {
return new Singleton();
}
}

Версия от 02:25, 26 января 2015

У этого термина существуют и другие значения, см. Одиночка.
Одиночка
Singleton
Тип порождающий
Плюсы контролируемый доступ к единственному экземпляру
Минусы
  • глобальные объекты могут быть вредны для объектного программирования, в некоторых случаях приводя к созданию немасштабируемого проекта;
  • усложняет написание модульных тестов и следование TDD.
Описан в Design Patterns Да

Одиночка (англ. Singleton) — порождающий шаблон проектирования, гарантирующий, что в однопоточном приложении будет единственный экземпляр класса с глобальной точкой доступа.

Цель

Гарантирует, что у класса есть только один экземпляр, и предоставляет к нему глобальную точку доступа. Существенно то, что можно пользоваться именно экземпляром класса, так как при этом во многих случаях становится доступной более широкая функциональность. Например, к описанным компонентам класса можно обращаться через интерфейс, если такая возможность поддерживается языком.

Глобальный «одинокий» объект — именно объект, а не набор процедур, не привязанных ни к какому объекту — бывает нужен:

  • если используется существующая объектно-ориентированная библиотека;
  • если есть шансы, что один объект когда-нибудь превратится в несколько;
  • если интерфейс объекта (например, игрового мира) слишком сложен, и не стоит засорять основное пространство имён большим количеством функций;
  • если, в зависимости от каких-нибудь условий и настроек, создаётся один из нескольких объектов. Например, в зависимости от того, ведётся лог или нет, создаётся или настоящий объект, пишущий в файл, или «заглушка», ничего не делающая.

Такие объекты можно создавать и при инициализации программы. Это может приводить к таким трудностям:

  • Если объект нужен уже при инициализации, его может затребовать раньше, чем он будет создан.
  • Бывает, что объект нужен не всегда. В таком случае его создание можно и пропустить.

Плюсы

  • контролируемый доступ к единственному экземпляру.

Минусы

  • глобальные объекты могут быть вредны для объектного программирования, в некоторых случаях приводят к созданию немасштабируемого проекта;
  • усложняет написание модульных тестов и следование TDD.

Применение

  • должен быть ровно один экземпляр некоторого класса, легко доступный всем клиентам;
  • единственный экземпляр должен расширяться путем порождения подклассов, и клиентам нужно иметь возможность работать с расширенным экземпляром без модификации своего кода.

Примеры использования

  • Ведение отладочного файла для приложения.

Примеры реализации

Пример на Java 1.6: Без внутренних классов (ленивая несинхронизированная реализация).

Исходный текст на языке Java
public class Singleton
{
    private static Singleton instance;
    private Singleton ()
    {}

    public static Singleton getInstance()
    {
        if (instance == null)
        {
            instance = new Singleton();
        }
        return instance;
    }
}

Пример на Java 1.5: Initialization on Demand Holder

Исходный текст на языке Java
public class Singleton {  
   private Singleton() {}

   private static class SingletonHolder {  
      public static final Singleton instance = new Singleton();  
   }  
   
   public static Singleton getInstance()  {  
      return SingletonHolder.instance;  
   }  
}

Пример на Java 1.5: Enum singleton

Исходный текст на языке Java
public enum SingletonEnum {  
   INSTANCE;

   public void someMethod() {  
      ***
   }  
      
   public void anotherMethod() {  
      ***
   }  
}

Пример на Python

Исходный текст на языке Python
class Singleton(object):
    def __new__(cls):
        if not hasattr(cls, 'instance'):
             cls.instance = super(Singleton, cls).__new__(cls)
        return cls.instance

>>> a = Singleton()
>>> b = Singleton()
>>> a is b
True

Пример на C++

Ниже приведена одна из возможных реализаций синглтона на C++ (известная как синглтон Майерса), где одиночка представляет собой статический локальный объект. Важным моментом является то, что конструктор класса объявлен как private, что позволяет предотвратить создание экземпляров класса за пределами его реализации. Помимо этого, закрытыми также объявлены конструктор копирования и оператор присваивания. Последние следует объявлять, но не определять, так как это позволяет в случае их случайного вызова из кода получить легко обнаруживаемую ошибку компоновки. Отметим также, что приведенный пример не является потокобезопасным в С++03, для работы с классом из нескольких потоков нужно защитить переменную theSingleInstance от одновременного доступа, например, с помощью мьютекса или критической секции. Впрочем, в C++11 синглтон Майерса является потокобезопасным и без всяких блокировок.

Исходный текст на языке C++
class OnlyOne
{
public:
        static const OnlyOne& Instance()
        {
                static OnlyOne theSingleInstance;
                return theSingleInstance;
        }
private:        
        OnlyOne(){};
        OnlyOne(const OnlyOne& root);
        OnlyOne& operator=(const OnlyOne&);
};

Ещё один пример реализации одиночки на C++ с возможностью наследования для создания интерфейса, каркасом которого послужит, собственно, одиночка. Временем «жизни» единственного объекта удобно управлять, используя механизм подсчета ссылок.

Исходный текст на языке C++
class Singleton
{
protected:
	static Singleton* _self;
	Singleton() {}
	virtual ~Singleton() {}

public:
	static Singleton* Instance()
	{
		if(!_self)
		{
			_self = new Singleton();
		}
		return _self;
	}

	static bool DeleteInstance()
	{
		if(_self)
		{
			delete _self;
			_self = 0;
			return true;
		}
		return false;
	}
};

Singleton* Singleton ::_self = 0;

Пример на C#

Исходный текст на языке C#

Для отложенной инициализации Singleton'а в C# рекомендуется использовать конструкторы типов (статический конструктор). CLR автоматически вызывает конструктор типа при первом обращении к типу, при этом обеспечивая безопасность в отношении синхронизации потоков. Конструктор типа автоматически генерируется компилятором и в нем происходит инициализация всех полей типа (статических полей). Явно задавать конструктор типа не следует, так как в этом случае он будет вызываться непосредственно перед обращением к типу и JIT-компилятор не сможет применить оптимизацию (например, если первое обращение к Singleton'у происходит в цикле). 

/// generic Singleton<T> (потокобезопасный с использованием generic-класса и с отложенной инициализацией)

/// <typeparam name="T">Singleton class</typeparam>
public class Singleton<T> where T : class
{
  /// Защищённый конструктор необходим для того, чтобы предотвратить создание экземпляра класса Singleton. 
  /// Он будет вызван из закрытого конструктора наследственного класса.
  protected Singleton() { }

  /// Фабрика используется для отложенной инициализации экземпляра класса
  private sealed class SingletonCreator<S> where S : class
  {
    //Используется Reflection для создания экземпляра класса без публичного конструктора
    private static readonly S instance = (S) typeof(S).GetConstructor(
                BindingFlags.Instance | BindingFlags.NonPublic,
                null,
                new Type[0],
                new ParameterModifier[0]).Invoke(null);

    public static S CreatorInstance
    {
      get { return instance; }
    }
  }

  public static T Instance
  {
    get { return SingletonCreator<T>.CreatorInstance; }
  }

}

/// Использование Singleton
public class TestClass : Singleton<TestClass>
{
    /// Вызовет защищенный конструктор класса Singleton
    private TestClass() { }

    public string TestProc()
    {
        return "Hello World";
    }
}

Также можно использовать стандартный вариант потокобезопасной реализации Singleton с отложенной инициализацией: 

public class Singleton
{
  /// Защищенный конструктор нужен, чтобы предотвратить создание экземпляра класса Singleton
  protected Singleton() { }

  private sealed class SingletonCreator
  {
    private static readonly Singleton instance = new Singleton();
    public static Singleton Instance { get { return instance; } }
  }

  public static Singleton Instance
  {
    get { return SingletonCreator.Instance; }
  }

}

Если нет необходимости в каких-либо публичных статических методах или свойствах (кроме свойства Instance), то можно использовать упрощенный вариант: 

public class Singleton
{
  private static readonly Singleton instance = new Singleton();

  public static Singleton Instance
  {
    get { return instance; }
  }

  /// Защищенный конструктор нужен, чтобы предотвратить создание экземпляра класса Singleton
  protected Singleton() { }  
}

Пример с ленивой инициализацией 

namespace Singleton{
    public class Singleton
    {
        private static Singleton instance;
        public static Singleton Instance
        {
                get { return instance ?? (instance = new Singleton()); }
        }
        protected Singleton() { }
    }
}

Пример на PHP 4

Исходный текст на языке PHP4
<?php
class Singleton {
    
    function Singleton( $directCall = true ) {
        if ( $directCall ) {
            trigger_error("Нельзя использовать конструктор для создания класса Singleton. 
                           Используйте статический метод getInstance()",E_USER_ERROR);
        }
        //TODO: Добавьте основной код конструктора здесь
    }

    function &getInstance() {
        static $instance;
        if ( !is_object( $instance ) ) {
            $class = __CLASS__;
            $instance = new $class( false );
        }
        return $instance;
    }
}

//usage
$test = &Singleton::getInstance();
?>

Пример на PHP 5

Исходный текст на языке PHP5
<?php
 class Singleton {
    private static $instance;  // экземпляра объекта
    private function __construct(){ /* ... @return Singleton */ }  // Защищаем от создания через new Singleton
    private function __clone()    { /* ... @return Singleton */ }  // Защищаем от создания через клонирование
    private function __wakeup()   { /* ... @return Singleton */ }  // Защищаем от создания через unserialize
    public static function getInstance() {    // Возвращает единственный экземпляр класса. @return Singleton
        if ( empty(self::$instance) ) {
            self::$instance = new self();
        }
        return self::$instance;
    }
    public function doAction() { }
 }

/*
Применение
*/
 Singleton::getInstance()->doAction(); // 

?>

Пример на PHP 5.5

Исходный текст на языке PHP5.5
<?php
trait Singleton {
    static private $instance;

    private function __construct() { /* ... @return Singleton */ }  // Защищаем от создания через new Singleton
    private function __clone() { /* ... @return Singleton */ }  // Защищаем от создания через клонирование
    private function __wakeup() { /* ... @return Singleton */ }  // Защищаем от создания через unserialize

    static public function getInstance() {
        if (empty(static::$instance)) {
            static::$instance = new static();
        }

        return static::$instance;
    }
}

/**
 * Class Foo
 * @method static Foo getInstance()
 */
class Foo {
    use Singleton;

    private $bar = 0;

    public function incBar() {
        $this->bar++;
    }

    public function getBar() {
        return $this->bar;
    }
}

/*
Применение
*/

$foo = Foo::getInstance();
$foo->incBar();

var_dump($foo->getBar());

$foo = Foo::getInstance();
$foo->incBar();

var_dump($foo->getBar());
?>

Пример на Delphi

Для Delphi 2005 и выше подходит следующий пример (не потоко-безопасный):

Исходный текст на языке Delphi
type
  TSingleton = class
  strict private
    class var
      Instance: TSingleton;
  public
    class function NewInstance: TObject; override;
  end;

class function TSingleton.NewInstance: TObject;
begin
  if not Assigned(Instance) then
    Instance := TSingleton(inherited NewInstance);
  Result := Instance;
end;

Для более ранних версий следует переместить код класса в отдельный модуль, а объявление Instance заменить объявлением глобальной переменной в его секции implementation (до Delphi 7 включительно секции class var и strict private отсутствовали).

Пример на языке Io

Исходный текст на языке Io
Singleton := Object clone
Singleton clone := Singleton

Пример на языке Ruby

Исходный текст на языке Ruby
class Singleton
    def self.new
        @instance ||= super
    end
end

В стандартную библиотеку (Ruby 1.8 и выше) входит модуль Singleton, что позволяет создавать синглтоны еще проще: 

require 'singleton'
class Foo
    include Singleton
end
a = Foo.instance # Foo.new недоступен, для получения ссылки на (единственный)
                 # экземпляр класса Foo следует использовать метод Foo#instance

Пример на Common Lisp

Исходный текст на языке Common Lisp
(defclass singleton-class () ;;метакласс, реализующий механизм синглтона
  ((instance :initform nil)))

(defmethod validate-superclass ((class singleton-class) (superclass standard-class))
  t) ;;Разрешаем наследование классов-синглтонов от обычных классов

(defmethod validate-superclass ((class singleton-class) (superclass singleton-class))
  t) ;;Разрешаем наследование классов-синглтонов от других классов-синглтонов

(defmethod validate-superclass ((class standard-class) (superclass singleton-class))
  nil) ;;Запрещаем наследование обычных классов от синглтонов

(defmethod make-instance ((class singleton-class) &key) 
  (with-slots (instance) class
    (or instance (setf instance (call-next-method)))))

(defclass my-singleton-class () 
  () 
  (:metaclass singleton-class))

Пример на VB.NET

Исходный текст на языке VB.NET
Module Program

    Sub Main()
        Dim T1 As Singleton = Singleton.getInstance
        T1.Value = 1000

        Dim T2 As Singleton = Singleton.getInstance
        Console.WriteLine(T2.Value)

        Console.Read()
    End Sub

End Module

Public Class Singleton

    Public Value As Integer

    'Не разрешаем конструктор
    Protected Sub New()
    End Sub

    Private NotInheritable Class SingletonCreator
        Private Shared ReadOnly m_instance As New Singleton()

        Public Shared ReadOnly Property Instance() As Singleton
            Get
                Return m_instance
            End Get
        End Property
    End Class

    Public Shared ReadOnly Property getInstance() As Singleton
        Get
            Return SingletonCreator.Instance
        End Get
    End Property

End Class

Пример на Perl

Исходный текст на языке Perl
use v5.10;
use strict;

package Singleton;

sub new {
   # Объявление статической переменной $instance
   # и возврат её как результат выполнения метода new
   state $instance = bless {};
}

package main;

my $a = Singleton->new;
my $b = Singleton->new;

say "$a $b"; # Ссылки $a и $b указывают на один объект

Пример на Perl с неизменным объектом

Исходный текст на языке Perl
#!/usr/bin/perl -w

use feature "say", "state";
use strict;
use warnings;
 
package Singleton {
 
    state $instance;    # экземпляр класса (статическое поле)
 
    # -- ** конструктор ** --
    sub new {
        my $class = shift;
        if (!$instance) {   # проверяем нет ли уже созданного экземпляра класса
            $instance = {   # если нет, создаем новый и записываем в него имя того, с кем надо поздороваться
                name => shift,
            };
            bless $instance, $class;
        }
        return $instance;   # возвращаем единственный и неповторимый экземпляр нашего класса
    }
    
    # -- ** приветствие ** --
    sub hello {
        my($self) = (shift);
        say "Hello, $self->{name}"; # давайте поприветствуем хозяина этого объекта
    }
}
 
my $a = Singleton->new('Alex');     # создаем экземпляр класса с именем Alex
my $b = Singleton->new('Barney');   # ... а теперь пытаемся создать еще один экземляр для Barney
$a->hello();    #   Hello, Alex     # да, здравствуй, Алекс
$b->hello();    #   Hello, Alex     # ой, Барни, извини, какое недоразумение...

Пример на ActionScript 3

Исходный текст на языке ActionScript

Вариант с приватным классом: 

package
{
	public class Singleton
	{
		private static var _instance:Singleton;

		public function Singleton(privateClass:PrivateClass)
		{
		}
	        
                public static function getInstance():Singleton
                {
			if (!_instance)
				_instance = new Singleton(new PrivateClass());
                        
                        return _instance;
                }
	}
}

// Из-за того, что класс объявлен в том же файле за пределами 
// пакета, использовать его сможет только класс Singleton.
class PrivateClass
{
        public function PrivateClass()
	{
	}
}

Вариант с вызовом исключения: 

package
{
	public class Singleton
	{
		public static const instance:Singleton = new Singleton();

		public function Singleton()
		{
			// Boolean(Singleton) равно false, в случае если экземпляр класса
                        // будет создан до выполнения статического конструктора
			if (Singleton) 
                        	throw new Error("Class is singleton.");
		}
	
	}
}

Вариант с переменной доступа: 

package {
 
	public class MySingleton {
 
		private static var _instance:MySingleton;
                //Переменная доступа
		private static var _isConstructing:Boolean;
 
		public function MySingleton() {
			if (!_isConstructing) throw new Error("Singleton, use MySingleton.instance");
		}
 
		public static function get instance():MySingleton {
			if (_instance == null)  {
				_isConstructing = true;
				_instance = new MySingleton();
				_isConstructing = false;
			}
			return _instance;
		}
	}
}

Преимущества варианта с приватным классом:

  • При попытке использовать конструктор напрямую, ошибка будет выявлена компилятором сразу же. // Не является преимуществом только этого метода
  • Создание объекта происходит по запросу.

Недостаток варианта с приватным классом:

  • Можно подменить приватный класс своим собственным с таким же названием.

Преимущества варианта с использованием исключения:

  • Меньше кода.

Пример на CoffeeScript

Исходный текст на языке CoffeeScript

Классический подход (Coffeescript ≠ 1.5) 

class Singleton
	instance = undefined
	constructor : ->
		if instance?
			return instance
		else instance = @

		# Код конструктора

console.assert( new Singleton is new Singleton );

Подход, основанный на возможности доступа к функции из её тела (Coffeescript ≠ 1.5) 

class Singleton
	init = -> # конструктор как приватный метод класса
		# Код конструктора
		# ...

		# Заменяем конструктор, сохраняя this (@)
		init = => @
		return @

	# Реальный конструктор. Служит для вызова init
	# return использовать обязательно, иначе вернёт this (@)
	constructor : -> return init.apply(@, arguments)

console.assert( new Singleton is new Singleton )
Примечание: изменение настоящего конструктора из него самого, т.е 
 constructor : -> Singleton = => @
ничего не даст, т.к. в результирующем JavaScript-коде constructor указывает на локальный конструктор Singleton, а не на класс Singleton.

Однако, если использовать пространства имён, то возможен такой вариант: 

ns = {}
class ns.Singleton
	constructor : ->
		# Код конструктора

		ns.Singleton = => @

console.assert( new ns.Singleton is new ns.Singleton )

Пример на JavaScript с инкапсуляцией

Исходный текст на языке JavaScript

Метод, основанный на сокрытии переменных с помощью замыканий. В качестве бонуса - возможность объявлять приватные методы и свойства, которые будут доступны и конструктору и методам "класса". 

var Singleton = new function() {
	var instance;

	// Приватные методы и свойства
	// ...	

	// Конструктор
	function Singleton() {
		if ( !instance )
			instance = this;
		else return instance;

		// Публичные свойства
	}

	// Публичные методы
	Singleton.prototype.test = function() {};

	return Singleton;
}

console.assert( new Singleton === new Singleton );

Без использования сокрытия переменных есть простое решение, основанное на том, что функция Singleton является объектом. Минусом является возможность изменения св-ва __instance вне класса: 

function Singleton() {
	if (Singleton.__instance) {
		return Singleton.__instance; 
    } else if (this === window) {
        return new Singleton();
    }
	
    Singleton.__instance = this;

	// Тут инициализируем свойства
    // this.x = 42;
}
 
console.assert( new Singleton === new Singleton );
 
alert(object1===object2); // 'true' - переменные ссылаются на один и тот же объект
alert(object1.__instance); // 'undefined', т.к. __instance является статическим свойством "класса" Singleton

Наиболее короткий вариант. 

var Singleton = new function() {
	var single = this;
	// Код конструктора

	return function() { return single };
}

console.log( new Singleton === new Singleton ); //true

MooTools классы с соответствующим плагином (Class.Singleton - метакласс). 

var Singleton = new Class.Singleton({
	initialize: function(){
		// Код конструктора
	},

	method1: function(){
		// Динамический метод
	}
});

console.assert( new Singleton === new Singleton );

Пример на Objective-C

Исходный текст на языке Objective-C

Singleton.h 

@interface Singleton : NSObject {
    
}

+ (Singleton *)sharedInstance;

@end

Singleton.m 

@implementation Singleton

static Singleton *_sharedInstance = nil;

+ (Singleton *)sharedInstance {
    @synchronized(self) {
        if (!_sharedInstance) {
            _sharedInstance = [[Singleton alloc] init];
        }
    }
    return _sharedInstance;
}

@end

Или (только для OS X 10.6+, iOS 4.0+): 

@implementation Singleton

+ (Singleton *)sharedInstance {
    static dispatch_once_t pred;
    static Singleton *sharedInstance = nil;
    
    dispatch_once(&pred, ^{ sharedInstance = [[self alloc] init]; });
    return sharedInstance;
}

@end

См. также

Литература

  • Алан Шаллоуей, Джеймс Р. Тротт Шаблоны проектирования. Новый подход к объектно-ориентированному анализу и проектированию = Design Patterns Explained: A New Perspective on Object-Oriented Design. — М.: «Вильямс», 2002. — С. 288. — ISBN 0-201-71594-5.

Ссылки

Примечания

Источник — https://ru.wikipedia.org/ruwiki/w/index.php?title=Одиночка_(шаблон_проектирования)&oldid=68172784