Taxonomic Editor for Vaadin Developers Guide¶

This page contains all information related to developing the CDM Editor based on Vaadin.
See also the VaadinNotes

• Table of contents
• Taxonomic Editor for Vaadin Developers Guide
  • Getting started
    • Development Environment Setup
      • Requirements
      • Setup

Getting started¶

Development Environment Setup¶

Requirements¶

1. Eclipse IDE: This guide assumes that you are using the Eclipse IDE. For installing and setting up eclipse, please see EclipsePreferencesforTeams
2. Maven 3: Install maven either via your packagemanegment or download it from Maven
3. Install the Eclipse Jetty Integration plugin (current version 3.9.0). Using the outdated run-jetty-run plugin (http://run-jetty-run.googlecode.com) is not recommended. If you need to use the RunJettyRun plugin for some reasonm make sure you are using version 9.0.0+ which is available via the nightly update site - http://run-jetty-run.googlecode.com/svn/trunk/updatesite-nightly. The reason for the specific version of Jetty is due to the dependency on Servlet 3.0+ API which is used in the project.
4. Vaadin Plugin for Eclipse: For details on this plugin see section 2.4.2 from the Book of Vaadin. This plugin provides tools for compiling widgetsets, creating Vaadin specific objects and designing components using the included Vaadin Visual Designer.

Setup¶

Get the cdm-vaadin project source code with

git clone git@dev.e-taxonomy.eu/var/git/cdm-vaadin.git

and build the project with

mvn clean install

A. If you have the m2e eclipse plugin installed: Import the project via File->Import->Maven/Existing Maven Projects ...
B. Otherwise you need to run mvn eclipse:eclipse and import the project into Eclipse as File->Import->General/Existing Projects into Workspace ...

Now you need to create the configuration files for the data sources:

1. In {home}/.cdmlibrary folder create a file cdmlib-remote.properties (if not yet exists) with an entry to a datasource e.g. cdm.datasource=testDataSource
2. In the same folder copy/create a datasources.xml with the according datasource (testDataSource) in it:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
  xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-2.5.xsd">

   <bean id="testDataSource"  lazy-init="true" class="com.mchange.v2.c3p0.ComboPooledDataSource">
        <property name="driverClass" value="com.mysql.jdbc.Driver"/>
        <property name="user" value="user"/>
        <property name="password" value="password"/>
        <property name="jdbcUrl" value="jdbc:mysql://localhost/testDataSource?autoReconnect=true&amp;autoReconnectForPools=true&amp;"/>
    </bean>
</beans>

Import the cdm-vaadin jetty launch configuration in Eclipse by selecting File->Import->Launch Configurations and choosing the cdm-vaadin.launch file in the ide/eclipse directory.

1. Goto to run configurations in eclipse, search for cdm-vaadin (Jetty Webapp) run configuration. If you cannot find a launch configuration you have to create one:
   1. Right-click on Jetty-Webapp->New
   2. Project: Select the vaadin project
   3. WebApp folder: src/main/webapp
   4. HTTP/HTTPS port: 8080

2. Launch the jetty launcher

3. Goto to Browser and browse to

   • http://localhost:8080/app
   • http://localhost:8080/app/editstatus
   • http://localhost:8080/app/distribution
   • http://localhost:8080/app/concept