com.unboundid.ldif
Class LDIFException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by com.unboundid.util.LDAPSDKException
              extended by com.unboundid.ldif.LDIFException
All Implemented Interfaces:
java.io.Serializable

@NotMutable
@ThreadSafety(level=COMPLETELY_THREADSAFE)
public final class LDIFException
extends LDAPSDKException

This class defines an exception that may be thrown if a problem occurs while attempting to decode data read from an LDIF source. It has a flag to indicate whether it is possible to try to continue reading additional information from the LDIF source, and also the approximate line number on which the problem was encountered.

See Also:
Serialized Form

Constructor Summary
LDIFException(java.lang.String message, long lineNumber, boolean mayContinueReading)
          Creates a new LDIF exception with the provided information.
LDIFException(java.lang.String message, long lineNumber, boolean mayContinueReading, java.lang.CharSequence[] dataLines, java.lang.Throwable cause)
          Creates a new LDIF exception with the provided information.
LDIFException(java.lang.String message, long lineNumber, boolean mayContinueReading, java.util.List<? extends java.lang.CharSequence> dataLines, java.lang.Throwable cause)
          Creates a new LDIF exception with the provided information.
LDIFException(java.lang.String message, long lineNumber, boolean mayContinueReading, java.lang.Throwable cause)
          Creates a new LDIF exception with the provided information.
 
Method Summary
 java.util.List<java.lang.String> getDataLines()
          Retrieves the lines comprising the data that could not be parsed as valid LDIF, if available.
 java.lang.String getExceptionMessage()
          Retrieves a string representation of this exception suitable for use in messages.
 long getLineNumber()
          Retrieves the line number on which the problem occurred.
 boolean mayContinueReading()
          Indicates whether it is possible to continue attempting to read from the LDIF source.
 void toString(java.lang.StringBuilder buffer)
          Appends a string representation of this exception to the provided buffer.
 
Methods inherited from class com.unboundid.util.LDAPSDKException
toString
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

LDIFException

public LDIFException(java.lang.String message,
                     long lineNumber,
                     boolean mayContinueReading)
Creates a new LDIF exception with the provided information.

Parameters:
message - A message explaining the problem that occurred. It must not be null.
lineNumber - The line number in the LDIF source on which the problem occurred.
mayContinueReading - Indicates whether it is possible to continue attempting to read from the LDIF source.

LDIFException

public LDIFException(java.lang.String message,
                     long lineNumber,
                     boolean mayContinueReading,
                     java.lang.Throwable cause)
Creates a new LDIF exception with the provided information.

Parameters:
message - A message explaining the problem that occurred. It must not be null.
lineNumber - The line number in the LDIF source on which the problem occurred.
mayContinueReading - Indicates whether it is possible to continue attempting to read from the LDIF source.
cause - The underlying exception that triggered this exception.

LDIFException

public LDIFException(java.lang.String message,
                     long lineNumber,
                     boolean mayContinueReading,
                     java.lang.CharSequence[] dataLines,
                     java.lang.Throwable cause)
Creates a new LDIF exception with the provided information.

Parameters:
message - A message explaining the problem that occurred. It must not be null.
lineNumber - The line number in the LDIF source on which the problem occurred.
mayContinueReading - Indicates whether it is possible to continue attempting to read from the LDIF source.
dataLines - The lines that comprise the data that could not be parsed as valid LDIF. It may be null if this is not available.
cause - The underlying exception that triggered this exception.

LDIFException

public LDIFException(java.lang.String message,
                     long lineNumber,
                     boolean mayContinueReading,
                     java.util.List<? extends java.lang.CharSequence> dataLines,
                     java.lang.Throwable cause)
Creates a new LDIF exception with the provided information.

Parameters:
message - A message explaining the problem that occurred. It must not be null.
lineNumber - The line number in the LDIF source on which the problem occurred.
mayContinueReading - Indicates whether it is possible to continue attempting to read from the LDIF source.
dataLines - The lines that comprise the data that could not be parsed as valid LDIF. It may be null if this is not available.
cause - The underlying exception that triggered this exception.
Method Detail

getLineNumber

public long getLineNumber()
Retrieves the line number on which the problem occurred.

Returns:
The line number on which the problem occurred.

mayContinueReading

public boolean mayContinueReading()
Indicates whether it is possible to continue attempting to read from the LDIF source.

Returns:
true if it is possible to continue attempting to read from the LDIF source, or false if it is not possible to continue.

getDataLines

public java.util.List<java.lang.String> getDataLines()
Retrieves the lines comprising the data that could not be parsed as valid LDIF, if available.

Returns:
An unmodifiable list of the lines comprising the data that could not be parsed as valid LDIF, or null if that is not available.

toString

public void toString(java.lang.StringBuilder buffer)
Appends a string representation of this exception to the provided buffer.

Overrides:
toString in class LDAPSDKException
Parameters:
buffer - The buffer to which the string representation of this exception is to be appended.

getExceptionMessage

public java.lang.String getExceptionMessage()
Retrieves a string representation of this exception suitable for use in messages.

Overrides:
getExceptionMessage in class LDAPSDKException
Returns:
A string representation of this exception suitable for use in messages.