CS 150, Spring 2018

Programming Assignment - P8

File Statistics - Gettysburg Address

Due - May 1, 2018 at 6:00pm

Late - May 2, 2018 at 8:00am

Objectives of this Assignment

1. To write a program which performs file input/output,
2. calculate file statistics on a given text file, and
3. review some of the Character wrapper class methods.

Instructions

Create a Java program called P8 with a class named P8, which after created should contain a file named P8.java in the src folder. All of the Java code you write should be contained in the main method. In addition to determining the number of lines and words in the Gettysburg address file, in P8 you should also determine the following: number of characters, number of uppercase letters, number of lowercase letters, number of digits, number of spaces, and number of special characters.

Lab 14 You will complete parts 1-3 during lab.

Part One
1. In order to import the text file to P8, right on the file here and click either 'Save as' or 'Download link as'. Then save the file to your P8 project directory. Do not save to the src or bin folder. After saving to your P8, right click on the P8 project and click refresh. Once P8 has been refreshed you should see Gettysburg.txt appear in the project directory.
2. First, copy the following code into the body of your main method:
   

     try {
         // Declare and initialize variables.
   
         // Read lines in file into String array and count words per line.
   
         // Write file statistics to Statistics.txt.
   
         // Close Scanner and PrintWriter.
   
     } catch (Exception e) {
   	System.out.println("Error");
   	e.printStackTrace();
     } // end try-catch
     

   All of the remaining code below should reside in the try-catch block. You do not need to make any changes to the try-catch code.
3. Declare and initialize two File objects, one with the source as args[0], and the other as args[1].
4. Declare and initialize a Scanner object to read from the file object related to args[0].
5. Declare and initialize a PrintWriter object to write to the file object pertaining to args[1].
6. Declare and initialize a String array to a size of 25 elements.
7. Declare and initialize eight integer variables to 0. These variables will represent statistics about the file, such as line count, character count, etc.
8. Declare and initialize a String to the empty string.
9. Declare a character variable.
10. Set up the program arguments for P9 to read Gettysburg.txt Statistics.txt - make sure there is a space in between file names.

Part Two
11. Write a while loop that continues to iterate as long as the file has another line.
12. Inside the loop, using your Scanner, assign the first line to the first element of the String array. As the loop iterates, lines should be assigned to sequential elements of the array; so do not hard code index values.
13. You should use one of your integer variables as the index variable for the String array. This same variable will also act, later on, as the variable to use when printing the number of lines in the file.
14. Next, create another Scanner object (still inside the while loop). The purpose of this Scanner will be to read each token of the lines previously read by the other Scanner object above.
15. The input to this second Scanner is the line of text just assigned to the String array. You should access the line via the array, not by writing another line of code with the first Scanner object.
16. Now, write an inner while loop that continues to iterate as long as the second Scanner object has more tokens.
17. Inside this while loop, do two things: (1) call the next method on the current Scanner, but do not assign the token to anything; and (2) increment your second integer variable, which will represent the number of words in the file.
18. Before exiting the outer while loop, but outside of the inner while loop, increment the integer representing number of lines in the file.

Part Three
19. You are now ready to print a few lines to the output file for this project, Statistics.txt. After running your program, in order to check the contents of Statistics.txt, you must once again refresh P8 which will make the file visible in your project directory.
20. First, using your PrintWriter object, print the following to the file:

     FILE STATISTICS 

21. Then, print:

     Number of Lines: 

    followed by a space and the associated variable.
22. Next, print:

     Number of Words: 

    followed by a space and the associated variable and include a new line.
23. Lastly, close your Scanner and PrintWriter.

Part Four
24. You will now need to add a block of code to determine the rest of the file statistics. This code will go after the nested while loops, but before your code that writes data to the output file.
25. Write a for loop that iterates over all of the elements in the String array.
26. First, assign the line at the current index to your String object.
27. Next, write an if statement that breaks the loop if the String is null. Without this check, what exception will be generated?
28. After the if statement, add the length of the String to your character count variable.
29. Now, write an inner for loop to determine the type of characters in each String.
30. First, the inner for loop should assign a single character from the String object to your character variable from step 4. This single character will then be sent through several conditionals.
31. Following this line of code, write several conditionals that utilize methods of the Character wrapper class. If the character is of a certain type, increment the appropriate integer variable. One type of character you should be counting will be the default case (i.e. for which type of character is there not a wrapper class method?).

Part Five
32. You are now ready to print six more lines to the output file for this project, Statistics.txt.
33. First, using your PrintWriter object, print the following to the file:

     Number of Characters: 

    followed by your associated variable.
34. Next print:

     Number of Uppercase: 

    followed by the appropriate variable.
35. The next four are as follows, and each print statement should include the variable with the associated statistic.

     Number of Lowercase:
     Number of Digits:
     Number of Spaces:
     Number of Special: 

36. Make sure the last print statement includes a new line.
37. If you have not already done so, close your Scanner and PrintWriter objects.

Output File Contents

FILE STATISTICS
Number of Lines: 21
Number of Words: 274
Number of Characters: 1475
Number of Uppercase: 13
Number of Lowercase: 1146
Number of Digits: 6
Number of Spaces: 270
Number of Special: 40

Questions to Consider

• Try commenting out the statement that closes your PrintWriter. What happens to the output file when you rerun your program?
• In what situation is writing program output to a file more appropriate than writing to the console? What happens to the console when you close Eclipse?
• What type of exception occurs if you do not set up your program arguments correctly? Is this a compile or runtime error?
• What type of exception requires the use of a try-catch block?

Specifications

• Work on your own, as always.
• The name of the source code file must be exactly

   P8.java 

• Name the file exactly - upper and lower case matters!
• Comments at the top as shown above.
• Assignments should be implemented using Eclipse.
• Assignments should be implemented using Java, version 1.8.
• Make sure your code runs on machines in the CSB 120 lab.
• Turn in through the Checkin tab.
• Read the syllabus for the late policy.
• We will be checking programs for plagiarism, so please don't copy from anyone else.

Grading Criteria

• 100 points for perfect submission.
• 0 points for no submission, will not compile, submitted class file, etc.
• Preliminary Tests
  • testCompile: checks that program compiles. (10 points)
  • lineTests: verify correct output based on String method used.
  • test1-test9: 10 points each

---