Finding the Code Responsible for Behavior

Revision as of 00:02, 25 May 2017

Background:

Students should be able to create an ArrayList and print it to the console (without a for loop). Students should also be able to read the Java API and understand inheritance at a high level.

Directions:

I can easily create an ArrayList of String named al, and add "a", "b", "c" and "d" to it. Then I can quickly print it out using the line of code System.out.println(al); This produces the output [a, b, c, d]. Have you ever wondered why the output looks like this? Why are those "weird" brackets included in the output? Why are there commas between each String? Let's discover the answer!

Part 1 - Read the API

1. Find the println method in the API. There are many println methods. Which overloaded println is used when you println an ArrayList? What method does the println call according the to API?
2. Since println invokes String.valueOf, navigate to this method. What method does String.valueOf invoke?
3. Now you can see that String.valueOf invokes the toString method of the object. What class does al belong to? Isn't it ArrayList?
4. Let's navigate to the ArrayList class. What class does ArrayList inherit its toString method from? This is the toString method we want to dissect.

Part 2 - Look at the Source Code in OpenJDK for Java

1. OpenJDK (Open Java Development Kit) is a free and open source implementation of the Java programming language.
2. If you do not already have it downloaded, discover how you can download the source code for Java from OpenJDK.
3. Understand the sub-directory structure. How does this relate to package/import statements?
4. Open the java source code for the class that you determined contains the toString that is executed to produce the output [a, b, c, d].

Part 3 - Find the code

1. Find the toString in the Java source code that is executed to produce the output [a, b, c, d].
2. Read and understand this method.
3. Copy and paste the code in the method, and explain the method in English.
   1. Indicate the line of code that produces the "[".
   2. Indicate the line of code that produces the "]".
   3. Indicate the line of code the places the comma and space between the elements in the ArrayList.

Part 4 - Open source vs. licensed code

1. Oracle makes this source code available. However, it is licensed and owned by Oracle. Therefore, can you modify this code? Is this open source??
2. What would be the proper way to change the way an ArrayList is output to a console.

Deliverables:

A document with answers to questions

Assessment:

TBD

Comments:

I used an in-class activity based on this description for two semesters now. Here is the link to the specific activity description and worksheet: https://goo.gl/6R6c2B. The students work in small groups during the recitation.

Additional Information:

Suggestions for the Open Source Project:

N/A

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License