URI-1.35 > URI::ldap

名前

URI::ldap - LDAP Uniform Resource Locators

URI::ldap - LDAP 統一資源位置指定子(Uniform Resource Locators )

概要

  use URI;

  $uri = URI->new("ldap:$uri_string");
  $dn     = $uri->dn;
  $filter = $uri->filter;
  @attr   = $uri->attributes;
  $scope  = $uri->scope;
  %extn   = $uri->extensions;
  
  $uri = URI->new("ldap:");  # start empty
  $uri->host("ldap.itd.umich.edu");
  $uri->dn("o=University of Michigan,c=US");
  $uri->attributes(qw(postalAddress));
  $uri->scope('sub');
  $uri->filter('(cn=Babs Jensen)');
  print $uri->as_string,"\n";

説明

URI::ldap provides an interface to parse an LDAP URI into its constituent parts and also to build a URI as described in RFC 2255.

URI::ldap は RFC 2255 で記述されているように、その構成要素部分での LDAP URI を解析したり、URI を組みたてるインターフェースを提供します。

メソッド

URI::ldap supports all the generic and server methods defined by URI, plus the following.

URI::ldapURI で定義されるすべての汎用とサーバメソッドを サポートし、さらに以下のものをサポートします。

Each of the following methods can be used to set or get the value in the URI. The values are passed in unescaped form. None of these return undefined values, but elements without a default can be empty. If arguments are given, then a new value is set for the given part of the URI.

以下のメソッドそれぞれは URI での値を設定あるいは取得するために使えます。 値はエスケープされない形式で渡されます。 これら全てはは未定義値を返しませんが、デフォルトがない要素は 空になるかもしれないことに注意してください。 引数が与えられると、新しい値は URI の与えられた部分に設定されます。

$uri->dn( [$new_dn] )

Sets or gets the Distinguished Name part of the URI. The DN identifies the base object of the LDAP search.

URI の Distinguised Name 部分を設定あるいは取得します。 DN は LDAP 検索のベースオブジェクトを識別します。

$uri->attributes( [@new_attrs] )

Sets or gets the list of attribute names which are returned by the search.

検索によって返される属性名のリストを設定あるいは取得します。

$uri->scope( [$new_scope] )

Sets or gets the scope to be used by the search. The value can be one of "base", "one" or "sub". If none is given in the URI then the return value defaults to "base".

検索が使うスコープ (scope) を設定あるいは取得します。 値は "base", "one", "sub" のいずれかを指定できます。 URI に何も与えられなければ、デフォルトの "base" になります。

$uri->_scope( [$new_scope] )

Same as scope(), but does not default to anything.

Same as scope(), but does not default to anything. (TBT)

$uri->filter( [$new_filter] )

Sets or gets the filter to be used by the search. If none is given in the URI then the return value defaults to "(objectClass=*)".

検索が使用するフィルター(filter)を設定あるいは取得します。 URI に何も与えられなければデフォルトの "(objectClass=*)" になります。

$uri->_filter( [$new_filter] )

Same as filter(), but does not default to anything.

Same as filter(), but does not default to anything. (TBT)

$uri->extensions( [$etype => $evalue,...] )

Sets or gets the extensions used for the search. The list passed should be in the form etype1 => evalue1, etype2 => evalue2,... This is also the form of list that is returned.

検索に使われる拡張子(extension)を設定あるいは取得します。 渡されるリストは etype1 => evalue1, etype2 => evalue2,... という 形式でなければなりません。 これは返されるリストの形式でもあります。

SEE ALSO

RFC-2255

作者

Graham Barr <gbarr@pobox.com>

Slightly modified by Gisle Aas to fit into the URI distribution.

コピーライト

Copyright (c) 1998 Graham Barr. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.