Borland Software JBUILDER 2005 Manual do Utilizador

JBuilder® 2005Developing Applications for J2EE™ Servers

4 Developing Applications for J2EE ServersDeveloper support and resourcesUsenet newsgroupsThe following Usenet groups are devoted to Java and related

94 Developing Applications for J2EE ServersUsing JBuilder with TomcatTo view Tomcat configurations,1 Choose Enterprise|Configure Servers. The Configur

Chapter 10: Using JBuilder with Tomcat 95Selecting Tomcat as your project’s web serverIf you’d like more information about Tomcat or would like to run

96 Developing Applications for J2EE ServersRunning your servlet or JSP with TomcatRunning your servlet or JSP with TomcatBefore you run your web appli

Chapter 10: Using JBuilder with Tomcat 97Running your servlet or JSP with TomcatChanging Tomcat’s port numberOccasionally, you may run into a problem

98 Developing Applications for J2EE ServersRunning your servlet or JSP with TomcatDebugging JSPs with Tomcat 4.1Tomcat 4.1 does not support JSP debugg

Chapter 11: Editing J2EE deployment descriptors 99Chapter11Chapter11Editing J2EE deploymentdescriptorsJBuilder has a Deployment Descriptor Editor, als

100 Developing Applications for J2EE ServersDisplaying the DD Editormodules and editing the deployment descriptors, see Chapter 12, “Integrating with

Chapter 11: Editing J2EE deployment descriptors 101Standard and server-specific pagesexpandable. When this node is expanded, you can see the entity be

102 Developing Applications for J2EE ServersAdding to and deleting from a deployment descriptorClick any server-specific tabs and fill in each of thes

Chapter 11: Editing J2EE deployment descriptors 103Validating a deployment descriptor entryA new page appears in the content pane that corresponds to

Chapter 2: Programming for the Java 2 Platform, Enterprise Edition 5Chapter2Chapter 2Programming for the Java 2 Platform,Enterprise EditionThe Java™ 2

104 Developing Applications for J2EE ServersValidating a deployment descriptor entryIf errors or warnings exist, they will appear on a Validation page

Chapter 12: Integrating with Enterprise Information Systems 105Chapter12Chapter 12Integrating with EnterpriseInformation SystemsThe J2EE Connector arc

106 Developing Applications for J2EE ServersCreating a connector module node in the project paneTo begin creating a connector module node that contain

Chapter 12: Integrating with Enterprise Information Systems 107Creating a connector module node in the project pane3 Specify a name to identify the ne

108 Developing Applications for J2EE ServersCreating a connector module node in the project pane7 Select which Connector specification you are using f

Chapter 12: Integrating with Enterprise Information Systems 109Creating a connector module node in the project pane4 Specify a name to identify the ne

110 Developing Applications for J2EE ServersViewing the connector module deployment descriptors3 Click Next to go to the next page:4 Specify the name

Chapter 12: Integrating with Enterprise Information Systems 111Editing the resource adapter descriptors Resource Adapter Version: Specify the version

112 Developing Applications for J2EE ServersEditing the resource adapter descriptorsFor more information about resource adapters and the J2EE Connecto

Chapter 12: Integrating with Enterprise Information Systems 113Editing the resource adapter descriptorsConfiguration Property pageConnector modules ha

6 Developing Applications for J2EE ServersWhy are J2EE applications desirable?was “served up” by a server. This approach initially promised improved s

114 Developing Applications for J2EE ServersServer-specific pagesServer-specific pagesAs you work with pages in the Connector Module DD Editor, you ma

Chapter 13: Building J2EE modules 115Chapter13Chapter 13Building J2EE modulesThis chapter presents specific information about packaging J2EE modules i

116 Developing Applications for J2EE ServersSetting module build propertiesConnector Module wizard. Compiling a connector module creates a RAR (Resour

Chapter 13: Building J2EE modules 117Adding custom file types A connector module RAR by default contains only descriptors. Classes in the project’s ou

118 Developing Applications for J2EE ServersSample build scenariosTo select file types to be copied over to the project’s output path and the module d

Chapter 13: Building J2EE modules 119Sample build scenariosEJB JAR without EJB designer XML descriptorsFollow these steps:1 Right-click the EJB module

120 Developing Applications for J2EE ServersSample build scenariosEAR with custom filesThis sample adds .dat files along with the archives and descrip

Chapter 13: Building J2EE modules 121Improving module build performanceImproving module build performanceTo improve module build performance, try thes

122 Developing Applications for J2EE Servers

Index 123Aapplication client modules 99Application Module wizard 11application modules 11, 99application servers 19Borland target 19configuring target

Chapter 2: Programming for the Java 2 Platform, Enterprise Edition 7Why are J2EE applications desirable?This expanded diagram shows you the various co

124 Developing Applications for J2EE ServersDeveloper Support 3disabled EJB wizards 24distributed applicationsCORBA 45VisiBroker ORB 45wizards 57docum

Index 125Nnewsgroups 3Borland and JBuilder 3public 4Usenet 4OORB (Object Request Broker) 45default 47, 51properties 47, 50setting up 47, 51OrbixWeb OR

126 Developing Applications for J2EE Serversweb serversconfiguring 19Tomcat 93WebLogic 66DD Editor 67setting EJBC options 67target application server

8 Developing Applications for J2EE ServersWhy are J2EE applications desirable?Benefits of the multi-tier modelThe multi-tier approach adopted by the J

Chapter 2: Programming for the Java 2 Platform, Enterprise Edition 9How JBuilder can helpHow JBuilder can helpJBuilder Enterprise Edition has many fea

10 Developing Applications for J2EE ServersHow JBuilder can helpmanipulate data from a database so you can build data-aware servlets and JSPs. For inf

Chapter 2: Programming for the Java 2 Platform, Enterprise Edition 11Learning about J2EE Extensible Markup Language (XML)Although not really a J2EE te

12 Developing Applications for J2EE Servers

Chapter 3: Creating applications with J2EE technologies 13Chapter3Chapter 3Creating applications with J2EEtechnologiesThe Developing Web Applications,

Borland Software Corporation100 Enterprise WayScotts Valley, California 95066-3249www.borland.comRefer to the file deploy.html located in the redist d

14 Developing Applications for J2EE ServersClient-server applicationsHere’s the diagram from the previous chapter showing the multiple tiers used in m

Chapter 3: Creating applications with J2EE technologies 15Multi-tier applicationshandle business logic, all on the client tier. You would use JDBC or

16 Developing Applications for J2EE ServersStand-alone clientsConsumers of dynamic web contentOne type of stand-alone client is a Java application or

Chapter 3: Creating applications with J2EE technologies 17Web-centric applicationsWeb-centric applicationsThere are times when your application just d

18 Developing Applications for J2EE Servers

Chapter 4: Configuring the target server settings 19Chapter4Chapter 4Configuring the target serversettingsBefore you begin creating enterprise applica

20 Developing Applications for J2EE ServersSetting up servers within JBuilderSetting up servers within JBuilderThis is a feature ofJBuilder Developera

Chapter 4: Configuring the target server settings 21Setting up servers within JBuilderdialog box when not all required values are set or selecting ano

22 Developing Applications for J2EE ServersAdding a service packCreating a duplicate configuration to editOnce you’ve created a server configuration,

Chapter 4: Configuring the target server settings 23The created librariesThe created librariesWhen you configure the server settings, one or more libr

iContentsChapter 1Introduction 1Documentation conventions . . . . . . . . . . . . . 1Developer support and resources. . . . . .

24 Developing Applications for J2EE ServersSelecting a serverJBoss 3.x+ JBoss 3.x+ Client: JARs needed to run a client. JBoss 3.x+ Servlet: Used for w

Chapter 4: Configuring the target server settings 25Selecting a server To use different servers for different services,1 Select the Modular Services P

26 Developing Applications for J2EE ServersSetting up JDBC driversData Source information is persisted in config.xml. DataSource entries are removed w

Chapter 4: Configuring the target server settings 27Updating projects with the latest server settings5 Click OK to close the file browser. This displa

28 Developing Applications for J2EE ServersUpdating from an earlier version of JBuilderUpdating from an earlier version of JBuilderPrevious versions o

Chapter 5: Using JBuilder with Borland servers 29Chapter5Chapter 5Using JBuilder with Borland serversThis chapter explains how to set up and use Borla

30 Developing Applications for J2EE ServersConfiguring Borland servers in JBuilder Home Directory: The directory where Borland Enterprise Server AppSe

Chapter 5: Using JBuilder with Borland servers 31Configuring Borland servers in JBuilder User Name: The name you use to identify yourself to the serve

32 Developing Applications for J2EE ServersConfiguring Borland servers in JBuilder3 Select the Enable Server option at the top of the dialog box.Check

Chapter 5: Using JBuilder with Borland servers 33Configuring Borland servers in JBuilder Partition Name: The name of the partition in which the server

iiSetting and viewing IDL build properties . . . . . . . 55Using the CORBA wizards . . . . . . . . . . . . . . 57Sample IDL wizard

34 Developing Applications for J2EE ServersMaking the ORB available to JBuilderMaking the ORB available to JBuilderYou use the CORBA node of the Enter

Chapter 5: Using JBuilder with Borland servers 35Configurations, partitions, partition services, and J2EE APIsBorland Enterprise Server AppServer Edit

36 Developing Applications for J2EE ServersConfigurations, partitions, partition services, and J2EE APIs4 For Borland Enterprise Server 6.0, change th

Chapter 5: Using JBuilder with Borland servers 37Configurations, partitions, partition services, and J2EE APIsrun configuration for the partition (Edi

38 Developing Applications for J2EE ServersStarting the configuration or serverStarting the configuration or serverBefore any server related actions (

Chapter 5: Using JBuilder with Borland servers 39Starting the configuration or serverThe libraries to be copied can be set with the Libraries To Deplo

40 Developing Applications for J2EE ServersRemote deployingNote By default, all services associated with a partition are started. This could cause the

Chapter 5: Using JBuilder with Borland servers 41Remote debuggingRemote debuggingBefore you can debug your application remotely, you need to configure

42 Developing Applications for J2EE ServersRemote debugging3 Look for the JPDA element and edit attribute values as follows:enable-jpda-debug="tr

Chapter 5: Using JBuilder with Borland servers 43Web module workaroundsRemote debugging in JBuilderOnce either edition of the Borland Enterprise Serve

iiiChapter 13Building J2EE modules 115J2EE modules . . . . . . . . . . . . . . . . . . . 115Setting module build properties . .

44 Developing Applications for J2EE ServersDisplaying the Borland Management Console in JBuilderIf you are working on a named context but have the roo

Chapter 6: Using JBuilder’s CORBA tools 45Chapter6Chapter 6Using JBuilder’s CORBA toolsThis chapter explains the CORBA (Common Object Request Broker A

46 Developing Applications for J2EE ServersHow JBuilder and the VisiBroker ORB work togetherthe Internet or through local intranets. The VisiBroker OR

Chapter 6: Using JBuilder’s CORBA tools 47Setting up JBuilder for CORBA applicationsSetting up JBuilder for CORBA applicationsThis section explains ho

48 Developing Applications for J2EE ServersSetting up JBuilder for CORBA applicationsConfiguring VisiBroker stand-aloneFollow the steps in this sectio

Chapter 6: Using JBuilder’s CORBA tools 49Setting up JBuilder for CORBA applications5 The Library For Projects field defines the library location of t

50 Developing Applications for J2EE ServersSetting up JBuilder for CORBA applications2 Make sure VisiBroker is selected as your IDL compiler.3 Enter t

Chapter 6: Using JBuilder’s CORBA tools 51Setting up JBuilder for CORBA applications4 The Path For ORB Tools field allows JBuilder to access ORB tools

52 Developing Applications for J2EE ServersSetting and viewing ORB build propertieslocation of the ORB tools. The library is necessary for compiling t

Chapter 6: Using JBuilder’s CORBA tools 53Setting and viewing ORB build propertiesMake sure the IDL Compiler field is set to VisiBroker or VisiBroker

iv

54 Developing Applications for J2EE ServersSetting and viewing ORB build properties Set the Java2IIOP Strict Portable Code Generation (Java2IIOP) opti

Chapter 6: Using JBuilder’s CORBA tools 55Setting and viewing IDL build properties3 Choose the Paths node in the Project Properties dialog box. Make s

56 Developing Applications for J2EE ServersSetting and viewing IDL build propertiesThe tie mechanism offers an alternative when it is not convenient o

Chapter 6: Using JBuilder’s CORBA tools 57Using the CORBA wizards3 Click the OK button to set the options to be used by the VisiBroker idl2java compil

58 Developing Applications for J2EE ServersUsing the CORBA wizardsThe CORBA Client Interface wizard looks like this:CORBA Server Interface wizardThe C

Chapter 6: Using JBuilder’s CORBA tools 59Using the CORBA wizardsThe Enter Application Details page of the HTML CORBA Client wizard looks like this. T

60 Developing Applications for J2EE ServersUsing the CORBA wizardsThe first page of the Use CORBA Interface wizard, where you choose whether to use an

Chapter 7: Using JBuilder with BEA WebLogic servers 61Chapter7Chapter 7Using JBuilder with BEA WebLogicserversThis chapter explains how to use to set

62 Developing Applications for J2EE ServersConfiguring JBuilder for WebLogic serversdialog box when not all required values are set or selecting anoth

Chapter 7: Using JBuilder with BEA WebLogic servers 63Configuring JBuilder for WebLogic servers Web Browser Path: Specify the path and file name of th

Chapter 1: Introduction 1Chapter1Chapter 1IntroductionDeveloping Applications for J2EE Servers introduces you to the various technologies that make up

64 Developing Applications for J2EE ServersSelecting a serverCreated librariesWhen you configure JBuilder to target a WebLogic server, required librar

Chapter 7: Using JBuilder with BEA WebLogic servers 65Selecting a serverYou can click the Help button on this page for assistance using this page to s

66 Developing Applications for J2EE ServersWorking in JBuildermeans the archive is exploded into a directory as its contents are deployed instead.If y

Chapter 7: Using JBuilder with BEA WebLogic servers 67Starting the serverCreating WebLogic entity beans in JBuilderJBuilder’s EJB designer has support

68 Developing Applications for J2EE ServersRemote deploying3 Select Server from the Type drop-down list.4 In the Name field, enter a name, such as Ser

Chapter 7: Using JBuilder with BEA WebLogic servers 69Remote deploying Deploying from the project pane:a Right-click the module you want to deploy in

70 Developing Applications for J2EE ServersRemote deploying5 Select the Map Project EJB Modules At Runtime option:6 Choose OK to close the dialog box.

Chapter 7: Using JBuilder with BEA WebLogic servers 71Remote debuggingA few WebLogic Server properties, such as field groups and other CMP WebLogic-sp

72 Developing Applications for J2EE ServersUpdating projects with the latest server settings4 Launch the WebLogic server with debug parameters. To do

Chapter 8: Using JBuilder with IBM WebSphere servers 73Chapter8Chapter 8Using JBuilder with IBM WebSphereserversThis chapter explains how set up and u

2 Developing Applications for J2EE ServersDeveloper support and resourcesJBuilder is available on multiple platforms. See the following table for a de

74 Developing Applications for J2EE ServersConfiguring JBuilder for WebSphere servers4 If you want to change any of the settings, click the ellipsis (

Chapter 8: Using JBuilder with IBM WebSphere servers 75Selecting a server Add An Administrative Scripting Item To The Enterprise Menu: Checking this c

76 Developing Applications for J2EE ServersStarting the serverthe WebSphere 4.0 Advanced Edition only. If you are using one edition of WebSphere 4.0 a

Chapter 8: Using JBuilder with IBM WebSphere servers 77DeployingBy default in WebSphere 5.x, the stdout and stderr streams are redirected to log files

78 Developing Applications for J2EE ServersDeploying8 Set the Host field to the host name where the Deployment Manager is running.9 Set the Port field

Chapter 8: Using JBuilder with IBM WebSphere servers 79Enabling remote debuggingYou can also deploy a module to a remote server from JBuilder’s projec

80 Developing Applications for J2EE ServersEnabling remote debugging2 Edit the launch script and add the following remote debug parameters to the java

Chapter 8: Using JBuilder with IBM WebSphere servers 81Container-managed persistence (CMP) 1.1 and 2.0 in WebSphere 5.x5 In the dialog box that appear

82 Developing Applications for J2EE ServersContainer-managed persistence (CMP) 1.1 and 2.0 in WebSphere 5.xTo change the default CMP mapping behavior

Chapter 9: Using JBuilder with JBoss servers 83Chapter9Chapter 9Using JBuilder with JBoss serversThis chapter explains how set up and use the JBoss ap

Chapter 1: Introduction 3Developer support and resourcesContacting Borland Developer SupportBorland offers several support programs for customers and

84 Developing Applications for J2EE ServersSelecting a server5 Click the Custom tab to view fields unique to the server. Change or fill in these field

Chapter 9: Using JBuilder with JBoss servers 85Creating a JBoss service module2 Decide whether you are creating an empty JBoss service module that you

86 Developing Applications for J2EE ServersCreating a JBoss service module3 Click Next.4 Specify a name to identify the new module in the Name field.5

Chapter 9: Using JBuilder with JBoss servers 87Creating a JBoss service module4 Specify a name to identify the new JBoss service module in the Name fi

88 Developing Applications for J2EE ServersEditing the JBoss service module deployment descriptorEditing the JBoss service module deployment descripto

Chapter 9: Using JBuilder with JBoss servers 89Deploying locally3 Select Server from the Type drop-down list.4 In the Name field, enter a name, such a

90 Developing Applications for J2EE ServersDeploying exploded web modulesBoth the Server Deployment dialog box and the Deployment page of the Project|

Chapter 9: Using JBuilder with JBoss servers 91JSP debuggingJSP debuggingTomcat or Jetty do not support JSP source debugging, but you can remedy this

92 Developing Applications for J2EE Servers

Chapter 10: Using JBuilder with Tomcat 93Chapter10Chapter 10Using JBuilder with TomcatWeb Development is afeature of JBuilderDeveloper andJBuilder Ent