Spec-Zone.ru › Ruby 2.5

класс URI::LDAP

Родитель:
URI::Generic

LDAP URI СХЕМА (описанная в RFC2255)

Константы

COMPONENT

Массив доступных компонентов для URI::LDAP

DEFAULT_PORT

Порт по умолчанию 389 для URI::LDAP

SCOPE

Доступные области для начальной точки.

  • SCOPE_BASE - базовая DN

  • SCOPE_ONE - один уровень ниже базовой DN, не включая саму базу DN и

    not including any entries under this.
  • SCOPE_SUB - поддерево, все записи на всех уровнях

Публичные методы класса

build(args) Показать исходный код
# File 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

Описание

Создать новый объект URI::LDAP из компонентов с проверкой синтаксиса.

Принимаемые компоненты: host, port, dn, attributes, scope, filter и extensions.

Компоненты должны быть предоставлены либо как массив, либо как хэш с ключами, образованными путём предшествования имени компонента двоеточием.

Если используется массив, компоненты должны передаваться в порядке [host, port, dn, attributes, scope, filter, extensions].

Пример:

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])
Вызывает метод суперкласса URI::Generic.build
new(*arg) Показать исходный код
# File lib/uri/ldap.rb, line 108
def initialize(*arg)
  super(*arg)

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

  parse_dn
  parse_query
end

Описание

Создать новый объект URI::LDAP из общих компонентов URI в соответствии с RFC 2396. Проверка синтаксиса, специфичная для LDAP, не выполняется.

Аргументы — scheme, userinfo, host, port, registry, path, opaque, query и fragment, в указанном порядке.

Пример:

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

См. также URI::Generic.new

Вызывает метод суперкласса URI::Generic.new

Общедоступные методы экземпляра

attributes() Показать исходный код
# File lib/uri/ldap.rb, line 177
def attributes
  @attributes
end

возвращает атрибуты.

attributes=(val) Показать исходный код
# File lib/uri/ldap.rb, line 190
def attributes=(val)
  set_attributes(val)
  val
end

установщик для атрибутов val

dn() Показать исходный код
# File lib/uri/ldap.rb, line 158
def dn
  @dn
end

возвращает dn.

dn=(val) Показать исходный код
# File lib/uri/ldap.rb, line 171
def dn=(val)
  set_dn(val)
  val
end

установщик для dn val

extensions() Показать исходный код
# File lib/uri/ldap.rb, line 234
def extensions
  @extensions
end

возвращает расширения.

extensions=(val) Показать исходный код
# File lib/uri/ldap.rb, line 247
def extensions=(val)
  set_extensions(val)
  val
end

установщик для расширений val

filter() Показать исходный код
# File lib/uri/ldap.rb, line 215
def filter
  @filter
end

возвращает фильтр.

filter=(val) Показать исходный код
# File lib/uri/ldap.rb, line 228
def filter=(val)
  set_filter(val)
  val
end

установщик для фильтра val

hierarchical?() Показать исходный код
# File lib/uri/ldap.rb, line 254
def hierarchical?
  false
end

Проверяет, содержит ли URI путь. Для URI::LDAP это вернёт false

scope() Показать исходный код
# File lib/uri/ldap.rb, line 196
def scope
  @scope
end

возвращает область.

scope=(val) Показать исходный код
# File lib/uri/ldap.rb, line 209
def scope=(val)
  set_scope(val)
  val
end

установщик для области val

Защищенные методы экземпляра

set_attributes(val) Показать исходный код
# File lib/uri/ldap.rb, line 182
def set_attributes(val)
  @attributes = val
  build_path_query
  @attributes
end

приватный метод установки атрибутов val

set_dn(val) Показать исходный код
# File lib/uri/ldap.rb, line 163
def set_dn(val)
  @dn = val
  build_path_query
  @dn
end

приватный метод установки dn val

set_extensions(val) Показать исходный код
# File lib/uri/ldap.rb, line 239
def set_extensions(val)
  @extensions = val
  build_path_query
  @extensions
end

приватный метод установки расширений val

set_filter(val) Показать исходный код
# File lib/uri/ldap.rb, line 220
def set_filter(val)
  @filter = val
  build_path_query
  @filter
end

приватный метод установки фильтра val

set_scope(val) Показать исходный код
# File lib/uri/ldap.rb, line 201
def set_scope(val)
  @scope = val
  build_path_query
  @scope
end

приватный метод установки области val

Приватные методы экземпляра

build_path_query() Показать исходный код
# File 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

приватный метод для сборки query из attributes, scope, filter и extensions.

parse_dn() Показать исходный код
# File lib/uri/ldap.rb, line 120
def parse_dn
  @dn = @path[1..-1]
end

приватный метод для очистки dn из использования атрибута компонента path

parse_query() Показать исходный код
# File 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

приватный метод для очистки attributes, scope, filter и extensions, из использования атрибута компонента query

Ruby Core © 1993–2017 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API