Skip to content
Idafen Santana Pérez edited this page Jul 22, 2016 · 1 revision

Development guide.

This guide explain how to develop WebAR2DTool on eclipse.

Table of Contents

  1. Install Eclipse
  2. Import the project
  3. Configure WebAR2DTool
  4. Run developer server
  5. Important files

1) Install Eclipse.

The firts step is install eclipse.
Download from: http://www.eclipse.org/downloads/
Follow the next installation manual and install it: https://wiki.eclipse.org/Eclipse/Installation

2) Import the project.

Go to "File" -> "Import" in the open window select "Maven" and click on "Existing Maven Project", on next step choose the root directory (where the pom.xml of WebAR2DTool project is located) and click finish.
The project is imported.
Import_WebAR2DTool_Maven_Project

3) Configure WebAR2DTool

For configure WebAR2DTool follow the link:
Configure WebAR2DTool

4) Run developer server.

In this section will explain how to run the web application for developing it.
Navigate on project explorer "src" -> "main" -> "webapp" do right click on index.jsp and click on "Run as" -> "Run on Server".
Choose your web java server.
Recommended server (Download and extract it): Apache Tomcat 8
Run_on_server

Click on "Browse..." and go to the server folder, select it.
Select_the_server_folder

Add the project to "Configured" box and click finish.
Add_to_server_the_project

On Eclipse appear new tab with the URL for development, if you prefer you can put this URL on a browser. For configure the tomcat server (for choose port or other options) visit the next webpage:
http://tomcat.apache.org/tomcat-8.0-doc/config/index.html

5) Important files.

  1. index.jsp:
    Location: src/main/webapp/index.jsp
    This file contains the HTML of WebAR2DTool (Include configuration container).
  2. AR2DToolMethods class:
    Location: src/main/java Java package: es.upm.oeg.webAR2DTool.services.AR2DToolMethods
    This class contains the RESTFul services.
  3. AR2DToolManager class: Location: src/main/java Java package: es.upm.oeg.webAR2DTool.managers.AR2DToolManager
    This class contains the code that manage each session ID.
  4. WebAR2DToolThread class:
    Location: src/main/java Java package: es.upm.oeg.webAR2DTool.threads.WebAR2DToolThread
    The thread that executes AR2DTool for generate the images.