Page History

Quick

Links

to:

1. Run Eclipse.  Go to File > New > Other....
   Scroll down to SVN and expand then select Project from SVN as shown in the following panel.

!setupWarTemplate002.jpg!

When satisfied that everything is correct, click Next.

!setupWarTemplate004.jpg!

1. svn+ssh://svn.mit.edu/es-common-services-framework/es-project-template/war-template/trunk

1. For

1. the

1. Label

1. ,

1. select:

1. use

1. the

1. repository

1. URL

1. as

1. the

1. label

1. 
   For

1. the

1. Authentication

1. ,

1. enter

1. your

1. User

1. name

1. and

1. password

1. .

1. indent
   2 2
   !setupWarTemplate006.jpg!

1. When

1. satisfied

1. that

1. everything

1. is

1. correct,

1. click

1. Next

1. .

2. The Repository Location Properties panel is a warning panel.

   indent
   2 2
   !setupWarTemplate007.jpg!

1. You

1. do

1. not

1. want

1. to

1. normalize

1. the

1. URL!

1. 
   click

1. No

1. .

2. In the Select Resourcepanel, select

   Code Block
   svn+ssh://svn.mit.edu/es-common-services-framework/es-project-template/war-template/trunk

1. as

1. shown

1. in

1. the

1. following

1. panel:

1. indent
   2 2
   !setupWarTemplate008.jpg!

1. When

1. satisfied

1. that

1. everything

1. is

1. correct,

1. click

1. Finish

1. .

2. In the Check Out As panel, select Check out as a project with the name specified: as shown in the following panel.

   indent
   2 2
   !setupWarTemplate010.jpg!

1. When

1. satisfied

1. that

1. everything

1. is

1. correct,

1. click

1. Finish

1. .

2. Your Eclipse - Project Explorer View should now look similar to the following:

   indent
   2 2
   !setupWarTemplate011.jpg!

3. Right click on the war-template project and select Team > Disconnect
   When the following Confirm Disconnect from SVN panel is displayed, select Also delete the SVN meta-information from the file system.

   indent
   2 2
   !setupWarTemplate012.jpg!

1. When

1. satisfied

1. that

1. everything

1. is

1. correct,

1. click

1. Yes

1. .

2. Open

1. the

1. Eclipse

1. Project

1. Explorer

1. View

1. .  The view should look as follows:

   indent
   2 2
   !setupWarTemplate014.jpg!

1. Right

1. click

1. on

1. the

1. war-template

1. project

1. and

1. select

1. Rename...

1. .

1. 
   Replace

1. war-template

1. with

1. the

1. short

1. project

1. acronym

1. that

1. you

1. have

1. previously selected.  If you have not selected a short project acronym, please go to Selecting names for your project before continuing.

   indent
   2 2
   *Note*:  If you haven't already do so, You might want to append a *-web* to the *short project acronym* to denote that this is the web component of your project.

1. 
   For example:

1. If

1. my

1. short

1. project

1. acronym

1. was

1. att

1. ,

1. then

1. my

1. panel

1. would

1. look

1. like

1. the

1. following:

1. indent
   2 2
   !setupWarTemplate016.jpg!

1. When

1. satisfied

1. that

1. everything

1. is

1. correct,

1. click

1. OK

1. .

2. The Eclipse - Project Explorer View should look similar to the following:

   indent
   2 2
   !setupWarTemplate018.jpg!

2. Right click on the renamed project and select Configure > Convert to Maven Project
   Expand your project and it should look similar to the following:

   indent
   2 2
   !setupWarTemplate019.jpg!

2. Right click on the renamed project and select Team > Share Project...

1. 
   Select

1. SVN

1. as

1. shown

1. below:

1. indent
   2 2
   !setupWarTemplate020.jpg!

1. When

1. satisfied

1. that

1. everything

1. is

1. correct,

1. click

1. Next

1. .

2. Select Create a new repository location as shown below:

   indent
   2 2
   !setupWarTemplate022.jpg!

1. When

1. satisfied

1. that

1. everything

1. is

1. correct,

1. click

1. Next

1. .

2. Enter a desired SVN URL for your project.
   The SVN repository that you should use is svn+ssh://svn.mit.edu/es-projects/

1. followed

1. by

1. the

1. SVN

1. project

1. identifier

1. that

1. you

1. had

1. previously

1. selected.

1.   If you have not selected a SVN project identifier, please go to Selecting names for your project before continuing.
   For example:

   indent
   1 1
   If my *SVN project identifier* is *academic-att*, then the SVN URL would be: {code} svn+ssh://svn.mit.edu/es-projects/academic-att. {code} This would mean that my jar project would be created under the *es-projects/academic-att* directory in the SVN repository.  This is shown in the following panel:

1. indent
   2 2
   !setupWarTemplate024.jpg!

1. Don't

1. forget

1. to

1. enter

1. your

1. User

1. name

1. and

1. Password

1. ,

1. 
   When

1. satisfied

1. that

1. everything

1. is

1. correct,

1. click

1. Next

1. .

2. When the following panel is display notifying you that a new SVN entry will be created:

   indent
   2 2
   !setupWarTemplate026.jpg!

1. When

1. satisfied

1. that

1. everything

1. is

1. correct,

1. click

1. OK

1. .

2. Do the following:

   indent
   1 1
   * In the *Advanced Mode* section, select *Use project name*. * In the *Project Repository Layout* section, select *Use single project layout*. * Check *Use Subversion recommended layout ('trunk', 'branches' and 'tags')* check box.

1. The

1. panel

1. should

1. be

1. as

1. illustrated

1. in

1. the

1. following

1. panel:

1. indent
   2 2
   !setupWarTemplate028.jpg!

1. When

1. satisfied

1. that

1. everything

1. is

1. correct,

1. click

1. Next

1. .

2. Nothing to do here.  This is an information panel similar to the following panel:

   indent
   2 2
   !setupWarTemplate030.jpg!

1. When

1. satisfied

1. that

1. everything

1. is

1. correct,

1. click

1. Finish

1. .

2. When a panel similar to the one below is display, enter a comment.
   This is the initial SVN check-in (svn commit) for the WAR project:

   indent
   2 2
   !setupWarTemplate032.jpg!

1. When

1. satisfied

1. that

1. everything

1. is

1. correct,

1. click

1. OK

1. .

2. When the SVN commit has completed, the Eclipse - Project Explorer View should look similar to the following.

   indent
   2 2
   !setupWarTemplate034.jpg!

Creating the project war component using the war-template

is

now

complete.

Panel

Anchor Customizing the project WAR Customizing the project WAR Section 2: Customizing the project WAR indent 1 1 Wiki Markup {anchor:Customizing the project WAR} h3. Section 2: Customizing the project WAR {indent:1} {color:red}Please read the [*OVERVIEW* | #overview] before continuing.{color} {indent} # Run *Eclipse*.&nbsp;&nbsp;From the *Project Explorer View*, open the Maven WAR project that you want to customize. Your *Project Explorer View* should look similar to the following: \\ {indent:2} Run Eclipse.  From the Project Explorer View, open the Maven WAR project that you want to customize. Your Project Explorer View should look similar to the following: indent 2 2 !customizeWar002.jpg! {indent} \\ # Expand your Expand your project, then expand * src/main/resources * . Your * Project Explorer View * should look similar to the following: \\ {indent:2} indent 2 2 !customizeWar004.jpg! {indent} \\ # Open the * Open the applicationContext-projectName-config.xml * for editing and change the following lines substituting your * short project acronym * for * projectName * . \\ There are 6 occurances of * projectName * that have to be changed. { Code Block } <value>file:${user.dir}/projectName/projectName.properties</value> <value>file:${user.home}/projectName.properties</value> <value>file:${user.dir}/projectName/projectName.properties</value> <value>file:${user.home}/projectName.properties</value> {code} When you have made all the changes, the lines you have changed should look similar to the following: { Code Block } <value>file:${user.dir}/att/att.properties</value> <value>file:${user.home}/att.properties</value> <value>file:${user.dir}/att/att.properties</value> <value>file:${user.home}/att.properties</ value> {code} value> In the above example, my * short project acronym * was * att * so I replaced * projectName * with * att * and * ProjectName * with * Att * . \\ When you are satisifed with the changes, * save * and * close * the file. # Open the * log4j.xml * for editing and change the following lines substituting your * short project acronym * for * projectName *. \\ \\ #* *For Tomcat 7 implementations:* There are 4 occurances of *projectName* that have to be changed. {code} . For Tomcat 7 implementations: There are 4 occurances of projectNamethat have to be changed. Code Block <param name="File" value="${logs.dir}/projectName/projectName.log" /> <param name="File" value="${logs.dir}/projectName/hbn-projectName.log" /> {code} When you have made all the changes, the lines you have changed should look similar to the following: { Code Block } <param name="File" value="${logs.dir}/att/att.log" /> <param name="File" value="${logs.dir}/att/hbn-att.log" /> {code} In the above example, my * short project acronym * was * att * so I replaced * projectName * with * att * and * ProjectName * with * Att *. \\ \\ #* *For OC4J implementations:* Replace *$\ . For OC4J implementations: Replace ${logs.dir}/projectName * with * log * and the 2 remaining occurances of * projectName * have to be changed. { Code Block } <param name="File" value="${logs.dir}/projectName/projectName.log" /> <param name="File" value="${logs.dir}/projectName/hbn-projectName.log" /> {code} When you have made all the changes, the lines you have changed should look similar to the following: { Code Block } <param name="File" value="log/att.log" /> <param name="File" value="log/hbn-att.log" /> {code} In the above example, my * short project acronym * was * att * so I replaced * projectName * with * att * and * ProjectName * with * Att *. \\ \\ When you are satisifed with the changes, *save* and *close* the file. # Open the * . When you are satisifed with the changes, save and close the file. Open the applicationContext-projectName.xml * for editing and change the following lines substituting your * short project acronym * for * projectName * . There are 3 occurances of * projectName * that have to be changed. { Code Block } <import resource="classpath*:applicationContext-projectName-component-scan.xml" /> <import resource="classpath*:applicationContext-projectName-config.xml" /> <import resource="classpath*:applicationContext-projectName-security-spring.xml" /> {code} When you have made all the changes, the lines you have changed should look similar to the following: { Code Block } <import resource="classpath*:applicationContext-att-component-scan.xml" /> <import resource="classpath*:applicationContext-att-config.xml" /> <import resource="classpath*:applicationContext-att-security-spring.xml" /> {code} In the above example, my * short project acronym * was * att * so i replaced * projectName * with * att * .*. \\ When you are satisifed with the changes, * save * and * close * the file. # Open the * servlet.xml * for editing and change the following lines substituting your * short project acronym * for * projectName * . \\ There is 1 occurance of * projectName * that has to be changed. { Code Block } <context:component-scan base-package="edu.mit.projectName.web"> {code} When you have made the change, the line you have changed should look similar to the following: { Code Block } <context:component-scan base-package="edu.mit.att.web"> {code} In the above example, my * short project acronym * was * att * so I replaced * projectName * with * att * .*. \\ When you are satisifed with the changes, * save * and * close * the file. # From the * Project Explorer View * , rename each of the following files, substituting your * short project acronym * for * projectName * . \\ There are 4 files that have to be renamed. { Code Block } applicationContext-projectName-component-scan.xml applicationContext-projectName-config.xml applicationContext-projectName-security-spring.xml applicationContext-projectName.xml {code} When you have made all the changes, the file names that you have changed should look similar to the following: { Code Block } applicationContext-att-component-scan.xml applicationContext-att-config.xml applicationContext-att-security-spring.xml applicationContext-att.xml {code} In the above example, my * short project acronym * was * att * so I replaced * projectName * with * att * .*. \\ Your *Project Explorer View* should look similar to the following: {indent:2} Your Project Explorer Viewshould look similar to the following: indent 2 2 !customizeWar006.jpg! {indent} # In the *Project Explorer View*, expand * In the Project Explorer View, expand src/main/java * . Rename the * edu.mit.projectName.web * package, substituting your * short project acronym * for * projectName * . Your * Project Explorer View * should look similar to the following: {indent:2} indent 2 2 !customizeWar008.jpg! {indent} # In the *Project Explorer View*, expand * In the Project Explorer View, expand src/test/resources * . Open the * applicationContext-csf-unit-tests-default.xml * for editing and change the following lines substituting your project name for * projectName * . \\ There are 3 occurances of * projectName * that have to be changed. { Code Block } <import resource="classpath*:applicationContext-csf-projectName.xml" /> <import resource="classpath*:applicationContext-projectName.xml" /> <import resource="classpath*:applicationContext-projectName-config-test.xml" /> {code} When you have made all the changes, the lines you have changed should look similar to the following: { Code Block } <import resource="classpath*:applicationContext-csf-att.xml" /> <import resource="classpath*:applicationContext-att.xml" /> <import resource="classpath*:applicationContext-att-config-test.xml" /> {code} In the above example, my * short project acronym * was * att * so I replaced * projectName * with * att * .*. \\ When you are satisifed with the changes, * save * and * close * the file. # In the * Project Explorer View * , expand * src/test/resources * . Open the * applicationContext-projectName-config-test.xml * for editing and change the following lines substituting your project name for * projectName * . \\ There are 2 occurances of * projectName * that have to be changed. { Code Block } <value>classpath:projectName-test.properties</value> <value>classpath:projectName-test.properties</value> {code} When you have made all the changes, the lines you have changed should look similar to the following: { Code Block } <value>classpath:att-test.properties</value> <value>classpath:att-test.properties</value> {code} In the above example, my * short project acronym * was * att * so I replaced * projectName * with * att * .*. \\ When you are satisifed with the changes, * save * and * close * the file. # From the * Project Explorer View * , rename the following file, substituting your * short project acronym * for * projectName * . \\ There are 2 files that have to be renamed. { Code Block } applicationContext-projectName-config-test.xml projectName-test.properties {code} When you have made all the changes, the file names that you have changed should look similar to the following: { Code Block } applicationContext-att-config-test.xml att-test.properties {code} In the above example, my * short project acronym * was * att * so I replaced * projectName * with * att * .*. \\ # In the *Project Explorer View*, expand * In the Project Explorer View, expand src/main/webapp/WEB-INF * . Open the * web.xml * for editing and change the following lines substituting your * short project acronym * for * projectName *. \\ \\ #* There are 7 occurances of *projectName* that have to be changed. {code} . There are 7 occurances of projectNamethat have to be changed. Code Block <display-name>projectName</display-name> classpath*:applicationContext-csf-projectName.xml, classpath*:applicationContext-projectName.xml <servlet-name>projectName</servlet-name> <servlet-name>projectName</servlet-name> <servlet-name>projectName</servlet-name> <servlet-name>projectName</servlet-name> {code} When you have made all the changes, the lines you have changed should look similar to the following: { Code Block } <display-name>att</display-name> classpath*:applicationContext-csf-att.xml, classpath*:applicationContext-att.xml <servlet-name>att</servlet-name> <servlet-name>att</servlet-name> <servlet-name>att</servlet-name> <servlet-name>att</servlet-name> {code} In the above example, my * short project acronym * was * att * so I replaced * projectName * with * att * .*. \\ \\ #* Find the following line and change *MitsisDS* for your Find the following line and change MitsisDSfor your project's JNDI name. { Code Block } <res-ref-name>jdbc/MitsisDS</res-ref-name> {code} \\ When you are satisifed with the changes, *save* and *close* the file. # *Commit* all changes to the SVN repository. h4. {color:green}Customizing the project WAR is now complete.{color} When you are satisifed with the changes, save and close the file. Commit all changes to the SVN repository. Customizing the project WAR is now complete.

Panel

Anchor Customizing the project WAR pom.xml Customizing the project WAR pom.xml Section 3: Customizing the project WAR pom.xml indent 1 1 {color:red}Please read the [*OVERVIEW* | #overview] before continuing.{color} Run Eclipse.  From the Project Explorer View, open the Maven WAR project that you want to customize. Expand your project and open the project's pom.xml for editing. Select the pom.xml tab. You should have a display similar to the following panel.  From time to time the war-template is updated and, as a result, the Configuration Instructionsare changed.  The instructions found in the pom.xml will ALWAYS be up-to-date and may differ from what is display in the panel below. indent 2 2 !pomXml002.jpg! Follow the Configuration Instructions that are provided in the pom.xml. When you are satisfied with the changes that you have made, save the changes and close the file. Commit the changes to the SVN repository. Customizing the project WAR pom.xml is now complete.

...