Easy-to-follow video tutorials help you learn software, creative, and business skills.Become a member

Using the debugger

From: Java Essential Training

Video: Using the debugger

All good Java development environments including Eclipse provide good debuggers that allow you to inspect data at runtime, set breakpoints, and otherwise figure out what's going on in your code. I'm going to show you how to use the debugger and along the way, I'll show you how to work with parts of the Java class library that commonly throw exceptions, how you can find out what those exceptions might be and anticipate them. I'm working in an empty main method in the current project debugger. I'm going to declare a variable of a special type URI.

Using the debugger

All good Java development environments including Eclipse provide good debuggers that allow you to inspect data at runtime, set breakpoints, and otherwise figure out what's going on in your code. I'm going to show you how to use the debugger and along the way, I'll show you how to work with parts of the Java class library that commonly throw exceptions, how you can find out what those exceptions might be and anticipate them. I'm working in an empty main method in the current project debugger. I'm going to declare a variable of a special type URI.

URI stands for Uniform Resource Identifier. This class is a part of the package java.net and is part of a collection of classes that are used for network communications in Java. After you have typed URI, press Ctrl+ Spacebar and choose the URI class from java.net. That will add an import statement at the top of the code. Then give it a variable name uri, all lower case, and set its initial value with the constructor method new URI and pass in a well formed domain string such as "http://somecompany.com." It doesn't matter what the name of the domain is or even whether it's real website, what matters is that it's well formed with http://at the beginning and then a well formed domain at the end.

When you save your changes and build the project, you'll see an error has occurred, Unhandled exception type URISyntaxException. The Java compiler seems to think that when I call this URI constructor method, it might throw an exception and that it's up to me as the programmer to make sure that I've handled that exception. Well, how would I know that as the programmer unless I have to wait for the compiler to tell me? And the answer as is so frequently the case in Java is that it's there in the documentation.

I'll go to the URI documentation, I'll double click URI, the data type and then I'll go to my Dynamic Help and click javadoc for java.net.uri and I'll maximize the Help screen. In the documentation, I'll click on Constructor, here is the method that I just called URI receiving a string argument. I'll click that method and it tells me and the documentation very explicitly, this method could throw an the instance of URI syntax exception.

So when you're working with a method that's part of the Java class library and that method has been defined as throwing an exception, it'll be there in the docs. So what do I have to do as a developer to deal with that? If a bit of code is going to throw an exception I have to handle it with a Try/catch method or by putting an appropriate throws declaration in the method signature where I'm actually calling the code. I'm going to wrap up this code with a Try /catch block, I'll select the code then right-click it and choose Surround With, Try/catch block.

Eclipse is smart enough to look at the syntax of the class or the method and say hey that method might throw URI syntax exception and so that's the class that puts into the catch block that it generates. Now, I'll delete the TODO comment and I will add a little bit more code down at the bottom, so I can see clearly that the application is still running System.out.println and I'll put the message "I'm alive!" I'll save the change and run the application.

And the first time everything works fine because the string that I passed into the URI method was a well formed domain. But now let's create an intentional error. I'll change those forward slashes to Backslashes. That will create a malformed URI. I'll save and run the application and now I get the stack dump. I still see I'm alive! at the end of the output. And by the way, you might not see this at the end of the output it might be mixed into the middle don't worry about that.

But if you see that message that means that the Trycatch block is working but in fact, this error message is being thrown as part of that complex exception object and this takes us to the debugger. Let's say, that I wanted to interrogate that exception object while I'm programming, I wanted to look at its structure. I can put a breakpoint on the line where the printStackTrace command is being executed. And I can freeze the execution of the application, suspend it, while it's suspended, I can use Eclipse to inspect that exception object and see what information is available.

To do this place a breakpoint on the line where the exception object is in scope, in this case it's on this line where I'm calling printStackTrace. To set a breakpoint, go to the left trough over on the left side of the editor and either double-click or you can right click and choose Toggle Breakpoint. Either way, you should see this little icon showing that there is now a breakpoint at this particular line. Now it's time to run the application in debug mode. Go to the toolbar and click debug, it's the little button that looks like it has a cockroach or a bug on it. Click the button.

If you see a message from your firewall application, let it know that everything is okay, and then you should see this message Confirm Perspective Switch. This is telling you that Eclipse wants to switch to something called the Debug perspective. The debug perspective is a collection of views that will allow you to more quickly inspect and fix your application. Click Yes. And this is the debug perspective. There is a Debug view in the upper left that shows your current call stack, a Variables view that shows all the currently in scope variables the Editor, the Outline and down at the bottom, the Console.

Go to the Variables view because you suspended the application at the point where the exception object became available, you should see the exception object named e listed there, double-click the tab for variables to expand it and then expands the e object. You'll see that there's all sorts of interesting information the cause, the detail message, the index, the input and the stack trace. Now some of these values occur on all exception objects like the detail message, but the values that they have may or may not be useful.

In this case, there's a pretty interesting error here, Illegal character in opaque part. But you'll also find that you can call methods of the exception object to get the information more elegantly. Once you've finished inspecting the exception object, double-click the Variables tab to return it to its original size, then go up to the toolbar and click the Terminate button, it's the red square button on the toolbar. And then return to your CustomForJava perspective.

You can choose the perspective from the upper right or you can go to the Menu and choose Window, Open Perspective, Other and choose the perspective you want, I've been using this one CustomForJava. Once you know what the structure of the exception object is, you can do some interesting stuff with it. So for example, instead of printing the stack trace, I'm going to do a little print line here System.out.println. And I'm going to output a value from e.getMessage. This is a method that's available on all exception objects.

I'll save my changes and run the application again. And I get that message Illegal character in opaque part at index 5, and it's talking about index 5 of the string. If you start counting at 0, the letter h is 0, ttp is 1, 2, 3, the : is 4 and the / is 5, that \\ was interpreted as a \ by Java and it's telling me exactly where the problem is in that string.

So now, I can come back to the code and go oh gosh, I put in \\ instead of // and I can fix it, save and run, and everything is okay. So whenever you are working with a method that might throw an exception, you should wrap it inside a Try/catch block and then within the catch block to can set a breakpoint and inspect that exception object. Once you know how to use the debugger for that, you know how to use it for everything. Whenever you have some information in your Java programming environment and you're not sure what the value of a variable is, set a breakpoint and use the debugger.

Show transcript

This video is part of

Image for Java Essential Training
Java Essential Training

71 video lessons · 72348 viewers

David Gassner
Author

 
Expand all | Collapse all
  1. 10m 8s
    1. Welcome
      1m 3s
    2. Is this course for you?
      5m 35s
    3. Using the exercise files
      3m 30s
  2. 31m 24s
    1. The history of Java
      5m 19s
    2. Java compilation and syntax
      8m 54s
    3. Understanding the principles of Java
      8m 28s
    4. Choosing a development environment
      8m 43s
  3. 19m 5s
    1. Installing Java on Windows
      6m 42s
    2. Installing Eclipse on Windows
      3m 19s
    3. Exploring Java on Mac OS X Leopard and Snow Leopard
      2m 27s
    4. Installing Java on Mac OS X Lion
      3m 27s
    5. Installing Eclipse on Mac OS X
      3m 10s
  4. 46m 10s
    1. Creating a Hello World application
      11m 7s
    2. Exploring the Eclipse IDE
      8m 55s
    3. Compiling and running from the command line
      8m 2s
    4. Passing arguments to the application
      8m 17s
    5. Using the Java API documentation
      4m 5s
    6. Memory management and garbage collection
      5m 44s
  5. 58m 57s
    1. Everything is an object
      5m 59s
    2. Declaring and initializing variables
      9m 15s
    3. Working with numbers
      8m 32s
    4. Converting numeric values
      6m 40s
    5. Understanding operators
      7m 58s
    6. Working with character values
      5m 14s
    7. Working with boolean values
      5m 13s
    8. Outputting primitive values as strings
      5m 33s
    9. Creating a simple calculator application
      4m 33s
  6. 53m 40s
    1. Writing conditional code
      5m 35s
    2. Using the switch statement
      8m 50s
    3. Repeating code blocks with loops
      7m 35s
    4. Creating reusable code with methods
      6m 31s
    5. Declaring methods with arguments
      5m 41s
    6. Overloading method names with different signatures
      5m 53s
    7. Passing arguments by reference or by value
      5m 35s
    8. Creating a more complex calculator application
      8m 0s
  7. 20m 30s
    1. Using the String class
      5m 44s
    2. Building strings with StringBuilder
      3m 34s
    3. Parsing string values
      3m 19s
    4. Working with date values
      7m 53s
  8. 20m 44s
    1. Understanding compile-time vs. runtime errors
      4m 5s
    2. Handling exceptions with try/catch
      4m 55s
    3. Throwing exceptions in methods
      2m 50s
    4. Using the debugger
      8m 54s
  9. 32m 22s
    1. Using simple arrays
      4m 47s
    2. Using two-dimensional arrays
      6m 17s
    3. Managing resizable arrays with ArrayList
      7m 14s
    4. Managing unordered data with HashMap
      6m 5s
    5. Looping through collections with iterators
      7m 59s
  10. 52m 2s
    1. Understanding encapsulation
      5m 59s
    2. Creating and instantiating custom classes
      8m 8s
    3. Organizing classes with packages
      6m 47s
    4. Creating and using instance methods
      6m 52s
    5. Storing data in instance variables
      6m 56s
    6. Using constructor methods
      5m 40s
    7. Managing instance data with getter and setter methods
      8m 26s
    8. Using class variables and Enum classes
      3m 14s
  11. 41m 15s
    1. Understanding inheritance and polymorphism
      9m 12s
    2. Extending custom classes
      9m 1s
    3. Overriding superclass methods
      3m 8s
    4. Casting subclass objects
      5m 3s
    5. Understanding interfaces and implementing classes
      4m 2s
    6. Creating your own interfaces
      4m 14s
    7. Using abstract classes and methods
      6m 35s
  12. 32m 17s
    1. Managing files with the core class library
      7m 46s
    2. Managing files with Apache Commons FileUtils
      7m 32s
    3. Reading a text file from a networked resource
      7m 52s
    4. Parsing an XML file with DOM
      9m 7s
  13. 17m 39s
    1. Creating your own JAR files
      4m 54s
    2. Understanding the classpath
      5m 2s
    3. Documenting code with Javadoc
      7m 43s
  14. 47s
    1. Goodbye
      47s

Start learning today

Get unlimited access to all courses for just $25/month.

Become a member
Sometimes @lynda teaches me how to use a program and sometimes Lynda.com changes my life forever. @JosefShutter
@lynda lynda.com is an absolute life saver when it comes to learning todays software. Definitely recommend it! #higherlearning @Michael_Caraway
@lynda The best thing online! Your database of courses is great! To the mark and very helpful. Thanks! @ru22more
Got to create something yesterday I never thought I could do. #thanks @lynda @Ngventurella
I really do love @lynda as a learning platform. Never stop learning and developing, it’s probably our greatest gift as a species! @soundslikedavid
@lynda just subscribed to lynda.com all I can say its brilliant join now trust me @ButchSamurai
@lynda is an awesome resource. The membership is priceless if you take advantage of it. @diabetic_techie
One of the best decision I made this year. Buy a 1yr subscription to @lynda @cybercaptive
guys lynda.com (@lynda) is the best. So far I’ve learned Java, principles of OO programming, and now learning about MS project @lucasmitchell
Signed back up to @lynda dot com. I’ve missed it!! Proper geeking out right now! #timetolearn #geek @JayGodbold
Share a link to this course

What are exercise files?

Exercise files are the same files the author uses in the course. Save time by downloading the author's files instead of setting up your own files, and learn by following along with the instructor.

Can I take this course without the exercise files?

Yes! If you decide you would like the exercise files later, you can upgrade to a premium account any time.

Become a member Download sample files See plans and pricing

Please wait... please wait ...
Upgrade to get access to exercise files.

Exercise files video

How to use exercise files.

Learn by watching, listening, and doing, Exercise files are the same files the author uses in the course, so you can download them and follow along Premium memberships include access to all exercise files in the library.


Exercise files

Exercise files video

How to use exercise files.

For additional information on downloading and using exercise files, watch our instructional video or read the instructions in the FAQ.

This course includes free exercise files, so you can practice while you watch the course. To access all the exercise files in our library, become a Premium Member.

Join now "Already a member? Log in

Are you sure you want to mark all the videos in this course as unwatched?

This will not affect your course history, your reports, or your certificates of completion for this course.


Mark all as unwatched Cancel

Congratulations

You have completed Java Essential Training.

Return to your organization's learning portal to continue training, or close this page.


OK
Become a member to add this course to a playlist

Join today and get unlimited access to the entire library of video courses—and create as many playlists as you like.

Get started

Already a member?

Become a member to like this course.

Join today and get unlimited access to the entire library of video courses.

Get started

Already a member?

Exercise files

Learn by watching, listening, and doing! Exercise files are the same files the author uses in the course, so you can download them and follow along. Exercise files are available with all Premium memberships. Learn more

Get started

Already a Premium member?

Exercise files video

How to use exercise files.

Ask a question

Thanks for contacting us.
You’ll hear from our Customer Service team within 24 hours.

Please enter the text shown below:

The classic layout automatically defaults to the latest Flash Player.

To choose a different player, hold the cursor over your name at the top right of any lynda.com page and choose Site preferencesfrom the dropdown menu.

Continue to classic layout Stay on new layout
Exercise files

Access exercise files from a button right under the course name.

Mark videos as unwatched

Remove icons showing you already watched videos if you want to start over.

Control your viewing experience

Make the video wide, narrow, full-screen, or pop the player out of the page into its own window.

Interactive transcripts

Click on text in the transcript to jump to that spot in the video. As the video plays, the relevant spot in the transcript will be highlighted.

Are you sure you want to delete this note?

No

Your file was successfully uploaded.

Thanks for signing up.

We’ll send you a confirmation email shortly.


Sign up and receive emails about lynda.com and our online training library:

Here’s our privacy policy with more details about how we handle your information.

Keep up with news, tips, and latest courses with emails from lynda.com.

Sign up and receive emails about lynda.com and our online training library:

Here’s our privacy policy with more details about how we handle your information.

   
submit Lightbox submit clicked
Terms and conditions of use

We've updated our terms and conditions (now called terms of service).Go
Review and accept our updated terms of service.