/*
|
* 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;
|
|
import com.sun.opends.sdk.util.Message;
|
|
|
|
/**
|
* 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 <a href="http://tools.ietf.org/html/rfc4511#section-4.1.9">RFC
|
* 4511 - Lightweight Directory Access Protocol (LDAP): The
|
* Protocol </a>
|
*/
|
public final class ResultCode
|
{
|
private static final ResultCode[] ELEMENTS = new ResultCode[16655];
|
|
private static final List<ResultCode> 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.
|
* <p>
|
* 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 server did not
|
* return any results for a search operation that was expected to
|
* match at least one entry. 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 indicates that the server has
|
* returned more matching entries for a search operation than have
|
* been processed so far. This is for client-side use only and should
|
* never be transferred over protocol.
|
*/
|
public static final ResultCode CLIENT_SIDE_MORE_RESULTS_TO_RETURN = registerErrorResultCode(
|
95, INFO_RESULT_CLIENT_SIDE_MORE_RESULTS_TO_RETURN.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 CANCELED = 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());
|
|
|
|
/**
|
* 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(int intValue,
|
Message name)
|
{
|
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(int intValue,
|
Message name)
|
{
|
ResultCode t = new ResultCode(intValue, name, false);
|
ELEMENTS[intValue] = t;
|
return t;
|
}
|
|
|
|
/**
|
* 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(int intValue)
|
{
|
ResultCode resultCode = null;
|
|
if (intValue >= 0 || intValue < ELEMENTS.length)
|
{
|
resultCode = ELEMENTS[intValue];
|
}
|
|
if (resultCode == null)
|
{
|
resultCode = new ResultCode(intValue, Message.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<ResultCode> values()
|
{
|
return IMMUTABLE_ELEMENTS;
|
}
|
|
|
|
private final int intValue;
|
|
private final Message name;
|
|
private final boolean exceptional;
|
|
|
|
// Prevent direct instantiation.
|
private ResultCode(int intValue, Message name, boolean exceptional)
|
{
|
this.intValue = intValue;
|
this.name = name;
|
this.exceptional = exceptional;
|
}
|
|
|
|
/**
|
* 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 short human-readable name of this result code.
|
*
|
* @return The short human-readable name of this result code.
|
*/
|
public Message getName()
|
{
|
return name;
|
}
|
|
|
|
/**
|
* {@inheritDoc}
|
*/
|
public boolean equals(Object obj)
|
{
|
if (this == obj)
|
{
|
return true;
|
}
|
else if (obj instanceof ResultCode)
|
{
|
return this.intValue == ((ResultCode) obj).intValue;
|
}
|
else
|
{
|
return false;
|
}
|
}
|
|
|
|
/**
|
* {@inheritDoc}
|
*/
|
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;
|
}
|
|
|
|
/**
|
* Returns the string representation of this result code.
|
*
|
* @return The string representation of this result code.
|
*/
|
public String toString()
|
{
|
return name.toString();
|
}
|
|
}
|
