EDIT

# CDM Library Development Resources

This page holds information and resources for developing the CDM Library. For a general introcution to the CDM Library and basic setup instructions please see: http://cybertaxonomy.eu/cdmlib

----

{{>toc}}

## Releases

* [[CdmPlatformReleaseSteps|How To do a Cdm Platform Release]]

* [[CdmReleasePolicy|CDM Release, Versioning & Branch Policy]]

## Maintenance

* [[CdmSearchIndexMaintenance]]

## CDM Internals

* [[CdmTransactions|Transactions in the CDM library]]

* [[CdmEntityInitalization]]

* [[CdmLibraryCaveats]]

* [[CdmClassificationRankSpecificRootnodes|Rank Specific Rootnodes of Classifications]]

* [[TermVocabularyHowTo|HowTo Create a Term Vocabulary]]

* [[TransmissionEngineDistribution]]

### Authentication, authorization, access control

* [[CdmAuthorisationAndAccessControl|Cdm authorisation and access control]] - security permissions etc

* [[HibernateSpringAndRowlevelSecurity]]

* Discussion and concepts

   * [[WorkshopRightsAndRoles2017-11|Rights&Roles Workshop 2017-11]]

### Searching

* [[CdmLibraryFreetextSearch]] 

### cdmlib-remote - RESTful services

* [[CdmServerReadWriteRest]]

* [REST API reference, Object Boundaries, Localization, Content Negotiation, Character Encoding](http://cybertaxonomy.eu/cdmlib/rest-api.html) 

* [[CdmEntityInitalization|Bean/Entity Initialization]]

* [[CdmRestServicesEntitySerialization|On the serialization of CDM entities in the cdmlib-remote RESTful services]]

* [[CdmRdfWebServices|On RDF responses for cdmlib-remote RESTful services]]

### cdmlib-remote-webapp

* [[cdmlib-remote-webappConfigurationAndBootstrapping|cdmlib-remote-webapp configuration and bootstrapping]]

## cdm-vaadin - CDM Vaadin UI

* [[VaadinNotes]] - design paterns, the cdm-vaadin project, vaadin run modes, managing sessions, ...

* [[VaadinEditorDevelopersGuide|Vaadin Developer Guide]] - workspace setup, launching, test urls

## Conventions & Policies

* [[CdmLibraryConventions]]

* [[EclipsePreferencesforTeams]]

 * --> [prefs_remote_workspace_preferences.epf](https://raw.githubusercontent.com/cybertaxonomy/code-templates/master/eclipse/4.x/prefs/prefs_remote_workspace_preferences.epf)

 * --> [CDM-Java-Code-Template.xml](https://raw.githubusercontent.com/cybertaxonomy/code-templates/master/eclipse/4.x/prefs/CDM-Java-Code-Template.xml)

## Tests (writing / running)

* [[IntegrationTests|IntegrationTests - Testing java code using Maven and Unitils]]

* [[IntegrationTestWriting|IntegrationTests - how to write tests and how to generate test data for them]]

## Debugging

* [[DebugC3P0Connections|How to debug leaking C3P0 connections]]

## Discussion 

* [[EditTeamMeetingTopics]] - Topics to be discussed in next meetings.

### historic

* [[CdmBrainstorm]] - problems & ideas for the future of the CDM

----

## External Resources / Links

### Hibernate

* Hibernate works with most current RDBMS. See  [supported databases](http://www.hibernate.org/80.html) 

* [On CascadeType.DELETE and CascadeType=DELETE_ORPHAN](http://www.mkyong.com/hibernate/hibernate-cascade-example-save-update-delete-and-delete-orphan/)

### Spring 2.0 Framework

We use the Spring 2.0 framework to develop the library and keep the coupling of components low.

*  [Spring2.0 Documentation](http://static.springframework.org/spring/docs/2.0.x/reference/index.html) 

*  [Introduction to the Spring Framework](http://www.theserverside.com/tt/articles/content/SpringFramework/article.html) 

*  [Die Rückkehr der POJOs. Das Spring-Framework: leichtgewichtiges Komponentenmodell als Alternative zu EJB](http://javamagazin.de/itr/online_artikel/psecom,id,608,nodeid,11.html) 

### Domain Models

* [Domain Models and Validation. An Architectural Discussion](http://forum.springframework.org/showthread.php?t=18699)

* [Avoiding anemic domain models with Hibernate](http://www.theserverside.com/patterns/thread.tss?thread_id=31010)

* [Business Object Pattern](http://www.corej2eepatterns.com/Patterns2ndEd/BusinessObject.htm)

* [AnemicDomainModel Anti Pattern](http://www.martinfowler.com/bliki/AnemicDomainModel.html) 

#### Property Change

* http://www.onjava.com/pub/a/onjava/2004/06/02/desktop.html

* http://www.javalobby.org/java/forums/t19476.html

### Useful Patterns

* [ApplicationService Pattern](http://www.corej2eepatterns.com/Patterns2ndEd/ApplicationService.htm)

### Aspect Oriented Programming

We use AspectJ to implement the change property crosscutting concern:

* AspectJ

  * http://today.java.net/pub/a/today/2005/12/15/writing-mixins-with-aop.html

* JBoss AOP

  * http://www.damnhandy.com/javabean-aspect/

* Spring AOP

  * http://forum.springframework.org/archive/index.php/t-13293.html

  * http://forum.springframework.com/viewtopic.php?t=301