Jump to: navigation, search

Difference between revisions of "Lyo/BuildingOSLC4J"

< Lyo
(Clone the Lyo Core and RIO (optional, for Change Management sample) git repositories)
(Run the Change Management sample provider)
Line 65: Line 65:
 
=== Run the Change Management JUnit tests ===
 
=== Run the Change Management JUnit tests ===
 
* Expand the OSLC4JChangeManagementTest project down to the Java source
 
* Expand the OSLC4JChangeManagementTest project down to the Java source
 +
* Right click AllTests.java -> Run As -> JUnit test
 +
* Results will appear in the JUnit view
 +
 +
== Run the Quality Management sample provider ==
 +
'''Note:''' the sample UIs for the Quality Management sample provider have not yet been committed to Eclipse.  The delegated selection and creation dialogs will not work yet
 +
* From the Git Repository view, right click the <tt>git://git.eclipse.org/gitroot/lyo/org.eclipse.lyo.rio.git</tt> repository (browse it also [http://git.eclipse.org/c/lyo/org.eclipse.lyo.rio.git/ on line]) and import projects :
 +
** Select the OSLC4JQualityManagement, OSLC4JQualityManagementCommon and OSLC4JQualityManagementTest projects.  The other projects in the rio repository are unrelated to OSLC4J.  See [[Lyo/LyoRio|Lyo RIOs]] for information on these other reference implementations.
 +
* Build each CM project by right clicking its pom.xml and selecting Run As->Maven install.  Build them in this order:
 +
  * OSLC4JQualityManagementCommon
 +
  * OSLC4JQualityManagement
 +
  * OSLC4JQualityManagementTest
 +
* Run the application as above (on the Tomcat server on port 8081).
 +
* You can test by going to this URL in a browser:  http://localhost:8081/OSLC4JQualityManagement/testPlans.  You should see an OSLC Test Plan resource.
 +
=== Run the Quality Management JUnit tests ===
 +
* Expand the OSLC4JQualityManagementTest project down to the Java source
 
* Right click AllTests.java -> Run As -> JUnit test
 
* Right click AllTests.java -> Run As -> JUnit test
 
* Results will appear in the JUnit view
 
* Results will appear in the JUnit view

Revision as of 16:22, 25 June 2012

Building and Running Lyo OSLC4J applications in Eclipse

Prerequisites

  • Eclipse 3.6 or 3.7 IDE
  • EGit team provider for git (recommended) or git command line package.
  • m2eclipse for Maven support in the Eclipse IDE
  • OSLC4J requires a Java 1.6 compiler and Java 1.6 runtime. The Eclipse project settings have been set appropriately. If you are building outside of Eclipse, please use Java 1.6.

Create an Apache Tomcat runtime environment in Eclipse

  • Tomcat is the default runtime for OSLC4J samples. Configuration for other runtimes (Jetty, etc) is possible.
  • See the Eclipse documentation for instructions on creating a Tomcat server. Be sure to name the server Apache Tomcat v7.0.
  • Create 1 server on port 8080 for the OSLC4JRegistry catalog application
  • Create 1 server on port 8081 for any sample applications you want to run. In the future, the config will change so all apps can run on the same port.

Clone the Lyo Core and RIO (optional, for Change and Quality Management samples) git repositories

This example assumes EGit is being used

Lyo-core-git-repo.png

  • On the Branch Selection page, select the master branch
  • On the Local Destination page, specify a location or accept the default and click Finish

The repository should now show up in your Git Repositories view

Import OSLC4J Eclipse projects from the git repository

  • In the Git Repositories view, right click org.eclipse.lyo.core and select Import Projects
  • Select the Import Existing Projects wizard and click next
  • Select all components of RIO

Lyo-core-import-projects.png

Build all projects

  • Expand the OSLC4JCoreRelEng project
  • Right click pom.xml -> Run As -> Maven clean
  • Right click pom.xml -> Run As -> Maven install

Run the StockQuote sample application

  • By default, the sample applications require that the OSLC4JRegistry application be running on the Tomcat server running on port 8080 and the sample application running on the Tomcat server running on port 8081.
  • Go to the Server view (Window->Show View->Other and select Servers)
  • right click the server running on port 8080 and select Add and Remove
  • Add OSLC4JRegistry and start this server
  • Test that the server is running by going to this URL in a web browser: http://localhost:8080/OSLC4JRegistry/catalog. You should get an OSLC catalog document in response.
  • right click the server running on port 8081 and select Add and Remove
  • Add OSLC4JStockQuote and start this server
  • Test that the server is running by going to this URL in the web browser: http://localhost:8081/OSLC4JStockQuote/stockQuotes. You should get an OSLC response with some recent stock quotes (if you have internet connectivity).

Run the StockQuote JUnit tests

  • Expand the OSLC4JStockQuoteTest project down to the Java source
  • Right click AllTests.java -> Run As -> JUnit test
  • Results will appear in the JUnit view

Run the Change Management sample provider

Note: the sample UIs for the Change Management sample provider have not yet been committed to Eclipse. The delegated selection and creation dialogs will not work yet

  • From the Git Repository view, right click the git://git.eclipse.org/gitroot/lyo/org.eclipse.lyo.rio.git repository (browse it also on line) and import projects :
    • Select the OSLC4JChangeManagement, OSLC4JChangeManagementCommon and OSLC4JChangeManagementTest projects. The other projects in the rio repository are unrelated to OSLC4J. See Lyo RIOs for information on these other reference implementations.
  • Build each CM project by right clicking its pom.xml and selecting Run As->Maven install. Build them in this order:
  * OSLC4JChangeManagementCommon
  * OSLC4JChangeManagement
  * OSLC4JChangeManagementTest

Run the Change Management JUnit tests

  • Expand the OSLC4JChangeManagementTest project down to the Java source
  • Right click AllTests.java -> Run As -> JUnit test
  • Results will appear in the JUnit view

Run the Quality Management sample provider

Note: the sample UIs for the Quality Management sample provider have not yet been committed to Eclipse. The delegated selection and creation dialogs will not work yet

  • From the Git Repository view, right click the git://git.eclipse.org/gitroot/lyo/org.eclipse.lyo.rio.git repository (browse it also on line) and import projects :
    • Select the OSLC4JQualityManagement, OSLC4JQualityManagementCommon and OSLC4JQualityManagementTest projects. The other projects in the rio repository are unrelated to OSLC4J. See Lyo RIOs for information on these other reference implementations.
  • Build each CM project by right clicking its pom.xml and selecting Run As->Maven install. Build them in this order:
  * OSLC4JQualityManagementCommon
  * OSLC4JQualityManagement
  * OSLC4JQualityManagementTest

Run the Quality Management JUnit tests

  • Expand the OSLC4JQualityManagementTest project down to the Java source
  • Right click AllTests.java -> Run As -> JUnit test
  • Results will appear in the JUnit view