An instantiable class that reads a given text file, parses it, and stores the generated statistics.

• Implement the Interface

  Your TextStatistics class must implement the given TextStatisticsInterface (dont modify the interface, it just provides a list of methods that your class must include).To implement an interface, you must modify your class header as follows

  public class TextStatistics implements TextStatisticsInterface{}

  Adding implements TextStatisticsInterface will cause an error in Eclipse. Select the quick fix option to Add unimplemented methods and it will stub out the required methods for you.

• Instance variables

  Include a reference to the processed File. Include variables for all of the statistics that are computed for the file. Look at the list of accessor methods in the TextStatisticsInterface to determine which statistics will be stored.

• Constructor

  Takes a File object as a parameter. The constructor should open the file and read the entire file line-by-line, processing each line as it reads it.

  • Your constructor needs to handle the FileNotFoundException that can occur when the File is opened in a Scanner. Use a try-catch statement to do this. Dont just throw the exception.
  • As each line is read, collect the following statistics:
    • The number of characters and lines in the file. The number of characters should include all whitespace characters, punctuation, etc. The number of lines should include any blank lines in the file.
    • The number of words in the file.You must use a Scanner on each line to count the number of words in each line of the text file.

      private static final String DELIMITERS = "[\W\d_]+";

      Use useDelimiter(DELIMITERS) on your line Scanner to set the delimiters that the Scanner will use for separating words in the file.The scanner will not return any of the delimiter characters. For example, using lineScan.next() on the string.

      scheme, and the "plan" (for us)

      will give the following tokens.

      schemeandtheplanforus

      The UseScannerDelimiter.java example shows the different results you get using the default delimiters and user-specified delimiters.

    • The number of words of each length that appears in the file. Assume that the maximum word length is 23. You do not need to print lengths that have a count of zero.
    • The average word length for the file.
    • The number of each letter that appears in the file do not separate upper and lower case, just convert all characters to lower case before counting.See LetterCount.java for a similar approach.

• Getter (accessor) methods

  Implement the accessor methods for the number of characters, number of words, number of lines, average word length and for the arrays that contain the number of words of each length and the number of times each letter occurs in the file.

• toString method

  Write a toString() method that generates and returns a String that can be printed to summarize the statistics for the file as shown in the sample output.

You must test your program thoroughly before submitting it. We will be using similar testing strategies when we grade your program, so you should have a good idea whether or not your code will pass our tests before submitting.

TextStatisticsTest.java: Automated testing based on the interface.

We have provided a test program that tests your TextStatistics class using three sample text files. This test program will not compile unless you have properly implemented the required interface. This is available in your starter files.

autograde.sh: Testing based on program output.

autograde.sh

A shell script (a program made up of shell commands) that you can run to see if your program is going to work with the shell script used for grading the programs.

testfile.txt and etext

Sample text files used by autograde.sh

testresults

The expected output of autograde.sh. Your output should match the contents of this file.

To use these files to test your program, copy them into your program directory on onyx and make sure that autograde.sh is executable. (Doing a ls -l on the file should give -rwx------. If the x is missing, type chmod +x autograde.sh).

Now you run the test by typing

./autograde.sh

If your program does not compile and run, you need to fix it if you want any points for the program. Make sure all the files have the names specified.

Sample Sessions

[[email protected] p4]$ java ProcessTextUsage: java ProcessText file1 [file2 ...][[email protected] p4]$ java ProcessText not-a-file.txtInvalid file path: not-a-file.txt[[email protected] p4]$ java ProcessText not-a-file.txt testfile.txtInvalid file path: not-a-file.txtStatistics for testfile.txt==========================================================11 lines79 words465 characters------------------------------ a = 27         n = 25 b = 1          o = 26 c = 11         p = 5 d = 10         q = 0 e = 33         r = 21 f = 9          s = 30 g = 7          t = 35 h = 24         u = 7 i = 25         v = 1 j = 0          w = 10 k = 2          x = 1 l = 18         y = 2 m = 5          z = 0------------------------------ length  frequency ------  ---------      1          3      2         13      3         24      4         13      5         10      6          2      7          5      8          3      9          1     10          3     11          2Average word length = 4.24==========================================================

[[email protected] p4]$ java ProcessText testfile.txtStatistics for testfile.txt==========================================================11 lines79 words465 characters------------------------------ a = 27         n = 25 b = 1          o = 26 c = 11         p = 5 d = 10         q = 0 e = 33         r = 21 f = 9          s = 30 g = 7          t = 35 h = 24         u = 7 i = 25         v = 1 j = 0          w = 10 k = 2          x = 1 l = 18         y = 2 m = 5          z = 0------------------------------ length  frequency ------  ---------      1          3      2         13      3         24      4         13      5         10      6          2      7          5      8          3      9          1     10          3     11          2Average word length = 4.24==========================================================

[[email protected] p4]$ java TextStatisticsTestTesting on data file:testfile.txtPassed! getCharCount()Passed! getWordCount()Passed! getLineCount()Passed! getAverageWordLength()Passed! Arrays frequenciesPassed! Letter frequenciesTesting on data file:etext/Gettysburg-Address.txtPassed! getCharCount()Passed! getWordCount()Passed! getLineCount()Passed! getAverageWordLength()Passed! Arrays frequenciesPassed! Letter frequenciesTesting on data file:etext/Alice-in-Wonderland.txtPassed! getCharCount()Passed! getWordCount()Passed! getLineCount()Passed! getAverageWordLength()Passed! Arrays frequenciesPassed! Letter frequencies

Documentation