home *** CD-ROM | disk | FTP | other *** search
/ Programming with VisualAge for Java / IBMVJAVA.ISO / vajwin / data1.cab / Ide / relnotes / ex.txt next >
Encoding:
Text File  |  1997-07-04  |  12.7 KB  |  404 lines
  1. ===========================================================================
  2.  
  3.                         VisualAge for Java
  4.                            Version 1.0
  5.  
  6.                             Examples
  7.  
  8.                          RELEASE NOTES
  9.  
  10. ===========================================================================
  11.  
  12. Table of Contents
  13.  
  14. 1.0 Introduction
  15. 2.0 Loading Projects
  16. 3.0 Visual Composition Editor Examples
  17.    3.1 Running the Visual Composition Editor Examples
  18.    3.2 Known problems with the Visual Composition Editor Examples
  19.        3.2.1 COM.ibm.ivj.examples.vc.beandemo
  20.  
  21. 4.0 Getting Started Examples
  22. 5.0 Towers of Hanoi
  23. 6.0 Sun BDK Examples
  24.    6.1 Adding Sun BDK Beans to the Visual Composition 
  25.        Editor Pallet
  26.    6.2 Known Problems with the Sun BDK Examples
  27.        6.2.1 BeanBox Source Code Modifications
  28.        6.2.2 Adding Beans to Sun's BeanBox Demo
  29.        6.2.3 BridgeTester Bean
  30.  
  31. 7.0 Sun JDK Examples
  32.    7.1 Running the Sun JDK Examples
  33.    7.2 Known Problems with the Sun JDK Examples
  34.        7.2.1 Sun JDK Animator
  35.        7.2.2 Sun JDK Clock
  36.        7.2.3 Sun JDK DrawTest
  37.        7.2.4 Sun JDK SymbolTest
  38.  
  39. 8.0 Awt Examples
  40.    8.1 Running the Awt Examples
  41.  
  42.  
  43. 1.0 Introduction
  44.  
  45. IBM VisualAge for Java 1.0 ships with example applications
  46. and applets to help you start exploring VisualAge.
  47.  
  48. The examples fall into six categories:
  49.  
  50.    Visual Composition Editor Examples
  51.    Getting Started Examples
  52.    Towers of Hanoi
  53.    Sun BDK Examples
  54.    Sun JDK Examples
  55.    Awt Examples
  56.  
  57. Each of the example categories will be covered in the
  58. following sections.
  59.  
  60.  
  61. 2.0 Loading Projects
  62.  
  63. The examples are contained in various projects.  These
  64. projects are stored in the repository and must be loaded 
  65. into your image before you can use them.
  66.  
  67. Use the following steps to load a project from the repository
  68. into your image:
  69.  
  70.   1)  Select a Workbench.
  71.   2)  Select the "Projects" tab.
  72.   3)  Press the "Add Projects" button on the tool bar.  This
  73.       is the button with a picture of a file folder on it.
  74.   4)  Click the "Add project(s) from the repository" radio 
  75.       button.
  76.   5)  Press the "Browse" button.  This will display all the
  77.       projects in the repository.
  78.   6)  Select the project you want to load from the "Available
  79.       project names" pane.
  80.   7)  Select the edition you want to load from the "Editions"
  81.       pane.
  82.   8)  Press the ">>" button to move the project edition over
  83.       to the "Editions to Add" pane.
  84.   9)  Repeat steps 5 through 7 for each project you want to
  85.       load.
  86.   10)  Press the "OK" button when you have selected all the
  87.       projects you wish to load.
  88.   11) Press the "Finish" button on the SmartGuide.  The 
  89.       project(s)will be added to your image.
  90.  
  91. For detailed explanations of the repository, the image and
  92. how to manipulate projects please consult the printed or
  93. on-line documentation.
  94.  
  95.  
  96. 3.0 Visual Composition Editor Examples
  97.  
  98. The Visual Composition Editor Examples are contained
  99. in the IBM Java Examples project.  The examples show 
  100. complete working applets and applications constructed 
  101. using the Visual Composition Editor.
  102.  
  103. If the IBM Java Examples project is not visible in the
  104. "Projects" tab of your Workbench you must load the project
  105. from the repository using the steps described in section
  106. 2.0 of this release note.
  107.  
  108. Each Visual Composition Editor Example is contained in
  109. its own package in the IBM Java Examples project.  Not
  110. all the packages in the IBM Java Examples project are
  111. Visual Composition Editor examples.  These other packages 
  112. will be covered later in this release note.
  113.  
  114. The Visual Composition Editor Example packages are:
  115.  
  116.    COM.ibm.ivj.examples.vc.beandemo
  117.    COM.ibm.ivj.examples.vc.bookmarklist
  118.    COM.ibm.ivj.examples.vc.common
  119.    COM.ibm.ivj.examples.vc.customerinfo
  120.    COM.ibm.ivj.examples.vc.layoutmanagers
  121.    COM.ibm.ivj.examples.vc.mortgageamortizer
  122.    COM.ibm.ivj.examples.vc.popupmenu
  123.  
  124.  
  125. 3.1 Running the Visual Composition Editor Examples
  126.  
  127. Each package comment describes what the example does and also
  128. describes the steps to run the example.  To view a package
  129. comment follow the following steps:
  130.  
  131.   1)  Select a Workbench.
  132.   2)  Select the "Projects" tab.
  133.   3)  Select a project.  The text pane in the Workbench will
  134.       display the project comment.
  135.   4)  If the project is collapsed expand it by double
  136.       clicking the project name.
  137.   5)  Select a package.  the text pane in the Workbench will
  138.       display the package comment.
  139.  
  140.  
  141. 3.2 Known problems with the Visual Composition Editor Examples
  142.  
  143.  
  144. 3.2.1 COM.ibm.ivj.examples.vc.beandemo
  145.  
  146. This example uses beans contained in the Sun BDK Examples 
  147. project.  This means that you have to load the project
  148. Sun BDK Examples before you can run this example.
  149.  
  150. You can load the Sun BDK Examples project before, at the 
  151. same time or after you load the IBM Java Examples project.
  152.  
  153. If you loaded the IBM Java Examples project before loading 
  154. the Sun BDK Examples project you would have noticed several 
  155. compile errors that would show up in the "Unresolved Problems"
  156. tab of the Workbench.  When you load the Sun JDK Examples 
  157. these errors are automatically corrected.
  158.  
  159.  
  160. 4.0 Getting Started Examples
  161.  
  162. The Getting Started Examples are meant to be used hand in
  163. hand with either the printed or on-line version of the 
  164. IBM VisualAge For Java Getting Started book.
  165.  
  166. The Getting Started Examples are contained in the IBM Java
  167. Examples project in the packages:
  168.  
  169.   COM.ibm.ivj.examples.vc.todofile
  170.   COM.ibm.ivj.examples.vc.todolist
  171.  
  172. For instructions on how to load and work with these examples
  173. please see the IBM VisualAge for Java Getting Started book.
  174.  
  175.  
  176. 5.0 Towers of Hanoi
  177.  
  178. The Towers of Hanoi example shows both a graphical applet and
  179. a textual application that recursively solves the classic 
  180. Towers of Hanoi puzzle.
  181.  
  182. The Towers of Hanoi example is contained in the IBM Java
  183. Examples project.  For instructions on how to load this 
  184. project see section 2.0 of this release note.
  185.  
  186. The Towers of Hanoi example is contained in the package:
  187.  
  188.   COM.ibm.ivj.examples.hanoi.
  189.  
  190. The package comments describe how to run the example.  For
  191. instructions on viewing package comments please see section
  192. 3.1 of this release note.
  193.  
  194.  
  195. 6.0 Sun BDK Examples
  196.  
  197. The Sun BDK Examples are examples that Javasoft ships with 
  198. their Sun BDK 1.0 April '97.
  199.  
  200. To load the Sun BDK Examples project follow the steps in 
  201. section 2.0 of this release note.
  202.  
  203. The Sun BDK Examples contain beans that you use in the 
  204. Visual Composition Editor to build applets, applications and
  205. beans of your own.
  206.  
  207. For complete instructions on what each Sun BDK bean does 
  208. please see the Sun BDK 1.0 April '97 documentation available
  209. on Javasoft's web page: 
  210.  
  211.    http://splash.javasoft.com/beans/index.html
  212.   
  213.  
  214. 6.1 Adding Sun BDK Beans to the 
  215.     Visual Composition Editor Pallet
  216.  
  217. Before you can use imported beans in the Visual Composition 
  218. Editor the beans must be added to the pallet.  Adding beans
  219. to the pallet is covered in detail in the IBM VisualAge for
  220. Java documentation.
  221.  
  222.  
  223. 6.2 Known Problems with the Sun BDK Examples
  224.  
  225.  
  226. 6.2.1 BeanBox Source Code Modifications
  227.  
  228. Since IBM VisualAge for Java does not support dynamic
  229. class loading two small changes where made to the Sun's
  230. BeanBox source code to make the BeanBox run.
  231.  
  232. SimpleClassLoader>>findClass (...)
  233.    Instead of loading the class dynamically the class is
  234.    simply found "in the workspace" based on its name.
  235.  
  236. SimpleClassLoader>>applyDefinition (...)
  237.    Instead of loading the class dynamically the class is
  238.    simply found "in the workspace" based on its name.
  239.  
  240.  
  241. 6.2.2  Adding Beans to Sun's BeanBox Demo
  242.  
  243. If you want to add beans to the Sun BeanBox you must copy
  244. the *.jar files for the beans to the directory:
  245.  
  246.    \<ibmvjava>\ide\project_resources\jars
  247.  
  248. Where <ibmvjava> is the directory where you installed
  249. IBM VisualAge for Java.  
  250.  
  251. You must also import the *.jar files into IBM VisualAge 
  252. for Java before trying to run the new beans from the 
  253. Sun BeanBox.  Detailed instructions for importing *.jar 
  254. can be found in the IBM VisualAge for Java documentation.
  255.  
  256.  
  257. 6.2.3 BridgeTester Bean
  258.  
  259. We do not ship the BridgeTester Bean that ships with Sun BDK 1.0.
  260. This bean exposes a bug in Sun's java.beans package.
  261.  
  262.  
  263. 7.0 Sun JDK Examples
  264.  
  265. The Sun JDK Examples are examples that Sun ships with 
  266. their Sun JDK 1.1.1.
  267.  
  268. Each Sun JDK Example is contained in its own project.  You
  269. can use the steps in section 2.0 of this release note to load
  270. the examples you are interested in.
  271.  
  272. For detailed instructions on what each example does please 
  273. see the Sun JDK 1.1.1 documentation available on their web
  274. page.
  275.  
  276. The following Sun JDK example projects in the VisualAge 
  277. repository:
  278.  
  279.   Sun JDK Animator
  280.   Sun JDK ArcTest
  281.   Sun JDK Blink
  282.   Sun JDK CardTest
  283.   Sun JDK Clock
  284.   Sun JDK DitherTest
  285.   Sun JDK DrawTest
  286.   Sun JDK Fractal
  287.   Sun JDK Gauge
  288.   Sun JDK GraphicsTest
  289.   Sun JDK GraphLayout
  290.   Sun JDK i18n code
  291.   Sun JDK ImageMap
  292.   Sun JDK JumpingBox
  293.   Sun JDK MoleculeViewer
  294.   Sun JDK NervousText
  295.   Sun JDK OpenlookButtons
  296.   Sun JDK RoundButtons
  297.   Sun JDK SimpleGraph
  298.   Sun JDK SortDemo
  299.   Sun JDK Spinner
  300.   Sun JDK SpreadSheet
  301.   Sun JDK SymbolTest
  302.   Sun JDK TicTacToe
  303.   Sun JDK WireFrame
  304.  
  305.  
  306. 7.1 Running the Sun JDK Examples
  307.  
  308. Once a Sun JDK Example project is loaded you can run the
  309. applet using the following steps:
  310.  
  311.   1)  Open a Workbench.
  312.   2)  Select the "Projects" tab.
  313.   3)  Select the example project you wish to run.
  314.   4)  Press the "Run" button on the Workbench toolbar.
  315.       This is the button with the picture of the runner on it.
  316.   5)  Due to the way Sun wrote these examples you may have
  317.       to tell IBM VisualAge for Java if the class is an
  318.       applet or a stand alone application.  A dialog may
  319.       appear with the three buttons "Run as Applet", 
  320.       "Run main()" and "Cancel".  If this dialog appears
  321.       press the "Run as Applet" button.  If this dialog does 
  322.       not appear then the example will automatically run as
  323.       an applet and you can skip directly to step 6.
  324.   6)  A settings dialog window will open.  All the examples
  325.       come with their settings already entered so all you
  326.       have to do is press the "Run" button on the settings
  327.       dialog window and the applet will run.
  328.  
  329.  
  330. 7.2 Known Problems with the Sun JDK Examples
  331.  
  332.  
  333. 7.2.1 Sun JDK Animator
  334.  
  335. If you select the restart option from the applet viewer menu
  336. while animator is running errors will be displayed on the
  337. Console.  The same behavior is present when this example is
  338. run under Sun JDK 1.1.1
  339.  
  340. Due to problems with the way the Animator exaple is written 
  341. you may experience a deadlock condition if you run a large 
  342. number of Animators.  The Sun JDK 1.1.1 experiences the 
  343. same problem.
  344.  
  345.  
  346. 7.2.2 Sun JDK Clock
  347.  
  348. The graphical time display will show the current system time
  349. but the textual time may be incorrect.
  350.  
  351.  
  352. 7.2.3 Sun JDK DrawTest
  353.  
  354. If you are running IBM VisualAge for Java in Windows 95 or 
  355. Windows NT and are using 256 colors then the fourth radio 
  356. button from the left will not draw with the displayed color.  
  357. This is a known problem that has to do with the way Windows
  358. allocates colors.  The problem does not appear if you a higher
  359. color resolution or if you are running IBM VisualAge 
  360. for Java under OS/2.
  361.  
  362.  
  363. 7.2.4 Sun JDK SymbolTest
  364.  
  365. The symbols will not be displayed.  Instead you will see the
  366. escape codes for the symbols.  This is a known problem.
  367.  
  368.  
  369. 8.0 Awt Examples
  370.  
  371. The Awt Examples are detailed test cases for the Java
  372. Awt classes.  Basically these examples exercise widgets.
  373.  
  374. The Awt Examples are contained in the IBM Java Examples project.
  375. To load this project follow the steps in section 2.0 of this
  376. release note.
  377.  
  378. The packages that comprise the Awt tests are:
  379.   COM.ibm.ivj.examples.awttestframework
  380.   COM.ibm.ivj.examples.awttestlauncher
  381.   COM.ibm.ivj.examples.awttests
  382.  
  383. 8.1 Running the Awt Examples
  384.  
  385. Follow these steps to run the Awt Examples:
  386.  
  387.   1)  Open a Workbench.
  388.   2)  Select the "Projects" tab.
  389.   3)  Select the IBM Java Examples project.
  390.   4)  Press the "Run" button on the Workbench toolbar.  This
  391.       is the button with the picture of the runner on it.
  392.   5)  An information dialog window will open.  Press the
  393.       "Run main()" button.
  394.   6)  A "Run Main" dialog window will open.  Select the class
  395.       COM.ibm.ivj.examples.awttestlauncher.AwtExampleLauncher
  396.       from the class list.  Press the "OK" button.
  397.   7)  A "Command Line Argument" dialog will open.  
  398.       The required information has already been entered for 
  399.       you so simply press the "Run" button.
  400.   8)  The AwtExampleLauncher will start.  Select one or more
  401.       examples from the list and press the "Execute"
  402.       button.  The example will run.
  403.  
  404.