Page History

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

{code}
For the *Label*, select: *use the repository URL as the label

*
For the *Authentication*, enter your *User* name and *password*.

\\
{indent:2}
!setupWarTemplate006.jpg!
{indent}

When satisfied that everything is correct, click *Next

*.
\\
# The *Repository Location Properties* panel is a warning panel.
\\
{indent:2}
!setupWarTemplate007.jpg!

{indent}
You do not want to normalize the URL!

click *No*.
\\
# In the *Select Resource* panel, select
{code}
    svn+ssh://svn.mit.edu/es-common-services-framework/es-project-template/war-template/trunk
{code}

as shown in the following panel:

\\
{indent:2}
!setupWarTemplate008.jpg!

{indent}
When satisfied that everything is correct, click *Finish

*.
\\
# In the *Check Out As* panel, select *Check out as a project with the name specified:* as shown in the following panel.
\\
{indent:2}
!setupWarTemplate010.jpg!

{indent}
When satisfied that everything is correct, click *Finish

*.
\\
# Your *Eclipse - Project Explorer View* should now look similar to the following:
\\
{indent:2}
!setupWarTemplate011.jpg!

{indent}
# 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}
!setupWarTemplate012.jpg!

{indent}
When satisfied that everything is correct, click *Yes*.

# Open the Eclipse *Project Explorer View

*.  The view should look as follows:
\\
{indent:2}
!setupWarTemplate014.jpg!

{indent}
Right click on the *war-template* project and select *Rename...*.

Replace *war-template* with the *short project acronym* that you have previously selected.

  If you have not selected a *short project acronym*, please go to [Selecting names for your project | Selecting names for your project#Selection of a short project acronym] before continuing.
\\
{indent: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.

{indent}
\\
For example: If my *short project acronym* was *att*, then my panel would look like the following:

\\
{indent:2}
!setupWarTemplate016.jpg!
{indent}

When satisfied that everything is correct, click *OK

*.
\\
# The *Eclipse - Project Explorer View* should look similar to the following:
\\
{indent:2}
!setupWarTemplate018.jpg!

{indent}
# 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}
!setupWarTemplate019.jpg!

{indent}
# Right click on the renamed project and select *Team > Share Project...

*
Select *SVN* as shown below:

\\
{indent:2}
!setupWarTemplate020.jpg!
{indent}

When satisfied that everything is correct, click *Next

*.
\\
# Select *Create a new repository location* as shown below:
\\
{indent:2}
!setupWarTemplate022.jpg!

{indent}
When satisfied that everything is correct, click *Next

*.
\\
# Enter a desired SVN URL for your project.
The SVN repository that you should use is *svn+ssh://svn.mit.edu/es-projects/* followed by the *SVN project identifier* that you had previously selected.

  If you have not selected a *SVN project identifier*, please go to [Selecting names for your project | Selecting names for your project#Selection of a SVN project identifier] before continuing.
For example:
{indent: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:

{indent}
{indent:2}
!setupWarTemplate024.jpg!

{indent}
Don't forget to enter your *User* name and *Password*,

When satisfied that everything is correct, click *Next

*.
\\
# When the following panel is display notifying you that a new SVN entry will be created:
\\
{indent:2}
!setupWarTemplate026.jpg!

{indent}
When satisfied that everything is correct, click *OK

*.
\\
# Do the following:
{indent: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.

{indent}
The panel should be as illustrated in the following panel:

\\
{indent:2}
!setupWarTemplate028.

jpg!
{indent}
When satisfied that everything is correct, click *Next*.
\\
# Nothing to do here.  This is an information panel similar to the following panel:
\\
{indent:2}
!setupWarTemplate030.jpg!

{indent}
When satisfied that everything is correct, click *Finish

*.
\\
# 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}
!setupWarTemplate032.jpg!

{indent}
When satisfied that everything is correct, click *OK

*.
\\
# When the SVN commit has completed, the *Eclipse - Project Explorer View* should look similar to the following.
\\
{indent:2}
!setupWarTemplate034.jpg!

{indent}

h4. {color:green}Creating the project war component using the war-template is now complete.{color}

*.  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}
!customizeWar002.jpg!

{indent}
\\
# Expand your project, then expand *src/main/resources*.

Your *Project Explorer View* should look similar to the following:

\\
{indent:2}
!customizeWar004.jpg!

{indent}
\\
# 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

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

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

}
<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 *$\{logs.dir}/projectName* with *log* and the 2 remaining occurances of *projectName* have to be changed.

{code

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

}
<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 *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

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

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

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

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

}
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

}
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}
!customizeWar006.jpg!

{indent}
# 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

}
!customizeWar008.jpg!

{indent}
# 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

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

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

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

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

}
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

}
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 *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}
<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

}
<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 project's JNDI name.

{code

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