Package com.unboundid.ldap.sdk.persist

Class LDAPPersistException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.unboundid.util.LDAPSDKException

com.unboundid.ldap.sdk.LDAPException

com.unboundid.ldap.sdk.persist.LDAPPersistException

All Implemented Interfaces:

Serializable

@NotMutable
@ThreadSafety(level=COMPLETELY_THREADSAFE)
public final class LDAPPersistException
extends LDAPException

This class defines an exception that may be thrown if a problem occurs while attempting to perform processing related to persisting Java objects in an LDAP directory server.

See Also:

• Serialized Form

Field Summary

Fields inherited from class com.unboundid.ldap.sdk.LDAPException

NO_CONTROLS, NO_REFERRALS

Constructor Summary

Constructors

Constructor	Description
LDAPPersistException(LDAPException e)	Creates a new LDAP persist exception that wraps the provided LDAP exception.
LDAPPersistException(String message)	Creates a new LDAP persist exception with the provided message.
LDAPPersistException(String message, Object partiallyDecodedObject, Throwable cause)	Creates a new LDAP persist exception with the provided message and cause.
LDAPPersistException(String message, Throwable cause)	Creates a new LDAP persist exception with the provided message and cause.

Method Summary

Modifier and Type	Method	Description
Object	getPartiallyDecodedObject()	Retrieves the partially-decoded object in the process of being initialized when this exception was thrown.
void	toString(StringBuilder buffer)	Appends a string representation of this exception to the provided buffer.
void	toString(StringBuilder buffer, boolean includeCause, boolean includeStackTrace)	Appends a string representation of this LDAPException to the provided buffer.

Methods inherited from class com.unboundid.ldap.sdk.LDAPException

getDiagnosticMessage, getExceptionMessage, getExceptionMessage, getMatchedDN, getReferralURLs, getResponseControl, getResponseControls, getResultCode, getResultString, hasResponseControl, hasResponseControl, toLDAPResult

Methods inherited from class com.unboundid.util.LDAPSDKException

toString

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

LDAPPersistException

public LDAPPersistException(@NotNull
 LDAPException e)

Creates a new LDAP persist exception that wraps the provided LDAP exception.

Parameters:

e - The LDAP exception to wrap with this LDAP persist exception.

LDAPPersistException

public LDAPPersistException(@NotNull
 String message)

Creates a new LDAP persist exception with the provided message.

Parameters:

message - The message for this exception.

LDAPPersistException

public LDAPPersistException(@NotNull
 String message,
 @Nullable
 Throwable cause)

Creates a new LDAP persist exception with the provided message and cause.

Parameters:

message - The message for this exception.

cause - The underlying cause for this exception.

LDAPPersistException

public LDAPPersistException(@NotNull
 String message,
 @Nullable
 Object partiallyDecodedObject,
 @Nullable
 Throwable cause)

Creates a new LDAP persist exception with the provided message and cause.

Parameters:

message - The message for this exception.

partiallyDecodedObject - The object that was in the process of being decoded when this exception was thrown. It may be null if the exception was thrown outside of the context of decoding an object. If an object is available, then it will likely be only partially initialized.

cause - The underlying cause for this exception.

Method Details

getPartiallyDecodedObject

@Nullable
public Object getPartiallyDecodedObject()

Retrieves the partially-decoded object in the process of being initialized when this exception was thrown.

Returns:

The partially-decoded object in the process of being initialized when this exception was thrown, or null if none is available or the exception was not thrown while decoding an object.

toString

public void toString(@NotNull
 StringBuilder buffer)

Appends a string representation of this exception to the provided buffer.

Overrides:

toString in class LDAPException

Parameters:

buffer - The buffer to which the string representation of this exception is to be appended.

toString

public void toString(@NotNull
 StringBuilder buffer,
 boolean includeCause,
 boolean includeStackTrace)

Appends a string representation of this LDAPException to the provided buffer.

Overrides:

toString in class LDAPException

Parameters:

buffer - The buffer to which the information should be appended. This must not be null.

includeCause - Indicates whether to include information about the cause (if any) in the exception message.

includeStackTrace - Indicates whether to include a condensed representation of the stack trace in the exception message. If a stack trace is included, then the cause (if any) will automatically be included, regardless of the value of the includeCause argument.