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

Public Class 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])

 
               # File uri/ldap.rb, line 74
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)

Public Instance Methods

attributes()

returns attributes.

 
               # File uri/ldap.rb, line 178
def attributes
  @attributes
end

attributes=(val)

setter for attributes val

 
               # File uri/ldap.rb, line 191
def attributes=(val)
  set_attributes(val)
  val
end

dn()

returns dn.

 
               # File uri/ldap.rb, line 159
def dn
  @dn
end

dn=(val)

setter for dn val

 
               # File uri/ldap.rb, line 172
def dn=(val)
  set_dn(val)
  val
end

extensions()

returns extensions.

 
               # File uri/ldap.rb, line 235
def extensions
  @extensions
end

extensions=(val)

setter for extensions val

 
               # File uri/ldap.rb, line 248
def extensions=(val)
  set_extensions(val)
  val
end

filter()

returns filter.

 
               # File uri/ldap.rb, line 216
def filter
  @filter
end

filter=(val)

setter for filter val

 
               # File uri/ldap.rb, line 229
def filter=(val)
  set_filter(val)
  val
end

hierarchical?()

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

 
               # File uri/ldap.rb, line 255
def hierarchical?
  false
end

scope()

returns scope.

 
               # File uri/ldap.rb, line 197
def scope
  @scope
end

scope=(val)

setter for scope val

 
               # File uri/ldap.rb, line 210
def scope=(val)
  set_scope(val)
  val
end

Protected Instance Methods

set_attributes(val)

private setter for attributes val

 
               # File uri/ldap.rb, line 183
def set_attributes(val)
  @attributes = val
  build_path_query
  @attributes
end

set_dn(val)

private setter for dn val

 
               # File uri/ldap.rb, line 164
def set_dn(val)
  @dn = val
  build_path_query
  @dn
end

set_extensions(val)

private setter for extensions val

 
               # File uri/ldap.rb, line 240
def set_extensions(val)
  @extensions = val
  build_path_query
  @extensions
end

set_filter(val)

private setter for filter val

 
               # File uri/ldap.rb, line 221
def set_filter(val)
  @filter = val
  build_path_query
  @filter
end

set_scope(val)

private setter for scope val

 
               # File uri/ldap.rb, line 202
def set_scope(val)
  @scope = val
  build_path_query
  @scope
end