Gecko [ nxtxgen.com ]

Name	Size	Permission
bigdecimal	[ DIR ]	drwxr-xr-x
cgi	[ DIR ]	drwxr-xr-x
date	[ DIR ]	drwxr-xr-x
digest	[ DIR ]	drwxr-xr-x
dl	[ DIR ]	drwxr-xr-x
drb	[ DIR ]	drwxr-xr-x
io	[ DIR ]	drwxr-xr-x
irb	[ DIR ]	drwxr-xr-x
net	[ DIR ]	drwxr-xr-x
openssl	[ DIR ]	drwxr-xr-x
optparse	[ DIR ]	drwxr-xr-x
racc	[ DIR ]	drwxr-xr-x
rdoc	[ DIR ]	drwxr-xr-x
rexml	[ DIR ]	drwxr-xr-x
rinda	[ DIR ]	drwxr-xr-x
rss	[ DIR ]	drwxr-xr-x
runit	[ DIR ]	drwxr-xr-x
shell	[ DIR ]	drwxr-xr-x
soap	[ DIR ]	drwxr-xr-x
test	[ DIR ]	drwxr-xr-x
uri	[ DIR ]	drwxr-xr-x
webrick	[ DIR ]	drwxr-xr-x
wsdl	[ DIR ]	drwxr-xr-x
x86_64-linux	[ DIR ]	drwxr-xr-x
xmlrpc	[ DIR ]	drwxr-xr-x
xsd	[ DIR ]	drwxr-xr-x
yaml	[ DIR ]	drwxr-xr-x
English.rb	5.6 KB	-rw-r--r--
Env.rb	274 B	-rw-r--r--
abbrev.rb	2.5 KB	-rw-r--r--
base64.rb	3.37 KB	-rw-r--r--
benchmark.rb	17.73 KB	-rw-r--r--
cgi-lib.rb	6.89 KB	-rw-r--r--
cgi.rb	73.74 KB	-rw-r--r--
complex.rb	12.84 KB	-rw-r--r--
csv.rb	24.46 KB	-rw-r--r--
date.rb	53.02 KB	-rw-r--r--
date2.rb	128 B	-rw-r--r--
debug.rb	20.61 KB	-rw-r--r--
delegate.rb	8.81 KB	-rw-r--r--
digest.rb	1.12 KB	-rw-r--r--
drb.rb	19 B	-rw-r--r--
e2mmap.rb	4.04 KB	-rw-r--r--
erb.rb	21.38 KB	-rw-r--r--
eregex.rb	487 B	-rw-r--r--
expect.rb	633 B	-rw-r--r--
fileutils.rb	42.23 KB	-rw-r--r--
finalize.rb	5.38 KB	-rw-r--r--
find.rb	1.84 KB	-rw-r--r--
forwardable.rb	6.16 KB	-rw-r--r--
ftools.rb	6.17 KB	-rw-r--r--
generator.rb	8.1 KB	-rw-r--r--
getoptlong.rb	14.88 KB	-rw-r--r--
getopts.rb	2.25 KB	-rw-r--r--
gserver.rb	6.43 KB	-rw-r--r--
importenv.rb	590 B	-rw-r--r--
ipaddr.rb	21.96 KB	-rw-r--r--
irb.rb	7.43 KB	-rw-r--r--
jcode.rb	4.3 KB	-rw-r--r--
kconv.rb	8.12 KB	-rw-r--r--
logger.rb	17.59 KB	-rw-r--r--
mailread.rb	1.28 KB	-rw-r--r--
mathn.rb	5.42 KB	-rw-r--r--
matrix.rb	27.21 KB	-rw-r--r--
md5.rb	411 B	-rw-r--r--
mkmf.rb	50.65 KB	-rw-r--r--
monitor.rb	7.93 KB	-rw-r--r--
mutex_m.rb	2.07 KB	-rw-r--r--
observer.rb	5.15 KB	-rw-r--r--
open-uri.rb	20.49 KB	-rw-r--r--
open3.rb	2.1 KB	-rw-r--r--
openssl.rb	575 B	-rw-r--r--
optparse.rb	47.12 KB	-rw-r--r--
ostruct.rb	3.35 KB	-rw-r--r--
parsearg.rb	1.55 KB	-rw-r--r--
parsedate.rb	1.33 KB	-rw-r--r--
pathname.rb	29.39 KB	-rw-r--r--
ping.rb	1.48 KB	-rw-r--r--
pp.rb	15.97 KB	-rw-r--r--
prettyprint.rb	18.33 KB	-rw-r--r--
profile.rb	90 B	-rw-r--r--
profiler.rb	1.59 KB	-rw-r--r--
pstore.rb	11.15 KB	-rw-r--r--
rational.rb	12.05 KB	-rw-r--r--
readbytes.rb	835 B	-rw-r--r--
resolv-replace.rb	1.55 KB	-rw-r--r--
resolv.rb	56.83 KB	-rw-r--r--
rss.rb	504 B	-rw-r--r--
rubyunit.rb	180 B	-rw-r--r--
scanf.rb	20.63 KB	-rw-r--r--
securerandom.rb	4.27 KB	-rw-r--r--
set.rb	27.08 KB	-rw-r--r--
sha1.rb	418 B	-rw-r--r--
shell.rb	4.66 KB	-rw-r--r--
shellwords.rb	3.99 KB	-rw-r--r--
singleton.rb	8.08 KB	-rw-r--r--
sync.rb	6.09 KB	-rw-r--r--
tempfile.rb	4.86 KB	-rw-r--r--
thread.rb	104 B	-rw-r--r--
thwait.rb	4.32 KB	-rw-r--r--
time.rb	31.58 KB	-rw-r--r--
timeout.rb	3 KB	-rw-r--r--
tmpdir.rb	3.69 KB	-rw-r--r--
tracer.rb	2.73 KB	-rw-r--r--
tsort.rb	7.99 KB	-rw-r--r--
un.rb	4.54 KB	-rw-r--r--
uri.rb	710 B	-rw-r--r--
weakref.rb	2.68 KB	-rw-r--r--
webrick.rb	811 B	-rw-r--r--
yaml.rb	12.36 KB	-rw-r--r--

Code Editor : observer.rb

#
# observer.rb implements the _Observer_ object-oriented design pattern.  The
# following documentation is copied, with modifications, from "Programming
# Ruby", by Hunt and Thomas; http://www.rubycentral.com/book/lib_patterns.html.
#
# == About
#
# The Observer pattern, also known as Publish/Subscribe, provides a simple
# mechanism for one object to inform a set of interested third-party objects
# when its state changes. 
#
# == Mechanism
#
# In the Ruby implementation, the notifying class mixes in the +Observable+
# module, which provides the methods for managing the associated observer
# objects.
#
# The observers must implement the +update+ method to receive notifications.
#
# The observable object must:
# * assert that it has +changed+
# * call +notify_observers+
#
# == Example
#
# The following example demonstrates this nicely.  A +Ticker+, when run,
# continually receives the stock +Price+ for its +@symbol+.  A +Warner+ is a
# general observer of the price, and two warners are demonstrated, a +WarnLow+
# and a +WarnHigh+, which print a warning if the price is below or above their
# set limits, respectively.
#
# The +update+ callback allows the warners to run without being explicitly
# called.  The system is set up with the +Ticker+ and several observers, and the
# observers do their duty without the top-level code having to interfere.
#
# Note that the contract between publisher and subscriber (observable and
# observer) is not declared or enforced.  The +Ticker+ publishes a time and a
# price, and the warners receive that.  But if you don't ensure that your
# contracts are correct, nothing else can warn you.
#
#   require "observer"
#   
#   class Ticker          ### Periodically fetch a stock price.
#     include Observable
#   
#     def initialize(symbol)
#       @symbol = symbol
#     end
#   
#     def run
#       lastPrice = nil
#       loop do
#         price = Price.fetch(@symbol)
#         print "Current price: #{price}\n"
#         if price != lastPrice
#           changed                 # notify observers
#           lastPrice = price
#           notify_observers(Time.now, price)
#         end
#         sleep 1
#       end
#     end
#   end
#
#   class Price           ### A mock class to fetch a stock price (60 - 140).
#     def Price.fetch(symbol)
#       60 + rand(80)
#     end
#   end
#   
#   class Warner          ### An abstract observer of Ticker objects.
#     def initialize(ticker, limit)
#       @limit = limit
#       ticker.add_observer(self)
#     end
#   end
#   
#   class WarnLow < Warner
#     def update(time, price)       # callback for observer
#       if price < @limit
#         print "--- #{time.to_s}: Price below #@limit: #{price}\n"
#       end
#     end
#   end
#   
#   class WarnHigh < Warner
#     def update(time, price)       # callback for observer
#       if price > @limit
#         print "+++ #{time.to_s}: Price above #@limit: #{price}\n"
#       end
#     end
#   end
#
#   ticker = Ticker.new("MSFT")
#   WarnLow.new(ticker, 80)
#   WarnHigh.new(ticker, 120)
#   ticker.run
#
# Produces:
#
#   Current price: 83
#   Current price: 75
#   --- Sun Jun 09 00:10:25 CDT 2002: Price below 80: 75
#   Current price: 90
#   Current price: 134
#   +++ Sun Jun 09 00:10:25 CDT 2002: Price above 120: 134
#   Current price: 134
#   Current price: 112
#   Current price: 79
#   --- Sun Jun 09 00:10:25 CDT 2002: Price below 80: 79

#
# Implements the Observable design pattern as a mixin so that other objects can
# be notified of changes in state.  See observer.rb for details and an example.
#
module Observable

#
  # Add +observer+ as an observer on this object. +observer+ will now receive
  # notifications.
  #
  def add_observer(observer)
    @observer_peers = [] unless defined? @observer_peers
    unless observer.respond_to? :update
      raise NoMethodError, "observer needs to respond to `update'" 
    end
    @observer_peers.push observer
  end

#
  # Delete +observer+ as an observer on this object. It will no longer receive
  # notifications.
  #
  def delete_observer(observer)
    @observer_peers.delete observer if defined? @observer_peers
  end

#
  # Delete all observers associated with this object.
  #
  def delete_observers
    @observer_peers.clear if defined? @observer_peers
  end

#
  # Return the number of observers associated with this object.
  #
  def count_observers
    if defined? @observer_peers
      @observer_peers.size
    else
      0
    end
  end

#
  # Set the changed state of this object.  Notifications will be sent only if
  # the changed +state+ is +true+.
  #
  def changed(state=true)
    @observer_state = state
  end

#
  # Query the changed state of this object.
  #
  def changed?
    if defined? @observer_state and @observer_state
      true
    else
      false
    end
  end

#
  # If this object's changed state is +true+, invoke the update method in each
  # currently associated observer in turn, passing it the given arguments. The
  # changed state is then set to +false+.
  #
  def notify_observers(*arg)
    if defined? @observer_state and @observer_state
      if defined? @observer_peers
	for i in @observer_peers.dup
	  i.update(*arg)
	end
      end
      @observer_state = false
    end
  end

end

${this.title}

Code Editor : observer.rb