Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

Help is available by sending an email to csf-support@mit.edu
Have any suggestion on how improve this wiki?  Please give us your feedback at csf-support@mit.edu

Panel
Wiki Markup

Quick Links to:
{toc:minLevel=3|maxLevel=3}

...

Panel

Anchor
overview
overview

OVERVIEW

This document contain the instruction on how to install and configure your project's JAR component using the jar-template.  The screen shots are taken from the Eclipse Java EE IDE for Web Developers - Version: Indigo Service Release 2 IDE.  If you are using a different version of Eclipse Java EE or a different variant of Eclipse, the screen shots may differ.  It is important to keep in mind that the following instructions should be viewed as to what has to be done rather than how to do it.

There are 3 sections to this document.  These sections are:

  • Section 1:
    This section deals with creating a Maven jar project using the jar-template.  There is nothing new here and you should know how to do the above relative to the Eclipse IDE that you are using.
    You should notice that in this section:
    1. Items 1 - 8 deal with checking out and disconnecting the jar template from the SVN repository.
    2. Items 9 - 12 deal with cleanup, renaming the jar template and converting the project to a Maven project.
    3. Items 13 - 20 deal with checking in the renamed project into a new SVN repository specifically for your project.
  • Section 2:
    This section deals editing various project files and is very straight forward.
    Again, there is nothing new here and you should know how to do the above relative to the Eclipse IDE that you are using.
  • Section 3:
    This section deals editing the project's pom.xml.
  • Section 4:
    This section deals with changes that have been made to the JAR template that are not reflected in the documentation.

It should take you approximately 10 - 20 minutes to get your jar component created and customized.

{anchor:Creating the project jar component using the jar-template} h3. Section 1: Creating the project jar component using the jar-template * {color:red}This setup assumes that you have completed the [Workstation configuration | Getting Started#Workstation configuration] as found on the [CSF Home - Getting Started | Getting Started] tab. If you have not completed the [Workstation configuration | Getting Started#Workstation configuration], please do so [*now* | Getting Started#Workstation configuration]. Please read the [*OVERVIEW* | #overview] before continuing.{color} # Run Eclipse.  Go to *File > New > Other...*. Scroll down to *SVN* and expand then select *Project from SVN* as shown in the following panel. !setupJarTemplate002.jpg! When satisfied that everything is correct, click *Next*. # From the *Checkout Project from SVN repository* panel, select *Create a new repository location* as shown in the following panel. !setupJarTemplate004.jpg! When satisfied that everything is correct, click *Next*. # In the *Enter Repository Location Information* panel do the following: for the *URL:* field enter: {code}
  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.
    Image Added
    When satisfied that everything is correct, click Next.
  2. From the Checkout Project from SVN repository panel, select Create a new repository location as shown in the following panel.
    Image Added
    When satisfied that everything is correct, click Next.
  3. In the Enter Repository Location Information panel do the following:
    for the URL:field enter:

Panel

 

Anchor
Creating the project jar component using the jar-template
Creating the project jar component using the jar-template

Section 1: Creating the project jar component using the jar-template

Wiki Markup
Code Block
  1.     svn+ssh://svn.mit.edu/es-common-services-framework/es-project-template/jar-template/trunk
    
{code}
  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

*. !setupJarTemplate006.jpg! When satisfied that everything is correct, click *Next*. # The *Repository Location Properties* panel is a warning panel. !setupJarTemplate007.jpg! You do not want to normalize the URL! click *No*. # In the *Select Resource* panel, select {code}
  1. .
    Image Added
    When satisfied that everything is correct, click Next.

  2. The Repository Location Properties panel is a warning panel.
    Image Added
    You do not want to normalize the URL!
    click No.
  3. In the Select Resourcepanel, select

    Code Block
        svn+ssh://svn.mit.edu/es-common-services-framework/es-project-template/jar-template/trunk
    
{code}
  1. as

  1. shown

  1. in

  1. the

  1. following

  1. panel:

!setupJarTemplate008.jpg! 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. !setupJarTemplate010.jpg! When satisfied that everything is correct, click *Finish*. # Your *Eclipse - Project Explorer View* should now look similar to the following: !setupJarTemplate011.jpg! # Right click on the *jar-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*. !setupjarTemplate012.jpg! When satisfied that everything is correct, click *Yes*. # Open the Eclipse *Project Explorer View*.&nbsp;&nbsp;The view should look as follows: !setupJarTemplate014.jpg! Right click on the *jar-template* project and select *Rename...*. Replace *jar-template* with the *short project acronym* that you have previously selected.&nbsp;&nbsp;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. {color:red}Prefix a *csf-* to the *short project acronym* to denote that this is the jar component of your project.{color} For example: If my *short project acronym* was *att*, then my panel would look like the following: !setupJarTemplate016.jpg! When satisfied that everything is correct, click *OK*. # The *Eclipse - Project Explorer View* should look similar to the following: !setupJarTemplate018.jpg! # Minimize your IDE, and open *Windows Explorer* (user *finder* on the MAC).&nbsp;&nbsp;Navigate to the home directory of your jar project.&nbsp;&nbsp;With a *text editor*, open the *.project* file.&nbsp;&nbsp;Find the following line: {code} <name>jar-template</name> {code} and replace *jar-template* with the *short project acronym* that you have previously selected. {color:red}Prefix a *csf-* to the *short project acronym* to denote that this is the jar component of your project.{color} For example: If my *short project acronym* was *att*, then the line would look like the following: {code} <name>csf-att</name> {code} When you are satisfied that everything is correct, save your change and close the .project file. Maximize your IDE. \\ # Right click on the renamed project and select *Configure > Convert to Maven Project* Expand your project and it should look similar to the following: !setupJarTemplate019.jpg! # Right click on the renamed project and select *Team > Share Project...* Select *SVN* as shown below: !setupJarTemplate020.jpg! When satisfied that everything is correct, click *Next*. # Select *Create a new repository location* as shown below: !setupJarTemplate022.jpg! When satisfied that everything is correct, click *Next*. # Enter a desired SVN URL for your project. The SVN repository that you should use is *

  1. Image Added
    When satisfied that everything is correct, click Finish.

  2. In the Check Out As panel, select Check out as a project with the name specified: as shown in the following panel.
    Image Added
    When satisfied that everything is correct, click Finish.
  3. Your Eclipse - Project Explorer View should now look similar to the following:
    Image Added
  4. Right click on the jar-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.
    Image Added
    When satisfied that everything is correct, click Yes.
  5. Open the Eclipse Project Explorer View.  The view should look as follows:
    Image Added
    Right click on the jar-template project and select Rename....
    Replace jar-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 before continuing.
    Prefix a csf- to the short project acronym to denote that this is the jar component of your project.
    For example: If my short project acronym was att, then my panel would look like the following:
    Image Added
    When satisfied that everything is correct, click OK.
  6. The Eclipse - Project Explorer View should look similar to the following:
    Image Added
  7. Minimize your IDE, and open Windows Explorer (user finder on the MAC).  Navigate to the home directory of your jar project.  With a text editor, open the .projectfile.  Find the following line:

    Code Block
    <name>jar-template</name>
    

    and replace jar-template with the short project acronym that you have previously selected.
    Prefix a csf- to the short project acronym to denote that this is the jar component of your project.
    For example: If my short project acronym was att, then the line would look like the following:

    Code Block
    <name>csf-att</name>
    

    When you are satisfied that everything is correct, save your change and close the .project file.
    Maximize your IDE.

  8. Right click on the renamed project and select Configure > Convert to Maven Project
    Expand your project and it should look similar to the following:
    Image Added
  9. Right click on the renamed project and select Team > Share Project...
    Select SVN as shown below:
    Image Added
    When satisfied that everything is correct, click Next.
  10. Select Create a new repository location as shown below:
    Image Added
    When satisfied that everything is correct, click Next.
  11. 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.

&nbsp;&nbsp;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:&nbsp;&nbsp;If my *SVN project identifier* is *academic-att*, then the SVN URL would be: {code}
  1.   If you have not selected a SVN project identifier, please go to Selecting names for your project before continuing.
    For example:  If my SVN project identifier is academic-att, then the SVN URL would be:

    Code Block
    svn+ssh://svn.mit.edu/es-projects/academic-att.
    
{code}
  1. This

  1. would

  1. mean

  1. that

  1. my

  1. jar

  1. project

  1. would

  1. be

  1. created

  1. under

  1. the

*
  1. es-projects/academic-att

*
  1. directory

  1. in

  1. the

  1. SVN

  1. repository.

&nbsp;&nbsp;This is shown in the following panel: !setupJarTemplate024.jpg!
  1.   This is shown
    in the following panel:
    Image Added
    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. .

#
  1. When
  1. the
  1. following
  1. panel
  1. is
  1. display
  1. notifying
  1. you
  1. that
  1. a
  1. new
  1. SVN
  1. entry
  1. will
  1. be
  1. created:
!setupJarTemplate026.jpg! When satisfied that everything is correct, click *OK*. # Do the following: &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;In the *Advanced Mode* section, select *Use project name*. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;In the *Project Repository Layout* section, select *Use single project layout*. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Check *Use Subversion recommended layout ('trunk', 'branches' and 'tags')* check box. The panel should be as illustrated in the following panel: !setupJarTemplate028.jpg! When satisfied that everything is correct, click *Next*. # Nothing to do here.&nbsp;&nbsp;This is an information panel similar to the following panel: !setupJarTemplate030.jpg! 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 JAR project: !setupJarTemplate032.jpg! 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. !setupJarTemplate034.jpg! h4. {color:green}Creating the project jar component using the jar-template is now complete.{color}

  1. Image Added
    When satisfied that everything is correct, click OK.
  2. Do the following:
              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.
    The panel should be as illustrated in the following panel:
    Image Added
    When satisfied that everything is correct, click Next.
  3. Nothing to do here.  This is an information panel similar to the following panel:
    Image Added
    When satisfied that everything is correct, click Finish.
  4. When a panel similar to the one below is display, enter a comment.
    This is the initial SVN check-in (svn commit) for the JAR project:
    Image Added
    When satisfied that everything is correct, click OK.
  5. When the SVN commit has completed, the Eclipse - Project Explorer View should look similar to the following.
    Image Added

Creating the project jar component using the jar-template is now complete.

{anchor:Customizing the project JAR} h3. Section 2: Customizing the project JAR * {color:red}Please read the [*OVERVIEW* | #overview] before continuing.{color} # Run *Eclipse*.&nbsp;&nbsp;From the *Project Explorer View*, open the Maven JAR project that you want to customize. Your *Project Explorer View* should look similar to the following: !customizeJar002.jpg! # Expand your project, then expand *src/main/resources*. Your *Project Explorer View* should look similar to the following: !customizeJar004.jpg! # Open the *applicationContext-csf-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}
  1. Run Eclipse.  From the Project Explorer View, open the Maven JAR project that you want to customize.
    Your Project Explorer View should look similar to the following:
    Image Added
  2. Expand your project, then expand src/main/resources.
    Your Project Explorer View should look similar to the following:
    Image Added
  3. Open the applicationContext-csf-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.

Panel

 

Anchor
Customizing the project JAR
Customizing the project JAR

Section 2: Customizing the project JAR

Panel
Wiki Markup
Code Block
  1.     <import resource="classpath*:applicationContext-csf-projectName-component-scan.xml" />
        <import resource="classpath*:applicationContext-csf-projectName-config.xml" />
        <import resource="classpath*:applicationContext-csf-projectName-security-spring.xml" />
    
{code}
  1. When

  1. you

  1. have

  1. made

  1. all

  1. the

  1. changes,

  1. the

  1. lines

  1. you

  1. have

  1. changed

  1. should

  1. look

  1. similar

  1. to

  1. the

  1. following:

{
  1. Code Block
}
  1.     <import resource="classpath*:applicationContext-csf-att-component-scan.xml" />
        <import resource="classpath*:applicationContext-csf-att-config.xml" />
        <import resource="classpath*:applicationContext-csf-att-security-spring.xml" />
    
{code}
  1. In

  1. the

  1. above

  1. example,

*
  1. projectName

*
  1. was

  1. replaced

  1. with

  1. the

*
  1. short

  1. project

  1. acronym

* *
  1. att

*
  1. .


  1. When

  1. you

  1. are

  1. satisfied

  1. with

  1. the

  1. changes,

*
  1. save

*
  1. and

*
  1. close

*
  1. the

  1. file.

#
  1. From

  1. the

*
  1. Project

  1. Explorer

  1. View

*
  1. ,

  1. rename

  1. each

  1. of

  1. the

  1. following

  1. files,

  1. substituting

  1. your

*
  1. short

  1. project

  1. acronym

*
  1. for

*
  1. projectName

*
  1. .


  1. There

  1. are

  1. 4

  1. files

  1. that

  1. have

  1. to

  1. be

  1. renamed.

{
  1. Code Block
}
  1.     applicationContext-csf-projectName.xml
        applicationContext-csf-projectName-component-scan.xml
        applicationContext-csf-projectName-config.xml
        applicationContext-csf-projectName-security.xml
    
{code}
  1. When

  1. you

  1. have

  1. made

  1. all

  1. the

  1. changes,

  1. the

  1. file

  1. names

  1. that

  1. you

  1. have

  1. changed

  1. should

  1. look

  1. similar

  1. to

  1. the

  1. following:

{
  1. Code Block
}
  1.     applicationContext-csf-att.xml
        applicationContext-csf-att-component-scan.xml
        applicationContext-csf-att-config.xml
        applicationContext-csf-att-security.xml
    
{code}
  1. In

  1. the

  1. above

  1. example,

*
  1. projectName

*
  1. was

  1. replaced

  1. with

  1. the

*
  1. short

  1. project

  1. acronym

* *
  1. att

*
  1. .


  1. Your

*
  1. Project

  1. Explorer

  1. View

*
  1. should

  1. look

  1. similar

  1. to

  1. the

  1. following:

!customizeJar006.jpg! When you are satisfied with the changes, *save* and *close* the file. # From the *Project Explorer View*, expand *

  1. Image Added
    When you are satisfied with the changes, save and close the file.

  2. From the Project Explorer View, expand src/test/resources

*.&nbsp;&nbsp;Open the *
  1. .  Open the applicationContext-csf-unit-tests-default.xml

*
  1. for

  1. editing

  1. and

  1. change

  1. the

  1. following

  1. lines

  1. substituting

  1. your

*
  1. short

  1. project

  1. acronym

*
  1. for

*
  1. projectName

*
  1. .


  1. There

  1. are

  1. 2

  1. occurances

  1. of

*
  1. projectName

*
  1. that

  1. have

  1. to

  1. be

  1. changed.

{
  1. Code Block
}
  1.     <import resource="classpath*:applicationContext-csf-projectName.xml" />
        <import resource="classpath*:applicationContext-csf-projectName-config-test.xml" />
    
{code}
  1. When

  1. you

  1. have

  1. made

  1. all

  1. the

  1. changes,

  1. the

  1. lines

  1. you

  1. have

  1. changed

  1. should

  1. look

  1. similar

  1. to

  1. the

  1. following:

{
  1. Code Block
}
  1.     <import resource="classpath*:applicationContext-csf-att.xml" />
        <import resource="classpath*:applicationContext-csf-att-config-test.xml" />
    
{code}
  1. When

  1. you

  1. are

  1. satisfied

  1. with

  1. the

  1. changes,

*
  1. save

*
  1. and

*
  1. close

*
  1. the

  1. file.

#
  1. From

  1. the

*
  1. Project

  1. Explorer

  1. View

*
  1. ,

  1. expand

*
  1. src/test/resources

*.&nbsp;&nbsp;Open the *
  1. .  Open the applicationContext-csf-projectName-config-test.xml

*
  1. for

  1. editing

  1. and

  1. change

  1. the

  1. following

  1. lines

  1. substituting

  1. your

*
  1. short

  1. project

  1. acronym

*
  1. for

*
  1. projectName

*
  1. .


  1. There

  1. are

  1. 2

  1. occurances

  1. of

*
  1. projectName

*
  1. that

  1. have

  1. to

  1. be

  1. changed.

{
  1. Code Block
}
  1.     <value>classpath:csf-projectName-test.properties</value>
        <value>classpath:csf-projectName-test.properties</value>
    
{code}
  1. When

  1. you

  1. have

  1. made

  1. all

  1. the

  1. changes,

  1. the

  1. lines

  1. you

  1. have

  1. changed

  1. should

  1. look

  1. similar

  1. to

  1. the

  1. following:

{
  1. Code Block
}
  1.     <value>classpath:csf-att-test.properties</value>
        <value>classpath:csf-att-test.properties</value>
    
{code}
  1. When

  1. you

  1. are

  1. satisfied

  1. with

  1. the

  1. changes,

*
  1. save

*
  1. and

*
  1. close

*
  1. the

  1. file.

#
  1. From

  1. the

*
  1. Project

  1. Explorer

  1. View

*
  1. ,

  1. rename

  1. each

  1. of

  1. the

  1. following

  1. files,

  1. substituting

  1. your

*
  1. short

  1. project

  1. acronym

*
  1. for

*
  1. projectName

*
  1. .


  1. There

  1. are

  1. 2

  1. files

  1. that

  1. have

  1. to

  1. be

  1. renamed.

{
  1. Code Block
}
  1.     applicationContext-csf-projectName-config-test.xml
        csf-projectName-test.properties
    
{code}
  1. When

  1. you

  1. have

  1. made

  1. all

  1. the

  1. changes,

  1. the

  1. file

  1. names

  1. that

  1. you

  1. have

  1. changed

  1. should

  1. look

  1. similar

  1. to

  1. the

  1. following:

{
  1. Code Block
}
  1.     applicationContext-csf-att-config-test.xml
        csf-att-test.properties
    
{code} # *Commit* all changes to the SVN repository. h4. {color:green}Customizing the project JAR is now complete.{color}
  1. Commit all changes to the SVN repository.

Customizing the project JAR is now complete.

 

Panel

Anchor
Customizing the project JAR pom.xml
Customizing the project JAR pom.xml

Section 3: Customizing the project JAR pom.xml

  1. Run Eclipse.  From the Project Explorer View, open the Maven JAR 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 jar-template is updated and, as a result, the Configuration Instructions are 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.

    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.
  2. Commit the changes to the SVN repository.

Customizing the project JAR pom.xml is now complete.

...