©2006 Felleisen, Proulx, et. al.

3  Designing Methods -- Part 2

We continue with the the theme of the photo images. Our goal is to design methods that answer questions about list of images and manipulate these lists.

We will also work with the geometric shapes and learn to draw their images on the Canvas. At the end we will design a simple interactive program.

3.1  Methods for Self-Referential Data

In the previous lab you designed a list of photo images. We first design the method that counts the images in our list.

Note: Of course, you will quickly realize that this method will look the same regardless of what are the pieces of data contained in the list. We will address that issue later on, once we are comfortable with dealing with lists that contain specific items.

Below is an example of the design of a method that counts the number of pictures in a list of photo image.

The method deals with ListOfPhotos. We have an interface ListOfPhotos and two classes that implement the interface, MTListOfPhotos and ConsListOfPhotos. When the DESIGN RECIPE calls for the method purpose statement and the header, we include the purpose statement and the header in the interface ListOfPhotos and in all the classes that implement the interface.

Including the method header in the interface serves as a contract that requires that all classes that implement the interface define the method with this header. As the result, the method can be invoked by any instance of a class that implement the interface - without the need for us to distinguish what is the defined type of the object.

We can now proceed with the DESIGN RECIPE.

Design the methods that will help you in dealing with your photo collection:

  1. Before burning a CD of your photos, you want to know what is the total size in bytes of all photos in the list of photos.

  2. When organizing your photos you want to know whether all photos in the list are from the given date.

    Remember to use helper methods and to delegate the tasks to the classes that are best suited to provide the desired answer.

  3. You now want to go over the list of photos and select only those that were taken on the given date.

3.2  Quiz

You have 10 minutes.

3.3  Methods for Self-Referential Data -- Part 2 Graphics and Key Events

In the previous lab you defined classes that represent different geometric shapes - a circle, a square, and a shape that is a combination of two shapes, the top and the bottom one.

  1. Design the method that computes the total area of a shape. For the shape that consists of two components add the areas - as if you were measuring how much paint is needed to paint all the components.

    You will need to use math functions, such as square root. The following example show how you can use the math function, and how to test doubles for equality. (You can only make sure they are different only within some given tolerance.)

    class Foo{
      double x;
    
      Foo(double x){
        this.x = x;
      }
    
      double squareRoot(){
        return Math.sqrt(this.x);
      }
    }
    
    class Examples {
      Examples () {}
    
      Foo f = new Foo(16.0);
    
      boolean testSquared = 
        check this.f.squareRoot() expect 4.0 within 0.01;
    }
    

  2. Design the method that produces a new shape moved by the given distance in the vertical and horizontal direction.

  3. Design the method that determines whether the given point is within this shape.

  4. Of course, we would like to draw the shapes on a canvas. The following code (that can be written within the Examples class shows how you can draw one circle:

    import draw.*;
    import colors.*;
    import geometry.*;
    
    class Examples{
      Examples() {}
    
      Canvas c = new Canvas(200, 200);
      
      boolean makeDrawing = 
        this.c.show() && 
        this.c.drawDisk(new Posn(100, 150), 50, new Red());
    }
      

    The three import statements on the top indicate that we are using the code programmed by someone else and available in the libraries named draw, colors, and geometry. Open the Help Desk and look under the Teachpacks for the teachpacks for How to Design Classes to find out more about the drawing and the Canvas.

  5. Finally, add some interaction to your program, by letting the shape move in response to the key events. Design the method onKeyEvent that consumes a String and moves the shape up, down, left, or right by 5 pixels every time the user hits one of the corresponding arrow keys.

    Use the code in the program WorldDemo.ijava to figure out how to respond to the key events and to see how to run the program. To get the program working, you need to use ProfessorJ Intermediate Language -- but do so only for this part of the lab.

Save all your work -- the next lab will build on the work you have done here!

If you have some time left, work on the Etudes part of the homework, especially on the Etude 3.2 that deals with Binary Search Trees.

Last modified: Thursday, September 21st, 2006 10:30:00am