/* * CDDL HEADER START * * The contents of this file are subject to the terms of the * Common Development and Distribution License, Version 1.0 only * (the "License"). You may not use this file except in compliance * with the License. * * You can obtain a copy of the license at * trunk/opends/resource/legal-notices/OpenDS.LICENSE * or https://OpenDS.dev.java.net/OpenDS.LICENSE. * See the License for the specific language governing permissions * and limitations under the License. * * When distributing Covered Code, include this CDDL HEADER in each * file and include the License file at * trunk/opends/resource/legal-notices/OpenDS.LICENSE. If applicable, * add the following below this CDDL HEADER, with the fields enclosed * by brackets "[]" replaced with your own identifying information: * Portions Copyright [yyyy] [name of copyright owner] * * CDDL HEADER END * * * Copyright 2009 Sun Microsystems, Inc. */ package org.opends.sdk; import static com.sun.opends.sdk.messages.Messages.*; import java.util.Arrays; import java.util.Collections; import java.util.List; /** * An operation result code as defined in RFC 4511 section 4.1.9 is used to * indicate the final status of an operation. If a server detects multiple * errors for an operation, only one result code is returned. The server should * return the result code that best indicates the nature of the error * encountered. Servers may return substituted result codes to prevent * unauthorized disclosures. * * @see RFC 4511 - * Lightweight Directory Access Protocol (LDAP): The Protocol */ public final class ResultCode { private static final ResultCode[] ELEMENTS = new ResultCode[16655]; private static final List IMMUTABLE_ELEMENTS = Collections .unmodifiableList(Arrays.asList(ELEMENTS)); /** * The result code that indicates that the operation completed successfully. */ public static final ResultCode SUCCESS = registerSuccessResultCode(0, INFO_RESULT_SUCCESS.get()); /** * The result code that indicates that an internal error prevented the * operation from being processed properly. */ public static final ResultCode OPERATIONS_ERROR = registerErrorResultCode(1, INFO_RESULT_OPERATIONS_ERROR.get()); /** * The result code that indicates that the client sent a malformed or illegal * request to the server. */ public static final ResultCode PROTOCOL_ERROR = registerErrorResultCode(2, INFO_RESULT_PROTOCOL_ERROR.get()); /** * The result code that indicates that a time limit was exceeded while * attempting to process the request. */ public static final ResultCode TIME_LIMIT_EXCEEDED = registerErrorResultCode( 3, INFO_RESULT_TIME_LIMIT_EXCEEDED.get()); /** * The result code that indicates that a size limit was exceeded while * attempting to process the request. */ public static final ResultCode SIZE_LIMIT_EXCEEDED = registerErrorResultCode( 4, INFO_RESULT_SIZE_LIMIT_EXCEEDED.get()); /** * The result code that indicates that the attribute value assertion included * in a compare request did not match the targeted entry. */ public static final ResultCode COMPARE_FALSE = registerSuccessResultCode(5, INFO_RESULT_COMPARE_FALSE.get()); /** * The result code that indicates that the attribute value assertion included * in a compare request did match the targeted entry. */ public static final ResultCode COMPARE_TRUE = registerSuccessResultCode(6, INFO_RESULT_COMPARE_TRUE.get()); /** * The result code that indicates that the requested authentication attempt * failed because it referenced an invalid SASL mechanism. */ public static final ResultCode AUTH_METHOD_NOT_SUPPORTED = registerErrorResultCode( 7, INFO_RESULT_AUTH_METHOD_NOT_SUPPORTED.get()); /** * The result code that indicates that the requested operation could not be * processed because it requires that the client has completed a strong form * of authentication. */ public static final ResultCode STRONG_AUTH_REQUIRED = registerErrorResultCode( 8, INFO_RESULT_STRONG_AUTH_REQUIRED.get()); /** * The result code that indicates that a referral was encountered. *

* Strictly speaking this result code should not be exceptional since it is * considered as a "success" response. However, referrals should occur rarely * in practice and, when they do occur, should not be ignored since the * application may believe that a request has succeeded when, in fact, nothing * was done. */ public static final ResultCode REFERRAL = registerErrorResultCode(10, INFO_RESULT_REFERRAL.get()); /** * The result code that indicates that processing on the requested operation * could not continue because an administrative limit was exceeded. */ public static final ResultCode ADMIN_LIMIT_EXCEEDED = registerErrorResultCode( 11, INFO_RESULT_ADMIN_LIMIT_EXCEEDED.get()); /** * The result code that indicates that the requested operation failed because * it included a critical extension that is unsupported or inappropriate for * that request. */ public static final ResultCode UNAVAILABLE_CRITICAL_EXTENSION = registerErrorResultCode( 12, INFO_RESULT_UNAVAILABLE_CRITICAL_EXTENSION.get()); /** * The result code that indicates that the requested operation could not be * processed because it requires confidentiality for the communication between * the client and the server. */ public static final ResultCode CONFIDENTIALITY_REQUIRED = registerErrorResultCode( 13, INFO_RESULT_CONFIDENTIALITY_REQUIRED.get()); /** * The result code that should be used for intermediate responses in * multi-stage SASL bind operations. */ public static final ResultCode SASL_BIND_IN_PROGRESS = registerSuccessResultCode( 14, INFO_RESULT_SASL_BIND_IN_PROGRESS.get()); /** * The result code that indicates that the requested operation failed because * it targeted an attribute or attribute value that did not exist in the * specified entry. */ public static final ResultCode NO_SUCH_ATTRIBUTE = registerErrorResultCode( 16, INFO_RESULT_NO_SUCH_ATTRIBUTE.get()); /** * The result code that indicates that the requested operation failed because * it referenced an attribute that is not defined in the server schema. */ public static final ResultCode UNDEFINED_ATTRIBUTE_TYPE = registerErrorResultCode( 17, INFO_RESULT_UNDEFINED_ATTRIBUTE_TYPE.get()); /** * The result code that indicates that the requested operation failed because * it attempted to perform an inappropriate type of matching against an * attribute. */ public static final ResultCode INAPPROPRIATE_MATCHING = registerErrorResultCode( 18, INFO_RESULT_INAPPROPRIATE_MATCHING.get()); /** * The result code that indicates that the requested operation failed because * it would have violated some constraint defined in the server. */ public static final ResultCode CONSTRAINT_VIOLATION = registerErrorResultCode( 19, INFO_RESULT_CONSTRAINT_VIOLATION.get()); /** * The result code that indicates that the requested operation failed because * it would have resulted in a conflict with an existing attribute or * attribute value in the target entry. */ public static final ResultCode ATTRIBUTE_OR_VALUE_EXISTS = registerErrorResultCode( 20, INFO_RESULT_ATTRIBUTE_OR_VALUE_EXISTS.get()); /** * The result code that indicates that the requested operation failed because * it violated the syntax for a specified attribute. */ public static final ResultCode INVALID_ATTRIBUTE_SYNTAX = registerErrorResultCode( 21, INFO_RESULT_INVALID_ATTRIBUTE_SYNTAX.get()); /** * The result code that indicates that the requested operation failed because * it referenced an entry that does not exist. */ public static final ResultCode NO_SUCH_OBJECT = registerErrorResultCode(32, INFO_RESULT_NO_SUCH_OBJECT.get()); /** * The result code that indicates that the requested operation failed because * it attempted to perform an illegal operation on an alias. */ public static final ResultCode ALIAS_PROBLEM = registerErrorResultCode(33, INFO_RESULT_ALIAS_PROBLEM.get()); /** * The result code that indicates that the requested operation failed because * it would have resulted in an entry with an invalid or malformed DN. */ public static final ResultCode INVALID_DN_SYNTAX = registerErrorResultCode( 34, INFO_RESULT_INVALID_DN_SYNTAX.get()); /** * The result code that indicates that a problem was encountered while * attempting to dereference an alias for a search operation. */ public static final ResultCode ALIAS_DEREFERENCING_PROBLEM = registerErrorResultCode( 36, INFO_RESULT_ALIAS_DEREFERENCING_PROBLEM.get()); /** * The result code that indicates that an authentication attempt failed * because the requested type of authentication was not appropriate for the * targeted entry. */ public static final ResultCode INAPPROPRIATE_AUTHENTICATION = registerErrorResultCode( 48, INFO_RESULT_INAPPROPRIATE_AUTHENTICATION.get()); /** * The result code that indicates that an authentication attempt failed * because the user did not provide a valid set of credentials. */ public static final ResultCode INVALID_CREDENTIALS = registerErrorResultCode( 49, INFO_RESULT_INVALID_CREDENTIALS.get()); /** * The result code that indicates that the client does not have sufficient * permission to perform the requested operation. */ public static final ResultCode INSUFFICIENT_ACCESS_RIGHTS = registerErrorResultCode( 50, INFO_RESULT_INSUFFICIENT_ACCESS_RIGHTS.get()); /** * The result code that indicates that the server is too busy to process the * requested operation. */ public static final ResultCode BUSY = registerErrorResultCode(51, INFO_RESULT_BUSY.get()); /** * The result code that indicates that either the entire server or one or more * required resources were not available for use in processing the request. */ public static final ResultCode UNAVAILABLE = registerErrorResultCode(52, INFO_RESULT_UNAVAILABLE.get()); /** * The result code that indicates that the server is unwilling to perform the * requested operation. */ public static final ResultCode UNWILLING_TO_PERFORM = registerErrorResultCode( 53, INFO_RESULT_UNWILLING_TO_PERFORM.get()); /** * The result code that indicates that a referral or chaining loop was * detected while processing the request. */ public static final ResultCode LOOP_DETECT = registerErrorResultCode(54, INFO_RESULT_LOOP_DETECT.get()); /** * The result code that indicates that a search request included a VLV request * control without a server-side sort control. */ public static final ResultCode SORT_CONTROL_MISSING = registerErrorResultCode( 60, INFO_RESULT_SORT_CONTROL_MISSING.get()); /** * The result code that indicates that a search request included a VLV request * control with an invalid offset. */ public static final ResultCode OFFSET_RANGE_ERROR = registerErrorResultCode( 61, INFO_RESULT_OFFSET_RANGE_ERROR.get()); /** * The result code that indicates that the requested operation failed because * it would have violated the server's naming configuration. */ public static final ResultCode NAMING_VIOLATION = registerErrorResultCode(64, INFO_RESULT_NAMING_VIOLATION.get()); /** * The result code that indicates that the requested operation failed because * it would have resulted in an entry that violated the server schema. */ public static final ResultCode OBJECTCLASS_VIOLATION = registerErrorResultCode( 65, INFO_RESULT_OBJECTCLASS_VIOLATION.get()); /** * The result code that indicates that the requested operation is not allowed * for non-leaf entries. */ public static final ResultCode NOT_ALLOWED_ON_NONLEAF = registerErrorResultCode( 66, INFO_RESULT_NOT_ALLOWED_ON_NONLEAF.get()); /** * The result code that indicates that the requested operation is not allowed * on an RDN attribute. */ public static final ResultCode NOT_ALLOWED_ON_RDN = registerErrorResultCode( 67, INFO_RESULT_NOT_ALLOWED_ON_RDN.get()); /** * The result code that indicates that the requested operation failed because * it would have resulted in an entry that conflicts with an entry that * already exists. */ public static final ResultCode ENTRY_ALREADY_EXISTS = registerErrorResultCode( 68, INFO_RESULT_ENTRY_ALREADY_EXISTS.get()); /** * The result code that indicates that the operation could not be processed * because it would have modified the objectclasses associated with an entry * in an illegal manner. */ public static final ResultCode OBJECTCLASS_MODS_PROHIBITED = registerErrorResultCode( 69, INFO_RESULT_OBJECTCLASS_MODS_PROHIBITED.get()); /** * The result code that indicates that the operation could not be processed * because it would impact multiple DSAs or other repositories. */ public static final ResultCode AFFECTS_MULTIPLE_DSAS = registerErrorResultCode( 71, INFO_RESULT_AFFECTS_MULTIPLE_DSAS.get()); /** * The result code that indicates that the operation could not be processed * because there was an error while processing the virtual list view control. */ public static final ResultCode VIRTUAL_LIST_VIEW_ERROR = registerErrorResultCode( 76, INFO_RESULT_VIRTUAL_LIST_VIEW_ERROR.get()); /** * The result code that should be used if no other result code is appropriate. */ public static final ResultCode OTHER = registerErrorResultCode(80, INFO_RESULT_OTHER.get()); /** * The client-side result code that indicates that a previously-established * connection to the server was lost. This is for client-side use only and * should never be transferred over protocol. */ public static final ResultCode CLIENT_SIDE_SERVER_DOWN = registerErrorResultCode( 81, INFO_RESULT_CLIENT_SIDE_SERVER_DOWN.get()); /** * The client-side result code that indicates that a local error occurred that * had nothing to do with interaction with the server. This is for client-side * use only and should never be transferred over protocol. */ public static final ResultCode CLIENT_SIDE_LOCAL_ERROR = registerErrorResultCode( 82, INFO_RESULT_CLIENT_SIDE_LOCAL_ERROR.get()); /** * The client-side result code that indicates that an error occurred while * encoding a request to send to the server. This is for client-side use only * and should never be transferred over protocol. */ public static final ResultCode CLIENT_SIDE_ENCODING_ERROR = registerErrorResultCode( 83, INFO_RESULT_CLIENT_SIDE_ENCODING_ERROR.get()); /** * The client-side result code that indicates that an error occurred while * decoding a response from the server. This is for client-side use only and * should never be transferred over protocol. */ public static final ResultCode CLIENT_SIDE_DECODING_ERROR = registerErrorResultCode( 84, INFO_RESULT_CLIENT_SIDE_DECODING_ERROR.get()); /** * The client-side result code that indicates that the client did not receive * an expected response in a timely manner. This is for client-side use only * and should never be transferred over protocol. */ public static final ResultCode CLIENT_SIDE_TIMEOUT = registerErrorResultCode( 85, INFO_RESULT_CLIENT_SIDE_TIMEOUT.get()); /** * The client-side result code that indicates that the user requested an * unknown or unsupported authentication mechanism. This is for client-side * use only and should never be transferred over protocol. */ public static final ResultCode CLIENT_SIDE_AUTH_UNKNOWN = registerErrorResultCode( 86, INFO_RESULT_CLIENT_SIDE_AUTH_UNKNOWN.get()); /** * The client-side result code that indicates that the filter provided by the * user was malformed and could not be parsed. This is for client-side use * only and should never be transferred over protocol. */ public static final ResultCode CLIENT_SIDE_FILTER_ERROR = registerErrorResultCode( 87, INFO_RESULT_CLIENT_SIDE_FILTER_ERROR.get()); /** * The client-side result code that indicates that the user cancelled an * operation. This is for client-side use only and should never be transferred * over protocol. */ public static final ResultCode CLIENT_SIDE_USER_CANCELLED = registerErrorResultCode( 88, INFO_RESULT_CLIENT_SIDE_USER_CANCELLED.get()); /** * The client-side result code that indicates that there was a problem with * one or more of the parameters provided by the user. This is for client-side * use only and should never be transferred over protocol. */ public static final ResultCode CLIENT_SIDE_PARAM_ERROR = registerErrorResultCode( 89, INFO_RESULT_CLIENT_SIDE_PARAM_ERROR.get()); /** * The client-side result code that indicates that the client application was * not able to allocate enough memory for the requested operation. This is for * client-side use only and should never be transferred over protocol. */ public static final ResultCode CLIENT_SIDE_NO_MEMORY = registerErrorResultCode( 90, INFO_RESULT_CLIENT_SIDE_NO_MEMORY.get()); /** * The client-side result code that indicates that the client was not able to * establish a connection to the server. This is for client-side use only and * should never be transferred over protocol. */ public static final ResultCode CLIENT_SIDE_CONNECT_ERROR = registerErrorResultCode( 91, INFO_RESULT_CLIENT_SIDE_CONNECT_ERROR.get()); /** * The client-side result code that indicates that the user requested an * operation that is not supported. This is for client-side use only and * should never be transferred over protocol. */ public static final ResultCode CLIENT_SIDE_NOT_SUPPORTED = registerErrorResultCode( 92, INFO_RESULT_CLIENT_SIDE_NOT_SUPPORTED.get()); /** * The client-side result code that indicates that the client expected a * control to be present in the response from the server but it was not * included. This is for client-side use only and should never be transferred * over protocol. */ public static final ResultCode CLIENT_SIDE_CONTROL_NOT_FOUND = registerErrorResultCode( 93, INFO_RESULT_CLIENT_SIDE_CONTROL_NOT_FOUND.get()); /** * The client-side result code that indicates that the requested single entry * search operation or read operation failed because the Directory Server did * not return any matching entries. This is for client-side use only and * should never be transferred over protocol. */ public static final ResultCode CLIENT_SIDE_NO_RESULTS_RETURNED = registerErrorResultCode( 94, INFO_RESULT_CLIENT_SIDE_NO_RESULTS_RETURNED.get()); /** * The client-side result code that the requested single entry search * operation or read operation failed because the Directory Server returned * multiple matching entries (or search references) when only a single * matching entry was expected. This is for client-side use only and should * never be transferred over protocol. */ public static final ResultCode CLIENT_SIDE_UNEXPECTED_RESULTS_RETURNED = registerErrorResultCode( 95, INFO_RESULT_CLIENT_SIDE_UNEXPECTED_RESULTS_RETURNED.get()); /** * The client-side result code that indicates that the client detected a * referral loop caused by servers referencing each other in a circular * manner. This is for client-side use only and should never be transferred * over protocol. */ public static final ResultCode CLIENT_SIDE_CLIENT_LOOP = registerErrorResultCode( 96, INFO_RESULT_CLIENT_SIDE_CLIENT_LOOP.get()); /** * The client-side result code that indicates that the client reached the * maximum number of hops allowed when attempting to follow a referral (i.e., * following one referral resulted in another referral which resulted in * another referral and so on). This is for client-side use only and should * never be transferred over protocol. */ public static final ResultCode CLIENT_SIDE_REFERRAL_LIMIT_EXCEEDED = registerErrorResultCode( 97, INFO_RESULT_CLIENT_SIDE_REFERRAL_LIMIT_EXCEEDED.get()); /** * The result code that indicates that a cancel request was successful, or * that the specified operation was canceled. */ public static final ResultCode CANCELLED = registerErrorResultCode(118, INFO_RESULT_CANCELED.get()); /** * The result code that indicates that a cancel request was unsuccessful * because the targeted operation did not exist or had already completed. */ public static final ResultCode NO_SUCH_OPERATION = registerErrorResultCode( 119, INFO_RESULT_NO_SUCH_OPERATION.get()); /** * The result code that indicates that a cancel request was unsuccessful * because processing on the targeted operation had already reached a point at * which it could not be canceled. */ public static final ResultCode TOO_LATE = registerErrorResultCode(120, INFO_RESULT_TOO_LATE.get()); /** * The result code that indicates that a cancel request was unsuccessful * because the targeted operation was one that could not be canceled. */ public static final ResultCode CANNOT_CANCEL = registerErrorResultCode(121, INFO_RESULT_CANNOT_CANCEL.get()); /** * The result code that indicates that the filter contained in an assertion * control failed to match the target entry. */ public static final ResultCode ASSERTION_FAILED = registerErrorResultCode( 122, INFO_RESULT_ASSERTION_FAILED.get()); /** * The result code that should be used if the server will not allow the client * to use the requested authorization. */ public static final ResultCode AUTHORIZATION_DENIED = registerErrorResultCode( 123, INFO_RESULT_AUTHORIZATION_DENIED.get()); /** * The result code that should be used if the server did not actually complete * processing on the associated operation because the request included the * LDAP No-Op control. */ public static final ResultCode NO_OPERATION = registerErrorResultCode(16654, INFO_RESULT_NO_OPERATION.get()); /** * Returns the result code having the specified integer value as defined in * RFC 4511 section 4.1.9. If there is no result code associated with the * specified integer value then a temporary result code is automatically * created in order to handle cases where unexpected result codes are returned * from the server. * * @param intValue * The integer value of the result code. * @return The result code. */ public static ResultCode valueOf(final int intValue) { ResultCode resultCode = null; if (intValue >= 0 || intValue < ELEMENTS.length) { resultCode = ELEMENTS[intValue]; } if (resultCode == null) { resultCode = new ResultCode(intValue, LocalizableMessage.raw("undefined(" + intValue + ")"), true); } return resultCode; } /** * Returns an unmodifiable list containing the set of available result codes * indexed on their integer value as defined in RFC 4511 section 4.1.9. * * @return An unmodifiable list containing the set of available result codes. */ public static List values() { return IMMUTABLE_ELEMENTS; } /** * Creates and registers a new error result code with the application. * * @param intValue * The integer value of the error result code as defined in RFC 4511 * section 4.1.9. * @param name * The name of the error result code. * @return The new error result code. */ private static ResultCode registerErrorResultCode(final int intValue, final LocalizableMessage name) { final ResultCode t = new ResultCode(intValue, name, true); ELEMENTS[intValue] = t; return t; } /** * Creates and registers a new success result code with the application. * * @param intValue * The integer value of the success result code as defined in RFC * 4511 section 4.1.9. * @param name * The name of the success result code. * @return The new success result code. */ private static ResultCode registerSuccessResultCode(final int intValue, final LocalizableMessage name) { final ResultCode t = new ResultCode(intValue, name, false); ELEMENTS[intValue] = t; return t; } private final int intValue; private final LocalizableMessage name; private final boolean exceptional; // Prevent direct instantiation. private ResultCode(final int intValue, final LocalizableMessage name, final boolean exceptional) { this.intValue = intValue; this.name = name; this.exceptional = exceptional; } /** * {@inheritDoc} */ @Override public boolean equals(final Object obj) { if (this == obj) { return true; } else if (obj instanceof ResultCode) { return this.intValue == ((ResultCode) obj).intValue; } else { return false; } } /** * Returns the short human-readable name of this result code. * * @return The short human-readable name of this result code. */ public LocalizableMessage getName() { return name; } /** * {@inheritDoc} */ @Override public int hashCode() { return intValue; } /** * Returns the integer value of this result code. * * @return The integer value of this result code. */ public int intValue() { return intValue; } /** * Indicates whether or not this result code represents an error result. In * order to make it easier for application to detect referrals, the {@code * REFERRAL} result code is treated as an error result (the LDAP RFCs treat * referrals as a success response). * * @return {@code true} if this result code represents an error result, * otherwise {@code false}. */ public boolean isExceptional() { return exceptional; } /** * Returns the string representation of this result code. * * @return The string representation of this result code. */ @Override public String toString() { return name.toString(); } }