edu.neu.ccs.codec
Class EscapedCodec

java.lang.Object
  |
  +--edu.neu.ccs.codec.EscapedCodec

All Implemented Interfaces:

Codec, Serializable

public final class EscapedCodec

extends Object

implements Codec, Serializable

CODEC implementation whose encoding scheme uses separator sequences to separate distinct data elements and uses escape sequences to mask separator sequences and escape sequences at each level of recursion. This CODEC does not make use of data compression, and does not result in any data loss. This CODEC produces encoded data that is extremely readable at low levels of recursion, but is very difficult to read at high levels of recursion.

The unique three letter identifier for this CODEC is "ESC". This CODEC is automatically installed by the JPT.

Since:

1.0

See Also:

CodecUtilities, Serialized Form

Constructor Summary

EscapedCodec()
Constructs an object capable of encoding and decoding data using the "Escaped-separated" encoding scheme.

Method Summary

String[]	decode(String data) Decodes the given compound data String into an array of data Strings using the "Escaped-separated" encoding scheme.
String	encode(String[] data) Encodes the given array of data Strings into a single compound data String using the "Escaped-separated" encoding scheme.
String	getPrefix() Returns the unique identifier for this encoding scheme: the String "ESC".

Methods inherited from class java.lang.Object

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

Constructor Detail

EscapedCodec

public EscapedCodec()

Constructs an object capable of encoding and decoding data using the "Escaped-separated" encoding scheme.

Method Detail

encode

public String encode(String[] data)

Encodes the given array of data Strings into a single compound data String using the "Escaped-separated" encoding scheme. If the given array is null, a representation of null is returned.

Specified by:

encode in interface Codec

Parameters:

data - an array of data Strings

Returns:

the resulting encoded String

See Also:

decode(String), CodecUtilities.encode(String[]), CodecUtilities.encode(Stringable[]), Codec

decode

public String[] decode(String data)
                throws ParseException

Decodes the given compound data String into an array of data Strings using the "Escaped-separated" encoding scheme. If the given data is null or the representation of null, this method returns null.

Specified by:

decode in interface Codec

Parameters:

data - an encoded data String

Returns:

the resulting array of data Strings

Throws:

ParseException - if the data was not encoded using this scheme

See Also:

encode(String[]), CodecUtilities.decode(String), Codec

getPrefix

public String getPrefix()

Returns the unique identifier for this encoding scheme: the String "ESC".

Specified by:

getPrefix in interface Codec

See Also:

CodecUtilities.installCodec(Codec), CodecUtilities.getDefaultCodec(), Codec