EDIT

		----

		Developing with the CDM Library

		----

* Integrating the CDM Library into a maven project

	{{http://wp5.e-taxonomy.eu/cdmlib/mavenrepo/}}. To use the <cdmlib-service> package add the following 

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

---

<dependency>

	<groupId>eu.etaxonomy</groupId>

	<artifactId>cdmlib-service</artifactId>

	<version>x.x</version>

</dependency>

---

* Spring applications with the CDM Library

	In addition it also needs a datasource bean and a hibernateProperties bean specific for that datasource. 

	The CDM Library comes with an embedded hypersonic database that is super easy to use. All you need to do 

	is to import that hsql specific spring configuration like this:

---

applicationContext.xml

<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans"

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

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

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

	<import resource="classpath:/eu/etaxonomy/cdm/services.xml" />

	<import resource="classpath:/eu/etaxonomy/cdm/hsql-datasource.xml" />

</beans>

---

	For a typical mysql database it looks like this: 

---

applicationContext.xml

<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans"

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

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

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

	<import resource="classpath:/eu/etaxonomy/cdm/services.xml" />

    <bean id="dataSource" 

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

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

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

        <property name="username" value="cdm_user"/>

        <property name="password" value="why_do_i_need_this"/>

    </bean>

    <bean id="hibernateProperties" 

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

        <property name="properties">

            <props>

                <prop key="hibernate.hbm2ddl.auto">validate</prop>

                <prop key="hibernate.dialect">org.hibernate.dialect.MySQLDialect</prop>

                <prop key="hibernate.cache.provider_class">

					org.hibernate.cache.NoCacheProvider

				</prop>

                <prop key="hibernate.show_sql">false</prop>

                <prop key="hibernate.format_sql">false</prop>

            </props>

        </property>

    </bean>    

</beans>

---

** Preparing the CDM Library

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

---

$ svn co http://dev.e-taxonomy.eu/svn/trunk/cdmlib/ .

---

---

---

	Let maven create project dependencies and Eclipse metafiles (.project s.o.)

--- 

$ mvn eclipse:eclipse 

---

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

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

* Where do I go from here?

	on how to develop with it. A good start is to read the {{{./reference.html}reference documentation}} 

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

	with the structure of the Common Data Model itself or consult the {{{./apidocs}javadoc}} for the API documentation.

	Please also have a look at the {{{http://dev.e-taxonomy.eu/trac/wiki/GeneralDev} general information}} and 

	{{{http://dev.e-taxonomy.eu/trac/wiki/CdmLibraryDev} further information about coding with the CDM Library}} in the development wiki.