Author: mcaspers Date: 2011-01-17 20:42:53 -0500 (Mon, 17 Jan 2011) New Revision: 28331 Modified: trunk/documentation/guides/GettingStartedGuide/en-US/jsp_application.xml Log: General Updates Modified: trunk/documentation/guides/GettingStartedGuide/en-US/jsp_application.xml =================================================================== --- trunk/documentation/guides/GettingStartedGuide/en-US/jsp_application.xml 2011-01-18 01:29:03 UTC (rev 28330) +++ trunk/documentation/guides/GettingStartedGuide/en-US/jsp_application.xml 2011-01-18 01:42:53 UTC (rev 28331) @@ -12,12 +12,11 @@ <note> <title>Note:</title> - <para>We highly recommend developing in <property>Seam</property>. This chapter is for users - who for some reason cannot use Seam.</para> + <para>We highly recommend developing in <property>Seam</property>. This chapter is for users who for some reason cannot use Seam.</para> </note> <para>In this chapter you'll find out how to create a simple <ulink - url="http://java.sun.com/products/jsp/">JSP</ulink> application using the + url="http://java.sun.com/products/jsp/">JSP</ulink> application using <property>JBoss Developer Studio</property>. The application will show a classic &quot;Hello World!&quot; on the page.</para> <para>We&apos;ll assume that you have already launched <property>JBoss Developer @@ -28,7 +27,7 @@ <section id="SettingUpTheProject"> <?dbhtml filename="SettingUpTheProject.html"?> <title>Setting Up the Project</title> - <para>We are going to start with the creating a Dynamic Web Project with a minimal + <para>We are going to start by creating a Dynamic Web Project with a minimal structure, i.e. with just required facets. Thus this section will perform you all necessary steps on how to do this.</para> <itemizedlist> @@ -60,10 +59,7 @@ </mediaobject> </figure> - <para>The <emphasis> - <property>jspHello</property> - </emphasis> node should appear in the upper-left <property>Package Explorer</property> - view.</para> + <para>The <emphasis><property>jspHello</property></emphasis> node should appear in the upper-left <property>Package Explorer</property> view.</para> <figure> <title>New Web Project</title> <mediaobject> @@ -82,13 +78,13 @@ <emphasis>&quot;Hello World!&quot;</emphasis> message.</para> <itemizedlist> <listitem> - <para>Right click <menuchoice><guimenuitem>WebContent</guimenuitem><guimenuitem>New</guimenuitem><guimenuitem>JSP</guimenuitem></menuchoice>.</para> + <para>Right click the <filename>WebContent</filename> folder and select <menuchoice><guimenuitem>New</guimenuitem><guimenuitem>JSP</guimenuitem></menuchoice>.</para> </listitem> <listitem> - <para>Type &quot;hello.jsp&quot; for a file name and click the <guibutton>Next</guibutton> button.</para> + <para>Type <filename>hello.jsp</filename> for a file name and click the <guibutton>Next</guibutton> button.</para> </listitem> </itemizedlist> - <para>In the next window you can choose a template for your jsp page and see its preview.</para> + <para>In the next window you can choose a template for your JSP page and see its preview.</para> <itemizedlist> <listitem> <para>Select <emphasis> @@ -104,13 +100,12 @@ </imageobject> </mediaobject> </figure> - <para>Our <emphasis><property>hello.jsp</property></emphasis> page will now appear in - <property>Project Explorer</property>. + <para>Our <filename>hello.jsp</filename> page will now appear in the <property>Project Explorer</property> view. </para> <section id="EditingJSPPage"> <?dbhtml filename="EditingJSPPage.html"?> <title>Editing a JSP Page</title> - <para>Let&apos;s now make a little change so that a jsp page displays + <para>Let&apos;s now make a little change so that a JSP page displays <emphasis>&quot;Hello World!&quot;</emphasis> message.</para> <itemizedlist> <listitem> @@ -140,9 +135,7 @@ </imageobject> </mediaobject> </figure> - <para>After changes made your <emphasis> - <property>hello.jsp</property> - </emphasis> page should look like this:</para> + <para>After changes made your <filename>hello.jsp</filename> page should look like this:</para> <figure> <title>Hello.jsp Page Source</title> <mediaobject> @@ -161,9 +154,7 @@ <section id="WebXML"> <?dbhtml filename="WebXML.html"?> <title>web.xml file</title> - <para>When you are creating web project the wizard creates the <emphasis> - <property>web.xml</property> - </emphasis> for you automatically. The <property>web.xml file editor</property> + <para>When you are creating web project the wizard creates the <filename>web.xml</filename> file for you automatically. The <property>web.xml file editor</property> provided by <property>JBoss Developer Studio</property> is available in two modes: <property>Tree</property> and <property>Source</property>.</para> <figure> @@ -175,14 +166,10 @@ </imageobject> </mediaobject> </figure> - <para>Both modes are fully synchronized. Let&apos;s add mapping to our <emphasis> - <property>hello.jsp</property> - </emphasis> page in <emphasis> - <property>web.xml</property> - </emphasis> file.</para> + <para>Both modes are fully synchronized. Let&apos;s add a mapping to our <filename>hello.jsp</filename> page in the <filename>web.xml</filename> file.</para> <itemizedlist> <listitem> - <para>Switch to <property>Source</property> tab.</para> + <para>Switch to the <property>Source</property> tab.</para> </listitem> <listitem> <para>Add the next code into @@ -200,8 +187,8 @@ <section id="DeployTheProject"> <?dbhtml filename="DeployTheProject.html"?> <title>Deploying the project</title> - <para>Writing ant scripts and managing the packaging can be quite a complicated and time consuming task for even the most trivial web applications. However, <property>JBoss Developer Studio</property> relieves you of this burden. All you need is to start <property>JBoss Server</property> and launch your application in your favorite browser.</para> - <para>You can also create a war archive with JBDS&apos;s Archive Tools + <para>Writing ant scripts and managing the packaging process can be quite a complicated and time consuming task for even the most trivial web applications. However, <property>JBoss Developer Studio</property> relieves you of this burden. All you need is to start <property>JBoss Server</property> and launch your application in your favorite browser.</para> + <para>You can also create a WAR archive with JBDS&apos;s Archive Tools and export it to any web server.</para> <section id="WarConfig"> <?dbhtml filename="WarConfig.html"?> @@ -216,7 +203,7 @@ <para>Select a project in Package Explorer you want to be archived</para> </listitem> </itemizedlist> - <para>In <property>Project Archives</property> you will see the that the project is now listed:</para> + <para>In the <property>Project Archives</property> view you will see the that the project is now listed:</para> <figure> <title>Project Archives</title> <mediaobject> @@ -252,9 +239,7 @@ <title>Stub Archive Configuration</title> <mediaobject> <imageobject> - <imagedata - fileref="images/jsp_application/jsp_application_10.png" - /> + <imagedata fileref="images/jsp_application/jsp_application_10.png"/> </imageobject> </mediaobject> </figure> @@ -262,15 +247,13 @@ </listitem> <listitem> <para>Click the <guibutton>Finish</guibutton> button. The - <emphasis>.war</emphasis> file will appear in <property>Package + <emphasis>.WAR</emphasis> file will appear in <property>Package Explorer</property> and also in <property>Project Archives</property> view as structure tree: <figure> <title>Archive is Created</title> <mediaobject> <imageobject> - <imagedata - fileref="images/jsp_application/jsp_application_11.png" - /> + <imagedata fileref="images/jsp_application/jsp_application_11.png"/> </imageobject> </mediaobject> </figure> @@ -278,16 +261,14 @@ <title>Archive in Project Archives View</title> <mediaobject> <imageobject> - <imagedata - fileref="images/jsp_application/jsp_application_12.png" - /> + <imagedata fileref="images/jsp_application/jsp_application_12.png"/> </imageobject> </mediaobject> </figure> </para> </listitem> </itemizedlist> - <para>Via <property>Project Archives</property> view you could now rebuild the archive:</para> + <para>Using the <property>Project Archives</property> view you can rebuild the archive:</para> <figure> <title>Configure Archive</title> <mediaobject> @@ -302,8 +283,8 @@ <?dbhtml filename="AutoRedeploy.html"?> <title>Auto redeploy</title> <para>When you are creating a web application and register it on <property>JBoss - Server</property> it is automatically deployed into - <emphasis>/deploy</emphasis> directory of the server. JBDS comes with the + Server</property> it is automatically deployed into the + <filename>/deploy</filename> directory of the server. JBDS comes with the feature of auto-redeploy. It means that you don&apos;t need to restart <property>JBoss Server</property>. Any changes made in the application in exploded format will trigger a redeployment on the server.</para> @@ -328,25 +309,20 @@ <title>JSP Page Preview</title> <para><property>JBDS</property> comes with JSP design-time preview features. When designing JSP pages you can easily preview how they will look during runtime. You - can even attach your stylesheet to the - Preview.</para> + can even attach your stylesheet to the Preview.</para> <itemizedlist> <listitem> - <para>Make a little change to <emphasis> - <property>hello.jsp</property> - </emphasis> page, e.g. put this code snippet:</para> + <para>Make a little change to <filename>hello.jsp</filename> page, e.g. put this code snippet:</para> </listitem> </itemizedlist> <programlisting role="XML"><![CDATA[<%= new java.util.Date() %> ]]></programlisting> <itemizedlist> <listitem> - <para>Click <emphasis> - <property>Save</property> - </emphasis> button.</para> + <para>Click the <guibutton>Save</guibutton> button.</para> </listitem> <listitem> - <para>Switch to Preview page by clicking <property>Preview</property> tab at the + <para>Switch to Preview page by clicking the <property>Preview</property> tab at the bottom of the page. You will see how the page will look at runtime.</para> </listitem> </itemizedlist> @@ -380,15 +356,9 @@ <itemizedlist> <listitem> - <para>Click the Run icon or right click your project folder and select <emphasis> - <property>Run As &gt; Run on Server</property>. </emphasis> If you - haven&apos;t made any changes in <emphasis> - <property>web.xml</property> - </emphasis> file or cleared it out you can launch the application by right - clicking the <emphasis> - <property>hello.jsp</property> - </emphasis> page and selecting <emphasis> - <property>Run on the Server</property> </emphasis>( + <para>Click the <guibutton>Run</guibutton> icon or right click your project folder and select <menuchoice><guimenuitem>Run As</guimenuitem><guimenuitem>Run on Server</guimenuitem></menuchoice>. If you + haven&apos;t made any changes in the <filename>web.xml</filename> file or cleared it out you can launch the application by right + clicking the the <filename>hello.jsp</filename> page and selecting <guimenuitem>Run on the Server</guimenuitem>( <inlinemediaobject> <imageobject> <imagedata fileref="images/jsp_application/jsp_application_16.png"/> @@ -407,8 +377,8 @@ </mediaobject> </figure> <para>Thus with the help of this chapter you&apos;ve learnt how to organize a Dynamic - Web Project with a minimal configuration, add any staff to it (in our case it&apos;s - just one jsp page) and deploy and run it on the <property>JBoss Server</property> + Web Project with a minimal configuration, add new elements to it (in our case it&apos;s + just one JSP page) and deploy and run it on the <property>JBoss Server</property> shipped with <property>JBDS</property>. </para> </section>