EDIT

Developing with the CDM Library

	<Table of Contents>

%{toc|section=0|fromDepth=2|toDepth=3}

  <<Note:>> The CDM Library uses Apache Maven for dependency management. If you are not familiar with that please take a look at the {{{https://dev.e-taxonomy.eu/redmine/projects/edit/wiki/GeneralDev#Maven}developer resources on the wiki}}. In case you run into problems, you might want to check {{{./troubleshooting.html}Troubleshooting}} or contact {{{mailto:editsupport@bgbm.org}editsupport@bgbm.org}} directly.

	To integrate the CDM Library into your personal maven project pelase add our maven repository to your POM:

	{{https://cybertaxonomy.eu/mavenrepo/}}. To use the <cdmlib-service> package add the following

	dependency to you POM (adapt the right version number !!):

	<artifactId>cdmlib-services</artifactId>

	<version>x.x</version>

	In your own applicationContext.xml you can simply import the cdm service spring beans from the library.

	is to import that hsql specific spring configuration like this:

    xsi:schemaLocation="http://www.springframework.org/schema/beans

		http://www.springframework.org/schema/beans/spring-beans-2.5.xsd">

</beans>

	In case you want to define the datasource within your own applicationContext you can surely do so.

    xsi:schemaLocation="http://www.springframework.org/schema/beans

		http://www.springframework.org/schema/beans/spring-beans-2.5.xsd">

    <bean id="dataSource"

			class="org.springframework.jdbc.datasource.DriverManagerDataSource">

        <property name="driverClassName" value="com.mysql.cj.jdbc.Driver"/>

        <property name="url" value="jdbc:mysql://192.168.2.10/cdm_build"/>

			class="org.springframework.beans.factory.config.PropertiesFactoryBean">

    </bean>

</beans>

* Developing the CDM Library with Eclipse

	To use the entire CDM Library with {{{http://www.eclipse.org/} Eclipse}}, you must meet the following prerequisites:

    * Maven 3 commandline tools. Follow the instruction to install maven on your local machine. See {{{https://dev.e-taxonomy.eu/redmine/projects/edit/wiki/GeneralDev#Maven}}} for installation instructions.

    * Git

    * Java JDK >= 1.8 (JRE is not enough) and JAVA_HOME is set to JDK path

	[]

** Preparing the CDM Library

	Start by checking out the source code from the git repository:

$ 	git clone https://dev.e-taxonomy.eu/git/cdmlib.git

---

	Change into the cdmlib directory, compile and install the cdmlib packages in your local repository. This will also download the dependencies into your local repository.

	You will need to configure the MAVEN_OPTS environment variable to configure JVM memory (-Xmx600M). The below example commands uses the 'export' command which is available in most default shells in Linux.

$ cd cdmlib

$ export MAVEN_OPTS=-Xmx600M

$ mvn install

---

---

$ mvn eclipse:eclipse

** Configuring Eclipse

	* Setup a new Eclipse workspace (where ever you want but using the cdmlib folder may be comfortable)

	* In Eclipse preferences (not project properties) set a java class variable called <<<M2_REPO>>>, pointing to your local repository.

		* Eclipse Preferences: Java -> Build Path -> Classpath

		* Click <<<New>>>. In the upcoming dialog, enter <<<M2_REPO>>> as the variables name and browse the filesystem for the location of the maven repository

			* In OSX for example    <<</Users/USERNAME/.m2/repository>>>

			* In WinXP for example  <<<C:\Documents and Settings\USERNAME\.m2\repository>>>

	* Import the cdmlib projects:

		* In Eclipse open the Import Wizard: File -> Import -> General -> Existing Projects into Workspace

		* Choose "Select root directory". Click "Browse" and navigate to your cdmlib folder and confirm the file dialog.

		* The projects should now show in the Import Wizard window. Select the projects you want wo work on (usually all) and hit OK.

* Getting started with the cdmlib based web services

	Now that you have integrated or installed the CDM Library you are probably looking for documentation

	of the CDM Library. The {{{./cdm-uml}UML diagrams}} are also a good starting point to get familiar

	Please also have a look at the {{{https://dev.e-taxonomy.eu/redmine/projects/edit/wiki/GeneralDev} general information}} and