814 WebSphere Studio Application Developer Version 5 Programming Guide Fixing the classpath errors Several errors are reported in the Tasks view. To fix the errors: Two Web projects (ItsoProGuideWebServ and ItsoProGuideWebServClient) have errors because the SOAP runtime is missing. Select the Web project and Properties . Select Java Build Path . On the Libraries page, click Add Variable . Select SOAPJAR and click OK . Click OK to close the Properties window and the errors should disappear. The XML project (ItsoProGuideXmlWeb) shows errors as well. Open the properties and add the three variables XERCES, XMLPARSERAPIS, and XSDBEANS to the Java build path. Installing the server To install a WebSphere Version 5 test server with a valid configuration: Create a server project named ItsoProGuideServers. Select the new project and Import -> Zip file . Browse to the \sg246957\sampcode\zSolutions\ItsoProGuideServers.zip file and import it into the ItsoProGuideServers project. Two servers appear in the Server Configuration view: – ItsoServer—built-in WebSphere server – WebSphere v5.0 on vertex (Copy)—a sample remote WebSphere server You can use the ItsoServer to test the ItsoProGuide enterprise application. You can configure the WebSphere v5.0 on vertex (Copy) server for a remote machine that has WebSphere Application Server installed. You also have to configure the remote file transfer instance, vertex-copy.rft, in the ItsoProGuideServers project. Installing other projects Use the JAR or WAR file to import a single project into the workbench. DB2 user ID and password You may have to modify the DB user ID and/or password in: ItsoProGuideJava and ItsoProGuideJUnit: CustomerListingNet ItsoProGuideDatabaseWeb: TestDBBeans.jsp, deployment descriptor init parameters for ListCreditMasterView and ListCreditDetailsView ItsoProGuideStoredProcWeb: GetCustomerBean Authentication alias in WebSphere v5.0 vertex server configuration © Copyright IBM Corp. 2003. All rights reserved. 815 AAT application assembly tool API application programming interface BMP bean-managed persistence BMT bean-managed transactions CICS Customer Information Control System CMP container-managed persistence CMR container-managed relationships CMT container-managed transactions DBMS database management system DOM document object model EAR enterprise application archive EIS enterprise information system EJB Enterprise JavaBeans EJB QL EJB query language EJS Enterprise Java Server GUI graphical user interface HTML Hypertext Markup Language HTTP Hypertext Transfer Protocol IBM International Business Machines Corporation IDE integrated development environment IDL interface definition language IIOP Internet Inter-ORB Protocol ITSO International Technical Support Organization J2CA J2EE connector architecture J2C J2EE connector architecture Abbreviations and acronyms J2EE Java 2 Enterprise Edition JAAS Java Authentication and Authorization Services JAF Java Activation Framework JAR Java archive JDBC Java Database Connectivity JDK Java Developer’s Kit JMS Java Messaging Service JNDI Java Naming and Directory Interface JSP JavaServer Pages JTA JavaTransaction API JTS Java Transaction Service JVM Java Virtual Machine LDAP lightweight directory access protocol LTPA lightweight third-party authentication MDB message-driven bean MVC model-view-controller OMG Object Management Group ORB object request broker OTS Object Transaction Service RAD rapid application development RAR resource adapter archive RDBMS relational database management system RMI Remote Method Invocation SAM Security Access Manager SAX simple API for XML SCCI source code control interface SCM software configuration management 816 WebSphere Studio Application Developer Version 5 Programming Guide SCMS source code management systems SDK Software Development Kit SOAP Simple Object Access Protocol (also known as Service Oriented Architecture Protocol) SQL structured query language TCP/IP Transmission Control Protocol/Internet Protocol UDDI universal description, discovery, and integration UOW unit of work URL uniform resource locator UTC universal test client WAR Web application archive WSDL Web Service Description Language WWW World Wide Web XHTML Extensible HyperText Markup Language XMI XML metadata interchange XML eXtensible Markup Language XSD XML schema definition © Copyright IBM Corp. 2003. All rights reserved. 817 Related publications The publications listed in this section are considered particularly suitable for a more detailed discussion of the topics covered in this redbook. IBM Redbooks For information on ordering these publications, see “How to get IBM Redbooks” on page 819. Note that some of the documents referenced here may be available in softcopy only. EJB 2.0 Development with WebSphere Studio Application Developer , SG24-6819 WebSphere Version 5 Web Services Handbook , SG24-6891 The XML Files: Development of XML/XSL Applications Using WebSphere Studio Version 5 , SG24-6586 Exploring WebSphere Studio Application Developer Integration Edition 5.0 , SG24-6200 Linux Application Development Using WebSphere Studio 5, SG24-6431 IBM WebSphere Application Server - Express V5.0 Handbook , SG24-6555 IBM WebSphere Application Server Version 5.0 Handbook , SG24-6195 IBM WebSphere V5.0 Security WebSphere Handbook Series , SG24-6573 Legacy Modernization with WebSphere Studio Enterprise Developer , SG24-6806 WebSphere Studio Application Developer Programming Guide , SG24-6585 Web Services Wizardry with WebSphere Studio Application Developer , SG24-6292 Self-Study Guide: WebSphere Studio Application Developer and Web Services, SG24-6407 WebSphere Version 4 Application Development Handbook , SG24-6134 EJB Development with VisualAge for Java for WebSphere Application Server , SG24-6144 Design and Implement Servlets, JSPs, and EJBs for IBM WebSphere Application Server, SG245754 818 WebSphere Studio Application Developer Version 5 Programming Guide Other publications These publications are also relevant as further information sources: Design Patterns: Elements of Reusable Object-Oriented Softwar e. Erich Gamma, et al. Addison-Wesley Publishing Company, January 1995, ISBN 0201633612 The Java Developer’s Guide to Eclipse, Sherry Shavor, Jim D'Anjou, Dan Kehn, Scott Fairbrother, John Kellerman, Pat McCarthy. Addison Wesley Professional, May 2003, ISBN 0321159640 EJB Design patterns , Floyd Marinescu, John Wiley & Sons, February 2002, ISBN 0471208310 Online resources These Web sites and URLs are also relevant as further information sources: IBM WebSphere Studio Application Developer http://www.ibm.com/software/awdtools/studioappdev/support IBM WebSphere Application Server http://www.ibm.com/software/webservers/appserv/ IBM WebSphere Developer Domain http://www7b.software.ibm.com/wsdd/ Eclipse workbench http://www.eclipse.org Apache open source http://jakarta.apache.org Apache Struts Project http://jakarta.apache.org/struts Apache XML Project http://xml.apache.org/ Apache Tomcat Project http://jakarta.apache.org/tomcat Apache Ant Project http://ant.apache.org Related publications 819 Common Versions System http://www.cvshome.org http://www.cvsnt.org Rational http://www.rational.com SCM partners http://www-3.ibm.com/software/ad/studioappdev/partners/scm.html Sun Java http://java.sun.com/ World Wide Web Consortium http://www.w3.org/ JUnit Organization http://www.junit.org Partners for Software Confguration Management http://www.ibm.com/software/ad/studioappdev/partners/scm.html Eclipse CVS http://dev.eclipse.org/viewcvs/index.cgi/ How to get IBM Redbooks You can search for, view, or download Redbooks, Redpapers, Hints and Tips, draft publications and Additional materials, as well as order hardcopy Redbooks or CD-ROMs, at this Web site: ibm.com/redbooks 820 WebSphere Studio Application Developer Version 5 Programming Guide © Copyright IBM Corp. 2003. All rights reserved. 821 Index A AAT 608 Abstract Windows Toolkit 470 access control 694 list 378 accessors 127 ACCOUNT.dtd 357 ACCOUNT.xsd 354 Account.xsl 362 AccountDB 446 AccountDetails 181 accountDetails.jsp 183, 309, 326 AccountDetailsAction 336 AccountDoesNotExistException 113 ACID 375 ACL 378 Action 298 ActionError 335 ActionErrors 314, 335 ActionForm 299, 313 ActionForward 335 ActionListener 503 ActionServlet 298 activity 749 administrative console 548, 617 AEs 17 Agent Controller 515, 588, 657 installation 792 remote machine 665 service 657 AmountConverter 113, 314, 388 Animated GIF Designer 13 Ant 633–634 build path 635 project 635 property 635 target 635 task 635 classpath 644 dependencies 637 documentation 634 headless 652 J2EE applications 644 build script 645 run 650 Javadoc 651 generation 136 run 641 script 135, 639 simple build file 636 tasks 636 Web site 634 Ant build files 635 Apache Software Foundation 294 Tomcat 17, 539 API J2EE 80 appearance preferences 35 Application Assembly Tool 608, 629 Application Client Configuration Tool 629 deployment descriptor 613 module 81 project 85 Application Developer 4, 8 Ant tasks 649 ClearCase integration 752 database tools 142 help 48, 50 installation 790 Integration Edition 8 overview 10 migration 12 overview 10 preferences 26 profiling 656 team support 698 tools 12 Update Manager 793 Version 5 11 application flow 309, 385 Application Server 10 822 WebSphere Studio Application Developer Version 5 Programming Guide classpath 632 configuration 617 Express 17 installation 786 Network Deployment 375 Application Template wizard 88 ApplicationResources 304 ApplicationResources.properties 306, 321 assembly 629 assertEquals 584 assertions 576 assertTrue 584 atomicity 375 Attributes view 61 audit file 230 authentication 610 alias 534, 607 AutoCommit 263 automatic build 27, 128 AWT 470 B backend folder 410 backupConfig 629 BankException 113, 307 banking application flow 185 banking model 18, 111, 181 EJB 384 BankingProxy 452 BankingTest 112 BankingTestCase 590 BankMain 113 Base time 667 baseline 749 make 770 new 779 bean message 319 bean-managed persistence 381 BMP 381 bookmark 132 Bookmarks view 132 branch 694 create 734 CVS 733 merge 736 tag 739 breakpoint 109, 554 condition 555 JSP 556 marker 554 properties 555 Breakpoints view 70, 561 broker 442 build 27 Ant 635 file 635 management 693 path 87 settings 96 targets 639 build.compiler 639 build.xml 636 business methods session bean 423 business rule bean 10 C caching HTML 196 change management 693 variable value 562 check in 767 check in and check out 749 check out 766 CICS 10 Class Instance Statistics view 72, 682 Method Statistics view 72, 668 Statistics view 667 class loader 545 policy 545 classpath Ant 644 Application Server 632 errors 814 JAR file 104 variable 97 preferences 97 variables 33 WebSphere extension 546 ClearCase 747 add project 762 check in 767 check out 766 Index 823 connect 759 deliver 768 help 753 import 774 plug-in 694 preferences 753 project 757 rebase 777 scenario 754, 765 setup 756 synchronize 779 ClearCase LT 16, 748 Client 752 installation 749 Server 750 client Web service 465 ClientBankingProxy 462 clientConfig 629 clone 375 Cloudscape 147, 787 CMP 381 attribute 391 CMR 382 code assist 38, 44, 118 formatter preferences 35 generation 126 synchronization 483 Color by 671 Colors view 61 column create 159 com.ibm.db.beans 260 COM.ibm.db2.jdbc.app.DB2Driver 146, 175 COM.ibm.db2.jdbc.net.DB2Driver 146, 175 command design pattern 181 line tools 629 compare files 690 compareTo 425 Compilation target 640 compile errors 108 compiler options preferences 36 component 749 interface 382 plug-in 18 test run 593 testing 573 Component Test perspective 72, 588 composer 386 compression 706 concurrency 377–378, 696 workflow 697 Concurrent Versions System see CVS condition breakpoint 555 conditions 168 -configuration 24 configuration file editor 300, 336 Struts 298 conflict 702 resolution 724 connect to ClearCase 759 connection JDBC 140 pooling 141 consistency 375, 575 Console view 105, 225 -consolelog 24 container EJB 377 container-managed persistence 381 relationships 382 content assist 351 context root 187, 302 controller MVC 181, 296 converter 386 copy file transfer 525 create database 156 VOB 756 create method 404 Create Web Pages from a JavaBean wizard 286 creating test case 582 CSS Designer 179, 200 custom finder 383, 406 CustomerDoesNotExistException 113 CustomerGUI 473 CustomerInfoForm 311 CustomerListDS 177 . WebSphere Studio Enterprise Developer , SG24-6806 WebSphere Studio Application Developer Programming Guide , SG24- 658 5 Web Services Wizardry with WebSphere Studio Application Developer ,. 734 CVS 733 merge 736 tag 739 breakpoint 109, 55 4 condition 55 5 JSP 55 6 marker 55 4 properties 55 5 Breakpoints view 70, 56 1 broker 442 build 27 Ant 6 35 file 6 35 management 693 path 87 settings 96 targets. V5.0 Handbook , SG24- 655 5 IBM WebSphere Application Server Version 5. 0 Handbook , SG24-61 95 IBM WebSphere V5.0 Security WebSphere Handbook Series , SG24- 657 3 Legacy Modernization with WebSphere