/* * Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package javax.naming.ldap; import javax.naming.Name;import javax.naming.InvalidNameException; import java.util.Enumeration;import java.util.Collection;import java.util.ArrayList;import java.util.List;import java.util.Iterator;import java.util.ListIterator;import java.util.Collections; import java.io.ObjectOutputStream;import java.io.ObjectInputStream;import java.io.IOException; /** * This class represents a distinguished name as specified by * <a href="http://www.ietf.org/rfc/rfc2253.txt">RFC 2253</a>. * A distinguished name, or DN, is composed of an ordered list of * components called <em>relative distinguished name</em>s, or RDNs. * Details of a DN's syntax are described in RFC 2253. *<p> * This class resolves a few ambiguities found in RFC 2253 * as follows: * <ul> * <li> RFC 2253 leaves the term "whitespace" undefined. The * ASCII space character 0x20 (" ") is used in its place. * <li> Whitespace is allowed on either side of ',', ';', '=', and '+'. * Such whitespace is accepted but not generated by this code, * and is ignored when comparing names. * <li> AttributeValue strings containing '=' or non-leading '#' * characters (unescaped) are accepted. * </ul> *<p> * String names passed to <code>LdapName</code> or returned by it * use the full Unicode character set. They may also contain * characters encoded into UTF-8 with each octet represented by a * three-character substring such as "\\B4". * They may not, however, contain characters encoded into UTF-8 with * each octet represented by a single character in the string: the * meaning would be ambiguous. *<p> * <code>LdapName</code> will properly parse all valid names, but * does not attempt to detect all possible violations when parsing * invalid names. It is "generous" in accepting invalid names. * The "validity" of a name is determined ultimately when it * is supplied to an LDAP server, which may accept or * reject the name based on factors such as its schema information * and interoperability considerations. *<p> * When names are tested for equality, attribute types, both binary * and string values, are case-insensitive. * String values with different but equivalent usage of quoting, * escaping, or UTF8-hex-encoding are considered equal. The order of * components in multi-valued RDNs (such as "ou=Sales+cn=Bob") is not * significant. * <p> * The components of a LDAP name, that is, RDNs, are numbered. The * indexes of a LDAP name with n RDNs range from 0 to n-1. * This range may be written as [0,n). * The right most RDN is at index 0, and the left most RDN is at * index n-1. For example, the distinguished name: * "CN=Steve Kille, O=Isode Limited, C=GB" is numbered in the following * sequence ranging from 0 to 2: {C=GB, O=Isode Limited, CN=Steve Kille}. An * empty LDAP name is represented by an empty RDN list. *<p> * Concurrent multithreaded read-only access of an instance of * <tt>LdapName</tt> need not be synchronized. *<p> * Unless otherwise noted, the behavior of passing a null argument * to a constructor or method in this class will cause a * NullPointerException to be thrown. * * @author Scott Seligman * @since 1.5 */ public class LdapName implements Name { // private transient ArrayList<Rdn> rdns; // parsed name components private transient ArrayList rdns; // parsed name components private transient String unparsed; // if non-null, the DN in unparsed form private static final long serialVersionUID = -1595520034788997356L; /** * Constructs an LDAP name from the given distinguished name. * * @param name This is a non-null distinguished name formatted * according to the rules defined in * <a href="http://www.ietf.org/rfc/rfc2253.txt">RFC 2253</a>. * * @throws InvalidNameException if a syntax violation is detected. * @see Rdn#escapeValue(Object value) */ public LdapName(String name) throws InvalidNameException { unparsed = name; parse(); } /** * Constructs an LDAP name given its parsed RDN components. * <p> * The indexing of RDNs in the list follows the numbering of * RDNs described in the class description. * * @param rdns The non-null list of <tt>Rdn</tt>s forming this LDAP name. */ public LdapName(List<Rdn> rdns) { // if (rdns instanceof ArrayList<Rdn>) { // this.rdns = rdns.clone(); // } else if (rdns instanceof List<Rdn>) { // this.rdns = new ArrayList<Rdn>(rdns); // } else { // throw IllegalArgumentException( // "Invalid entries, list entries must be of type Rdn"); // } this.rdns = new ArrayList(rdns.size()); for (int i = 0; i < rdns.size(); i++) { Object obj = rdns.get(i); if (!(obj instanceof Rdn)) { throw new IllegalArgumentException("Entry:" + obj + " not a valid type;list entries must be of type Rdn"); } this.rdns.add(obj); } } /* * Constructs an LDAP name given its parsed components (the elements * of "rdns" in the range [beg,end)) and, optionally * (if "name" is not null), the unparsed DN. * */ // private LdapName(String name, List<Rdn> rdns, int beg, int end) { private LdapName(String name, ArrayList rdns, int beg, int end) { unparsed = name; // this.rdns = rdns.subList(beg, end); List sList = rdns.subList(beg, end); this.rdns = new ArrayList(sList); } /** * Retrieves the number of components in this LDAP name. * @return The non-negative number of components in this LDAP name. */ public int size() { return rdns.size(); } /** * Determines whether this LDAP name is empty. * An empty name is one with zero components. * @return true if this LDAP name is empty, false otherwise. */ public boolean isEmpty() { return rdns.isEmpty(); } /** * Retrieves the components of this name as an enumeration * of strings. The effect of updates to this name on this enumeration * is undefined. If the name has zero components, an empty (non-null) * enumeration is returned. * The order of the components returned by the enumeration is same as * the order in which the components are numbered as described in the * class description. * * @return A non-null enumeration of the components of this LDAP name. * Each element of the enumeration is of class String. */ public Enumeration<String> getAll() { final Iterator iter = rdns.iterator(); return new Enumeration<String>() { public boolean hasMoreElements() { return iter.hasNext(); } public String nextElement() { return iter.next().toString(); } }; } /** * Retrieves a component of this LDAP name as a string. * @param posn The 0-based index of the component to retrieve. * Must be in the range [0,size()). * @return The non-null component at index posn. * @exception IndexOutOfBoundsException if posn is outside the * specified range. */ public String get(int posn) { return rdns.get(posn).toString(); } /** * Retrieves an RDN of this LDAP name as an Rdn. * @param posn The 0-based index of the RDN to retrieve. * Must be in the range [0,size()). * @return The non-null RDN at index posn. * @exception IndexOutOfBoundsException if posn is outside the * specified range. */ public Rdn getRdn(int posn) { return (Rdn) rdns.get(posn); } /** * Creates a name whose components consist of a prefix of the * components of this LDAP name. * Subsequent changes to this name will not affect the name * that is returned and vice versa. * @param posn The 0-based index of the component at which to stop. * Must be in the range [0,size()]. * @return An instance of <tt>LdapName</tt> consisting of the * components at indexes in the range [0,posn). * If posn is zero, an empty LDAP name is returned. * @exception IndexOutOfBoundsException * If posn is outside the specified range. */ public Name getPrefix(int posn) { try { return new LdapName(null, rdns, 0, posn); } catch (IllegalArgumentException e) { throw new IndexOutOfBoundsException( "Posn: " + posn + ", Size: "+ rdns.size()); } } /** * Creates a name whose components consist of a suffix of the * components in this LDAP name. * Subsequent changes to this name do not affect the name that is * returned and vice versa. * * @param posn The 0-based index of the component at which to start. * Must be in the range [0,size()]. * @return An instance of <tt>LdapName</tt> consisting of the * components at indexes in the range [posn,size()). * If posn is equal to size(), an empty LDAP name is * returned. * @exception IndexOutOfBoundsException * If posn is outside the specified range. */ public Name getSuffix(int posn) { try { return new LdapName(null, rdns, posn, rdns.size()); } catch (IllegalArgumentException e) { throw new IndexOutOfBoundsException( "Posn: " + posn + ", Size: "+ rdns.size()); } } /** * Determines whether this LDAP name starts with a specified LDAP name * prefix. * A name <tt>n</tt> is a prefix if it is equal to * <tt>getPrefix(n.size())</tt>--in other words this LDAP * name starts with 'n'. If n is null or not a RFC2253 formatted name * as described in the class description, false is returned. * * @param n The LDAP name to check. * @return true if <tt>n</tt> is a prefix of this LDAP name, * false otherwise. * @see #getPrefix(int posn) */ public boolean startsWith(Name n) { if (n == null) { return false; } int len1 = rdns.size(); int len2 = n.size(); return (len1 >= len2 && matches(0, len2, n)); } /** * Determines whether the specified RDN sequence forms a prefix of this * LDAP name. Returns true if this LdapName is at least as long as rdns, * and for every position p in the range [0, rdns.size()) the component * getRdn(p) matches rdns.get(p). Returns false otherwise. If rdns is * null, false is returned. * * @param rdns The sequence of <tt>Rdn</tt>s to check. * @return true if <tt>rdns</tt> form a prefix of this LDAP name, * false otherwise. */ public boolean startsWith(List<Rdn> rdns) { if (rdns == null) { return false; } int len1 = this.rdns.size(); int len2 = rdns.size(); return (len1 >= len2 && doesListMatch(0, len2, rdns)); } /** * Determines whether this LDAP name ends with a specified * LDAP name suffix. * A name <tt>n</tt> is a suffix if it is equal to * <tt>getSuffix(size()-n.size())</tt>--in other words this LDAP * name ends with 'n'. If n is null or not a RFC2253 formatted name * as described in the class description, false is returned. * * @param n The LDAP name to check. * @return true if <tt>n</tt> is a suffix of this name, false otherwise. * @see #getSuffix(int posn) */ public boolean endsWith(Name n) { if (n == null) { return false; } int len1 = rdns.size(); int len2 = n.size(); return (len1 >= len2 && matches(len1 - len2, len1, n)); } /** * Determines whether the specified RDN sequence forms a suffix of this * LDAP name. Returns true if this LdapName is at least as long as rdns, * and for every position p in the range [size() - rdns.size(), size()) * the component getRdn(p) matches rdns.get(p). Returns false otherwise. * If rdns is null, false is returned. * * @param rdns The sequence of <tt>Rdn</tt>s to check. * @return true if <tt>rdns</tt> form a suffix of this LDAP name, * false otherwise. */ public boolean endsWith(List<Rdn> rdns) { if (rdns == null) { return false; } int len1 = this.rdns.size(); int len2 = rdns.size(); return (len1 >= len2 && doesListMatch(len1 - len2, len1, rdns)); } private boolean doesListMatch(int beg, int end, List rdns) { for (int i = beg; i < end; i++) { if (!this.rdns.get(i).equals(rdns.get(i - beg))) { return false; } } return true; } /* * Helper method for startsWith() and endsWith(). * Returns true if components [beg,end) match the components of "n". * If "n" is not an LdapName, each of its components is parsed as * the string form of an RDN. * The following must hold: end - beg == n.size(). */ private boolean matches(int beg, int end, Name n) { if (n instanceof LdapName) { LdapName ln = (LdapName) n; return doesListMatch(beg, end, ln.rdns); } else { for (int i = beg; i < end; i++) { Rdn rdn; String rdnString = n.get(i - beg); try { rdn = (new Rfc2253Parser(rdnString)).parseRdn(); } catch (InvalidNameException e) { return false; } if (!rdn.equals(rdns.get(i))) { return false; } } } return true; } /** * Adds the components of a name -- in order -- to the end of this name. * * @param suffix The non-null components to add. * @return The updated name (not a new instance). * * @throws InvalidNameException if <tt>suffix</tt> is not a valid LDAP * name, or if the addition of the components would violate the * syntax rules of this LDAP name. */ public Name addAll(Name suffix) throws InvalidNameException { return addAll(size(), suffix); } /** * Adds the RDNs of a name -- in order -- to the end of this name. * * @param suffixRdns The non-null suffix <tt>Rdn</tt>s to add. * @return The updated name (not a new instance). */ public Name addAll(List<Rdn> suffixRdns) { return addAll(size(), suffixRdns); } /** * Adds the components of a name -- in order -- at a specified position * within this name. Components of this LDAP name at or after the * index (if any) of the first new component are shifted up * (away from index 0) to accomodate the new components. * * @param suffix The non-null components to add. * @param posn The index at which to add the new component. * Must be in the range [0,size()]. * * @return The updated name (not a new instance). * * @throws InvalidNameException if <tt>suffix</tt> is not a valid LDAP * name, or if the addition of the components would violate the * syntax rules of this LDAP name. * @throws IndexOutOfBoundsException. * If posn is outside the specified range. */ public Name addAll(int posn, Name suffix) throws InvalidNameException { unparsed = null; // no longer valid if (suffix instanceof LdapName) { LdapName s = (LdapName) suffix; rdns.addAll(posn, s.rdns); } else { Enumeration comps = suffix.getAll(); while (comps.hasMoreElements()) { rdns.add(posn++, (new Rfc2253Parser((String) comps.nextElement()). parseRdn())); } } return this; } /** * Adds the RDNs of a name -- in order -- at a specified position * within this name. RDNs of this LDAP name at or after the * index (if any) of the first new RDN are shifted up (away from index 0) to * accomodate the new RDNs. * * @param suffixRdns The non-null suffix <tt>Rdn</tt>s to add. * @param posn The index at which to add the suffix RDNs. * Must be in the range [0,size()]. * * @return The updated name (not a new instance). * @throws IndexOutOfBoundsException. * If posn is outside the specified range. */ public Name addAll(int posn, List<Rdn> suffixRdns) { unparsed = null; for (int i = 0; i < suffixRdns.size(); i++) { Object obj = suffixRdns.get(i); if (!(obj instanceof Rdn)) { throw new IllegalArgumentException("Entry:" + obj + " not a valid type;suffix list entries must be of type Rdn"); } rdns.add(i + posn, obj); } return this; } /** * Adds a single component to the end of this LDAP name. * * @param comp The non-null component to add.Lines 1–500 of 791. Load more
/* * Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package javax.naming.ldap; import javax.naming.Name; import javax.naming.InvalidNameException; import java.util.Enumeration; import java.util.Collection; import java.util.ArrayList; import java.util.List; import java.util.Iterator; import java.util.ListIterator; import java.util.Collections; import java.io.ObjectOutputStream; import java.io.ObjectInputStream; import java.io.IOException; /** * This class represents a distinguished name as specified by * <a href="http://www.ietf.org/rfc/rfc2253.txt">RFC 2253</a>. * A distinguished name, or DN, is composed of an ordered list of * components called <em>relative distinguished name</em>s, or RDNs. * Details of a DN's syntax are described in RFC 2253. *<p> * This class resolves a few ambiguities found in RFC 2253 * as follows: * <ul> * <li> RFC 2253 leaves the term "whitespace" undefined. The * ASCII space character 0x20 (" ") is used in its place. * <li> Whitespace is allowed on either side of ',', ';', '=', and '+'. * Such whitespace is accepted but not generated by this code, * and is ignored when comparing names. * <li> AttributeValue strings containing '=' or non-leading '#' * characters (unescaped) are accepted. * </ul> *<p> * String names passed to <code>LdapName</code> or returned by it * use the full Unicode character set. They may also contain * characters encoded into UTF-8 with each octet represented by a * three-character substring such as "\\B4". * They may not, however, contain characters encoded into UTF-8 with * each octet represented by a single character in the string: the * meaning would be ambiguous. *<p> * <code>LdapName</code> will properly parse all valid names, but * does not attempt to detect all possible violations when parsing * invalid names. It is "generous" in accepting invalid names. * The "validity" of a name is determined ultimately when it * is supplied to an LDAP server, which may accept or * reject the name based on factors such as its schema information * and interoperability considerations. *<p> * When names are tested for equality, attribute types, both binary * and string values, are case-insensitive. * String values with different but equivalent usage of quoting, * escaping, or UTF8-hex-encoding are considered equal. The order of * components in multi-valued RDNs (such as "ou=Sales+cn=Bob") is not * significant. * <p> * The components of a LDAP name, that is, RDNs, are numbered. The * indexes of a LDAP name with n RDNs range from 0 to n-1. * This range may be written as [0,n). * The right most RDN is at index 0, and the left most RDN is at * index n-1. For example, the distinguished name: * "CN=Steve Kille, O=Isode Limited, C=GB" is numbered in the following * sequence ranging from 0 to 2: {C=GB, O=Isode Limited, CN=Steve Kille}. An * empty LDAP name is represented by an empty RDN list. *<p> * Concurrent multithreaded read-only access of an instance of * <tt>LdapName</tt> need not be synchronized. *<p> * Unless otherwise noted, the behavior of passing a null argument * to a constructor or method in this class will cause a * NullPointerException to be thrown. * * @author Scott Seligman * @since 1.5 */ public class LdapName implements Name { // private transient ArrayList<Rdn> rdns; // parsed name components private transient ArrayList rdns; // parsed name components private transient String unparsed; // if non-null, the DN in unparsed form private static final long serialVersionUID = -1595520034788997356L; /** * Constructs an LDAP name from the given distinguished name. * * @param name This is a non-null distinguished name formatted * according to the rules defined in * <a href="http://www.ietf.org/rfc/rfc2253.txt">RFC 2253</a>. * * @throws InvalidNameException if a syntax violation is detected. * @see Rdn#escapeValue(Object value) */ public LdapName(String name) throws InvalidNameException { unparsed = name; parse(); } /** * Constructs an LDAP name given its parsed RDN components. * <p> * The indexing of RDNs in the list follows the numbering of * RDNs described in the class description. * * @param rdns The non-null list of <tt>Rdn</tt>s forming this LDAP name. */ public LdapName(List<Rdn> rdns) { // if (rdns instanceof ArrayList<Rdn>) { // this.rdns = rdns.clone(); // } else if (rdns instanceof List<Rdn>) { // this.rdns = new ArrayList<Rdn>(rdns); // } else { // throw IllegalArgumentException( // "Invalid entries, list entries must be of type Rdn"); // } this.rdns = new ArrayList(rdns.size()); for (int i = 0; i < rdns.size(); i++) { Object obj = rdns.get(i); if (!(obj instanceof Rdn)) { throw new IllegalArgumentException("Entry:" + obj + " not a valid type;list entries must be of type Rdn"); } this.rdns.add(obj); } } /* * Constructs an LDAP name given its parsed components (the elements * of "rdns" in the range [beg,end)) and, optionally * (if "name" is not null), the unparsed DN. * */ // private LdapName(String name, List<Rdn> rdns, int beg, int end) { private LdapName(String name, ArrayList rdns, int beg, int end) { unparsed = name; // this.rdns = rdns.subList(beg, end); List sList = rdns.subList(beg, end); this.rdns = new ArrayList(sList); } /** * Retrieves the number of components in this LDAP name. * @return The non-negative number of components in this LDAP name. */ public int size() { return rdns.size(); } /** * Determines whether this LDAP name is empty. * An empty name is one with zero components. * @return true if this LDAP name is empty, false otherwise. */ public boolean isEmpty() { return rdns.isEmpty(); } /** * Retrieves the components of this name as an enumeration * of strings. The effect of updates to this name on this enumeration * is undefined. If the name has zero components, an empty (non-null) * enumeration is returned. * The order of the components returned by the enumeration is same as * the order in which the components are numbered as described in the * class description. * * @return A non-null enumeration of the components of this LDAP name. * Each element of the enumeration is of class String. */ public Enumeration<String> getAll() { final Iterator iter = rdns.iterator(); return new Enumeration<String>() { public boolean hasMoreElements() { return iter.hasNext(); } public String nextElement() { return iter.next().toString(); } }; } /** * Retrieves a component of this LDAP name as a string. * @param posn The 0-based index of the component to retrieve. * Must be in the range [0,size()). * @return The non-null component at index posn. * @exception IndexOutOfBoundsException if posn is outside the * specified range. */ public String get(int posn) { return rdns.get(posn).toString(); } /** * Retrieves an RDN of this LDAP name as an Rdn. * @param posn The 0-based index of the RDN to retrieve. * Must be in the range [0,size()). * @return The non-null RDN at index posn. * @exception IndexOutOfBoundsException if posn is outside the * specified range. */ public Rdn getRdn(int posn) { return (Rdn) rdns.get(posn); } /** * Creates a name whose components consist of a prefix of the * components of this LDAP name. * Subsequent changes to this name will not affect the name * that is returned and vice versa. * @param posn The 0-based index of the component at which to stop. * Must be in the range [0,size()]. * @return An instance of <tt>LdapName</tt> consisting of the * components at indexes in the range [0,posn). * If posn is zero, an empty LDAP name is returned. * @exception IndexOutOfBoundsException * If posn is outside the specified range. */ public Name getPrefix(int posn) { try { return new LdapName(null, rdns, 0, posn); } catch (IllegalArgumentException e) { throw new IndexOutOfBoundsException( "Posn: " + posn + ", Size: "+ rdns.size()); } } /** * Creates a name whose components consist of a suffix of the * components in this LDAP name. * Subsequent changes to this name do not affect the name that is * returned and vice versa. * * @param posn The 0-based index of the component at which to start. * Must be in the range [0,size()]. * @return An instance of <tt>LdapName</tt> consisting of the * components at indexes in the range [posn,size()). * If posn is equal to size(), an empty LDAP name is * returned. * @exception IndexOutOfBoundsException * If posn is outside the specified range. */ public Name getSuffix(int posn) { try { return new LdapName(null, rdns, posn, rdns.size()); } catch (IllegalArgumentException e) { throw new IndexOutOfBoundsException( "Posn: " + posn + ", Size: "+ rdns.size()); } } /** * Determines whether this LDAP name starts with a specified LDAP name * prefix. * A name <tt>n</tt> is a prefix if it is equal to * <tt>getPrefix(n.size())</tt>--in other words this LDAP * name starts with 'n'. If n is null or not a RFC2253 formatted name * as described in the class description, false is returned. * * @param n The LDAP name to check. * @return true if <tt>n</tt> is a prefix of this LDAP name, * false otherwise. * @see #getPrefix(int posn) */ public boolean startsWith(Name n) { if (n == null) { return false; } int len1 = rdns.size(); int len2 = n.size(); return (len1 >= len2 && matches(0, len2, n)); } /** * Determines whether the specified RDN sequence forms a prefix of this * LDAP name. Returns true if this LdapName is at least as long as rdns, * and for every position p in the range [0, rdns.size()) the component * getRdn(p) matches rdns.get(p). Returns false otherwise. If rdns is * null, false is returned. * * @param rdns The sequence of <tt>Rdn</tt>s to check. * @return true if <tt>rdns</tt> form a prefix of this LDAP name, * false otherwise. */ public boolean startsWith(List<Rdn> rdns) { if (rdns == null) { return false; } int len1 = this.rdns.size(); int len2 = rdns.size(); return (len1 >= len2 && doesListMatch(0, len2, rdns)); } /** * Determines whether this LDAP name ends with a specified * LDAP name suffix. * A name <tt>n</tt> is a suffix if it is equal to * <tt>getSuffix(size()-n.size())</tt>--in other words this LDAP * name ends with 'n'. If n is null or not a RFC2253 formatted name * as described in the class description, false is returned. * * @param n The LDAP name to check. * @return true if <tt>n</tt> is a suffix of this name, false otherwise. * @see #getSuffix(int posn) */ public boolean endsWith(Name n) { if (n == null) { return false; } int len1 = rdns.size(); int len2 = n.size(); return (len1 >= len2 && matches(len1 - len2, len1, n)); } /** * Determines whether the specified RDN sequence forms a suffix of this * LDAP name. Returns true if this LdapName is at least as long as rdns, * and for every position p in the range [size() - rdns.size(), size()) * the component getRdn(p) matches rdns.get(p). Returns false otherwise. * If rdns is null, false is returned. * * @param rdns The sequence of <tt>Rdn</tt>s to check. * @return true if <tt>rdns</tt> form a suffix of this LDAP name, * false otherwise. */ public boolean endsWith(List<Rdn> rdns) { if (rdns == null) { return false; } int len1 = this.rdns.size(); int len2 = rdns.size(); return (len1 >= len2 && doesListMatch(len1 - len2, len1, rdns)); } private boolean doesListMatch(int beg, int end, List rdns) { for (int i = beg; i < end; i++) { if (!this.rdns.get(i).equals(rdns.get(i - beg))) { return false; } } return true; } /* * Helper method for startsWith() and endsWith(). * Returns true if components [beg,end) match the components of "n". * If "n" is not an LdapName, each of its components is parsed as * the string form of an RDN. * The following must hold: end - beg == n.size(). */ private boolean matches(int beg, int end, Name n) { if (n instanceof LdapName) { LdapName ln = (LdapName) n; return doesListMatch(beg, end, ln.rdns); } else { for (int i = beg; i < end; i++) { Rdn rdn; String rdnString = n.get(i - beg); try { rdn = (new Rfc2253Parser(rdnString)).parseRdn(); } catch (InvalidNameException e) { return false; } if (!rdn.equals(rdns.get(i))) { return false; } } } return true; } /** * Adds the components of a name -- in order -- to the end of this name. * * @param suffix The non-null components to add. * @return The updated name (not a new instance). * * @throws InvalidNameException if <tt>suffix</tt> is not a valid LDAP * name, or if the addition of the components would violate the * syntax rules of this LDAP name. */ public Name addAll(Name suffix) throws InvalidNameException { return addAll(size(), suffix); } /** * Adds the RDNs of a name -- in order -- to the end of this name. * * @param suffixRdns The non-null suffix <tt>Rdn</tt>s to add. * @return The updated name (not a new instance). */ public Name addAll(List<Rdn> suffixRdns) { return addAll(size(), suffixRdns); } /** * Adds the components of a name -- in order -- at a specified position * within this name. Components of this LDAP name at or after the * index (if any) of the first new component are shifted up * (away from index 0) to accomodate the new components. * * @param suffix The non-null components to add. * @param posn The index at which to add the new component. * Must be in the range [0,size()]. * * @return The updated name (not a new instance). * * @throws InvalidNameException if <tt>suffix</tt> is not a valid LDAP * name, or if the addition of the components would violate the * syntax rules of this LDAP name. * @throws IndexOutOfBoundsException. * If posn is outside the specified range. */ public Name addAll(int posn, Name suffix) throws InvalidNameException { unparsed = null; // no longer valid if (suffix instanceof LdapName) { LdapName s = (LdapName) suffix; rdns.addAll(posn, s.rdns); } else { Enumeration comps = suffix.getAll(); while (comps.hasMoreElements()) { rdns.add(posn++, (new Rfc2253Parser((String) comps.nextElement()). parseRdn())); } } return this; } /** * Adds the RDNs of a name -- in order -- at a specified position * within this name. RDNs of this LDAP name at or after the * index (if any) of the first new RDN are shifted up (away from index 0) to * accomodate the new RDNs. * * @param suffixRdns The non-null suffix <tt>Rdn</tt>s to add. * @param posn The index at which to add the suffix RDNs. * Must be in the range [0,size()]. * * @return The updated name (not a new instance). * @throws IndexOutOfBoundsException. * If posn is outside the specified range. */ public Name addAll(int posn, List<Rdn> suffixRdns) { unparsed = null; for (int i = 0; i < suffixRdns.size(); i++) { Object obj = suffixRdns.get(i); if (!(obj instanceof Rdn)) { throw new IllegalArgumentException("Entry:" + obj + " not a valid type;suffix list entries must be of type Rdn"); } rdns.add(i + posn, obj); } return this; } /** * Adds a single component to the end of this LDAP name. * * @param comp The non-null component to add.