Undocumented secrets of MATLAB-Java programming

Cover......Page 1 Undocumented Secrets of MATLAB-Java Programming......Page 2 ©......Page 3 Dedication......Page 4 Contents at a Glance......Page 5 Contents......Page 6 Preface......Page 13 Book Organization......Page 14 Disclaimer and Warning......Page 16 Chapter 1 Introduction to Java in Matlab®......Page 18 1.1.1 The Basics......Page 20 1.1.2 Accessing Java Objects......Page 23 1.1.3 Memory Usage......Page 28 1.2 Java Object Properties......Page 29 1.3 Java Object Methods and Actions......Page 31 1.4 Java Events and MATlAB Callbacks31......Page 36 1.5 Safe Java Programming in MATlAB — A How- to Guide......Page 41 1.6 Compiling and Debugging User- Created Java Classes in MATlAB......Page 44 1.7 Compatibility Issues......Page 52 1.8.1 Pre- Bundled JVM Versions......Page 54 1.8.2 Configuring MATlAB to Use a Different JVM......Page 56 1.9 Java.opts......Page 59 Chapter 2 Using Non-GUI Java libraries in Matlab®......Page 71 2.1.1 Java Collections......Page 72 2.1.2 Collections Example: Hashtable......Page 75 2.1.3 Enumerators......Page 76 2.2 Database Connectivity......Page 77 2.2.1 Using Java Database Connectivity ( JDBC) in MATlAB......Page 78 2.2.2 Initializing the JDBC Driver......Page 79 2.2.3 Connecting to a Database......Page 81 2.2.4 Sending SQl Requests......Page 82 2.2.5 Handling SQl Result Sets......Page 83 2.3 Miscellaneous Other Uses......Page 87 2.4 A Short Pause for Reflection......Page 88 References......Page 89 Chapter 3 Rich GUI Using Java Swing......Page 94 3.1.1 The javacomponent Function5......Page 95 3.1.2 The Swing Component library......Page 101 3.1.3 Displaying Swing- Derived Components......Page 105 3.2 MATlAB's Main Thread and the Event Dispatch Thread ( EDT)......Page 106 3.3.1 Component Properties and Methods......Page 111 3.3.2 look- and- Feel......Page 117 3.3.3 HTMl Support......Page 121 3.3.4 Focus Traversal60......Page 125 3.4 Component Callbacks......Page 126 3.5.1 JFreeChart and Other Charting libraries93......Page 134 3.5.2 JFreeReport and Other Reporting libraries......Page 137 3.5.3 JGraph and Other Visualization libraries......Page 140 3.5.5 Swing Extension Class libraries......Page 144 3.5.6 A Note of Caution......Page 145 3.6 System- Tray Icons......Page 146 3.7.1 Data Transfer Mechanism in MATlAB......Page 149 3.7.2 A Sample MATlAB Application That Supports DND......Page 153 3.8 Adding MATlAB Components to Java Swing Containers......Page 158 3.9 Alternatives to Swing......Page 160 References......Page 162 Chapter 4 Uitools......Page 168 4.1 Uitable......Page 170 4.1.1 Customizing Uitable......Page 173 4.1.2 Table Callbacks......Page 181 4.1.3 Customizing Scrollbars, Column Widths, and Selection Behavior......Page 183 4.1.4 Data Sorting and Filtering......Page 185 4.1.5 JIDE Customizations......Page 188 4.1.6 Controlling Table Structure ( Adding/ Deleting Rows)......Page 189 4.2 Uitree......Page 191 4.2.1 Customizing Uitree......Page 193 4.2.2 Accessing Tree Nodes......Page 196 4.2.3 Controlling Tree Nodes......Page 198 4.2.4 Customizing Tree Nodes......Page 200 4.2.5 FindJObj......Page 204 4.3 Uitab......Page 205 4.3.1 Customizing Tabs at the Java level......Page 207 4.3.2 Tabdlg and Other Alternatives......Page 211 4.4 Uiundo......Page 212 4.5 Toolbars......Page 217 4.5.1 Uitoolfactory......Page 218 4.5.2 Other Undocumented Toolbar Functions......Page 220 4.5.3 Customizing Toolbars at the Java level......Page 221 4.5.4 Uisplittool and Uitogglesplittool......Page 227 4.5.5 Adding Undo/ Redo Toolbar Buttons......Page 231 4.6.1 Accessing Menu Items......Page 237 4.6.2 Customizing Menus via Uitools......Page 239 4.6.3 Customizing Menus via HTMl......Page 240 4.6.4 Customizing Menus via Java......Page 241 4.7 Status Bar......Page 246 References......Page 251 Chapter 5 built-In Matlab® Widgets and Java Classes......Page 255 5.1.1 Inspecting Package Contents......Page 256 5.1.2 Inspecting an Internal MATlAB Class......Page 257 5.1.3 Standard MATlAB Packages......Page 260 5.2.1 Enhancements of Standard Java Swing Controls......Page 264 5.2.2 Entirely New Java Controls......Page 271 5.3 MWT Package......Page 280 5.4 MlWidgets Package......Page 282 5.4.1 Color- Selection Components83......Page 289 5.4.2 Plot- Type Selection Components......Page 298 5.5.1 Widget Components......Page 301 5.5.2 Font- Selection Components......Page 313 5.5.3 Dialogs......Page 317 5.5.4 Closable ( Collapsible) Panels......Page 320 5.5.5 Specialized Widgets......Page 322 5.6 MlServices Package......Page 324 5.7 JIDE......Page 332 5.7.1 Important JIDE Classes......Page 333 5.7.2 JIDE Grids......Page 336 5.7.3 MATlAB's PropertyInspector121......Page 340 5.7.4 JIDE's PropertyTable......Page 342 5.7.5 Nonstandard Property Renderers and Editors135......Page 345 5.7.7 Trapping Property Change Events......Page 348 5.7.8 Date- Selection Components146......Page 350 5.8 Miscellaneous Other Internal Classes......Page 353 5.8.1 logging Utilities......Page 355 5.8.3 Additional Others......Page 358 References......Page 360 Chapter 6 Customizing Matlab® Controls......Page 366 6.1 PushButton......Page 370 6.3 RadioButton......Page 378 6.4 Checkbox......Page 380 6.5 Editbox......Page 383 6.5.1 Single- line Editbox......Page 384 6.5.2 Multi- line Editbox......Page 390 6.5.3 The JEditorPane Alternative......Page 402 6.6 listbox......Page 403 6.6.1 The listbox Data Model......Page 411 6.6.2 Customizing the Appearance of listbox Items......Page 412 6.6.3 Dynamic ( Item- Specific) Context- Menus and Tooltips......Page 417 6.7 Popup Menu ( a. k. a. Drop- Down, Combo- Box)......Page 420 6.8 Slider......Page 429 6.9 Text label......Page 432 6.10 Frame......Page 435 6.11 Uipanel......Page 436 6.12.1 Displaying a Tooltip on Disabled Controls95......Page 437 6.12.2 Displaying a Tooltip on Truncated Text......Page 438 6.12.3 Controlling Tooltip Timing......Page 439 6.12.4 Displaying a Tooltip on Inactive Controls97......Page 440 References......Page 444 Chapter 7 the Java Frame......Page 448 7.1.2 Docking and Undocking......Page 450 7.1.3 UI- Related JavaFrame Properties......Page 452 7.1.4 Miscellaneous Other JavaFrame Properties......Page 454 7.2 FindJObj and the Java Frame Components Hierarchy......Page 456 7.2.2 Finding the Underlying Java Object of a MATlAB Control......Page 458 7.2.3 GUI for Displaying Container Hierarchy, Properties, and Callbacks......Page 460 7.3.1 AxisCanvas......Page 463 7.3.3 Component's Private Container......Page 465 7.3.4 FigurePanel or ContainerFactory......Page 466 7.3.5 DTToolBarContainer......Page 467 7.3.6 FigureMenuBar and Docking Controls......Page 468 7.3.7 FigureFrame......Page 469 References......Page 474 Chapter 8 the Matlab® Desktop......Page 476 8.1.1 The Java Desktop Object......Page 477 8.1.2 The Desktop Frame......Page 488 8.1.3 Organizing the Desktop Clients......Page 490 8.1.4 Customizing the Desktop Toolbars......Page 493 8.2 System Preferences23......Page 495 8.3 Command Window......Page 497 8.3.1 Controlling Command Window Colors......Page 499 8.3.2 Help Popup and Integrated Browser Controls......Page 503 8.3.3 Modifying the Command Window Prompt......Page 510 8.3.4 Tab Completions......Page 514 8.3.5 Additional Command Window Uses......Page 518 8.4 Editor......Page 519 8.4.1 The EditorServices/ matlab. desktop. editor Object......Page 520 8.4.2 The Editor Frame Object......Page 525 8.5 Keyboard Bindings......Page 528 8.5.1 Inserting/ Replacing Text......Page 529 8.5.2 Running Action Macros......Page 532 8.5.3 Running Built- In Actions......Page 534 8.6 Workspace......Page 538 8.7 Other Desktop Tools......Page 541 8.7.1 Profiler......Page 542 8.7.2 Find- Files Dialog......Page 545 8.7.3 GUIDE......Page 546 8.7.4 Variable ( Array) Editor......Page 550 References......Page 552 Chapter 9 Using Matlab® from within Java......Page 556 9.1 Approaches for Java Control of MATlAB......Page 557 9.1.1 Controlling the MATlAB GUI......Page 558 9.1.2 Controlling the MATlAB Engine......Page 559 9.1.4 Running or Modifying MATlAB Code without MATlAB......Page 560 9.2 JMI — Java- to- MATlAB Interface62......Page 561 9.2.1 com. mathworks. jmi. Matlab......Page 562 9.2.2 Other Interesting JMI Classes......Page 566 9.3.2 localMatlabProxy......Page 567 9.3.3 Some Usage Examples......Page 569 9.4.1 Remote Control of MATlAB......Page 573 9.4.2 A Simple RemoteExample......Page 574 9.4.3 Parsing MATlAB's Return Values......Page 576 9.5 Using JNI to Connect Java and MATlAB......Page 577 References......Page 585 Chapter 10 Putting It all together......Page 590 10.1 UISplitPane1......Page 591 10.1.1 Technical Description......Page 592 10.1.2 Source- Code listing......Page 593 10.2.1 Data Setup......Page 622 10.2.2 Defining Data Items and Events......Page 624 10.2.3 Defining Analyses......Page 625 10.2.4 Defining Reports......Page 627 10.2.5 Displaying Analysis Results......Page 628 10.3 Concluding Exercise: UIMultilistbox......Page 631 Appendix A: What Is Java?......Page 633 References......Page 638 Appendix B: Udd......Page 639 Appendix C: Open Questions......Page 650 Index......Page 652 Color Insert......Page 675 "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