javatools.filehandlers

Class HTMLReader

java.lang.Object

java.io.Reader

javatools.filehandlers.HTMLReader

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, java.lang.Readable

public class HTMLReader
extends java.io.Reader

This class is part of the Java Tools (see http://mpii.de/yago-naga/javatools). It is licensed under the Creative Commons Attribution License (see http://creativecommons.org/licenses/by/3.0) by the YAGO-NAGA team (see http://mpii.de/yago-naga). The HTML-Reader reads characters from a HTML-file.
Example:

         HTMLReader r=new HTMLReader(new File("index.html"));
         int c;
         while((c=r.read())!=-1) {
           if(c==-2) System.out.print(" TAG:",r.getTag());
           else System.out.print(c);
         }
         
         -->
             This is the HTML-file, with resolved ampersand sequences
             and with -2 returned for tags.
   

If the file is UTF8-encoded, consider wrapping an UTF8Reader:

     HTMLReader r=new HTMLReader(new UTF8Reader(new File("index.html")));
   

Field Summary

Fields

Modifier and Type	Field and Description
protected long	announceChars number of chars for announce (or -1)
protected java.io.Reader	in Holds the actual reader
boolean	skipSTYLE TRUE to skip STYLE attributes
protected java.lang.String	tag Holds the last tag (uppercased)
protected java.lang.String	tagContent Holds the content of the last tag

Fields inherited from class java.io.Reader

lock

Constructor Summary

Constructors

Constructor and Description
HTMLReader(java.io.File f) Constructs a HTMLReader from a File
HTMLReader(java.io.File f, java.lang.String message) Constructs a HTMLReader from a File with a progress bar
HTMLReader(java.io.Reader s) Constructs a HTMLReader from a Reader
HTMLReader(java.net.URL url) Constructs a HTMLReader for an URL

Method Summary

Modifier and Type	Method and Description
void	close()
java.lang.String	getTag() Returns the last tag (uppercased)
java.lang.String	getTagContent() Returns the content of the last tag
static void	main(java.lang.String[] argv) Test routine
int	read() Reads a character, returns -2 for tags
int	read(char[] cbuf, int off, int len)
java.lang.String	readTaggedText(java.lang.String t) Seeks the next tag of name t and returns all text to the terminating tag /t.
java.lang.String	readTextLine(int n) Reads a sequence of characters up to the blank following the nth char, ignores tags
boolean	scrollTo(java.lang.String s) Seeks a specific string and scrolls to it, returns TRUE if found
boolean	scrollToTag(java.lang.String s) Seeks a specific tag and scrolls to it, returns TRUE if found
java.lang.StringBuilder	text(java.lang.String forTag) Returns the entire text

Methods inherited from class java.io.Reader

mark, markSupported, read, read, ready, reset, skip

Methods inherited from class java.lang.Object

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

Field Detail

in

protected java.io.Reader in

Holds the actual reader

announceChars

protected long announceChars

number of chars for announce (or -1)

skipSTYLE

public boolean skipSTYLE

TRUE to skip STYLE attributes

tagContent

protected java.lang.String tagContent

Holds the content of the last tag

tag

protected java.lang.String tag

Holds the last tag (uppercased)

Constructor Detail

HTMLReader

public HTMLReader(java.io.Reader s)

Constructs a HTMLReader from a Reader

HTMLReader

public HTMLReader(java.net.URL url)
           throws java.io.IOException

Constructs a HTMLReader for an URL

Throws:

java.io.IOException

HTMLReader

public HTMLReader(java.io.File f)
           throws java.io.FileNotFoundException

Constructs a HTMLReader from a File

Throws:

java.io.FileNotFoundException

HTMLReader

public HTMLReader(java.io.File f,
                  java.lang.String message)
           throws java.io.FileNotFoundException

Constructs a HTMLReader from a File with a progress bar

Throws:

java.io.FileNotFoundException

Method Detail

readTextLine

public java.lang.String readTextLine(int n)
                              throws java.io.IOException

Reads a sequence of characters up to the blank following the nth char, ignores tags

Throws:

java.io.IOException

getTagContent

public java.lang.String getTagContent()

Returns the content of the last tag

getTag

public java.lang.String getTag()

Returns the last tag (uppercased)

read

public int read()
         throws java.io.IOException

Reads a character, returns -2 for tags

Overrides:

read in class java.io.Reader

Throws:

java.io.IOException

readTaggedText

public java.lang.String readTaggedText(java.lang.String t)
                                throws java.io.IOException

Seeks the next tag of name t and returns all text to the terminating tag /t. Nesting is not supported. Returns null if t was not found.

Throws:

java.io.IOException

text

public java.lang.StringBuilder text(java.lang.String forTag)
                             throws java.io.IOException

Returns the entire text

Throws:

java.io.IOException

scrollTo

public boolean scrollTo(java.lang.String s)
                 throws java.io.IOException

Seeks a specific string and scrolls to it, returns TRUE if found

Throws:

java.io.IOException

scrollToTag

public boolean scrollToTag(java.lang.String s)
                    throws java.io.IOException

Seeks a specific tag and scrolls to it, returns TRUE if found

Throws:

java.io.IOException

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in class java.io.Reader

Throws:

java.io.IOException

read

public int read(char[] cbuf,
                int off,
                int len)
         throws java.io.IOException

Specified by:

read in class java.io.Reader

Throws:

java.io.IOException

main

public static void main(java.lang.String[] argv)
                 throws java.lang.Exception

Test routine

Throws:

java.lang.Exception