module Singleton

要約

Singleton パターンを提供するモジュールです。

Mix-in により singleton パターンを提供します。

Singleton モジュールを include することにより、クラスは高々ひとつのインスタンスしか持たないことが保証されます。

Singleton を Mix-in したクラスのクラスメソッド instance はその唯一のインスタンスを返します。

new は private メソッドに移され、外部から呼び出そうとするとエラーになります。

サンプルコード

require 'singleton'

class SomeSingletonClass
  include Singleton
 #....
end

a = SomeSingletonClass.instance
b = SomeSingletonClass.instance # a and b are same object
p [a,b] # => [#<SomeSingletonClass:0x0000562e6e18ddd0>, #<SomeSingletonClass:0x0000562e6e18ddd0>]
a = SomeSingletonClass.new  # => NoMethodError (private method `new' called for SomeSingletonClass:Class)

目次

特異メソッド
インスタンスメソッド

特異メソッド

instance -> object[permalink][rdoc]

そのクラスの唯一のインスタンスを返します。最初に呼ばれたときはそのインスタンスを生成します。

Singleton を include したクラスで定義されますので、正確には Singleton モジュールのメソッドではありません。

インスタンスメソッド

clone[permalink][rdoc]
[EXCEPTION] TypeError:
このメソッドを呼び出した場合に発生します。
dup[permalink][rdoc]
[EXCEPTION] TypeError:
このメソッドを呼び出した場合に発生します。