Add ViewTool for interactive WARC file exploration

Author: ato

README.md

@@ -116,6 +116,10 @@ Create a CDX file:
 
     java -jar jwarc.jar cdx example.warc > records.cdx
 
+List, filter and extract captures with an interactive terminal interface:
+
+    java -jar jwarc.jar view example.warc
+
 Run a replay proxy and web server:
 
     export PORT=8080

src/org/netpreserve/jwarc/WarcCaptureReader.java

@@ -86,6 +86,20 @@ WarcCaptureRecord readConcurrentTo(ConcurrentRecordSet concurrentSet) throws IOE
         return null;
     }
 
+    /**
+     * Seeks to the record at the given position in the underlying channel.
+     *
+     * @param position byte offset of the beginning of the record to seek to
+     * @throws IOException                   if an I/O error occurs
+     * @throws IllegalArgumentException      if the position is negative
+     * @throws UnsupportedOperationException if the underlying channel does not support seeking
+     */
+    public void position(long position) throws IOException {
+        reader.position(position);
+        nextRecord = null;
+        warcinfo = null;
+    }
+
     /**
      * Closes the underlying WarcReader.
      * @throws IOException if an I/O error occurs during the close operation.