eu.ehri.project.importers.util

Class ImportHelpers

java.lang.Object

eu.ehri.project.importers.util.ImportHelpers

public class ImportHelpers
extends Object

Import utility class.

Field Summary

Fields

Modifier and Type	Field and Description
static String	LINK_TARGET
static String	OBJECT_IDENTIFIER
static String	UNKNOWN_PREFIX

Constructor Summary

Constructors

Constructor and Description
ImportHelpers()

Method Summary

Modifier and Type	Method and Description
static Map<String,Object>	extractAddress(Map<String,Object> itemData) Extract an address node representation from the itemData.
static List<Map<String,Object>>	extractDates(Map<String,Object> data) Extract a list of entity bundles for DatePeriods from the data, attempting to parse the unitdate attribute.
static Map<String,Object>	extractDescription(Map<String,Object> itemData, EntityClass entity) Extract a Map containing the properties of a generic description.
static Map<String,Object>	extractIdentifiers(Map<String,Object> itemData) Extract DocumentaryUnit properties from the itemData and return them as a new Map.
static List<Map<String,Object>>	extractSubNodes(String type, Map<String,Object> data)
static Map<String,Object>	extractUnknownProperties(Map<String,Object> itemData) Extract properties from the itemData Map that are marked as unknown, and return them in a new Map.
static Object	flattenNonMultivaluedProperties(String key, Object value, EntityClass entity) only properties that have the multivalued-status can actually be multivalued.
static Map<String,Object>	getSubNode(Map<String,Object> event) Extract the data from a sub-node.
static void	overwritePropertyInGraph(Map<String,Object> c, String property, String value)
static void	putPropertyInGraph(Map<String,Object> c, String property, String value) Stores this property value pair in the given graph node representation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LINK_TARGET

public static final String LINK_TARGET

See Also:

Constant Field Values

OBJECT_IDENTIFIER

public static final String OBJECT_IDENTIFIER

See Also:

Constant Field Values

UNKNOWN_PREFIX

public static final String UNKNOWN_PREFIX

See Also:

Constant Field Values

Constructor Detail

ImportHelpers

public ImportHelpers()

Method Detail

extractUnknownProperties

public static Map<String,Object> extractUnknownProperties(Map<String,Object> itemData)
                                                   throws ValidationError

Extract properties from the itemData Map that are marked as unknown, and return them in a new Map.

Parameters:

itemData - a Map containing raw properties of a unit

Returns:

returns a Map with all keys from itemData that start with SaxXmlHandler.UNKNOWN

Throws:

ValidationError - never

flattenNonMultivaluedProperties

public static Object flattenNonMultivaluedProperties(String key,
                                                     Object value,
                                                     EntityClass entity)

only properties that have the multivalued-status can actually be multivalued. all other properties will be flattened by this method.

Parameters:

key - a property key

value - a property value

entity - the EntityClass with which this frameMap must comply

extractIdentifiers

public static Map<String,Object> extractIdentifiers(Map<String,Object> itemData)
                                             throws ValidationError

Extract DocumentaryUnit properties from the itemData and return them as a new Map. This implementation only extracts the objectIdentifier.

This implementation does not throw ValidationErrors.

Parameters:

itemData - a Map containing raw properties of a DocumentaryUnit

Returns:

a new Map containing the objectIdentifier property

Throws:

ValidationError - never

extractDescription

public static Map<String,Object> extractDescription(Map<String,Object> itemData,
                                                    EntityClass entity)

Extract a Map containing the properties of a generic description. Excludes unknown properties, object identifier(s), maintenance events, relations, addresses and access point relations.

Parameters:

itemData - a Map containing raw properties of the description

entity - an EntityClass

Returns:

a Map representation of a generic Description

extractAddress

public static Map<String,Object> extractAddress(Map<String,Object> itemData)

Extract an address node representation from the itemData.

Parameters:

itemData - a Map containing raw properties of a unit

Returns:

returns a Map with all address/ keys (may be empty)

extractDates

public static List<Map<String,Object>> extractDates(Map<String,Object> data)

Extract a list of entity bundles for DatePeriods from the data, attempting to parse the unitdate attribute.

Parameters:

data - the data map. This is an out parameter from which keys associated with extracted dates will be removed

getSubNode

public static Map<String,Object> getSubNode(Map<String,Object> event)

Extract the data from a sub-node.

Parameters:

event - a Map of event properties

Returns:

a data map

overwritePropertyInGraph

public static void overwritePropertyInGraph(Map<String,Object> c,
                                            String property,
                                            String value)

putPropertyInGraph

public static void putPropertyInGraph(Map<String,Object> c,
                                      String property,
                                      String value)

Stores this property value pair in the given graph node representation. If the value is effectively empty, nothing happens. If the property already exists, it is added to the value list.

Parameters:

c - a Map representation of a graph node

property - the key to store the value for

value - the value to store

extractSubNodes

public static List<Map<String,Object>> extractSubNodes(String type,
                                                       Map<String,Object> data)