Undocumented Secrets of MatLab-Java Programming

Preface......Page 0 Chapter 1 Introduction to Java in Matlab®......Page 19 1.1.1 The Basics......Page 21 1.1.2 Accessing Java Objects......Page 24 1.1.3 Memory Usage......Page 29 1.2 Java Object Properties......Page 30 1.3 Java Object Methods and Actions......Page 32 1.4 Java Events and MATlAB Callbacks31......Page 37 1.5 Safe Java Programming in MATlAB — A How- to Guide......Page 42 1.6 Compiling and Debugging User- Created Java Classes in MATlAB......Page 45 1.7 Compatibility Issues......Page 53 1.8.1 Pre- Bundled JVM Versions......Page 55 1.8.2 Configuring MATlAB to Use a Different JVM......Page 57 1.9 Java.opts......Page 60 Chapter 2 Using Non-GUI Java libraries in Matlab®......Page 72 2.1.1 Java Collections......Page 73 2.1.2 Collections Example: Hashtable......Page 76 2.1.3 Enumerators......Page 77 2.2 Database Connectivity......Page 78 2.2.1 Using Java Database Connectivity ( JDBC) in MATlAB......Page 79 2.2.2 Initializing the JDBC Driver......Page 80 2.2.3 Connecting to a Database......Page 82 2.2.4 Sending SQl Requests......Page 83 2.2.5 Handling SQl Result Sets......Page 84 2.3 Miscellaneous Other Uses......Page 88 2.4 A Short Pause for Reflection......Page 89 References......Page 90 Chapter 3 Rich GUI Using Java Swing......Page 95 3.1.1 The javacomponent Function5......Page 96 3.1.2 The Swing Component library......Page 102 3.1.3 Displaying Swing- Derived Components......Page 106 3.2 MATlAB's Main Thread and the Event Dispatch Thread ( EDT)......Page 107 3.3.1 Component Properties and Methods......Page 112 3.3.2 look- and- Feel......Page 118 3.3.3 HTMl Support......Page 122 3.3.4 Focus Traversal60......Page 126 3.4 Component Callbacks......Page 127 3.5.1 JFreeChart and Other Charting libraries93......Page 135 3.5.2 JFreeReport and Other Reporting libraries......Page 138 3.5.3 JGraph and Other Visualization libraries......Page 141 3.5.5 Swing Extension Class libraries......Page 145 3.5.6 A Note of Caution......Page 146 3.6 System- Tray Icons......Page 147 3.7.1 Data Transfer Mechanism in MATlAB......Page 150 3.7.2 A Sample MATlAB Application That Supports DND......Page 154 3.8 Adding MATlAB Components to Java Swing Containers......Page 159 3.9 Alternatives to Swing......Page 161 References......Page 163 Chapter 4 Uitools......Page 169 4.1 Uitable......Page 171 4.1.1 Customizing Uitable......Page 174 4.1.2 Table Callbacks......Page 182 4.1.3 Customizing Scrollbars, Column Widths, and Selection Behavior......Page 184 4.1.4 Data Sorting and Filtering......Page 186 4.1.5 JIDE Customizations......Page 189 4.1.6 Controlling Table Structure ( Adding/ Deleting Rows)......Page 190 4.2 Uitree......Page 192 4.2.1 Customizing Uitree......Page 194 4.2.2 Accessing Tree Nodes......Page 197 4.2.3 Controlling Tree Nodes......Page 199 4.2.4 Customizing Tree Nodes......Page 201 4.2.5 FindJObj......Page 205 4.3 Uitab......Page 206 4.3.1 Customizing Tabs at the Java level......Page 208 4.3.2 Tabdlg and Other Alternatives......Page 212 4.4 Uiundo......Page 213 4.5 Toolbars......Page 218 4.5.1 Uitoolfactory......Page 219 4.5.2 Other Undocumented Toolbar Functions......Page 221 4.5.3 Customizing Toolbars at the Java level......Page 222 4.5.4 Uisplittool and Uitogglesplittool......Page 228 4.5.5 Adding Undo/ Redo Toolbar Buttons......Page 232 4.6.1 Accessing Menu Items......Page 238 4.6.2 Customizing Menus via Uitools......Page 240 4.6.3 Customizing Menus via HTMl......Page 241 4.6.4 Customizing Menus via Java......Page 242 4.7 Status Bar......Page 247 References......Page 252 Chapter 5 built-In Matlab® Widgets and Java Classes......Page 256 5.1.1 Inspecting Package Contents......Page 257 5.1.2 Inspecting an Internal MATlAB Class......Page 258 5.1.3 Standard MATlAB Packages......Page 261 5.2.1 Enhancements of Standard Java Swing Controls......Page 265 5.2.2 Entirely New Java Controls......Page 272 5.3 MWT Package......Page 281 5.4 MlWidgets Package......Page 283 5.4.1 Color- Selection Components83......Page 290 5.4.2 Plot- Type Selection Components......Page 299 5.5.1 Widget Components......Page 302 5.5.2 Font- Selection Components......Page 314 5.5.3 Dialogs......Page 318 5.5.4 Closable ( Collapsible) Panels......Page 321 5.5.5 Specialized Widgets......Page 323 5.6 MlServices Package......Page 325 5.7 JIDE......Page 333 5.7.1 Important JIDE Classes......Page 334 5.7.2 JIDE Grids......Page 337 5.7.3 MATlAB's PropertyInspector121......Page 341 5.7.4 JIDE's PropertyTable......Page 343 5.7.5 Nonstandard Property Renderers and Editors135......Page 346 5.7.7 Trapping Property Change Events......Page 349 5.7.8 Date- Selection Components146......Page 351 5.8 Miscellaneous Other Internal Classes......Page 354 5.8.1 logging Utilities......Page 356 5.8.3 Additional Others......Page 359 References......Page 361 Chapter 6 Customizing Matlab® Controls......Page 367 6.1 PushButton......Page 371 6.3 RadioButton......Page 379 6.4 Checkbox......Page 381 6.5 Editbox......Page 384 6.5.1 Single- line Editbox......Page 385 6.5.2 Multi- line Editbox......Page 391 6.5.3 The JEditorPane Alternative......Page 403 6.6 listbox......Page 404 6.6.1 The listbox Data Model......Page 412 6.6.2 Customizing the Appearance of listbox Items......Page 413 6.6.3 Dynamic ( Item- Specific) Context- Menus and Tooltips......Page 418 6.7 Popup Menu ( a. k. a. Drop- Down, Combo- Box)......Page 421 6.8 Slider......Page 430 6.9 Text label......Page 433 6.10 Frame......Page 436 6.11 Uipanel......Page 437 6.12.1 Displaying a Tooltip on Disabled Controls95......Page 438 6.12.2 Displaying a Tooltip on Truncated Text......Page 439 6.12.3 Controlling Tooltip Timing......Page 440 6.12.4 Displaying a Tooltip on Inactive Controls97......Page 441 References......Page 445 Chapter 7 the Java Frame......Page 449 7.1.2 Docking and Undocking......Page 451 7.1.3 UI- Related JavaFrame Properties......Page 453 7.1.4 Miscellaneous Other JavaFrame Properties......Page 455 7.2 FindJObj and the Java Frame Components Hierarchy......Page 457 7.2.2 Finding the Underlying Java Object of a MATlAB Control......Page 459 7.2.3 GUI for Displaying Container Hierarchy, Properties, and Callbacks......Page 461 7.3.1 AxisCanvas......Page 464 7.3.3 Component's Private Container......Page 466 7.3.4 FigurePanel or ContainerFactory......Page 467 7.3.5 DTToolBarContainer......Page 468 7.3.6 FigureMenuBar and Docking Controls......Page 469 7.3.7 FigureFrame......Page 470 References......Page 475 Chapter 8 the Matlab® Desktop......Page 477 8.1.1 The Java Desktop Object......Page 478 8.1.2 The Desktop Frame......Page 489 8.1.3 Organizing the Desktop Clients......Page 491 8.1.4 Customizing the Desktop Toolbars......Page 494 8.2 System Preferences23......Page 496 8.3 Command Window......Page 498 8.3.1 Controlling Command Window Colors......Page 500 8.3.2 Help Popup and Integrated Browser Controls......Page 504 8.3.3 Modifying the Command Window Prompt......Page 511 8.3.4 Tab Completions......Page 515 8.3.5 Additional Command Window Uses......Page 519 8.4 Editor......Page 520 8.4.1 The EditorServices/ matlab. desktop. editor Object......Page 521 8.4.2 The Editor Frame Object......Page 526 8.5 Keyboard Bindings......Page 529 8.5.1 Inserting/ Replacing Text......Page 530 8.5.2 Running Action Macros......Page 533 8.5.3 Running Built- In Actions......Page 535 8.6 Workspace......Page 539 8.7 Other Desktop Tools......Page 542 8.7.1 Profiler......Page 543 8.7.2 Find- Files Dialog......Page 546 8.7.3 GUIDE......Page 547 8.7.4 Variable ( Array) Editor......Page 551 References......Page 553 Chapter 9 Using Matlab® from within Java......Page 557 9.1 Approaches for Java Control of MATlAB......Page 558 9.1.1 Controlling the MATlAB GUI......Page 559 9.1.2 Controlling the MATlAB Engine......Page 560 9.1.4 Running or Modifying MATlAB Code without MATlAB......Page 561 9.2 JMI — Java- to- MATlAB Interface62......Page 562 9.2.1 com. mathworks. jmi. Matlab......Page 563 9.2.2 Other Interesting JMI Classes......Page 567 9.3.2 localMatlabProxy......Page 568 9.3.3 Some Usage Examples......Page 570 9.4.1 Remote Control of MATlAB......Page 574 9.4.2 A Simple RemoteExample......Page 575 9.4.3 Parsing MATlAB's Return Values......Page 577 9.5 Using JNI to Connect Java and MATlAB......Page 578 References......Page 586 Chapter 10 Putting It all together......Page 591 10.1 UISplitPane1......Page 592 10.1.1 Technical Description......Page 593 10.1.2 Source- Code listing......Page 594 10.2.1 Data Setup......Page 623 10.2.2 Defining Data Items and Events......Page 625 10.2.3 Defining Analyses......Page 626 10.2.4 Defining Reports......Page 628 10.2.5 Displaying Analysis Results......Page 629 10.3 Concluding Exercise: UIMultilistbox......Page 632 Appendix A: What Is Java?......Page 634 References......Page 639 Appendix B: Udd......Page 640 Appendix C: Open Questions......Page 651 Index......Page 653 Color Insert......Page 676 "Preface The Matlab programming environment uses Java for numerous tasks, including networking, data-processing algorithms, and graphical user-interface (GUI). Matlab's internal Java classes can often be easily accessed and used by Matlab users. Matlab also enables easy access to external Java functionality, either third-party or user-created. Using Java, we can extensively customize the Matlab environment and application GUI, enabling the creation of very esthetically pleasing applications. Unlike Matlab's interface with other programming languages, the internal Java classes and the Matlab-Java interface were never fully documented by The MathWorks (TMW), the company that manufactures the Matlab product. This is really quite unfortunate: Java is one of the most widely used programming languages, having many times as many programmers as Matlab. Using this huge pool of knowledge and components can significantly improve Matlab applications. As a consultant, I often hear clients claim that Matlab is a fine programming platform for prototyping, but is not suitable for real-world modern-looking applications. This book aimed at correcting this misconception. It shows how using Java can significantly improve Matlab program appearance and functionality and that this can be done easily and even without any prior Java knowledge. In fact, many basic programming requirements cannot be achieved (or are difficult) in pure Matlab, but are very easy in Java. As a simple example, maximizing and minimizing windows is not possible in pure Matlab, but is a trivial one-liner using the underlying Java codeʹ:"--Provided by publisher Preface The Matlab programming environment uses Java for numerous tasks, including networking, data-processing algorithms, and graphical user-interface (GUI). Matlab's internal Java classes can often be easily accessed and used by Matlab users. Matlab also enables easy access to external Java functionality, either third-party or user-created. Using Java, we can extensively customize the Matlab environment and application GUI, enabling the creation of very esthetically pleasing applications. Unlike Matlab's interface with other programming languages, the internal Java classes and the Matlab-Java interface were never fully documented by The MathWorks (TMW), the company that manufactures the Matlab product. This is really quite unfortunate: Java is one of the most widely used programming languages, having many times as many programmers as Matlab. Using this huge pool of knowledge and components can significantly improve Matlab applications. As a consultant, I often hear clients claim that Matlab is a fine programming platform for prototyping, but is not suitable for real-world modern-looking applications. This book aimed at correcting this misconception. It shows how using Java can significantly improve Matlab program appearance and functionality and that this can be done easily and even without any prior Java knowledge. In fact, many basic programming requirements cannot be achieved (or are difficult) in pure Matlab, but are very easy in Java. As a simple example, maximizing and minimizing windows is not possible in pure Matlab, but is a trivial one-liner using the underlying Java code:-- Provided by publisher For a variety of reasons, the MATLAB-Java interface was never fully documented. This is really quite Java is one of the most widely used programming languages, having many times the number of programmers and programming resources as MATLAB. Also unfortunate is the popular claim that while MATLAB is a fine programming platform for prototyping, it is not suitable for real-world, modern-looking applications. Undocumented Secrets of MATLAB-Java Programming aims to correct this misconception. This book shows how using Java can significantly improve MATLAB program appearance and functionality, and that this can be done easily and even without any prior Java knowledge . Readers are led step-by-step from simple to complex customizations. Code snippets, screenshots, and numerous online references are provided to enable the utilization of this book as both a sequential tutorial and as a random-access reference suited for immediate use. Java-savvy readers will find it easy to tailor code samples for their particular needs; for Java newcomers, an introduction to Java and numerous online references are provided. This book demonstrates how For a variety of reasons, the MATLAB-Java interface was never fully documented. This is really quite unfortunate: Java is one of the most widely used programming languages, having many times the number of programmers and programming resources as MATLAB. Also unfortunate is the popular claim that while MATLAB is a fine programming platform for proto