netscape.ldap.util
Class LDIF

java.lang.Object
  netscape.ldap.util.LDIF

All Implemented Interfaces:

Serializable

public class LDIF

extends Object

implements Serializable

LDAP Data Interchange Format (LDIF) is a file format used to import and export directory data from an LDAP server and to describe a set of changes to be applied to data in a directory. This format is described in the Internet draft The LDAP Data Interchange Format (LDIF) - Technical Specification.

This class implements an LDIF file parser. You can construct an object of this class to parse data in LDIF format and manipulate the data as individual LDIFRecord objects.

See Also:

LDIFRecord, Serialized Form

Constructor Summary

LDIF()
Constructs an LDIF object to parse the LDAP data read from stdin.

LDIF(DataInputStream ds)
Constructs an LDIF object to parse the LDIF data read from an input stream.

LDIF(String file)
Constructs an LDIF object to parse the LDIF data read from a specified file.

Method Summary

static void	breakString(PrintWriter pw, String value, int max) Outputs the String in LDIF line-continuation format.
int	getVersion() Gets the version of LDIF used in the data.
static boolean	isPrintable(byte[] b) Returns true if all the bytes in the given array are valid for output as a String according to the LDIF specification.
static void	main(String[] args) Test driver - just reads and parses an LDIF file, printing each record as interpreted
LDIFRecord	nextRecord() Returns the next record in the LDIF data.
static String	toPrintableString(byte[] b) Converts a byte array to a printable string following the LDIF rules (encode in base64 if necessary)
String	toString() Gets the string representation of the entire LDIF file.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

LDIF

public LDIF()
     throws IOException

Constructs an LDIF object to parse the LDAP data read from stdin.

Throws:

IOException - An I/O error has occurred.

LDIF

public LDIF(String file)
     throws IOException

Constructs an LDIF object to parse the LDIF data read from a specified file.

Parameters:

file - the name of the LDIF file to parse

Throws:

IOException - An I/O error has occurred.

LDIF

public LDIF(DataInputStream ds)
     throws IOException

Constructs an LDIF object to parse the LDIF data read from an input stream.

Parameters:

ds - The input stream providing the LDIF data

Throws:

IOException - An I/O error has occurred.

Method Detail

nextRecord

public LDIFRecord nextRecord()
                      throws IOException

Returns the next record in the LDIF data. You can call this method repeatedly to iterate through all records in the LDIF data.

Returns:

the next record as an LDIFRecord object or null if there are no more records.

Throws:

IOException - An I/O error has occurred.

See Also:

LDIFRecord

isPrintable

public static boolean isPrintable(byte[] b)

Returns true if all the bytes in the given array are valid for output as a String according to the LDIF specification. If not, the array should output base64-encoded.

Returns:

true if all the bytes in the given array are valid for output as a String according to the LDIF specification; otherwise, false.

breakString

public static void breakString(PrintWriter pw,
                               String value,
                               int max)

Outputs the String in LDIF line-continuation format. No line will be longer than the given max. A continuation line starts with a single blank space.

Parameters:

pw - the printer writer

value - the given string being printed out

max - the maximum characters allowed in the line

getVersion

public int getVersion()

Gets the version of LDIF used in the data.

Returns:

version of LDIF used in the data.

toString

public String toString()

Gets the string representation of the entire LDIF file.

Returns:

the string representation of the entire LDIF data file.

toPrintableString

public static String toPrintableString(byte[] b)

Converts a byte array to a printable string following the LDIF rules (encode in base64 if necessary)

Parameters:

b - the byte array to convert

Returns:

a converted string which is printable.

main

public static void main(String[] args)

Test driver - just reads and parses an LDIF file, printing each record as interpreted

Parameters:

args - name of the LDIF file to parse