Lab: Experimenting with Type-Safe Collections

Instructions: Answer the following questions one at a time. After answering each question, check your answer (by clicking on the check-mark icon if it is available) before proceeding to the next question.

Getting Ready: Before going any further, you should:

Depending on your development environment, create either a directory or a project for this lab.
Setup your development environment.
Download the following files:

ArrayColorFinder.java
Driver.java
../part1/colors.txt
../part2/robotics.jar
../part2/Bender.java
../part2/Driver1.java
../part2/Driver2.java
../part2/Driver3.java
../part2/familyroom.txt
../part2/box.txt
../part2/bump.txt
../part2/left9.txt

to an appropriate directory/folder (e.g., the course downloads directory/folder). In most browsers/OSs, the easiest way to do this is by right-clicking/control-clicking on each of the links above and then selecting Save as... or Save link as....

and add them to your project/directory. Remember to put the data files in the appropriate place (e.g., in the project directory in Eclipse). robotics.jar contains both Direction.class and Robot.class, which are in the robotics package;

1. A Review: This part of the lab will help you recall/remember some important concepts about arrays (especially arrays of objects).

Open ArrayColorFinder.java.
What "kind of thing" is colors?
.

Conceptually, it is an array of Color objects. In fact, it is really an array of references to Color objects.
What "kind of thing" is colors[0]?
.

Conceptually, it is a Color object. In fact, it is a reference to a Color object.
What "kind of thing" is names?
.

Conceptually, it is an array of String objects. In fact, it is really an array of references to String objects.
What statement allocates memory for colors?
.
colors = new Color[147];
After this statement has been executed, how many actual Color objects have been instantiated?
.

None. Space has been allocated for 147 references.

What statement instantiates the Color objects?


                                           value = new Color(red, green, blue);

What statement assigns Color objects to elements of the array colors?
.
colors[i] = value;
What word is commonly used to describe two arrays like names and colors?
.

They are often said to be conformal (that is, they have common indexes).
Open, compile and execute the Driver. What output is generated when you enter "snow"?
.
snow: java.awt.Color[r=255,g=250,b=250]
What output is generated when you enter "apricotice"? Why?
.

No output is generated since there is no such color. (Actually, I used to have a car that was "Apricot Ice" but that's a story for another day.)

2. Using List Objects: This part of the lab will help you become acquainted with the List interface and the ArrayList class.

Create a class named ListColorFinder and copy the code from ArrayColorFinder into it (changing the name of the constructor appropriately).
Change the declarations of the parameters named colors and names so that they are both List objects. (Do not parameterize them!) What changes did you make?
.
private List colors; private List names;
Recall that you must import something in order to use the List class. What line do you have to add to the top of your class as a result?
.
import java.util.List;
Change the instantiation of the colors and names objects so that they are now ArrayList objects. What changes did you make?
.
colors = new ArrayList(); names = new ArrayList();
What did you need to import?
.
import java.util.ArrayList;
Why can you declare variables to be List objects but instantiate them as ArrayList objects>?
.

Because the ArrayList class implements the List interface. In other words, an ArrayList object "is a" List.
What is the major advantage of declaring these variables to be List objects rather than ArrayList objects>?
.

The particular implementation can easily be changed, if needed.
What is the major advantage of using List objects rather than arrays? (Hint: It should be immediately apparent from the change you just made.)
.

They do not have a pre-defined size.
Change the statements in the for loop that store the names and colors. (Hint: Look at the documentation for the ArrayList class.) What changes did you make?
.

I replaced names[i] with names.set(i, key), and colors[i] with colors.set(i, value).
Change the statements in the for in getColor(). (Hint: Look at the documentation for the ArrayList class.) What changes did you make?
.

I replaced names.length with names.size(), names[i] with names.get(i), and colors[i] with colors.get(i).

Compile the ListColorFinder class. What error messages were generated?


                                    ColorFinder.java:106: incompatible types
found   : java.lang.Object
required: java.lang.String
          key = names.get(i);
                         ^
ColorFinder.java:109: incompatible types
found   : java.lang.Object
required: java.awt.Color
             result = colors.get(i);
                                ^

Fix these errors by typecasting the objects that are returned by the get() method calls. What changes did you make?


                                              key = (String)names.get(i);

and


                                                 result = (Color)colors.get(i);

Compile the ListColorFinder class. The compiler still generates at least one "Note/Warning" when you compile the class. What "Note/Warning" is generated?
.
A warning about using raw types.
Why is this "Note" generated?
.

Because we did not ensure type safety.

3. Making a List Type Safe: This part of the lab will help you understand how to use type-safe collections.

Change the declaration of colors so that it is a List of Color objects. What change did you make?
private List<Color> colors;
Change the declaration of names so that it is a List of String objects. What change did you make?
private List<String> names;

Change the instantiation of the colors and names objects. What changes did you make?


                                           colors = new ArrayList<Color>();
       names  = new ArrayList<String>();

"Fix" the getColor() method so that it no longer casts the objects returned by the calls to get(). What changes did you make?
key = names.get(i);
and
result = colors.get(i);
Was it necessary to remove the type cast?

No. But, there is no reason to cast a String as a String or a Color as a Color.

4. Using a Map: This part of the lab will help you understand how to use objects that implement the Map interface and some of the benefits of maps. Since you understand type-safety now, there's no reason to start with a version that isn't type-safe.

Create a class named MapColorFinder and copy the code from ArrayColorFinder into it (changing the name of the constructor appropriately).
Delete the declaration and instantiation of the names object.
Change the declaration of the colors object so that it is now a Map with a key of type String and a value of type Color. (This is often described as a Map from String to Color.) What code did you change?
.
Map<String,Color> colors;
What class do you need to import?
.
java.util.Map
Instantiate the colors object as a HashMap from String to Color. What code did you add?
.
colors = new HashMap<String,Color>();
What class do you need to import?
.
java.util.HashMap
Replace the assignment statements involving the local variables key and value with a call to the appropriate method in the HashMap class. What change did you make?
.
colors.put(key, value);
Complete the getColor() method in the ColorFinder class so that it now uses the HashMap named colors. (Hint: Look at the documentation for the HashMap class.) What code did you add?
.
public Color getColor(String description) { return colors.get(description); }
What is the major advantage of Map objects as compared to List objects. (Hint: It should be immediately apparent from the change you just made.)
.

They can use anything as the key/index.

5. Passing a Simple Type-Safe Collection: This part of the lab will help you understand how to pass type safe collections as parameters.

Open the Bender and Driver1 classes.

The Robot class includes the following methods:


                             protected boolean canMove(Direction d)

        protected void move(Direction d)

        protected boolean haveBeen(Direction d)

Complete the execute() method in the Bender class using the above methods from the Robot class in such a way that it is consistent with the comments describing it. (Note: You need not use the haveBeen() method.) Do not use an Iterator or a for-each loop.

What code did you add?


                                        public void execute(List<Direction> method)
    {
       Direction        d;
       

       for (int i=0; i<method.size(); i++)
       {
          d = method.get(i);
	  move(d);          
       }
    }

Compile and execute Driver1.

Modify the execute() method so that it uses a for-each loop. What is your execute() method now?


                                        public void execute(List<Direction> method)
    {
       for (Direction d: method)
       {
           move(d);
       }
    }

Compile and execute Driver1.

Modify the execute() method so that it uses an Iterator. What is your execute() method now?


                                        public void execute(List<Direction> method)
    {
       Direction              d;
       Iterator<Direction>    i;

       i = method.iterator();
       while (i.hasNext())
       {
           d = i.next();
           move(d);
       }
    }

Compile and execute Driver1.

6. Creating a Simple Type-Safe Collection: This part of the lab will help you understand how to read a text file and use it to create a simple type-safe collection.

Read and understand the Driver2 class and the data file box.txt.

Add the following method to the Bender class and complete it. (For this question you should assume that there are four directions: Direction.FORWARD, Direction.RIGHT, Direction.BACKWARD, and Direction.LEFT.)

     * Read instructions from a file
     *
     * @param name   The name of the file
     * @return       An ArrayList of Direction objects
     */
    public List<Direction> read(String name)
    {


    }

What code did you add?


                                        public List<Direction> read(String name)
    {
       BufferedReader           in;
       File                     file;       
       String                   line;       
       List<Direction>    method;
       

       try
       {
          file    = new File(name);
          in      = new BufferedReader(new FileReader(file));
          method  = new ArrayList<Direction>();
          
          while ((line=in.readLine()) != null)
          {
	     Direction      d;

	     d = Direction.valueOf(line);
	     if (d != null) method.add(d);

             // This could also be accomplished as follows:
             //if      (line.equals("FORWARD"))  method.add(Direction.FORWARD);
             //else if (line.equals("RIGHT"))    method.add(Direction.RIGHT);
             //else if (line.equals("BACKWARD")) method.add(Direction.BACKWARD);
             //else if (line.equals("LEFT"))     method.add(Direction.LEFT);
          }
       }
       catch (IOException ioe)
       {
          method = null;
       }
       
       return method;       
    }

Compile and execute Driver2.
The Direction class actually includes Direction.CONTINUE. Add a line to the read() method that accounts for this Direction. What code did you add?
For the implementation that uses if statements, I added the following: else if (line.equals("CONTINUE")) method.add(Direction.CONTINUE);
For the implementation that uses valueOf() it isn't necessary to make any changes.

Modify the execute() method (the version that uses the Iterator pattern) so that it handles Direction.CONTINUE. Specifically, when a Direction.CONTINUE is encountered the execute() method must get the next element in the method collection and then repeatedly move the Robot in that direction until it can no longer do so. What code did you add?


                                        public void execute(List<Direction> method)
    {
       Direction        d;
       Iterator<Direction>    i;

       i = method.iterator();
       while (i.hasNext())
       {
          d = i.next();

          if (d.equals(Direction.CONTINUE))
          {
             d = i.next();
             while (canMove(d)) move(d);             
          }
          else
          {
             move(d);          
          }
       }
    }

7. Using Complicated Type-Safe Collections: This part of the lab will help you understand more complicated type-safe collections.

Read and understand Driver3.
Add the following attribute to the Bender class:
```
    private Map<String, List<Direction>>    library;
    
```
Make sure you understand this declaration.
Instantiate the library attribute in the constructor of the Bender class. What code did you add?
library = new HashMap<String, List<Direction>>();

Add the following method to the Bender class and complete it:

    /**
     * Add a method to the existing library
     *
     * @param method   The method to add
     */
    public void add(String name, List<Direction> method)
    {

    }

What code did you add?


                                    
    /**
     * Add a method to the existing library
     *
     * @param method   The method to add
     */
    public void add(String name, List<Direction> method)
    {
       library.put(name, method);       
    }

Add the following method to the Bender class and complete it:

    /**
     * Execute a named set of instructions from the library.
     * Specifically, retrieve a named set of instructions from
     * the library and then call the other version of
     * execute().
     *
     * @param name   The name of the method
     */
    public void execute(String name)
    {
    }

What code did you add?


                                        /**
     * Execute a named set of instructions from the library.
     * Specifically, retrieve a named set of instructions from
     * the library and then call the other version of
     * execute().
     *
     * @param name   The name of the method
     */
    public void execute(String name)
    {
       List<Direction>        method;
       
       method = library.get(name);
       if (method != null) execute(method);
    }

Compile and execute Driver3.