[Date Prev][Date Next] [Chronological] [Thread] [Top]

Re: Java LDAP API



The section "4.3.5 getAttribute" contains definitions for two getAttribute
methods. The second definition is written as:

   public LDAPAttribute[] getAttribute(String attrName, String lang)

   Returns a single best-match attribute, or none if no match is
   available in the entry.

=========
If the method returns a "single" best-match attribute, why is it
returned in LDAPAttribute[] instead of LDAPAttribute?

Is it possible to return multiple LDAPAttributes? If so, what example
would show that behavior?

=========
Shouldn't the description read:

   Returns a single best-match attribute, or null if no match is
   available in the entry.

=========
The last word "specification" needs to be made plural in the parameter 
definition of lang:

      lang           A language specification as in [9], with optional
                      subtypes appended using "-" as separator. "lang-
                      en", "lang-en-us", "lang-ja", and "lang-ja-JP-
                      kanji" are valid language specifications.