0N/A * The contents of this file are subject to the terms of the 0N/A * Common Development and Distribution License, Version 1.0 only 0N/A * (the "License"). You may not use this file except in compliance 0N/A * You can obtain a copy of the license at 0N/A * See the License for the specific language governing permissions 0N/A * and limitations under the License. 0N/A * When distributing Covered Code, include this CDDL HEADER in each 0N/A * file and include the License file at 0N/A * add the following below this CDDL HEADER, with the fields enclosed 873N/A * by brackets "[]" replaced with your own identifying information: 0N/A * Portions Copyright [yyyy] [name of copyright owner] 3231N/A * Copyright 2006-2008 Sun Microsystems, Inc. 5866N/A * Portions Copyright 2012 ForgeRock AS 0N/A * This class defines the directory string attribute syntax, which is simply a 0N/A * set of UTF-8 characters. By default, they will be treated in a 0N/A * case-insensitive manner, and equality, ordering, substring, and approximate 0N/A * matching will be allowed. 0N/A // The default approximate matching rule for this syntax. 0N/A // Indicates whether we will allow zero-length values. 1617N/A // The reference to the configuration for this directory string syntax. 0N/A // The default equality matching rule for this syntax. 0N/A // The default ordering matching rule for this syntax. 0N/A // The default substring matching rule for this syntax. 0N/A * A {@link String} attribute value decoder for this syntax. 0N/A // Make sure that the value is valid. 0N/A * Creates a new instance of this syntax. Note that the only thing that 0N/A * should be done here is to invoke the default constructor for the 0N/A * superclass. All initialization should be performed in the 0N/A * <CODE>initializeSyntax</CODE> method. 0N/A // This syntax is one of the Directory Server's core syntaxes and therefore 0N/A // it may be instantiated at times without a configuration entry. If that 0N/A // is the case, then we'll exit now before doing anything that could require 0N/A // access to that entry. 0N/A * Performs any finalization that may be necessary for this attribute syntax. 0N/A * Retrieves the common name for this attribute syntax. 0N/A * @return The common name for this attribute syntax. 0N/A * Retrieves the OID for this attribute syntax. 0N/A * @return The OID for this attribute syntax. 0N/A * Retrieves a description for this attribute syntax. 0N/A * @return A description for this attribute syntax. 0N/A * Retrieves the default equality matching rule that will be used for 0N/A * attributes with this syntax. 0N/A * @return The default equality matching rule that will be used for 0N/A * attributes with this syntax, or <CODE>null</CODE> if equality 0N/A * matches will not be allowed for this type by default. 0N/A * Retrieves the default ordering matching rule that will be used for 0N/A * attributes with this syntax. 0N/A * @return The default ordering matching rule that will be used for 0N/A * attributes with this syntax, or <CODE>null</CODE> if ordering 0N/A * matches will not be allowed for this type by default. 0N/A * Retrieves the default substring matching rule that will be used for 0N/A * attributes with this syntax. 0N/A * @return The default substring matching rule that will be used for 0N/A * attributes with this syntax, or <CODE>null</CODE> if substring 0N/A * matches will not be allowed for this type by default. 0N/A * Retrieves the default approximate matching rule that will be used for 0N/A * attributes with this syntax. 0N/A * @return The default approximate matching rule that will be used for 0N/A * attributes with this syntax, or <CODE>null</CODE> if approximate 0N/A * matches will not be allowed for this type by default. 0N/A * Indicates whether the provided value is acceptable for use in an attribute 0N/A * with this syntax. If it is not, then the reason may be appended to the 0N/A * @param value The value for which to make the determination. 0N/A * @param invalidReason The buffer to which the invalid reason should be 0N/A * @return <CODE>true</CODE> if the provided value is acceptable for use with 0N/A * this syntax, or <CODE>false</CODE> if not. 0N/A * Indicates whether zero-length values will be allowed. This is technically 0N/A * forbidden by the LDAP specification, but it was allowed in earlier versions 0N/A * of the server, and the discussion of the directory string syntax in RFC 0N/A * 2252 does not explicitly state that they are not allowed. 0N/A * @return <CODE>true</CODE> if zero-length values should be allowed for 0N/A * attributes with a directory string syntax, or <CODE>false</CODE> 1617N/A // The configuration will always be acceptable.