palio.connectors
Class LDAPConnector

java.lang.Object
  palio.connectors.Connector
      palio.connectors.PooledConnector
          palio.connectors.LDAPConnector

public class LDAPConnector
extends PooledConnector

A Class LDAPConnector

Version:

1.2.8

Author:

Krzysztof Madyniak

Field Summary

static java.lang.String

CONTEXT_FACTORY

Constructor Summary

LDAPConnector(java.lang.String url, java.util.Properties properties)
Creates a new instance of LDAPConnector

Method Summary

void	bind(java.lang.String name, java.lang.Object obj) przypisuje nazwę do obiektu
void	createSubcontext(java.lang.String name) tworzy i przypisuje nowy podkontekst
void	destroySubcontext(java.lang.String name) niszczy zadany kontekst i usuwa go z przestrzeni nazw
java.util.LinkedList	getAttributes(java.lang.String name) Odczytuje atrybuty i ich wartosci dla obiektu o danej nazwie
java.util.LinkedList	getAttributes(java.lang.String name, java.lang.Object[] _attrIds) Odczytuje wybrane atrybuty i ich wartosci dla obiektu o danej nazwie
javax.naming.Context	getInitialContext()
javax.naming.directory.DirContext	getInitialDirContext()
java.lang.String	getURL()
java.util.LinkedList	list(java.lang.String name) zwraca listę obiektów z danego kontekstu
java.lang.Object	lookup(java.lang.String name) zwraca obiekt o danej nazwie
java.lang.Object	lookup(java.lang.String name, boolean tryReconnect, palio.connectors.LDAPConnection c)
void	modifyAttribute(java.lang.String name, java.lang.Long mode, java.lang.String attrName, java.lang.String attrValue) modyfikuje atrybut obiektu o danej nazwie
void	modifyAttributes(java.lang.String name, java.lang.Long mode, java.lang.Object[] attrs) modyfikuje atrybuty obiektu o danej nazwie
void	rebind(java.lang.String name, java.lang.Object obj) przypisuje nazwe do obiektu przy jednoczesnym nadpisaniem istniejacych przypisań
void	rename(java.lang.String oldName, java.lang.String newName) zmienia nazwę obiektu przypisanego do starej nazwy
java.util.LinkedList	search(java.lang.String contextName, java.lang.Object[] attributes) wyszukuje obiekty z zadanego kontekstu zawierające zbiór zadanych atrybutów z zadanymi wartosciami
java.util.LinkedList	search(java.lang.String contextName, java.lang.Object[] attrsNames, java.lang.Object[] attrsValues) Deprecated.
java.util.LinkedList	search(java.lang.String contextName, java.lang.String filter, java.lang.Long scope, java.lang.Long countLimit, java.lang.Long timeLimit) wyszukuje obiekty z zadanego kontekstu zawierające zbiór zadanych atrybutów z wartosciami spełaniające warunek nakładany przez filtr
java.util.LinkedList	search(java.lang.String contextName, java.lang.String filter, java.lang.Long scope, java.lang.Long countLimit, java.lang.Long timeLimit, boolean tryReconnect, palio.connectors.LDAPConnection c)
void	unbind(java.lang.String name) usuwa obiekt o danej nazwie

Methods inherited from class palio.connectors.PooledConnector

BusyChecker, clearThreadResources, close, DedicateChecker, FreeChecker, getInfo, info, init, refresh

Methods inherited from class palio.connectors.Connector

getConnector, getInstance, getName, getUrl, init, setDedicatedLogConfiguration, setInstance

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CONTEXT_FACTORY

public static final java.lang.String CONTEXT_FACTORY

See Also:

Constant Field Values

Constructor Detail

LDAPConnector

public LDAPConnector(java.lang.String url,
                     java.util.Properties properties)

Creates a new instance of LDAPConnector

Method Detail

getURL

public java.lang.String getURL()

getInitialContext

public javax.naming.Context getInitialContext()
                                       throws palio.PalioException

Returns:

initial Context

Throws:

palio.PalioException

Since:

1.2.8

getInitialDirContext

public javax.naming.directory.DirContext getInitialDirContext()
                                                       throws palio.PalioException

Returns:

initial DirContext

Throws:

palio.PalioException

Since:

1.2.8

list

public java.util.LinkedList list(java.lang.String name)
                          throws palio.PalioException

zwraca listę obiektów z danego kontekstu

Parameters:

name - nazwa kontekstu

Returns:

listę tablic zawierającą nazwę obiektu i nazawę klasy

Throws:

palio.PalioException

lookup

public java.lang.Object lookup(java.lang.String name)
                        throws palio.PalioException

zwraca obiekt o danej nazwie

Parameters:

name -

Returns:

obiekt o danej nazwie

Throws:

palio.PalioException

lookup

public java.lang.Object lookup(java.lang.String name,
                               boolean tryReconnect,
                               palio.connectors.LDAPConnection c)
                        throws palio.PalioException

Throws:

palio.PalioException

bind

public void bind(java.lang.String name,
                 java.lang.Object obj)
          throws palio.PalioException

przypisuje nazwę do obiektu

Parameters:

name -

obj -

Throws:

palio.PalioException

rebind

public void rebind(java.lang.String name,
                   java.lang.Object obj)
            throws palio.PalioException

przypisuje nazwe do obiektu przy jednoczesnym nadpisaniem istniejacych przypisań

Parameters:

name -

obj -

Throws:

palio.PalioException

unbind

public void unbind(java.lang.String name)
            throws palio.PalioException

usuwa obiekt o danej nazwie

Parameters:

name -

Throws:

palio.PalioException

rename

public void rename(java.lang.String oldName,
                   java.lang.String newName)
            throws palio.PalioException

zmienia nazwę obiektu przypisanego do starej nazwy

Parameters:

oldName -

newName -

Throws:

palio.PalioException

createSubcontext

public void createSubcontext(java.lang.String name)
                      throws palio.PalioException

tworzy i przypisuje nowy podkontekst

Parameters:

name -

Throws:

palio.PalioException

destroySubcontext

public void destroySubcontext(java.lang.String name)
                       throws palio.PalioException

niszczy zadany kontekst i usuwa go z przestrzeni nazw

Parameters:

name -

Throws:

palio.PalioException

getAttributes

public java.util.LinkedList getAttributes(java.lang.String name)
                                   throws palio.PalioException

Odczytuje atrybuty i ich wartosci dla obiektu o danej nazwie

Parameters:

name - nazwa obiektu

Returns:

lista atrybutów wraz z ich wartościami. każdy element listy to dwuelementowa tablica: (1 - nazwa atrybutu, 2 - wartości danego atrybutu)

Throws:

palio.PalioException

getAttributes

public java.util.LinkedList getAttributes(java.lang.String name,
                                          java.lang.Object[] _attrIds)
                                   throws palio.PalioException

Odczytuje wybrane atrybuty i ich wartosci dla obiektu o danej nazwie

Parameters:

name - nazwa obiektu

_attrIds - tablica identyfikatorów atrybutów

Returns:

lista atrybutów wraz z ich wartościami. każdy element listy to dwuelementowa tablica: (1 - nazwa atrybutu, 2 - wartości danego atrybutu)

Throws:

palio.PalioException

modifyAttribute

public void modifyAttribute(java.lang.String name,
                            java.lang.Long mode,
                            java.lang.String attrName,
                            java.lang.String attrValue)
                     throws palio.PalioException

modyfikuje atrybut obiektu o danej nazwie

Parameters:

name - nazwa obiektu

mode - type modyfikacji obiektu 1 - ADD_ATTRIBUTE 2 - REPLACE_ATTRIBUTE 3 - REMOVE_ATTRIBUTE

attrName - nazwa modyfikowanego atrybutu

attrValue - wartość atrybutu (w przypadku usuwania należy użyć wartości null)

Throws:

palio.PalioException

modifyAttributes

public void modifyAttributes(java.lang.String name,
                             java.lang.Long mode,
                             java.lang.Object[] attrs)
                      throws palio.PalioException

modyfikuje atrybuty obiektu o danej nazwie

Parameters:

name - nazwa obiektu

mode - type modyfikacji obiektu 1 - ADD_ATTRIBUTE 2 - REPLACE_ATTRIBUTE 3 - REMOVE_ATTRIBUTE

attrs - tablica dwu wymiarowych tablic [[nazwa atrybutu, wartość atrybutu], ...]

Throws:

palio.PalioException

search

@Deprecated
public java.util.LinkedList search(java.lang.String contextName,
                                              java.lang.Object[] attrsNames,
                                              java.lang.Object[] attrsValues)
                            throws palio.PalioException

Deprecated.

wyszukuje obiekty z zadanego kontekstu zawierające zbiór zadanych atrybutów z zadanymi wartosciami

Parameters:

contextName - nazwa kontekstu

attrsNames - nazwy atrybutów

attrsValues - wartosci wymagane, w przypadku gdy chcemy aby znalezione zostały obiekty posiadające dany atrybut(nie zależnie od wartości) używamy null'a

Returns:

lista nazw znalezionych obiektów spełaniające zadany warunek

Throws:

palio.PalioException

search

public java.util.LinkedList search(java.lang.String contextName,
                                   java.lang.Object[] attributes)
                            throws palio.PalioException

wyszukuje obiekty z zadanego kontekstu zawierające zbiór zadanych atrybutów z zadanymi wartosciami

Parameters:

contextName - nazwa kontekstu

attributes - tablica dwuelementowych tablic (1 - nazwa atrybutu, 2 - wartość (w przypadku gdy chcemy aby znalezione zostały obiekty posiadające dany atrybut, nie zależnie od wartości, użyć należy wartości null)

Returns:

lista nazw znalezionych obiektów spełaniające zadany warunek

Throws:

palio.PalioException

search

public java.util.LinkedList search(java.lang.String contextName,
                                   java.lang.String filter,
                                   java.lang.Long scope,
                                   java.lang.Long countLimit,
                                   java.lang.Long timeLimit)
                            throws palio.PalioException

wyszukuje obiekty z zadanego kontekstu zawierające zbiór zadanych atrybutów z wartosciami spełaniające warunek nakładany przez filtr

Parameters:

contextName - nazwa kontekstu

filter - filtr używany do wyszukiwania - składnia opisana w RFC 2254 np (&(sn=XXX)(mail=*)) wyszukuje obiekty, którego atrybut "sn" równy jest "XXX" oraz posiada atrybut "mail" o dowolnej wartości

scope - zakres wyszukiwania (jeżeli null, wartoscia domyslna jest ONLEVEL_SCOPE) 0 - OBJECT_SCOPE - sprawdzanie czy dany obiekt spełnia dane warunki 1 - ONELEVEL_SCOPE - przeszukuje poziom kontekstu 2 - SUBTREE_SCOPE = przeszukuje poddrzewo kontekstu

countLimit - liczba ograniczająca liczbę znalezionych obiektów (jeżeli null to brak ograniczenia)

timeLimit - timeout wyszykiwania w milisekundach (jeżeli null to brak ograniczenia na czas)

Returns:

lista nazw znalezionych obiektów spełaniające zadany warunek

Throws:

palio.PalioException

search

public java.util.LinkedList search(java.lang.String contextName,
                                   java.lang.String filter,
                                   java.lang.Long scope,
                                   java.lang.Long countLimit,
                                   java.lang.Long timeLimit,
                                   boolean tryReconnect,
                                   palio.connectors.LDAPConnection c)
                            throws palio.PalioException

Throws:

palio.PalioException