LDAP URI SCHEMA (described in RFC2255) Methods

A
B
D
E
F
H
N
P
S
Constants
DEFAULT_PORT = 389
 

A Default port of 389 for URI::LDAP
COMPONENT = [ :scheme, :host, :port, :dn, :attributes, :scope, :filter, :extensions, ].freeze
 

An Array of the available components for URI::LDAP
SCOPE = [ SCOPE_ONE = 'one', SCOPE_SUB = 'sub', SCOPE_BASE = 'base', ].freeze
 

Scopes available for the starting point.

  • SCOPE_BASE - the Base DN

  • SCOPE_ONE - one level under the Base DN, not including the base DN and

    not including any entries under this.

  • SCOPE_SUB - subtress, all entries at all levels
Class Public methods
build(args)

Description

Create a new URI::LDAP object from components, with syntax checking.

The components accepted are host, port, dn, attributes, scope, filter, and extensions.

The components should be provided either as an Array, or as a Hash with keys formed by preceding the component names with a colon.

If an Array is used, the components must be passed in the order [host, port, dn, attributes, scope, filter, extensions].

Example:

newuri = URI::LDAP.build({:host => 'ldap.example.com',
  :dn> => '/dc=example'})

newuri = URI::LDAP.build(["ldap.example.com", nil,
  "/dc=example;dc=com", "query", nil, nil, nil])

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 73
def self.build(args)
  tmp = Util::make_components_hash(self, args)

  if tmp[:dn]
    tmp[:path] = tmp[:dn]
  end

  query = []
  [:extensions, :filter, :scope, :attributes].collect do |x|
    next if !tmp[x] && query.size == 0
    query.unshift(tmp[x])
  end

  tmp[:query] = query.join('?')

  return super(tmp)
end
new(*arg)

Description

Create a new URI::LDAP object from generic URI components as per RFC 2396. No LDAP-specific syntax checking is performed.

Arguments are scheme, userinfo, host, port, registry, path, opaque, query and fragment, in that order.

Example:

uri = URI::LDAP.new("ldap", nil, "ldap.example.com", nil,
  "/dc=example;dc=com", "query", nil, nil, nil, nil)

See also URI::Generic.new

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 108
def initialize(*arg)
  super(*arg)

  if @fragment
    raise InvalidURIError, 'bad LDAP URL'
  end

  parse_dn
  parse_query
end
Instance Public methods
attributes()

returns attributes.

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 177
def attributes
  @attributes
end
attributes=(val)

setter for attributes val

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 190
def attributes=(val)
  set_attributes(val)
  val
end
dn()

returns dn.

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 158
def dn
  @dn
end
dn=(val)

setter for dn val

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 171
def dn=(val)
  set_dn(val)
  val
end
extensions()

returns extensions.

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 234
def extensions
  @extensions
end
extensions=(val)

setter for extensions val

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 247
def extensions=(val)
  set_extensions(val)
  val
end
filter()

returns filter.

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 215
def filter
  @filter
end
filter=(val)

setter for filter val

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 228
def filter=(val)
  set_filter(val)
  val
end
hierarchical?()

Checks if URI has a path For URI::LDAP this will return false

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 254
def hierarchical?
  false
end
scope()

returns scope.

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 196
def scope
  @scope
end
scope=(val)

setter for scope val

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 209
def scope=(val)
  set_scope(val)
  val
end
Instance Protected methods
set_attributes(val)

private setter for attributes val

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 182
def set_attributes(val)
  @attributes = val
  build_path_query
  @attributes
end
set_dn(val)

private setter for dn val

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 163
def set_dn(val)
  @dn = val
  build_path_query
  @dn
end
set_extensions(val)

private setter for extensions val

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 239
def set_extensions(val)
  @extensions = val
  build_path_query
  @extensions
end
set_filter(val)

private setter for filter val

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 220
def set_filter(val)
  @filter = val
  build_path_query
  @filter
end
set_scope(val)

private setter for scope val

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 201
def set_scope(val)
  @scope = val
  build_path_query
  @scope
end
Instance Private methods
build_path_query()

private method to assemble query from attributes, scope, filter and extensions.

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 145
def build_path_query
  @path = '/' + @dn

  query = []
  [@extensions, @filter, @scope, @attributes].each do |x|
    next if !x && query.size == 0
    query.unshift(x)
  end
  @query = query.join('?')
end
parse_dn()

private method to cleanup dn from using the path component attribute

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 120
def parse_dn
  @dn = @path[1..-1]
end
parse_query()

private method to cleanup attributes, scope, filter and extensions, from using the query component attribute

Source: show | on GitHub 

# File ../ruby/lib/uri/ldap.rb, line 127
def parse_query
  @attributes = nil
  @scope      = nil
  @filter     = nil
  @extensions = nil

  if @query
    attrs, scope, filter, extensions = @query.split('?')

    @attributes = attrs if attrs && attrs.size > 0
    @scope      = scope if scope && scope.size > 0
    @filter     = filter if filter && filter.size > 0
    @extensions = extensions if extensions && extensions.size > 0
  end
end