📄 flat.html

📁 a a a a a a a a a a a a a a a a a a a a a a
💻 HTML
字号:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Context-sensitive help for the Lotus Notes API for Java</title><link type="text/css" rel="stylesheet" href="active/slides-default.css" /></head><body><div class="navhead"><table width="100%" border="0" cellpadding="0" cellspacing="0" summary="Navigation"><tr><td align="right" valign="top"><a href="index.html"><img alt="Home" border="0" src="./active/nav-home.png" /></a></td></tr></table></div><div id="id367408" class="titlepage"><div class="titlepage-body"><div class="slidesinfo">
  <h1 class="title"><a id="id367406"></a>Context-sensitive help for the Lotus Notes API for Java</h1>
  
  <div class="author"><h3 class="author"><span class="firstname">Ferdinand</span> <span class="surname">Prantl</span></h3></div>
  <p class="pubdate">Saturday, 29 July 2006</p>
  <p class="releaseinfo">Domino Javadoc Generator</p>
  <p class="copyright">Copyright 漏 2006 Ferdinand Prantl</p>
</div></div><table xmlns="http://www.w3.org/TR/xhtml1/transitional" width="100%" border="0"><tr><td align="left"><a href="http://sourceforge.net" style="padding-right: 0.3em"><img width="88" height="31" border="0" alt="SourceForge.net Logo" src="http://sourceforge.net/sflogo.php?group_id=173113&amp;type=1"></img></a><a href="https://sourceforge.net/donate/index.php?group_id=173113"><img src="http://images.sourceforge.net/images/project-support.jpg" width="88" height="31" border="0" alt="Support This Project"></img></a></td><td align="right"><a href="http://sourceforge.net/projects/domino-javadoc">Project Home</a>聽<a href="http://sourceforge.net/export/rss2_projnews.php?group_id=173113&amp;rss_fulltext=1"><img src="http://images.sourceforge.net/images/xml.png" width="36" height="14" border="0" alt="RSS Feed Available"></img></a></td></tr></table></div><hr xmlns="" class="top-nav-sep" /><div class="foil" id="id354630"><div class="foil-body"><h1 class="title">Why is the Domino Designer Help not enough?</h1><p>The Domino Designer Help serves good while developing in the Domino Designer. They are tightly integrated speaking about the auto-complete feature of editors for the formula language and LotusScript.</p><p>However, there is usually other IDE used for the development of external applications integrating Domino via the Notes API for Java. Such IDEs integrate the most common format of the source code documentation for Java - packed sources and packed javadoc documentation. These sources are used to display a context-sensitive help for the classes and methods from the corresponding Java package.</p><p>While IBM does not provide a package with the javadoc documentation for the Notes API for Java every searching for an information about a class or method means opening the Domino Designer Help and looking for an answer there.</p><p>There is more lost then only the convenience; there are other productivity features which are standard today and which are not available with the Domino Designer Help. See further.</p></div></div><hr xmlns="" class="top-nav-sep" /><div class="foil" id="id361815"><div class="foil-body"><h1 class="title">What does it bring having sources and javadoc of an API?</h1><p>Being able to stay in the IDE for Java and not to have to switch to a separate documentation browser saves time of developers and helps to keep them concentrated. There are also other improvements which a resonable IDE for offers:</p><div class="itemizedlist"><ul type="disc"><li><p>Auto-complete for names of classes and methods typed in the source code editor. It makes typing faster. Just seeing the methods available can save a jump to help looking for the right one.</p></li><li><p>Object-browser for classes and interfaces presenting the API in a hierarchic tree-like form. It helps for the orientation in the API while picking class a suitable for the current task.</p></li><li><p>Help-popups are context-sensitive windows with a javadoc content displayed for classes and methods when the mouse cursor is hovering over their names. It is not always necessary to sieve through the documentation just to know what the method does.</p></li><li><p>Links to the documentation can be followed just by selecting names of a classes or methods and asking for a help for them (usually by pressing the key F1). There is no need first to search in the external documentation for the class or method. You can be pointed to the right one automatically.</p></li><li><p>A developer can jump to the source code to have method prototypes together with their javacod comments in the editor instead of switching to a help pane.</p></li></ul></div><p>These features increase remarkably productivity of developers. See further how they look like.</p></div></div><hr xmlns="" class="top-nav-sep" /><div class="foil" id="id361876"><div class="foil-body"><h1 class="title">Auto-complete</h1><p>In this example a developer wants to call a method named "recycle". Let us see how the editor helps without an attached source code or a javadoc documentation:</p><div class="mediaobject"><img src="auto-complete-without.gif" /></div><p>And let us see how it improves after providing the editor with the necessary data:</p><div class="mediaobject"><img src="auto-complete-with.gif" /></div><p>The first paragraph of the documentation is usually enough to pick the right method without reading the full documentation.</p></div></div><hr xmlns="" class="top-nav-sep" /><div class="foil" id="id361918"><div class="foil-body"><h1 class="title">Help-popups</h1><p>In this example a developer wants to see briefly what the method does by hovering the mouse over its name without opening the documentation. Let us see what happens without an attached source code or a javadoc documentation:</p><div class="mediaobject"><img src="help-popup-without.gif" /></div><p>And let us see how it improves after providing the editor with the necessary data:</p><div class="mediaobject"><img src="help-popup-with.gif" /></div><p>The window with the documentation can be enlarged and it can be also pinned not to hide when the mouse has moved or a button has been clicked.</p></div></div><hr xmlns="" class="top-nav-sep" /><div class="foil" id="id361962"><div class="foil-body"><h1 class="title">Links to the documentation</h1><p>In this example a developer wants to read more about the method. Just by pressing a single key (F1) he gets a help pane with an offer what documentation is available for the context of the current cursor position:</p><div class="mediaobject"><img src="help-view-1.gif" /></div><p>And after clicking on the most fitting possibility (the link to a javadoc with the prototype of the method) we get right to the documentation:</p><div class="mediaobject"><img src="help-view-2.gif" /></div><p>There is no need to switch applications, type the name of the method again and scroll to the beginning of the documentation.</p></div></div><hr xmlns="" class="top-nav-sep" /><div class="foil" id="id362006"><div class="foil-body"><h1 class="title">Jump to the source code</h1><p>In this example a developer wants to get to the source code of the method to see what it does. Just by pressing a single key (F3) while letting the cursor on the name of the method he gets to a file with the definition of it. Folding of comments and bodies of methods is optional:</p><div class="mediaobject"><img src="jump-to-source.gif" /></div><p>Well, sources of the Notes API are not public, thus it does not help much to learn about its internals. At least it is possible to read sources for the javadoc documentation and see the layout of the class. And probably copy &amp; paste it somewhere; after all, it is a full editor for Java sources...</p></div></div><hr xmlns="" class="top-nav-sep" /><div class="foil" id="id362042"><div class="foil-body"><h1 class="title">Configuration of an IDE</h1><p>There are two files ready to be integrated with an IDE for Java:</p><div class="variablelist"><dl><dt><span class="term">Notes7-pseudo-sources.zip</span></dt><dd><p>Pseudo-source code - a zipped archive with source files defining the interfaces. Sources of classes are provided with empty bodies just to serve the generation of the javadoc documentation. They cannot be used to produce the real Notes API :-)</p></dd><dt><span class="term">Notes7-pseudo-javadoc.zip</span></dt><dd><p>Javadoc documentation - a zipped archive with the generated HTML documentation by the standard javadoc toll from JDK.</p></dd></dl></div><p>This is an example how to configure these files in a build path of an Eclipse project referencing the Notes API already:</p><div class="mediaobject"><img src="eclipse-configuration.gif" /></div><p>The fields "Source attachment" and "Javadoc location" were changed to point to the files mentioned above.</p><p>Configuration dialogs of other IDEs for Java (NetBeans, IntelliJ) contains similar settings.</p><p>Enjoy improved convenience and productivity! :-)</p></div></div><a xmlns="http://www.w3.org/TR/xhtml1/transitional" href="http://sourceforge.net" style="padding-right: 0.3em"><img width="88" height="31" border="0" alt="SourceForge.net Logo" src="http://sourceforge.net/sflogo.php?group_id=173113&amp;type=1"></img></a><a xmlns="http://www.w3.org/TR/xhtml1/transitional" href="https://sourceforge.net/donate/index.php?group_id=173113"><img src="http://images.sourceforge.net/images/project-support.jpg" width="88" height="31" border="0" alt="Support This Project"></img></a><hr class="bottom-nav-sep" /><span class="navfooter"><span class="copyright">Copyright 漏 2006 Ferdinand Prantl</span></span></body></html>
⌨️ 快捷键说明

复制代码 Ctrl + C
搜索代码 Ctrl + F
全屏模式 F11
切换主题 Ctrl + Shift + D
显示快捷键 ?
增大字号 Ctrl + =
减小字号 Ctrl + -