edu.isi.ikcap.workflows.util.logging
Class Escape

java.lang.Object
  edu.isi.ikcap.workflows.util.logging.Escape

public class Escape
extends Object

This class tries to define an interface to deal with quoting, escaping, and the way back. The quoting algorithm is safe to only itself. Thus,

 unescape( escape( s ) ) === s
 

holds true, but

 escape( unescape( s ) ) =?= s
 

does not necessarily hold.

Version:

$Revision: 1.1 $

Author:

Gaurang Mehta, Karan Vahi, Jens-S. Vöckler

Field Summary

private String	m_escapable Defines the set of characters that require escaping.
private char	m_escape Defines the character used to escape characters.

Constructor Summary

Escape()
Defines the default quoting and escaping rules, escaping the apostrophe, double quote and backslash.

Escape(String escapable, char escape)
Constructs arbitrary escaping rules.

Escape(String escapable, char escape, boolean escapeEscape)
Constructs arbitrary escaping rules.

Method Summary

String	escape(String s) Transforms a given string by escaping all characters inside the quotable characters set with the escape character.
static void	main(String[] args) Test program.
String	unescape(String s) Transforms a given string by unescaping all characters that are prefixed with the escape character.

Methods inherited from class java.lang.Object

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

Field Detail

m_escape

private char m_escape

Defines the character used to escape characters.

m_escapable

private String m_escapable

Defines the set of characters that require escaping.

Constructor Detail

Escape

public Escape()

Defines the default quoting and escaping rules, escaping the apostrophe, double quote and backslash. The escape character is the backslash.

Escape

public Escape(String escapable,
              char escape)

Constructs arbitrary escaping rules.

Parameters:

escapable - is the set of characters that require escaping

escape - is the escape character itself.

Escape

public Escape(String escapable,
              char escape,
              boolean escapeEscape)

Constructs arbitrary escaping rules.

Parameters:

escapable - is the set of characters that require escaping

escape - is the escape character itself.

escapeEscape - boolean indicating whether escape character itself should be escaped if not present in escapable.

Method Detail

escape

public String escape(String s)

Transforms a given string by escaping all characters inside the quotable characters set with the escape character. The escape character itself is also escaped.

Parameters:

s - is the string to escape.

Returns:

the quoted string

See Also:

unescape( String )

unescape

public String unescape(String s)

Transforms a given string by unescaping all characters that are prefixed with the escape character.

Parameters:

s - is the string to remove escapes from.

Returns:

the quoted string

See Also:

unescape( String )

main

public static void main(String[] args)

Test program.

Parameters:

args - are command-line arguments