Chapter 6 Object-Oriented Design Part 3

© 2004 Pearson Addison-Wesley. All rights reserved6-2 Outline Enumerated Types Revisited Method Design Testing

© 2004 Pearson Addison-Wesley. All rights reserved6-3 Enumerated Types In Chapter 3 we introduced enumerated types, which define a new data type and list all possible values of that type enum Season {winter, spring, summer, fall} Once established, the new type can be used to declare variables Season time; // Note: no quotes around time. The only values this variable can be assigned are the ones established in the enum definition

© 2004 Pearson Addison-Wesley. All rights reserved6-4 Enumerated Types An enumerated type definition is a special kind of class The values of the enumerated type are or objects of that type For example, fall is an object of type Season Fall is ‘associated’ with a list of values. That's why the following assignment is valid time = Season.fall;

© 2004 Pearson Addison-Wesley. All rights reserved6-5 Enumerated Types An enumerated type definition can be more interesting than a simple list of values Because they are like classes, we can add additional instance data and methods We can define an enum constructor as well Each value listed for the enumerated type calls the constructor See Season.java (page 318)Season.java See SeasonTester.java (page 319)SeasonTester.java DO go through these routines.

© 2004 Pearson Addison-Wesley. All rights reserved6-6 // Season.java Author: Lewis/Loftus // Enumerates the values for Season. //******************************************************************** public enum Season //Note: this is NOT a class! You do NOT see ‘class’ here… { winter ("December through February"), // Note the syntax: the comma?? spring ("March through May"), summer ("June through August"), fall ("September through November"); // and ultimately the semicolon! // Note that this is a new ‘data type’ And we list all possible values of this type. // The only values of this type are winter, spring, summer, and fall. private String span; // // Constructor: Sets up each value with an associated string. // Season (String months) // Note the Constructor; kind of ‘like’ a Constructor. { span = months; } // // Returns the span message for this value. // public String getSpan() { return span; } } // end enum Season

© 2004 Pearson Addison-Wesley. All rights reserved6-7 //******************************************************************** // SeasonTester.java Author: Lewis/Loftus // // Demonstrates the use of a full enumerated type. //******************************************************************** public class SeasonTester { // // Iterates through the values of the Season enumerated type. // public static void main (String[] args) { for (Season time : Season.values()) // note: ‘time is a ‘variable’ of enum Season. This invokes enum types via Season.values(). Very neat! When we declare ‘time’, System.out.println (time + "\t" + time.getSpan()); }

© 2004 Pearson Addison-Wesley. All rights reserved6-8 Enumerated Types Every enumerated type contains a static method called values that returns a list of all possible values for that type  The list returned from values is an iterator, so a for loop can be used to process them easily (infer that there is a next() and a hasNext() method. An enumerated type cannot be instantiated outside of its own definition A carefully designed enumerated type provides a versatile and type-safe mechanism for managing data

© 2004 Pearson Addison-Wesley. All rights reserved6-9 Outline Software Development Activities Identifying Classes and Objects Static Variables and Methods Class Relationships Interfaces Enumerated Types Revisited Method Design Testing

© 2004 Pearson Addison-Wesley. All rights reserved6-10 Method Design As we've discussed, high-level design issues include:  identifying primary classes and objects  assigning primary responsibilities After establishing high-level design issues, its important to address low-level issues such as the design of key methods For some methods, careful planning is needed to make sure they contribute to an efficient and elegant system design

© 2004 Pearson Addison-Wesley. All rights reserved6-11 Method Design An algorithm is a step-by-step process for solving a problem Examples: a recipe, travel directions  Every method implements an algorithm that determines how the method accomplishes its goals An algorithm may be expressed in pseudocode, a mixture of code statements and English that communicate the steps to take

© 2004 Pearson Addison-Wesley. All rights reserved6-12 Method Decomposition A method should be relatively small, so that it can be understood as a single entity A potentially large method should be decomposed into several smaller methods as needed for clarity A public service method of an object may call one or more private support methods to help it accomplish its goal Support methods might call other support methods if appropriate

© 2004 Pearson Addison-Wesley. All rights reserved6-13 Method Decomposition Let's look at an example that requires method decomposition – translating English into Pig Latin Pig Latin is a language in which each word is modified by moving the initial sound of the word to the end and adding "ay" Words that begin with vowels have the "yay" sound added on the end bookookbaytableabletay itemitemyaychairairchay

© 2004 Pearson Addison-Wesley. All rights reserved6-14 Method Decomposition The primary objective (translating a sentence) is too complicated for one method to accomplish Therefore we look for natural ways to decompose the solution into pieces Translating a sentence can be decomposed into the process of translating each word The process of translating a word can be separated into translating words that:  begin with vowels  begin with consonant blends (sh, cr, th, etc.)  begin with single consonants

© 2004 Pearson Addison-Wesley. All rights reserved6-15 Method Decomposition See PigLatin.java (page 320)PigLatin.java See PigLatinTranslator.java (page 323)PigLatinTranslator.java  In a UML class diagram, the visibility of a variable or method can be shown using special characters  Public members are preceded by a plus sign  Private members are preceded by a minus sign Know these visibility symbols: +. -, #. (# means ‘protected’ – later with inheritance)

© 2004 Pearson Addison-Wesley. All rights reserved6-16 Class Diagram for Pig Latin PigLatin + main (args : String[]) : void + translate (sentence : String) : String - translateWord (word : String) : String - beginsWithVowel (word : String) : boolean - beginsWithBlend (word : String) : boolean PigLatinTranslator  Be able to explain everything on this UML! If you do NOT understand, ask me!

© 2004 Pearson Addison-Wesley. All rights reserved6-17  Objects as Parameters Another very important issue related to method design involves parameter passing Parameters in a Java method are passed by value. This is often referred to as Call by Value. A copy of the actual parameter (the value passed in) is stored into the formal parameter (in the method header) Therefore passing parameters is similar to an assignment statement When an object is passed to a method, the actual parameter and the formal parameter become aliases of each other

© 2004 Pearson Addison-Wesley. All rights reserved6-18 Passing Objects to Methods What a method does with a parameter may or may not have a permanent effect (outside the method) See ParameterTester.java (page 327)ParameterTester.java See ParameterModifier.java (page 329)ParameterModifier.java See Num.java (page 330)Num.java Note the difference between changing the internal state of an object versus changing which object a reference points to.

© 2004 Pearson Addison-Wesley. All rights reserved6-19 Bottom Line – Know This. The whole thing about Call by Value (true for all languages that do this: C, COBOL (calls theirs Call by Content), Java, etc.) is that only the values of the variables are copied into the format parameters of the invoked methods.  So, once values are passed, whatever the called method does with them WILL NOT affect the values in the calling method at all! When we ‘return,’ the original values are unchanged. BUT: Objects and other structures are called by what we say is Call by Reference. In this case, only the reference (address) of the item is passed. So, the calling method and the called method are actually looking at the same item in the computer’s memory. Thus, anything changed in the called method to, say, an attribute in a passed object, will have the same result in the calling reference.

© 2004 Pearson Addison-Wesley. All rights reserved6-20 // ParameterTester.java Author: Lewis/Loftus public class ParameterTester { // serve as actual parameters to the changeValues method. Prints their values before and after // calling the method. public static void main (String[] args) // main driver. { ParameterModifier modifier = new ParameterModifier(); int a1 = 111; // plain, old integer with a value Num a2 = new Num (222); // two objects, each with a value Num a3 = new Num (333); // “ // The integer will be passed ‘by value’; object: ‘by reference.’ System.out.println ("Before calling changeValues:"); System.out.println ("a1\ta2\ta3"); // merely a header System.out.println (a1 + "\t" + a2 + "\t" + a3 + "\n"); //returns value of int a1 plus executes the toString method of Num for a2 and a3 (since these are objects. No values changed yet. modifier.changeValues (a1, a2, a3); //invokes the changeValues method object, modifier. // passes the int, a1, by value; passes objects a2 and a3 by reference. System.out.println ("After calling changeValues:"); System.out.println ("a1\ta2\ta3"); System.out.println (a1 + "\t" + a2 + "\t" + a3 + "\n"); //note: value for a1 not changed. } // values for a2 and a3 ARE changed (as changed in the changeValues method) }

© 2004 Pearson Addison-Wesley. All rights reserved6-21 //******************************************************************** // ParameterModifier.java Author: Lewis/Loftus // // Demonstrates the effects of changing parameter values. //******************************************************************** public class ParameterModifier { // // Modifies the parameters, printing their values before and // after making the changes. // public void changeValues (int f1, Num f2, Num f3) { System.out.println ("Before changing the values:"); System.out.println ("f1\tf2\tf3"); System.out.println (f1 + "\t" + f2 + "\t" + f3 + "\n"); f1 = 999; f2.setValue(888); f3 = new Num (777); System.out.println ("After changing the values:"); System.out.println ("f1\tf2\tf3"); System.out.println (f1 + "\t" + f2 + "\t" + f3 + "\n"); } Prints out values of formal params (f2 and f3 use toString…) Discuss: integer; f2.setValue(888); f3? old f3?? Talk! And new values are: xxxxxx But when we ‘return’ to driver?? Note: f2 and a2 are aliases! f3 was unchanged here. so too a3.

© 2004 Pearson Addison-Wesley. All rights reserved6-22 // Num.java Author: Lewis/Loftus Represents a single integer as an object. //******************************************************************** public class Num { private int value; // // Sets up the new Num object, storing an initial value. // public Num (int update) { value = update; } // // Sets the stored value to the newly specified value. // public void setValue (int update) { value = update; } // // Returns the stored integer value as a string. // public String toString () { return value + ""; } } // end class Num

© 2004 Pearson Addison-Wesley. All rights reserved6-23  Method Overloading Method overloading is the process of giving a single method name multiple definitions If a method is overloaded, the method name is not sufficient to determine which method is being called  The signature of each overloaded method must be unique The signature includes the number, type, and order of the parameters Method overloading is a very important concept!

© 2004 Pearson Addison-Wesley. All rights reserved6-24 Method Overloading The compiler determines which method is being invoked by analyzing the parameters float tryMe(int x) { return x +.375; } float tryMe(int x, float y) { return x*y; } result = tryMe(25, 4.32) Invocation

© 2004 Pearson Addison-Wesley. All rights reserved6-25 Method Overloading The println method is overloaded: println (String s) println (int i) println (double d) and so on... The following lines invoke different versions of the println method: System.out.println ("The total is:"); System.out.println (total);

© 2004 Pearson Addison-Wesley. All rights reserved6-26 Overloading Methods  The return type of the method is not part of the signature  That is, overloaded methods cannot differ only by their return type  Constructors can be overloaded  Overloaded constructors provide multiple ways to initialize a new object This is very important to understand! We may have a class built to do op1 in different ways depending upon the data type for which op1 is to be instantiated. If Strings, we do it one way; if objects, perhaps some other way; if ints, some other way!

© 2004 Pearson Addison-Wesley. All rights reserved6-27 Outline Software Development Activities Identifying Classes and Objects Static Variables and Methods Class Relationships Interfaces Enumerated Types Revisited Method Design Testing

© 2004 Pearson Addison-Wesley. All rights reserved6-28 Testing Testing can mean many different things It certainly includes running a completed program with various inputs It also includes any evaluation performed by human or computer to assess quality Some evaluations should occur before coding even begins The earlier we find an problem, the easier and cheaper it is to fix

© 2004 Pearson Addison-Wesley. All rights reserved6-29 Testing The goal of testing is to find errors As we find and fix errors, we raise our confidence that a program will perform as intended We can never really be sure that all errors have been eliminated  So when do we stop testing?  Conceptual answer: Never  Snide answer: When we run out of time  Better answer: When we are willing to risk that an undiscovered error still exists

© 2004 Pearson Addison-Wesley. All rights reserved6-30 Reviews A review is a meeting in which several people examine a design document or section of code It is a common and effective form of human-based testing Presenting a design or code to others:  makes us think more carefully about it  provides an outside perspective Reviews are sometimes called inspections or walkthroughs

© 2004 Pearson Addison-Wesley. All rights reserved6-31  Test Cases A test case is a set of input and user actions, coupled with the expected results Often test cases are organized formally into test suites which are stored and reused as needed For medium and large systems, testing must be a carefully managed process Many organizations have a separate Quality Assurance (QA) department to lead testing efforts

© 2004 Pearson Addison-Wesley. All rights reserved6-32 Defect and Regression Testing Defect testing is the execution of test cases to uncover errors  The act of fixing an error may introduce new errors  After fixing a set of errors we should perform regression testing – running previous test suites to ensure new errors haven't been introduced  It is not possible to create test cases for all possible input and user actions Therefore we should design tests to maximize their ability to find problems

© 2004 Pearson Addison-Wesley. All rights reserved6-33  Black-Box Testing In black-box testing, test cases are developed without considering the internal logic  They are based on the input and expected output  Input can be organized into equivalence categories Two input values in the same equivalence category would produce similar results  Therefore a good test suite will cover all equivalence categories and focus on the boundaries between categories

© 2004 Pearson Addison-Wesley. All rights reserved6-34  White-Box Testing White-box testing focuses on the internal structure of the code The goal is to ensure that every path through the code is tested Paths through the code are governed by any conditional or looping statements in a program A good testing effort will include both black-box and white-box tests