Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Lyo/creating OSLC4J project"
< Lyo
m (cleanup and force the TOC) |
Jad.kth.se (Talk | contribs) |
||
| Line 1: | Line 1: | ||
| − | + | Make sure your environment is setup for OSLC4J development as instructed on [[Lyo/General_Setup_for_OSLC4J_Development | General Setup for OSLC4J development]] | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
= Sample Project = | = Sample Project = | ||
Revision as of 02:38, 26 April 2017
Make sure your environment is setup for OSLC4J development as instructed on General Setup for OSLC4J development
Sample Project
As a complement when following the instructions below, this sample OSLC4J project contains a basic but complete Eclipse project that can be used as a starting point and/or a reference.
The project is configured with the following values:
ProjectName: SampleAdaptor PackageName: your.basepackage.name
If you desire to change the project configuration, search and replace in the files below each of the above keywords with the specific values for your project
-
.project -
pom.xml -
adaptorModel/my.adaptorInterface -
src/main/webapp/WEB-INF/web.xml -
src/test/resources/launches/Launch SampleAdaptor.launch
If you get the error "Project configuration is not up-to-date with pom.xml", simply right click on the eclipse project and select Maven-->Update Project....
Setup an OSLC4J project
Note: This information is based on the tutorial from The MBAT Tutorial on Implementing OSLC Consumers and Providers with OSLC4J - By Stefan Paschke ViF.
The steps below guide you through the necessary steps of creating an Eclipse project with the necessary configurations to develop any OSLC4J adaptor.
In the instructions below, we assume an eclipse project named SampleAdaptor, where the java classes are managed under the base package named your.basepackage.name.
- Create a JAVA EE Web Application
- - File-->New-->Project...
- - Select Web/Dynamic Web Project
- - As project name, specify SampleAdaptor
- - On the final step of the wizard, check the Generate web.xml... option
- - Select Finish
- Convert project to Maven
- - Right click on the project, and select Configure --> Convert to Maven Project
- - In the window that appears, select war under Packaging
- Configure the project
- - Create a folder test at the root of the project
- - Create the sub-folders launches & resources under the new folder test
- - Copy the 3 configuration files from the Configuration File Templates into the corresponding folders:
- - /SampleAdaptor/pom.xml
- - /SampleAdaptor/src/main/webapp/WEB-INF/web.xml
- - /SampleAdaptor/src/main/webapp/WEB-INF/jetty.xml
- - If necessary, refresh your Eclipse workspace by right clicking on SampleAdaptor -> Refresh
- - If you choose a different name for your project and/or java package, search and replace these values in the project files as instructed under the Sample Project above.
- Activate Project Facet JAX-RS
- - Right click the project & Select properties
- - Select the Project Facets window
- - Select JAX-RS (REST Web Services)
- - Click OK to commit the changes.
- - Right click again on the project & Select properties
- - select the new JAX-RS sub-window under Project Facets
- - Set Type: to Disable Library Configuration
- - Enter JAX-RS servlet class name: org.apache.wink.server.internal.servlet.RestServlet
- - Under URL mapping patterns:
- - Remove the existing pattern
- - Add a new pattern /services/*
- Note: the above two steps (editing the JAX-RS servlet class name and the URL mapping patterns) are no longer available in the Eclipse Mars 4.5 Java EE dialog for the JAX-RS facet. The web.xml file can, of course, be manually edited to make the indicated changes.
- - Click OK to commit the changes.
- Further project configuration
- - right click the project & select Properties
- - select Deployment Assembly
- - Add...
- - In the new window that appears
- - select Java Build Path Entries
- - click Next >
- - select Maven Dependencies
- - click Finish
- - click Apply
- - click OK
- Create a new Run configuration
- - Select the menu Run-->Run Configurations...
- - Select Maven Build
- - Create a new Configuration (Right click on Maven Build -> New)
- - Enter a name for the new configuration (such as "Launch SampleAdaptor")
- - Set the Base directory to ${workspace_loc:/SampleAdaptor}
- - Set Goal as jetty:run-exploded
- - Switch to tab JRE
- - Set Runtime JRE to Workspace default JRE...
- - Switch to tab Source
- - Click Add...
- - In the new window, select Project and click OK
- - Check the SampleAdaptor project
- - Check the add required projects of selected projects option
- - Click OK
- - Switch to Tab Common
- - Select Shared file
- - Click Browse...
- - In the window that appears, select the recently created folder test/launches under the SampleAdaptor project
- - click OK
- - Click Apply
- - Clock Close