Package com.unboundid.ldap.sdk.unboundidds.logs

Class AuditLogReader

java.lang.Object

com.unboundid.ldap.sdk.unboundidds.logs.AuditLogReader

All Implemented Interfaces:

Closeable, AutoCloseable

@NotMutable
@ThreadSafety(level=COMPLETELY_THREADSAFE)
public final class AuditLogReader
extends Object
implements Closeable

This class provides a mechanism for reading messages from a Directory Server audit log.

NOTE: This class, and other classes within the com.unboundid.ldap.sdk.unboundidds package structure, are only supported for use against Ping Identity, UnboundID, and Nokia/Alcatel-Lucent 8661 server products. These classes provide support for proprietary functionality or for external specifications that are not considered stable or mature enough to be guaranteed to work in an interoperable way with other types of LDAP servers.

Constructor Summary

Constructors

Constructor	Description
AuditLogReader(File file)	Creates a new audit log reader that will read messages from the specified log file.
AuditLogReader(InputStream inputStream)	Creates a new audit log reader that will read messages from the provided input stream.
AuditLogReader(Reader reader)	Creates a new audit log reader that will read messages using the provided Reader object.
AuditLogReader(String path)	Creates a new audit log reader that will read messages from the specified log file.

Method Summary

Modifier and Type	Method	Description
void	close()	Closes this error log reader.
AuditLogMessage	read()	Reads the next audit log message from the log file.

Methods inherited from class java.lang.Object

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

Constructor Details

AuditLogReader

public AuditLogReader(@NotNull
 String path)
               throws IOException

Creates a new audit log reader that will read messages from the specified log file.

Parameters:

path - The path of the log file to read.

Throws:

IOException - If a problem occurs while opening the file for reading.

AuditLogReader

public AuditLogReader(@NotNull
 File file)
               throws IOException

Creates a new audit log reader that will read messages from the specified log file.

Parameters:

file - The log file to read.

Throws:

IOException - If a problem occurs while opening the file for reading.

AuditLogReader

public AuditLogReader(@NotNull
 Reader reader)

Creates a new audit log reader that will read messages using the provided Reader object.

Parameters:

reader - The reader to use to read log messages.

AuditLogReader

public AuditLogReader(@NotNull
 InputStream inputStream)

Creates a new audit log reader that will read messages from the provided input stream.

Parameters:

inputStream - The input stream from which to read log messages.

Method Details

read

@Nullable
public AuditLogMessage read()
                     throws IOException,
AuditLogException

Reads the next audit log message from the log file.

Returns:

The audit log message read from the log file, or null if there are no more messages to be read.

Throws:

IOException - If an error occurs while trying to read from the file.

AuditLogException - If an error occurs while trying to parse the log message.

close

public void close()
           throws IOException

Closes this error log reader.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException - If a problem occurs while closing the reader.