Europeana CoreLib

The CoreLib repository contains the libraries that provide the underlying functionality (i.e. search and ingestion) for both the Europeana Portal (deprecated) and API.

Build requirements

Runtime

• Java version "1.8.0_72", Oracle Java(TM) SE Runtime Environment (build 1.8.0_72-b15) or above

Tools

• Maven v3.3.x or above

Build

mvn clean install (add -DskipTests) to skip the unit tests during build

Known issues

Cannot resolve dependencies

Note: there are a number of older/outdated libraries still being referenced as dependencies, some of which may not be provided anymore by the central repositories. The Europeana artifactory has a copy of these dependencies; add this repository as a mirror (to the <mirrors> section of the maven settings file, usually found in ~/.m2/settings) to successfully build the code

Generate classes with JIBX

Java 8 / Maven: The combination of Java 8 and Maven has a known issue in that it does not generate the JIBX content. This manifests itself as follows:

[ERROR] Failed to execute goal org.jibx:maven-jibx-plugin:1.2.6:schema-codegen (generate-java-code-from-schema (EDM)) on project corelib-edm-definitions: Execution generate-java-code-from-schema (EDM) of goal org.jibx:maven-jibx-plugin:1.2.6:schema-codegen failed: Plugin org.jibx:maven-jibx-plugin:1.2.6 or one of its dependencies could not be resolved: Failure to find org.apache.bcel:bcel:jar:6.0-SNAPSHOT in https://oss.sonatype.org/content/repositories/snapshots was cached in the local repository, resolution will not be reattempted until the update interval of sonatype-nexus-snapshots has elapsed or updates are forced -> [Help 1]

The workaround is to add a mirror to your Maven settings.xml:

<mirror>
      <id>sonatype-mirror</id>
      <url>http://artifactory.eanadev.org/artifactory/ext-snapshot-local</url>
      <mirrorOf>sonatype-nexus-snapshots</mirrorOf>
</mirror>

Errors in Eclipse

New versions of Eclipse will show a number of errors that can be ignored:

• Various JPA / NamedQuery problems in several classes in corelib-db (for example 'The parameter value is missing from the input parameter.')
• XML schema problems in CONTEXTS.XSD, EDM-COMMON-MAIN.XSD, and FOAF.XSD

IntelliJ does not have this problem.

Create empty database

mvn hibernate4:export in corelib-db module to create a database schema script