TextFormat.java

Go to the documentation of this file.

/*
 * Javolution - Java(TM) Solution for Real-Time and Embedded Systems
 * Copyright (C) 2012 - Javolution (http://javolution.org/)
 * All rights reserved.
 * 
 * Permission to use, copy, modify, and distribute this software is
 * freely granted, provided that this notice is preserved.
 */
package javolution.text;
 
import java.io.IOException;
 
import javolution.lang.Parallelizable;
 
@Parallelizable
public abstract class TextFormat<T> {
 
    public abstract T parse(CharSequence csq, Cursor cursor);
 
    public abstract Appendable format(T obj, Appendable dest)
            throws IOException;
 
    public T parse(CharSequence csq) throws IllegalArgumentException {
        Cursor cursor = new Cursor();
        T obj = parse(csq, cursor);
        if (!cursor.atEnd(csq))
            throw new IllegalArgumentException("Extraneous character(s) \""
                    + cursor.tail(csq) + "\"");
        return obj;
    }
 
    public TextBuilder format(T obj, TextBuilder dest) {
        try {
            this.format(obj, (Appendable) dest);
            return dest;
        } catch (IOException e) {
            throw new Error(e); // Cannot happens.
        }
    }
 
    public String format(T obj) {
        return this.format(obj, new TextBuilder()).toString();
 
    }
}