Class: RubyDNS::Rule

Inherits:
Object
  • Object
show all
Defined in:
lib/rubydns/rule.rb

Overview

Represents a single rule in the server.

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(pattern, callback) ⇒ Rule

Create a new rule with a given pattern and callback.



25
26
27
28
 
# File 'lib/rubydns/rule.rb', line 25

def initialize(pattern, callback)
	@pattern = pattern
	@callback = callback
end

Class Method Details

.for(pattern, &block) ⇒ Object

Create a new rule with a given pattern and callback.



17
18
19
 
# File 'lib/rubydns/rule.rb', line 17

def self.for(pattern, &block)
	new(pattern, block)
end

Instance Method Details

#call(server, name, resource_class, transaction) ⇒ Object

Invoke the rule, if it matches the incoming request, it is evaluated and returns ‘true`, otherwise returns `false`.



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
 
# File 'lib/rubydns/rule.rb', line 44

def call(server, name, resource_class, transaction)
	unless match(name, resource_class)
		Console.debug "<#{transaction.query.id}> Resource class #{resource_class} failed to match #{@pattern[1].inspect}!"
		
		return false
	end
	
	# Does this rule match against the supplied name?
	case @pattern[0]
	when Regexp
		match_data = @pattern[0].match(name)
		
		if match_data
			Console.debug "<#{transaction.query.id}> Regexp pattern matched with #{match_data.inspect}."
			
			@callback.call(transaction, match_data)
			
			return true
		end
	when String
		if @pattern[0] == name
			Console.debug "<#{transaction.query.id}> String pattern matched."
			
			@callback.call(transaction)
			
			return true
		end
	else
		if (@pattern[0].call(name, resource_class) rescue false)
			Console.debug "<#{transaction.query.id}> Callable pattern matched."
			
			@callback.call(transaction)
			
			return true
		end
	end
	
	Console.debug "<#{transaction.query.id}> No pattern matched."
	
	# We failed to match the pattern.
	return false
end

#match(name, resource_class) ⇒ Object

Returns true if the name and resource_class are sufficient:



31
32
33
34
35
36
37
38
39
40
41
 
# File 'lib/rubydns/rule.rb', line 31

def match(name, resource_class)
	# If the pattern doesn't specify any resource classes, we implicitly pass this test:
	return true if @pattern.size < 2
	
	# Otherwise, we try to match against some specific resource classes:
	if Class === @pattern[1]
		@pattern[1] == resource_class
	else
		@pattern[1].include?(resource_class) rescue false
	end
end

#to_s ⇒ Object

Return a string representation of the rule.



88
89
90
 
# File 'lib/rubydns/rule.rb', line 88

def to_s
	"#<#{self.class} #{@pattern}>"
end