Getting Started with JBoss Developer Studio

@@ -851,14 +856,14 @@ JBoss EAP 4.2 we do= not ultimately tie you to any particular server for deployment. There are some servers that Studio supp= orts directly (via the bundled Eclipse WTP plug-ins). In this section we discuss how = to manage self-installed - JBoss AS. Suppose you want to deploy the application to JBoss 4.2.3 - server. First of all you need = to install it. + JBoss AS. Suppose you want to deploy the application to JBoss 4.2.3 + server. First of all you need to install it.

JBoss AS Installation - Download the binary package of JBoss 4.2.3 and save + Downlo= ad the binary package of JBoss AS, e.g. JBoss 4.2.3 and save it on your computer: http://labs.jboss.com/jbossas/downloads @@ -876,24 +881,24 @@ range. - After = you have the binary archive you want to install, use the JDK jar + After you have the binary archive you want to in= stall, use the JDK jar tool (or any other ZIP extraction tool) to extract= the jboss-4.2.3.GA.zip archive contents into a location of your choice. T= he jboss-4.2.3.GA.tgz archive is a gzipped tar file that requires a gnut= ar compatible tar which can handle the long pathnames in the archive. The = extraction process will - create a jboss-4.2.3.GA directory. + create a jboss-4.2.3.GA directory.

- <diffmk:wrapper diffmk:change=3D"changed">Adding and Co= nfiguring JBoss Server</diffmk:wrapper> + Adding and Configuring JBoss Server Now we should add just installed server into server mana= ger in JBoss Developer Studio. - Open the= JBoss Server View by selecting + Open the JBoss Serve= r View by selecting Window > Show V= iew > Other > Server > JBoss Server View @@ -905,7 +910,7 @@ Select - JBoss Community > JBoss 4.2 Server + JBoss Community &g= t; JBoss 4.2 Server @@ -918,21 +923,21 @@ = - - <diffmk:wrapper diffmk:chan= ge=3D"added">Note:</diffmk:wrapper> + + Note: = - Now in the= New Server wizard there is a separation - between the .org servers (the - JBoss Community<= /property> - ca= tegory) and product server that comes bundled with JBoss EAP (the - - JBoss Enterprise Middleware c= ategory). + Now in the New Server wi= zard there is a separation + between the .org servers (the + JBoss Community + category) and product server that comes bu= ndled with JBoss EAP (the + + JBoss Enterprise Middl= eware category). = - To cre= ate a new runtime, which Jboss AS 4.2 matches to, click - Next + To create a new runtime, which Jboss AS 4.2 matc= hes to, click + Next @@ -960,8 +965,8 @@ = - In the n= ext dialog verify the specified information and if something is - unfair go back and correct it + In the next dialog verify the specified informat= ion and if something is + unfair go back and correct it

@@ -1277,17 +1282,13 @@ = The complete information on how to manage JBoss AS from JBoss = Developer Studio you can read in a corresponding chapter. - Now you just need to start the server by clicking on green cir= cle/triangle icon in the - JBoss Server View. - -

- Starting the Server - + Now you just need to s= tart the server by clicking on the Start the server icon ( = + - + - - + ) in = the + JBoss Server View. = Then run the project by selecting the project and use Run As... > Run on Server. @@ -2024,15 +2025,15 @@ Developing a simple JSP web application - + = Note: We highly recommend developing in Seam= . This chapter is for users who for some reason cannot use Seam. - - In this chapter you'll find out how to create a simple JSP application using the - JBoss Developer Studio. The appl= ication will show a classic + = + In this chapter you'll find out how to create a simple JSP application using the + JBoss Developer Studio. The application will show a classic "Hello World!" on the page. We'll assume that you have already launched JBoss Developer Studio and also that the Web Deve= lopment perspective is the @@ -2042,7 +2043,7 @@ Window > Open Perspective > Other...<= /property> from the menu bar and then selecting Web Development from th= e Select Perspective dialog box. - + =

Setting Up the Project @@ -2052,18 +2053,18 @@ Go to the menu bar and select - File > New > Other... - + File > New > Other... + Select - Web > Dynamic Web Project - in the New Project dialog box + Web > Dynamic Web Project + in the New Project dialog box Click - Next - + Next + @@ -2071,10 +2072,10 @@ Then select - Minimal Configuration - from the list of possible configurations and click - Finish - + Minimal Configuration + from the list of possible configurations and click + Finish +

@@ -2085,10 +2086,10 @@ - + = The - jspHello - node should appear in the upper-left Package Explorer + jspHello + node should appear in the upper-left Package Explorer view.

New Web Project @@ -2099,32 +2100,32 @@

- + =

Creating JSP Page This section covers all the points how to create, edit and then pr= eview JSP page. - In our simple application we need to create only one JSP page whic= h displays a - "Hello World!" message. + In our simple applicatio= n we need to create only one JSP page which displays a + "Hello World!" message. - Right click WebContent >= ; New > - JSP. + Right click WebContent > New > + JSP. Type "hello.jsp" for a file name and click the - Next - button. + Next + button. In the next window you can choose a template for your jsp page and= see its preview. Select - New JSP File (xhtml) - template and click - Finish - button. + New JSP File (xhtml) + template and click + Finish + button.

@@ -2141,20 +2142,27 @@

Editing a JSP Page - Let's now make a little change so that a jsp page displays - "Hello World!" message. + Let's now make a little= change so that a jsp page displays + "Hello World!" message. - Insert this line inside the - <body> + + + = + Insert this line inside the = +

<body> </body>
+

+ tag: + ]]> - - + + = Notice that content assist functionality is always available when= you are typing:

Content Assist in JSP Page @@ -2165,8 +2173,8 @@ After changes made your - hello.jsp - page should look like this: + hello.jsp + page should look like this:

Hello.jsp Page @@ -2175,21 +2183,21 @@ - + = This line will actually output "Hello - World!" message in the Console<= /property>. To make the + World!" message in the Console<= /property>. To make the message displayed in the Browser, just replace this line with the simp= le - Hello World!. + Hello World!.

- + =

web.xml file When you are creating web project the wizard creates the - web.xml - for you automatically. The web= .xml file editor - provided by JBoss Developer Studio is available in two modes: - Tree and Source. + web.xml + for you automatically. The web.= xml file editor + provided by JBoss Developer Studio is available in two modes: + Tree and Source.

Web.xml in Design and Source Mode @@ -2199,18 +2207,18 @@ Both modes are fully synchronized. Let's add mapping to our - hello.jsp - page in - web.xml - file. + hello.jsp + page in + web.xml + file. Switch to Source tab. - Add the next code into - <welcome-file-list> - : + Add the next code into = +

<welcome-file-list=
>

+ : hello.jsp @@ -2219,13 +2227,13 @@ made are automatically reflected in that mode. Actually you don't really need to do any configurations right now= .

- + =

Deploying the project - While creating any web project you could experience a pain writin= g ant scripts and + While creating any web = project you could experience a pain writing ant scripts and managing the packaging even when writing the most trivial web applicat= ions. With - JBoss Developer Studio you are= saved from such a pain. All + JBoss Developer Studio you are saved from such a pain. All you need is to start JBoss Server and launch your application in your favorite browser. You can also create a war archive with JBDS's Archive Tools @@ -2237,9 +2245,9 @@ Select - Window > Show view > Other > = JBoss - Tools > Project archives - from menu bar + Window > Show view > Other > JBoss + Tools > Project archives + from menu bar Select a project in Package Explorer you want to be archived @@ -2258,8 +2266,8 @@ Click, for example, - WAR - option to create war archive + WAR + option to create war archive In the New WAR dialog you= can see automatically selected @@ -2275,22 +2283,22 @@ Click - Next - to see a stub archive configuration for your project: <= figure float=3D"0"> - Stub Archive Configuration - - - - - -

+ Next + to see a stub archive configuration for your project: + Stub Archive Configuration + + + + + +

Click - Finish. The - .war file will appear in Package - Explorer and also in Project= Archives + Finish. The + .war file will appear in Package + Explorer and also in Project Archives view as structure tree:

Archive is Created @@ -2321,19 +2329,19 @@

- + =

Auto redeploy - When you are creating a web application and register it on JBoss - Server it is automatically deployed into - /deploy directory of the server. JBDS comes with= the + When you are creating a web application and register it on JBoss + Server it is automatically deployed into + /deploy directory of the server. JBDS comes with the feature of auto-redeploy. It means that you don't need to restart - JBoss Server. Any changes mad= e in the application in + JBoss Server.= Any changes made in the application in exploded format will trigger a redeployment on the server.