summaryrefslogtreecommitdiffstats
path: root/lib/edoors/board.rb
blob: 27c5c85ac0ae7c8b599b353eb59e47fb205c1502 (plain)
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
#! /usr/bin/env ruby
# -*- coding: UTF-8 -*-
#
# Copyright 2012 Jérémy Zurcher <jeremy@asynk.ch>
#
# This file is part of edoors-ruby.
#
# edoors-ruby is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# edoors-ruby is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU Affero General Public License for more details.
#
# You should have received a copy of the GNU Affero General Public License
# along with edoors-ruby.  If not, see <http://www.gnu.org/licenses/>.

#
module Edoors
    #
    ACT_FOLLOW = 'follow'.freeze
    ACT_PASS_THROUGH = 'pass_through'.freeze
    #
    class Board < Door
        #
        # creates a Board object from the arguments.
        #
        # @param [String] n the name of this Board
        # @param [Iota] p the parent
        #
        def initialize n, p
            super n, p
            @postponed = {}
        end
        #
        # called by JSON#generate to serialize the Board object into JSON data
        #
        # @param [Array] a belongs to JSON generator
        #
        def to_json *a
            {
                'kls'       => self.class.name,
                'name'      => @name,
                'postponed' => @postponed
            }.merge(hibernate!).to_json *a
        end
        #
        # creates a Board object from a JSON data
        #
        # @param [Hash] o belongs to JSON parser
        #
        # @raise Edoors::Exception if the json kls attribute is wrong
        #
        def self.json_create o
            raise Edoors::Exception.new "JSON #{o['kls']} != #{self.name}" if o['kls'] != self.name
            board = self.new o['name'], o['parent']
            o['postponed'].each do |link_value,particle|
                board.process_p Edoors::Particle.json_create(particle.merge!('spin'=>board.spin))
            end
            board.resume! o
            board
        end
        #
        # process the given particle then forward it to user code
        #
        # @param [Particle] p the Particle to be processed
        #
        def process_p p
            @viewer.receive_p p if @viewer
            if p.action!=Edoors::ACT_ERROR and p.action!=Edoors::ACT_PASS_THROUGH
                p2 = @postponed[p.link_value] ||= p
                return if p2==p
                @postponed.delete p.link_value
                p,p2 = p2,p if p.action==Edoors::ACT_FOLLOW
                p.merge! p2
            end
            @saved = p
            receive_p p
            _garbage if not @saved.nil?
        end
        #
    end
    #
end
#
# EOF