hw6

Class MarvelParser

java.lang.Object

hw6.MarvelParser

public class MarvelParser
extends java.lang.Object

Parser utility to load the Marvel Comics dataset.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MarvelParser.MalformedDataException A checked exception class for bad data files

Constructor Summary

Constructors

Constructor and Description
MarvelParser()

Method Summary

Modifier and Type	Method and Description
static void	parseData(java.lang.String filename, java.util.Set<java.lang.String> characters, java.util.Map<java.lang.String,java.util.List<java.lang.String>> books) Reads the Marvel Universe dataset.

Methods inherited from class java.lang.Object

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

Constructor Detail

MarvelParser

public MarvelParser()

Method Detail

parseData

public static void parseData(java.lang.String filename,
                             java.util.Set<java.lang.String> characters,
                             java.util.Map<java.lang.String,java.util.List<java.lang.String>> books)
                      throws MarvelParser.MalformedDataException

Reads the Marvel Universe dataset. Each line of the input file contains a character name and a comic book the character appeared in, separated by a tab character

Parameters:

filename - the file that will be read

characters - list in which all character names will be stored; typically empty when the routine is called

books - map from titles of comic books to characters that appear in them; typically empty when the routine is called

Throws:

MarvelParser.MalformedDataException - if the file is not well-formed: each line contains exactly two tokens separated by a tab, or else starting with a # symbol to indicate a comment line.

Requires:

filename is a valid file path

Effects:

• fills characters with a list of all unique character names
• fills books with a map from each comic book to all characters appearing in it

Modifies:

characters, books