Class: LDAP::Server::MatchingRule

Inherits:

Object

• Object
• LDAP::Server::MatchingRule

show all

Defined in:

lib/ldap/server/match.rb,
lib/ldap/server/match.rb

Overview

Defined Under Namespace

Modules: Equality, IA5Downcase, IA5Trim, Integer, Ordering, StringDowncase, StringTrim, Substrings Classes: DefaultMatchingClass

Constant Summary

DefaultMatch =

DefaultMatchingClass.new

@@rules =

oid / name / alias => object

{}

Instance Attribute Summary (collapse)

• - (Object) desc readonly

  Returns the value of attribute desc.

• - (Object) names readonly

  Returns the value of attribute names.

• - (Object) obsolete readonly

  Returns the value of attribute obsolete.

• - (Object) oid readonly

  Returns the value of attribute oid.

• - (Object) syntax readonly

  Returns the value of attribute syntax.

Class Method Summary (collapse)

• + (Object) add(*args, &blk)

  Add a new matching rule.

• + (Object) all_matching_rules

  Return all known matching rules.

• + (Object) find(x)

  Find a MatchingRule object given a name or oid, or return nil (? should we create one automatically, like Syntax).

• + (Object) from_def(str, &blk)

  Create a new MatchingRule object, given its description string.

Instance Method Summary (collapse)

• - (MatchingRule) initialize(oid, names, syntax, desc = nil, obsolete = false, &blk) constructor

  Create a new MatchingRule object.

• - (Object) name
• - (Object) normalize(x)
• - (Object) to_def
• - (Object) to_s

16
17
18
19
20
21
22
23
24
25
26

# File 'lib/ldap/server/match.rb', line 16

def initialize(oid, names, syntax, desc=nil, obsolete=false, &blk)
  @oid = oid
  @names = names
  @names = [@names] unless @names.is_a?(Array)
  @desc = desc
  @obsolete = obsolete
  @syntax = LDAP::Server::Syntax.find(syntax)  # creates new obj if reqd
  @def = nil
  # initialization hook
  self.instance_eval(&blk) if blk
end

12
13
14

# File 'lib/ldap/server/match.rb', line 12

def desc
  @desc
end

12
13
14

# File 'lib/ldap/server/match.rb', line 12

def names
  @names
end

12
13
14

# File 'lib/ldap/server/match.rb', line 12

def obsolete
  @obsolete
end

12
13
14

# File 'lib/ldap/server/match.rb', line 12

def oid
  @oid
end

12
13
14

# File 'lib/ldap/server/match.rb', line 12

def syntax
  @syntax
end

72
73
74
75
76
77
78
79

# File 'lib/ldap/server/match.rb', line 72

def self.add(*args, &blk)
  s = new(*args, &blk)
  @@rules[s.oid] = s
  return if s.names.nil?
  s.names.each do |n|
    @@rules[n.downcase] = s
  end
end

91
92
93

# File 'lib/ldap/server/match.rb', line 91

def self.all_matching_rules
  @@rules.values.uniq
end

84
85
86
87

# File 'lib/ldap/server/match.rb', line 84

def self.find(x)
  return x if x.nil? or x.is_a?(LDAP::Server::MatchingRule)
  @@rules[x.downcase]
end

42
43
44
45
46
47

# File 'lib/ldap/server/match.rb', line 42

def self.from_def(str, &blk)
  m = LDAP::Server::Syntax::MatchingRuleDescription.match(str)
  raise LDAP::ResultError::InvalidAttributeSyntax,
    "Bad MatchingRuleDescription #{str.inspect}" unless m
  new(m[1], m[2].scan(/'(.*?)'/).flatten, m[5], m[3], m[4], &blk)
end

28
29
30

# File 'lib/ldap/server/match.rb', line 28

def name
  (@names && names[0]) || @oid
end

36
37
38

# File 'lib/ldap/server/match.rb', line 36

def normalize(x)
  x
end

49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

# File 'lib/ldap/server/match.rb', line 49

def to_def
  return @def if @def
  ans = "( #{@oid} "
  if names.nil? or @names.empty?
    # nothing
  elsif @names.size == 1
    ans << "NAME '#{@names[0]}' "
  else
    ans << "NAME ( "
    @names.each { |n| ans << "'#{n}' " }
    ans << ") "
  end
  ans << "DESC '#@desc' " if @desc
  ans << "OBSOLETE " if @obsolete
  ans << "SYNTAX #@syntax " if @syntax
  ans << ")"
  @def = ans
end

32
33
34

# File 'lib/ldap/server/match.rb', line 32

def to_s
  (@names && names[0]) || @oid
end