NAME

ResourcePool::Factory::Net::LDAP - A Net::LDAP Factory for ResourcePool

SYNOPSIS

 use ResourcePool::Factory::Net::LDAP;

 my $factory = ResourcePool::Factory::Net::LDAP->new($hostname, 
                                [@NamedBindOptions],
                                [@NamedNewOptions]);

DESCRIPTION

This class is a Factory class for Net::LDAP Resources to be used with the ResourcePool class.

Please read the ResourcePool::Factory(3pm) manpage about the purpos of such a factory.

ResourcePool::Factory::Net::LDAP->new

$hostname

The hostname of the LDAP server. Please note: The portnumber (if not 389) has to go to the [@NamedNewOptions] option, see below.

[@NamedBindOptions]

This is a list of named options which will be passed to the Net::LDAP->bind() call.

[@NamedNewOptions]

This is a list of named options which will be passed to the Net::LDAP->new() call.

If you have to use a LDAP Server on an non-standard port you have to include the 'port' parameter here.

EXAMPLE

To connect to the server ldap.domain.com on port 389 and bind anonymously:

   my $factory = ResourcePool::Factory::Net::LDAP->new(
                     "ldap.domain.com"
   );

To connect to the same server and bind with a dn and password:

   my $factory = ResourcePool::Factory::Net::LDAP->new(
                     "ldap.domain.com",
                     [
                         dn       => "cn=Manager,dc=domain,dc=com",
                         password => "secret" 
                     ]
   );

To connect to the same server but to the port 10000 and bind anonymously:

   my $factory = ResourcePool::Factory::Net::LDAP->new(
                     "ldap.domain.com",
                     [],        # no bind options
                     [port => 10000]
   );

NOTE: This class does not actually connect to the LDAP server, it only stores the credential, the actual connection is done with the $factory->create_resource() method wich is invoked from the ResourcePool.

SEE ALSO

Net::LDAP(3pm), ResourcePool(3pm), ResourcePool::Factory(3pm), ResourcePool::Factory::DBI(3pm)

AUTHOR

    Copyright (C) 2002 by Markus Winand <mws@fatalmind.com>

    This program is free software; you can redistribute it and/or
    modify it under the same terms as Perl itself.