Book Image

Eclipse Plug-in Development Beginner's Guide - Second Edition

By : Alex Blewitt
Book Image

Eclipse Plug-in Development Beginner's Guide - Second Edition

By: Alex Blewitt

Overview of this book

Eclipse is used by everyone from indie devs to NASA engineers. Its popularity is underpinned by its impressive plug-in ecosystem, which allows it to be extended to meet the needs of whoever is using it. This book shows you how to take full advantage of the Eclipse IDE by building your own useful plug-ins from start to finish. Taking you through the complete process of plug-in development, from packaging to automated testing and deployment, this book is a direct route to quicker, cleaner Java development. It may be for beginners, but we're confident that you'll develop new skills quickly. Pretty soon you'll feel like an expert, in complete control of your IDE. Don't let Eclipse define you - extend it with the plug-ins you need today for smarter, happier, and more effective development.
Table of Contents (24 chapters)
Eclipse Plug-in Development Beginner's Guide Second Edition
Credits
Foreword
About the Author
Acknowledgments
About the Reviewers
www.PacktPub.com
Preface
Index

Time for action – inspecting and watching variables


Finally, it's worth seeing what the Variables view can do.

  1. Create a breakpoint at the start of the execute method.

  2. Click on the hello world icon again.

  3. Highlight the openInformation call and navigate to Run | Step Into Selection.

  4. Select the title variable in the the Variables view.

  5. Modify where it says Hello in the bottom half of the variables view and change it to Goodbye:

  6. Save the value with Ctrl + S (or Cmd + S on macOS).

  7. Click on resume, and the newly updated title can be seen in the dialog.

  8. Click on the hello world icon again.

  9. With the debugger stopped in the execute method, highlight the event in the Variables view.

  10. Right-click on the value and choose Inspect (by navigating to Ctrl + Shift + I or Cmd + Shift + I on macOS) and the value is opened in the Expressions view:

  11. Click on Add new expression at the bottom of the Expressions view.

  12. Add new java.util.Date() and the right-hand side will show the current time.

  13. Right-click on the new java.util.Date() and choose Re-evaluate Watch Expression. The right-hand-side pane shows the new value.

  14. Step through the code line by line, and notice that the watch expression is re-evaluated after each step.

  15. Disable the watch expression by right-clicking on it and choosing Disable.

  16. Step through the code line by line, and the watch expression will not be updated.

What just happened?

The Eclipse debugger has many powerful features, and the ability to inspect (and change) the state of the program is one of the more important ones.

Watch expressions, when combined with conditional breakpoints, can be used to find out when data becomes corrupted or used to show the state of a particular object's value.

Expressions can also be evaluated based on objects in the variables view, and code completion is available to select methods, with the result being shown with Display.

Pop quiz: debugging

Q1. How can an Eclipse plug-in be launched in debug mode?

Q2. How can certain packages be avoided when debugging?

Q3. What are the different types of breakpoints that can be set?

Q4. How can a loop that only exhibits a bug after 256 iterations be debugged?

Q5. How can a breakpoint be set on a method when its argument is null?

Q6. What does inspecting an object do?

Q7. How can the value of an expression be calculated?

Q8. How can multiple statements be executed in breakpoint conditions?

Have a go hero – working with breakpoints

Using a conditional breakpoint to stop at a certain method is fine if the data is simple, but sometimes there needs to be more than one expression. Although it is possible to use multiple statements in the breakpoint condition definition, the code is not very reusable. To implement additional reusable functionality, the breakpoint can be delegated to a breakpoint utility class.

  1. Create a Utility class in the com.packtpub.e4.hello.ui.handlers package with a static method breakpoint that returns a true value if the breakpoint should stop, and false otherwise:

    public class Utility {
      public static boolean breakpoint() {
        System.out.println("Breakpoint");
        return false;
      }
    }
  2. Create a conditional breakpoint in the execute method that calls Utility.breakpoint().

  3. Click on the hello world icon again, and the message will be printed to the host Eclipse's Console view. The breakpoint will not stop.

  4. Modify the breakpoint method to return true instead of false. Run the action again. The debugger will stop.

  5. Modify the breakpoint method to take the message as an argument, along with a Boolean value that is returned to say whether the breakpoint should stop.

  6. Set up a conditional breakpoint with the expression:

    Utility.breakpoint(
     ((org.eclipse.swt.widgets.Event)event.trigger).stateMask != 0,
     "Breakpoint")
  7. Modify the breakpoint method to take a variable Object array, and use that in conjunction with the message to use String.format() for the resulting message:

    Utility.breakpoint(
     ((org.eclipse.swt.widgets.Event)event.trigger).stateMask != 0,
     "Breakpoint %s %h",
     event,
     java.time.Instant.now())