Class EntrySourceException

All Implemented Interfaces:
Serializable
Direct Known Subclasses:
SearchResultReferenceEntrySourceException

This class defines an exception that may be thrown if a problem occurs while trying to access an entry in an entry source (e.g., because the entry source is no longer available, because an entry could not be parsed, or because the next element returned was a search result reference rather than a search result entry).
See Also:
  • Constructor Details

    • EntrySourceException

      public EntrySourceException(boolean mayContinueReading, @Nullable Throwable cause)
      Creates a new entry source exception with the provided information.
      Parameters:
      mayContinueReading - Indicates whether it is possible to continue attempting to iterate through subsequent entries in the entry source.
      cause - The underlying exception that triggered this exception. It must not be null.
    • EntrySourceException

      public EntrySourceException(boolean mayContinueReading, @NotNull String message, @Nullable Throwable cause)
      Creates a new entry source exception with the provided information.
      Parameters:
      mayContinueReading - Indicates whether it is possible to continue attempting to iterate through subsequent entries in the entry source.
      message - A message explaining the problem that occurred. It must not be null.
      cause - The underlying exception that triggered this exception. It must not be null.
  • Method Details

    • mayContinueReading

      public final boolean mayContinueReading()
      Indicates whether it is possible to continue attempting to iterate through subsequent entries in the entry source.
      Returns:
      true if it is possible to continue attempting to read from the entry source, or false if it is not possible to continue.
    • toString

      public void toString(@NotNull 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.