Assignment 5 Generic Classes \Utility Class

Creating a Tree Class, Building a Tree

Converting Morse code to English characters

 

Concepts tested by this program:

            Generic Classes

            Utility Class (all static methods)

New concepts tested by this program

            Linked Trees

            Building a Tree for conversion purposes

 

Samuel F. B. Morse produced the first working telegraph set in 1836. This made transmission possible over any distance. The first Morse Code message, "What hath God wrought?", was sent from Washington to Baltimore.

Morse code was extensively used for early radio communication beginning in the 1890s.

In the early part of the twentieth century, the majority of high-speed international communication

was conducted in Morse code, using telegraph lines, undersea cables, and radio circuits.

 

Morse code can also be transmitted using light which sometimes happens between ships at sea. It is used in emergencies to transmit distress signals when no other form of communication is available. The standard international distress signal is •••---••• (SOS).

 

 

Your assignment is to write a generic TreeNode class, a MorseCodeTreeclass and a MorseCodeConverter class.  There is no GUI required for this assignment.  Your classes will be tested with Junit tests.

 

TreeNodeclass

            This generic class is used in the MorseCodeTree classes.  The class consists of a reference to the data and a reference to the left and right child.Follow the Javadoc that is provided.  The Javadoc only lists those public methods that are required to pass the Junit tests.  You may add any private methods you need for your design.

 

MorseCodeTreeclass

      A generic linked binary tree which inherits from the LinkedConverterTreeInterface.  The class uses an external generic TreeNode class parameterized as a String: TreeNode<String.  This class uses the private member of root.  Nodes are added based on their morse code value.  A ‘.’ (dot) means to traverse left and a ‘-‘ (dash) means to traverse right. The constructor will “build the tree”.  Follow the Javadoc that is provided. The Javadoc only lists those public methods that are required to pass the Junit tests.  You may add any private methods you need for your design.

 

Building the Data Structure (buildTree)

Your MorseCodeTreeis a tree 4 levels.  Insert a mapping for every letter of the alphabetinto thetree map.  The root is aTreeNodewith an empty string.  The left node at level 1 stores letter ‘e’ (code ‘.’) and the right node stores letter ‘t’ (code ‘-‘).  The 4 nodes at level 2 are ‘i’, ‘a’, ‘n’, ‘m’ (code ‘..’, ‘.-‘, ‘-.’, ‘—‘).  Insertinto the tree by tree level from left to right.  A ‘.’ will take the branch to the left and a ‘-‘ will take the branch to the right.  This is the structure of the tree.

 

 

Using the Data Structure

Use the MorseCodeTree to convert Morse Code to English by taking the code and finding it’s corresponding English letter by traversing the MorseCodeTree, ‘.’ branches to the left and ‘-‘ branches to the right.  The code ‘.--.’ would branch to the left, then to the right, then to the right, then to the left to Fetch the letter ‘p’.  Each letter is delimited by a space (‘ ‘).  Each word is delimited by a ‘/’.

 

MorseCodeConverter – Utility Class

The MorseCodeConvertercontains a static MorseCodeTree object and constructs (calls the constructor for) the MorseCodeTree.

This class has two static methods convertToEnglishto convert from morse code to English. One method is passed a string object (“.-.. --- ...- . / .-.. --- --- -.- ...”).  The other method is passed a file to be converted.  These static methods use the MorseCodeTree to convert from morse code to English characters.  Each method returns a string object of English characters.

There is also a static printTree method that is used for testing purposed – to make sure the tree for MorseCodeTree was built properly.

Use the Javadoc provided to make sure that your MorseCodeConverter class follows the method headers so that the MorseCodeConverterTest will run correctly.

 

The JUnit Test Class

You must addat least 1test for MorseCodeConverter.convertToEnglish(String) and at least 1 test for MorseCodeConverter.convertToEnglish(File) to the MorseCodeConverterTest class.Include your test file with your code files.

 

Test Cases:

 

Hello World

 

 

How do I love thee let me count the ways

 

 

Some suggestions:

1.       There is a morse code translator at:

http://morsecode.scphillips.com/jtranslator.html

it will help you make test cases


Program Grade Sheet

Assignment #5

CS204

 

Name   ____________________________Blackboard Date/Time: _______________

 
DOCUMENTATION
CheckList for Assignment 5 is included and completed                                  1 pt   _____
Class documentation - Javadoc for all user created classes                              4 pt   _____
            Class Description, @author

            Method description, @param, @return

     Test Cases                                                                                                   6 pt_____

            JUnit Test Class

                        Implement STUDENT test for the MorseCodeConverter

                        Create a test for your MorseCodeTree class

UML Diagram                                                                                                  4 pt_____

Lessons Learned                                                                                              5  pt _____

In 3+ paragraphs, highlight your lessons learned and learning experience from working on this project.  How did you do?  What have you learned?  What did you struggle with? How will you approach your next project differently?

 
PROGRAMMING
     Programming Style

     Internal class documentation (within source code)                                       5 pt     _____

            Class description using Javadoc                                                                      

            Author’s Name, Class, Class Time, @author                                                  

Methods commented using Javadoc, @param, @return                                                         

     Accuracy - Received correct output                                                                                   

Public test given you                                                                              6 pt

Your tests for MorseCodeConverter and MorseCodeTree                                 4 pt   _____

Private tests                                                                                          10pt     _____

     Program Details

MorseCodeConverter                                                                           20pt   _____
a.       Uses the MorseCodeTree

b.      Static method convertToEnglish that takes a String object of morse code

and  returns a String object of corresponding English characters

c.       Static method convertToEnglish that takes a File object of morse code

and  returns a String object of corresponding English characters

d.      Static method to print the tree

e.       Follows the Javadoc provided

MorrisCodeTree                                                                                   25pt    _____
a.       Implements the LinkedConverterTreeInterface

b.      Creates and builds the MorseCodeTree

c.       Uses recursive method to add a node to the tree

d.      Uses recursive method to fetch a node from the tree

e.       Follow the Javadoc provided

TreeNode                                                                                             10pt    _____
Follow the Javadoc provided
Total                                                                                                                100pt   _____

Comments: