Page History

Section 2: Customizing the project WAR

indent
1 1
{color:red}Please read the [*OVERVIEW* | #overview] before continuing.{color}

1. 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

1. !customizeWar002.jpg!

2. Expand your project, then expand src/main/resources.
   Your Project Explorer View should look similar to the following:

   indent
   2 2

1. !customizeWar004.jpg!

2. Open the applicationContext-projectName-config.xml for editing and change the following lines substituting your short project

1. acronym for projectName.
   

1. There are

1. 6 occurances of projectNamethat have to be changed.

   Code Block

1. <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>

   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:$

1. {user.home}/

1. att.properties</value>

1. 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.

2. 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 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" />

     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" />

     In the above example, my short project acronym was att so I replaced projectName with att and ProjectName with Att.

   • For OC4J implementations:
     Replace ${logs.dir}/projectName with log and the 2 remaining occurances of projectNamehave to be changed.

     Code Block
     <param name="File" value="${logs.dir}/projectName/projectName.log" /> <param name="File" value="${logs.dir}/projectName/hbn-projectName.log" />

     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" />

     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.

3. Open the applicationContext-projectName.xml for editing and change the following lines substituting your short project acronym for projectName.
   There are 3 occurances of projectNamethat 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" />

   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" />

   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.

4. Open the servlet.xml for editing and change the following lines substituting your short project acronym for projectName.
   There is 1 occurance of projectNamethat has to be changed.

   Code Block
   <context:component-scan base-package="edu.mit.projectName.web">

   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">

   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.

5. 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

   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

   In the above example, my short project acronym was att so I replaced projectName with att.*.
   Your Project Explorer Viewshould look similar to the following:

   indent
   2 2
   !customizeWar006.jpg!

6. 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 Viewshould look similar to the following:

   indent
   2 2
   !customizeWar008.jpg!

7. 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 projectNamethat 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" />

   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" />

   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.

8. 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 projectNamethat have to be changed.

   Code Block
   <value>classpath:projectName-test.properties</value> <value>classpath:projectName-test.properties</value>

   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>

   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.

9. 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

   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

   In the above example, my short project acronym was att so I replaced projectName with att.*.

10. 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 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>

      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>

      In the above example, my short project acronym was att so I replaced projectName with att.*.

    • Find the following line and change MitsisDSfor your project's JNDI name.

      Code Block
      <res-ref-name>jdbc/MitsisDS</res-ref-name>

      
      When you are satisifed with the changes, save and close the file.

1. Commit all changes to the SVN repository.

Customizing the project WAR is now complete.