ORG.oclc.ecat.util
Class UUDecoder

java.lang.Object
  |
  +--ORG.oclc.ecat.util.CharacterDecoder
        |
        +--ORG.oclc.ecat.util.UUDecoder

public class UUDecoder

extends CharacterDecoder

This class implements a Berkeley uu character decoder. This decoder was made famous by the uudecode program. The basic character coding is algorithmic, taking 6 bits of binary data and adding it to an ASCII ' ' (space) character. This converts these six bits into a printable representation. Note that it depends on the ASCII character encoding standard for english. Groups of three bytes are converted into 4 characters by treating the three bytes a four 6 bit groups, group 1 is byte 1's most significant six bits, group 2 is byte 1's least significant two bits plus byte 2's four most significant bits. etc. In this encoding, the buffer prefix is:

     begin [mode] [filename]
 

This is followed by one or more lines of the form:

	(len)(data)(data)(data) ...
 

where (len) is the number of bytes on this line. Note that groupings are always four characters, even if length is not a multiple of three bytes. When less than three characters are encoded, the values of the last remaining bytes is undefined and should be ignored. The last line of data in a uuencoded buffer is represented by a single space character. This is translated by the decoding engine to a line length of zero. This is immediately followed by a line which contains the word 'end[newline]' If an error is encountered during decoding this class throws a CEFormatException. The specific detail messages are:

	"UUDecoder: No begin line."
	"UUDecoder: Malformed begin line."
	"UUDecoder: Short Buffer."
	"UUDecoder: Bad Line Length."
	"UUDecoder: Missing 'end' line."
 

See Also:

CharacterDecoder, UUEncoder

Field Summary

String	bufferName This string contains the name that was in the buffer being decoded.
int	mode Represents UNIX(tm) mode bits.

Constructor Summary

UUDecoder()

Methods inherited from class ORG.oclc.ecat.util.CharacterDecoder

decodeBuffer, decodeBuffer, decodeBuffer, readFully

Methods inherited from class java.lang.Object

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

Field Detail

bufferName

public String bufferName

This string contains the name that was in the buffer being decoded.

mode

public int mode

Represents UNIX(tm) mode bits. Generally three octal digits representing read, write, and execute permission of the owner, group owner, and others. They should be interpreted as the bit groups:

 (owner) (group) (others)
	rwx      rwx     rwx 	(r = read, w = write, x = execute)

Constructor Detail

UUDecoder

public UUDecoder()