org.gluu.oxtrust.ldap.service.PersonService クラス

org.gluu.oxtrust.ldap.service.PersonService の継承関係図

org.gluu.oxtrust.ldap.service.PersonService 連携図

公開メンバ関数
void	addCustomObjectClass (GluuCustomPerson person)
void	addPerson (GluuCustomPerson person) throws Exception
void	updatePerson (GluuCustomPerson person)
void	removePerson (GluuCustomPerson person)
List< GluuCustomPerson >	searchPersons (String pattern, int sizeLimit)
List< GluuCustomPerson >	searchPersons (String pattern)
List< GluuCustomPerson >	findPersons (GluuCustomPerson person, int sizeLimit)
List< GluuCustomPerson >	searchPersons (String pattern, int sizeLimit, List< GluuCustomPerson > excludedPersons) throws Exception
List< GluuCustomPerson >	findAllPersons (String[] returnAttributes)
List< GluuCustomPerson >	findPersonsByUids (List< String > uids, String[] returnAttributes) throws Exception
List< GluuCustomPerson >	findPersonsByMailids (List< String > mailids, String[] returnAttributes) throws Exception
GluuCustomPerson	findPersonByDn (String dn, String... returnAttributes)
boolean	containsPerson (GluuCustomPerson person)
boolean	contains (String dn)
GluuCustomPerson	getPersonByDn (String dn)
GluuCustomPerson	getPersonByInum (String inum)
GluuCustomPerson	getPersonByUid (String uid)
int	countPersons ()
String	generateInumForNewPerson ()
String	generateInameForNewPerson (String uid)
String	getDnForPerson (String inum)
boolean	authenticate (String userName, String password)
List< GluuCustomAttribute >	getMandatoryAtributes ()
String	getPersonUids (List< GluuCustomPerson > persons) throws Exception
String	getPersonMailids (List< GluuCustomPerson > persons) throws Exception
List< GluuCustomPerson >	createEntities (Map< String, List< AttributeData >> entriesAttributes) throws Exception
GluuCustomPerson	getPersonByEmail (String email)
List< GluuCustomPerson >	getPersonsByUid (String uid)
List< GluuCustomPerson >	getPersonsByEmail (String email)
GluuCustomPerson	getPersonByAttribute (String attribute, String value) throws Exception
User	getUserByUid (String uid)
List< GluuCustomPerson >	getPersonsByAttribute (String attribute, String value) throws Exception

非公開メンバ関数
String	generateInumForNewPersonImpl ()
String	generateInum ()

非公開変数類
Logger	log
PersistenceEntryManager	ldapEntryManager
AttributeService	attributeService
AppConfiguration	appConfiguration
OrganizationService	organizationService
List< GluuCustomAttribute >	mandatoryAttributes

静的非公開変数類
static final long	serialVersionUID = 6685720517520443399L

詳解

Provides operations with persons

著者

Yuriy Movchan Date: 10.13.2010

関数詳解

addCustomObjectClass()

void org.gluu.oxtrust.ldap.service.PersonService.addCustomObjectClass ( GluuCustomPerson  person )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                              {
        String customObjectClass = attributeService.getCustomOrigin();
        String[] customObjectClassesArray = person.getCustomObjectClasses();
        if (ArrayHelper.isNotEmpty(customObjectClassesArray)) {
            List<String> customObjectClassesList = Arrays.asList(customObjectClassesArray);
            if (!customObjectClassesList.contains(customObjectClass)) {
                List<String> customObjectClassesListUpdated = new ArrayList<String>();
                customObjectClassesListUpdated.addAll(customObjectClassesList);
                customObjectClassesListUpdated.add(customObjectClass);
                customObjectClassesList = customObjectClassesListUpdated;
            }

            person.setCustomObjectClasses(customObjectClassesList.toArray(new String[0]));

        } else {
            person.setCustomObjectClasses(new String[] { customObjectClass });
        }
    }

addPerson()

void org.gluu.oxtrust.ldap.service.PersonService.addPerson ( GluuCustomPerson  person ) throws Exception

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                                    {
        GluuCustomPerson uidPerson = new GluuCustomPerson();
        uidPerson.setUid(person.getUid());
        List<GluuCustomPerson> persons = findPersons(uidPerson, 1);
        if (persons == null || persons.size() == 0) {
            person.setCreationDate(new Date());
            ldapEntryManager.persist(person);
        } else {
            throw new DuplicateEntryException("Duplicate UID value: " + person.getUid());
        }
    }

authenticate()

boolean org.gluu.oxtrust.ldap.service.PersonService.authenticate ( String  userName, String  password  )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                                  {
        boolean result = ldapEntryManager.authenticate(appConfiguration.getBaseDN(), userName, password);

        return result;
    }

contains()

boolean org.gluu.oxtrust.ldap.service.PersonService.contains ( String  dn )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                       {
        return ldapEntryManager.contains(GluuCustomPerson.class, dn);
    }

containsPerson()

boolean org.gluu.oxtrust.ldap.service.PersonService.containsPerson ( GluuCustomPerson  person )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                           {
        boolean result=false;
        try {
            result = ldapEntryManager.contains(person);
        }
        catch (Exception e){
            log.debug(e.getMessage(), e);
        }
        return result;
    }

countPersons()

int org.gluu.oxtrust.ldap.service.PersonService.countPersons ( )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                              {
        GluuCustomPerson gluuBasePerson = new GluuCustomPerson();
        gluuBasePerson.setBaseDn(getDnForPerson(null));

        return ldapEntryManager.countEntries(gluuBasePerson);
    }

createEntities()

List<GluuCustomPerson> org.gluu.oxtrust.ldap.service.PersonService.createEntities ( Map< String, List< AttributeData >>  entriesAttributes ) throws Exception

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                                                                                      {
        List<GluuCustomPerson> result = ldapEntryManager.createEntities(GluuCustomPerson.class, entriesAttributes);

        return result;
    }

findAllPersons()

List<GluuCustomPerson> org.gluu.oxtrust.ldap.service.PersonService.findAllPersons ( String []  returnAttributes )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                                             {
        List<GluuCustomPerson> result = ldapEntryManager.findEntries(getDnForPerson(null), GluuCustomPerson.class, null, returnAttributes);

        return result;
    }

findPersonByDn()

GluuCustomPerson org.gluu.oxtrust.ldap.service.PersonService.findPersonByDn ( String  dn, String...  returnAttributes  )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                                                  {
        return ldapEntryManager.find(GluuCustomPerson.class, dn, returnAttributes);
    }

findPersons()

List<GluuCustomPerson> org.gluu.oxtrust.ldap.service.PersonService.findPersons ( GluuCustomPerson  person, int  sizeLimit  )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                                                      {
        person.setBaseDn(getDnForPerson(null));
        return ldapEntryManager.findEntries(person, sizeLimit);
    }

findPersonsByMailids()

List<GluuCustomPerson> org.gluu.oxtrust.ldap.service.PersonService.findPersonsByMailids ( List< String >  mailids, String []  returnAttributes  ) throws Exception

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                                                                                         {
        List<Filter> mailidFilters = new ArrayList<Filter>();
        for (String mailid : mailids) {
                mailidFilters.add(Filter.createEqualityFilter(OxTrustConstants.mail, mailid));
        }

        Filter filter = Filter.createORFilter(mailidFilters);

        List<GluuCustomPerson> result = ldapEntryManager
                .findEntries(getDnForPerson(null), GluuCustomPerson.class, filter, returnAttributes);

        return result;
    }

findPersonsByUids()

List<GluuCustomPerson> org.gluu.oxtrust.ldap.service.PersonService.findPersonsByUids ( List< String >  uids, String []  returnAttributes  ) throws Exception

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                                                                                   {
        List<Filter> uidFilters = new ArrayList<Filter>();
        for (String uid : uids) {
            uidFilters.add(Filter.createEqualityFilter(OxConstants.UID, uid));
        }

        Filter filter = Filter.createORFilter(uidFilters);

        List<GluuCustomPerson> result = ldapEntryManager
                .findEntries(getDnForPerson(null), GluuCustomPerson.class, filter, returnAttributes);

        return result;
    }

generateInameForNewPerson()

String org.gluu.oxtrust.ldap.service.PersonService.generateInameForNewPerson ( String  uid )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                        {
        return String.format("%s*person*%s", appConfiguration.getOrgIname(), uid);
    }

generateInum()

String org.gluu.oxtrust.ldap.service.PersonService.generateInum ( )

inlineprivate

                                  {
        String inum = "";
        while (true) {
            inum = INumGenerator.generate(4);
            try {
                BigInteger value = new BigInteger(inum.replace(".", ""), 16);
                if (value.doubleValue() < 7.0) {
                    continue;
                }
            } catch (Exception ex) {
                log.error("Error generating inum: ", ex);
            }
            break;
        }
        return inum;
    }

generateInumForNewPerson()

String org.gluu.oxtrust.ldap.service.PersonService.generateInumForNewPerson ( )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                             {
        GluuCustomPerson person = null;
        String newInum = null;

        do {
            newInum = generateInumForNewPersonImpl();
            String newDn = getDnForPerson(newInum);
            person = new GluuCustomPerson();
            person.setDn(newDn);
        } while (containsPerson(person));
        return newInum;
    }

generateInumForNewPersonImpl()

String org.gluu.oxtrust.ldap.service.PersonService.generateInumForNewPersonImpl ( )

inlineprivate

Generate new inum for person

戻り値

New inum for person

例外

Exception

                                                  {
        String orgInum = organizationService.getInumForOrganization();
        return orgInum + OxTrustConstants.inumDelimiter + OxTrustConstants.INUM_PERSON_OBJECTTYPE + OxTrustConstants.inumDelimiter + generateInum();
    }

getDnForPerson()

String org.gluu.oxtrust.ldap.service.PersonService.getDnForPerson ( String  inum )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                              {
        String orgDn = organizationService.getDnForOrganization();
        if (StringHelper.isEmpty(inum)) {
            return String.format("ou=people,%s", orgDn);
        }

        return String.format("inum=%s,ou=people,%s", inum, orgDn);
    }

getMandatoryAtributes()

List<GluuCustomAttribute> org.gluu.oxtrust.ldap.service.PersonService.getMandatoryAtributes ( )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                             {
        if (this.mandatoryAttributes == null) {
            mandatoryAttributes = new ArrayList<GluuCustomAttribute>();
            mandatoryAttributes.add(new GluuCustomAttribute("uid", "", true, true));
            mandatoryAttributes.add(new GluuCustomAttribute("givenName", "", true, true));
            mandatoryAttributes.add(new GluuCustomAttribute("displayName", "", true, true));
            mandatoryAttributes.add(new GluuCustomAttribute("sn", "", true, true));
            mandatoryAttributes.add(new GluuCustomAttribute("mail", "", true, true));
            mandatoryAttributes.add(new GluuCustomAttribute("userPassword", "", true, true));
            mandatoryAttributes.add(new GluuCustomAttribute("gluuStatus", "", true, true));
        }

        return mandatoryAttributes;
    }

getPersonByAttribute()

GluuCustomPerson org.gluu.oxtrust.ldap.service.PersonService.getPersonByAttribute ( String  attribute, String  value  ) throws Exception

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                                                                  {
        GluuCustomPerson person = new GluuCustomPerson();
        person.setBaseDn(getDnForPerson(null));
        person.setAttribute(attribute, value);

        List<GluuCustomPerson> persons = ldapEntryManager.findEntries(person);

        if ((persons != null) && (persons.size() > 0)) {
            return persons.get(0);
        }

        return null;
    }

getPersonByDn()

GluuCustomPerson org.gluu.oxtrust.ldap.service.PersonService.getPersonByDn ( String  dn )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                     {
        GluuCustomPerson result = ldapEntryManager.find(GluuCustomPerson.class, dn);

        return result;

    }

getPersonByEmail()

GluuCustomPerson org.gluu.oxtrust.ldap.service.PersonService.getPersonByEmail ( String  email )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                           {
        GluuCustomPerson person = new GluuCustomPerson();
        person.setBaseDn(getDnForPerson(null));
        person.setMail(email);

        List<GluuCustomPerson> persons = ldapEntryManager.findEntries(person);

        if ((persons != null) && (persons.size() > 0)) {
            return persons.get(0);
        }

        return null;
    }

getPersonByInum()

GluuCustomPerson org.gluu.oxtrust.ldap.service.PersonService.getPersonByInum ( String  inum )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                         {
        GluuCustomPerson person = null;
        try{
            person = ldapEntryManager.find(GluuCustomPerson.class, getDnForPerson(inum));
        }catch (Exception e) {
            log.error("Failed to find Person by Inum " + inum, e);
        }


        return person;
    }

getPersonByUid()

GluuCustomPerson org.gluu.oxtrust.ldap.service.PersonService.getPersonByUid ( String  uid )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                       {
        GluuCustomPerson person = new GluuCustomPerson();
        person.setBaseDn(getDnForPerson(null));
        person.setUid(uid);

        List<GluuCustomPerson> persons = ldapEntryManager.findEntries(person);

        if ((persons != null) && (persons.size() > 0)) {
            return persons.get(0);
        }

        return null;
    }

getPersonMailids()

String org.gluu.oxtrust.ldap.service.PersonService.getPersonMailids ( List< GluuCustomPerson >  persons ) throws Exception

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                                                    {
        StringBuilder sb = new StringBuilder();

        for (Iterator<GluuCustomPerson> iterator = persons.iterator(); iterator.hasNext();) {
            GluuCustomPerson call = iterator.next();
            sb.append('\'').append(call.getMail()).append('\'');
            if (iterator.hasNext()) {
                sb.append(", ");
            }
        }
        return sb.toString();
    }

getPersonsByAttribute()

List<GluuCustomPerson> org.gluu.oxtrust.ldap.service.PersonService.getPersonsByAttribute ( String  attribute, String  value  ) throws Exception

inline

Get list of persons by attribute

引数

attribute	attribute
value	value

戻り値

List <Person>

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                                                                         {
        log.info("atttriburte : " + attribute + "      value : "+value);
        GluuCustomPerson person = new GluuCustomPerson();
        person.setBaseDn(getDnForPerson(null));
        person.setAttribute(attribute, value);

        List<GluuCustomPerson> persons = ldapEntryManager.findEntries(person);
        log.info("list : " + (persons));
        if ((persons != null) && (persons.size() > 0)) {
            return persons;
        }

        return null;
    }

getPersonsByEmail()

List<GluuCustomPerson> org.gluu.oxtrust.ldap.service.PersonService.getPersonsByEmail ( String  email )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                                  {
        GluuCustomPerson person = new GluuCustomPerson();
        person.setBaseDn(getDnForPerson(null));
        person.setMail(email);

        List<GluuCustomPerson> persons = ldapEntryManager.findEntries(person);

        return persons ;
    }

getPersonsByUid()

List<GluuCustomPerson> org.gluu.oxtrust.ldap.service.PersonService.getPersonsByUid ( String  uid )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                              {
        GluuCustomPerson person = new GluuCustomPerson();
        person.setBaseDn(getDnForPerson(null));
        person.setUid(uid);

        List<GluuCustomPerson> persons = ldapEntryManager.findEntries(person);

        return persons;
    }

getPersonUids()

String org.gluu.oxtrust.ldap.service.PersonService.getPersonUids ( List< GluuCustomPerson >  persons ) throws Exception

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                                                 {
        StringBuilder sb = new StringBuilder();

        for (Iterator<GluuCustomPerson> iterator = persons.iterator(); iterator.hasNext();) {
            GluuCustomPerson call = iterator.next();
            sb.append('\'').append(call.getUid()).append('\'');
            if (iterator.hasNext()) {
                sb.append(", ");
            }
        }
        return sb.toString();
    }

getUserByUid()

User org.gluu.oxtrust.ldap.service.PersonService.getUserByUid ( String  uid )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                         {

        User user = new User();

        user.setBaseDn(getDnForPerson(null));
        user.setUid(uid);

        List<User> users = ldapEntryManager.findEntries(user);// getLdapEntryManagerInstance().findEntries(person);
        if ((users != null) && (users.size() > 0)) {
            return users.get(0);
        }

        return null;
    }

removePerson()

void org.gluu.oxtrust.ldap.service.PersonService.removePerson ( GluuCustomPerson  person )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                      {
        // Remove person
        ldapEntryManager.removeRecursively(person.getDn());
    }

searchPersons() [1/3]

List<GluuCustomPerson> org.gluu.oxtrust.ldap.service.PersonService.searchPersons ( String  pattern, int  sizeLimit  )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                                               {
        String[] targetArray = new String[] { pattern };
        Filter uidFilter = Filter.createSubstringFilter(OxConstants.UID, null, targetArray, null);
        Filter mailFilter = Filter.createSubstringFilter(OxTrustConstants.mail, null, targetArray, null);
        Filter nameFilter = Filter.createSubstringFilter(OxTrustConstants.displayName, null, targetArray, null);
        Filter inameFilter = Filter.createSubstringFilter(OxTrustConstants.iname, null, targetArray, null);
        Filter searchFilter = Filter.createORFilter(uidFilter, mailFilter, nameFilter, inameFilter);

        List<GluuCustomPerson> result = ldapEntryManager.findEntries(getDnForPerson(null), GluuCustomPerson.class, searchFilter, sizeLimit);

        return result;
    }

searchPersons() [2/3]

List<GluuCustomPerson> org.gluu.oxtrust.ldap.service.PersonService.searchPersons ( String  pattern )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                                {
        String[] targetArray = new String[] { pattern };
        Filter uidFilter = Filter.createSubstringFilter(OxConstants.UID, null, targetArray, null);
        Filter mailFilter = Filter.createSubstringFilter(OxTrustConstants.mail, null, targetArray, null);
        Filter nameFilter = Filter.createSubstringFilter(OxTrustConstants.displayName, null, targetArray, null);
        Filter inameFilter = Filter.createSubstringFilter(OxTrustConstants.iname, null, targetArray, null);
        Filter ppidFilter = Filter.createSubstringFilter(OxTrustConstants.ppid, null, targetArray, null);
        Filter inumFilter = Filter.createSubstringFilter(OxTrustConstants.inum, null, targetArray, null);
        Filter searchFilter = Filter.createORFilter(uidFilter, mailFilter, nameFilter, inameFilter, ppidFilter, inumFilter);

        List<GluuCustomPerson> result = ldapEntryManager.findEntries(getDnForPerson(null), GluuCustomPerson.class, searchFilter);

        return result;
    }

searchPersons() [3/3]

List<GluuCustomPerson> org.gluu.oxtrust.ldap.service.PersonService.searchPersons ( String  pattern, int  sizeLimit, List< GluuCustomPerson >  excludedPersons  ) throws Exception

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                                                                                                        {
        String[] targetArray = new String[] { pattern };
        Filter uidFilter = Filter.createSubstringFilter(OxConstants.UID, null, targetArray, null);
        Filter mailFilter = Filter.createSubstringFilter(OxTrustConstants.mail, null, targetArray, null);
        Filter nameFilter = Filter.createSubstringFilter(OxTrustConstants.displayName, null, targetArray, null);
        Filter inameFilter = Filter.createSubstringFilter(OxTrustConstants.iname, null, targetArray, null);

        Filter orFilter = Filter.createORFilter(uidFilter, mailFilter, nameFilter, inameFilter);

        Filter searchFilter = orFilter;

        if (excludedPersons != null && excludedPersons.size() > 0) {
            List<Filter> excludeFilters = new ArrayList<Filter>();
            for (GluuCustomPerson excludedPerson : excludedPersons) {
                Filter eqFilter = Filter.createEqualityFilter(OxConstants.UID, excludedPerson.getUid());
                excludeFilters.add(eqFilter);
            }
            Filter orExcludeFilter = null;
            if (excludedPersons.size() == 1) {
                orExcludeFilter = excludeFilters.get(0);
            } else {
                orExcludeFilter = Filter.createORFilter(excludeFilters);
            }
            Filter notFilter = Filter.createNOTFilter(orExcludeFilter);
            searchFilter = Filter.createANDFilter(orFilter, notFilter);
        }

        List<GluuCustomPerson> result = ldapEntryManager.findEntries(getDnForPerson(null), GluuCustomPerson.class, searchFilter, sizeLimit);

        return result;

    }

updatePerson()

void org.gluu.oxtrust.ldap.service.PersonService.updatePerson ( GluuCustomPerson  person )

inline

org.gluu.oxtrust.ldap.service.IPersonServiceを実装しています。

                                                      {

        Date updateDate = new Date();
        person.setUpdatedAt(updateDate);
        //Update oxTrustMetaLastModified if it has been previously set
        if (person.getAttribute("oxTrustMetaLastModified") != null) {
            person.setAttribute("oxTrustMetaLastModified", ISODateTimeFormat.dateTime().withZoneUTC().print(updateDate.getTime()));
        }
        ldapEntryManager.merge(person);
    }

メンバ詳解

appConfiguration

AppConfiguration org.gluu.oxtrust.ldap.service.PersonService.appConfiguration

private

attributeService

AttributeService org.gluu.oxtrust.ldap.service.PersonService.attributeService

private

ldapEntryManager

PersistenceEntryManager org.gluu.oxtrust.ldap.service.PersonService.ldapEntryManager

private

log

Logger org.gluu.oxtrust.ldap.service.PersonService.log

private

mandatoryAttributes

List<GluuCustomAttribute> org.gluu.oxtrust.ldap.service.PersonService.mandatoryAttributes

private

organizationService

OrganizationService org.gluu.oxtrust.ldap.service.PersonService.organizationService

private

serialVersionUID

final long org.gluu.oxtrust.ldap.service.PersonService.serialVersionUID = 6685720517520443399L

staticprivate

---

このクラス詳解は次のファイルから抽出されました:

• D:/AppData/OpenId/gluu/src/oxTrust/server/src/main/java/org/gluu/oxtrust/ldap/service/PersonService.java