org.springframework.ldap.core.LdapEntryIdentification Maven / Gradle / Ivy
/*
* Copyright 2005-2010 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.springframework.ldap.core;
import javax.naming.directory.DirContext;
import org.springframework.util.Assert;
/**
* Wrapper class to handle the full identification of an LDAP entry. An LDAP
* entry is identified by its Distinguished Name, in Spring LDAP represented by
* the {@link DistinguishedName} class. A Distinguished Name can be absolute -
* i.e. complete including the very root (base) of the LDAP tree - or relative -
* i.e relative to the base LDAP path of the current LDAP connection (specified
* as base
to the {@link ContextSource}).
*
* The different representations are needed on different occasions, e.g. the
* relative DN is typically what is needed to perform lookups and searches in
* the LDAP tree, whereas the absolute DN is needed when authenticating and when
* an LDAP entry is referred to in e.g. a group. This wrapper class contains
* both of these representations.
*
* @author Mattias Hellborg Arthursson
*/
public class LdapEntryIdentification {
private final DistinguishedName relativeDn;
private final DistinguishedName absoluteDn;
/**
* Construct an LdapEntryIdentification instance.
* @param absoluteDn the absolute DN of the identified entry, e.g. as
* returned by {@link DirContext#getNameInNamespace()}.
* @param relativeDn the DN of the identified entry relative to the base
* LDAP path, e.g. as returned by {@link DirContextOperations#getDn()}.
*/
public LdapEntryIdentification(DistinguishedName absoluteDn, DistinguishedName relativeDn) {
Assert.notNull(absoluteDn, "Absolute DN must not be null");
Assert.notNull(relativeDn, "Relative DN must not be null");
this.absoluteDn = absoluteDn.immutableDistinguishedName();
this.relativeDn = relativeDn.immutableDistinguishedName();
}
/**
* Get the DN of the identified entry relative to the base LDAP path, e.g.
* as returned by {@link DirContextOperations#getDn()}.
* @return the relative DN.
*/
public DistinguishedName getRelativeDn() {
return relativeDn;
}
/**
* Get the absolute DN of the identified entry, e.g. as returned by
* {@link DirContext#getNameInNamespace()}.
* @return the absolute DN.
*/
public DistinguishedName getAbsoluteDn() {
return absoluteDn;
}
public boolean equals(Object obj) {
if (obj != null && obj.getClass().equals(this.getClass())) {
LdapEntryIdentification that = (LdapEntryIdentification) obj;
return this.absoluteDn.equals(that.absoluteDn) && this.relativeDn.equals(that.relativeDn);
}
return false;
}
public int hashCode() {
return absoluteDn.hashCode() ^ relativeDn.hashCode();
}
}