Difference between revisions of "Lyo/BuildingOSLC4J"

From Eclipsepedia

< Lyo
Jump to: navigation, search
m (OSLC4J Sample Application runtimes)
m (Run the Change Management sample provider)
(One intermediate revision by one user not shown)
Line 49: Line 49:
 
* Expand the Maven Build section
 
* Expand the Maven Build section
 
* Select '''Launch OSLC4JStockQuote''' and click Run
 
* Select '''Launch OSLC4JStockQuote''' and click Run
* Test that the server is running by going to this URL in the web browser:  http://localhost:8080/OSLC4JStockQuote/stockQuotes.  You should get an OSLC response with some ChangeRequest resources.
+
* Test that the server is running by going to this URL in the web browser:  http://localhost:8080/OSLC4JStockQuote/stockQuotes.  You should get an OSLC response with some recent stock quotes (if you have internet connectivity).
 
** The OSLC Catalog entry for this application can be found at http://localhost:8080/OSLC4JRegistry/catalog/singleton
 
** The OSLC Catalog entry for this application can be found at http://localhost:8080/OSLC4JRegistry/catalog/singleton
  
Line 68: Line 68:
 
* Expand the Maven Build section
 
* Expand the Maven Build section
 
* Select '''Launch OSLC4JChangeManagement''' and click Run
 
* Select '''Launch OSLC4JChangeManagement''' and click Run
* Test that the server is running by going to this URL in the web browser:  http://localhost:8080/OSLC4JChangeManagement/changeRequests.  You should get an OSLC response with some recent stock quotes (if you have internet connectivity).   
+
* Test that the server is running by going to this URL in the web browser:  http://localhost:8080/OSLC4JChangeManagement/changeRequests.  You should get an OSLC response with some ChangeRequest resources.   
 
** The OSLC Catalog entry for this application can be found at http://localhost:8080/OSLC4JRegistry/catalog/singleton
 
** The OSLC Catalog entry for this application can be found at http://localhost:8080/OSLC4JRegistry/catalog/singleton
  

Revision as of 15:22, 19 October 2012

Contents

Building and Running Lyo OSLC4J applications in Eclipse

Prerequisites

  • Eclipse 3.6 or higher 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.

OSLC4J Sample Application runtimes

The OSLC4J sample applications now use a Jetty app server as the default runtime. The samples will also work in an Eclipse IDE using a Tomcat runtime. See the Eclipse documentation for instructions on creating a Tomcat server.

Options for running the OSLC4J Samples

You can develop and run OSLC4J samples one of 2 ways

  • Build OSLC4J and samples from source
  • Download the OSLC4J package with its dependencies here and add the jars to the classpath of your project

The remainder of this document explains the process for building from source.

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 OSLC4J core. The org.eclipse.lyo.core.query project is optional and not part of the core of OSLC4J at this point.

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

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


The OSLC4JRegistry web application

The OSLC4J StockQuote, Test, ChangeManagement and QualityManagement all use the OSLC4JRegistry web application as an OSLC Catalog. When each application starts, it registers its OSLC service provider details with OSLC4JRegistry.

The sample applications are currently configured to automatically launch the OSLC4JRegistry in the same application server as the sample application and register with this local OSLC4JRegistry instance. If you wish to change this behavior and have the applications register with a remote OSLC4JRegistry, two changes are required.

  • Edit the pom.xml for the sample application and remove the following lines:
<!-- Also start OSLC4JRegistry webApp -->
<contextHandlers>
   <contextHandler implementation="org.eclipse.jetty.webapp.WebAppContext">
      <war>${basedir}/../../org.eclipse.lyo.core/OSLC4JRegistry/target/oslc4j-registry-0.1.1-SNAPSHOT.war</war>
      <contextPath>/OSLC4JRegistry</contextPath>
      </contextHandler>
</contextHandlers>
  • Add the following system property to the JVM arguments for the application launch:
    • -Dorg.eclipse.lyo.oslc4j.client.registryuri=http://<hostname>:<port>/OSLC4JRegistry/catalog/singleton (assuming a context of OSLC4JRegistry)

The system property can also be set by modifying the application code to set it directly, load it from a properties file, etc.