eu.slipo.athenarc.triplegeo.utils

Class Mapping

java.lang.Object

eu.slipo.athenarc.triplegeo.utils.Mapping

public class Mapping
extends java.lang.Object

Retains mappings of feature attributes (input) to RDF predicates (output) that will be used in generation of triples.

Version:

2.0

Author:

Kostas Patroumpas

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Mapping.MappingProfile Helper class containing enumeration of possible mapping profiles to be applied in triple generation.
class	Mapping.mapProperties Helper class containing properties of a particular mapping.

Field Summary

Fields

Modifier and Type	Field and Description
(package private) java.util.Map<java.lang.String,Mapping.mapProperties>	attrMappings Basic structure with mappings of feature attributes (key) to RDF predicates (values)
(package private) java.util.List<java.lang.String>	extraGeometricAttrs List that retains the names of the geometric attributes to be auto-generated.
(package private) java.util.List<java.lang.String>	extraThematicAttrs List that retains the names of the thematic attributes to be auto-generated.
(package private) java.util.List<java.lang.String>	multiFacetedAttrs Internal structure that keeps the names of all multi-faceted attributes (e.g., names in various languages)

Constructor Summary

Constructors

Constructor and Description
Mapping() Constructor of the Mapping class.

Method Summary

Modifier and Type	Method and Description
void	add(java.lang.String key, java.lang.String[] mappings) Create a new mapping for a specific attribute in the input dataset.
void	createFromFile(java.lang.String fileName) Creates a new mapping specification from a YML file.
Mapping.mapProperties	find(java.lang.String key) Retrieve the properties associated with a given attribute.
java.util.List<java.lang.String>	findExtraGeometricAttr(java.lang.String f) Identifies the name(s) of any auto-generated attribute(s) based on geometric properties (e.g., area, length, perimeter).
java.lang.String	findMultiFaceted(java.lang.String key) Identifies whether a multi-faceted attribute is included in the mapping specifications.
java.util.List<java.lang.String>	getExtraGeometricAttributes() Provides a list with the names of all geometric attributes that will be generated on-the-fly during transformation.
java.util.List<java.lang.String>	getExtraThematicAttributes() Provides a list with the names of all thematic attributes that will be generated on-the-fly during transformation.
java.util.Set<java.lang.String>	getKeys() Provides all attribute names listed in the user-specified mapping.
boolean	remove(java.lang.String key) Removes the mapping specification for a given attribute (used as key in the mapping).

Methods inherited from class java.lang.Object

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

Field Detail

attrMappings

java.util.Map<java.lang.String,Mapping.mapProperties> attrMappings

Basic structure with mappings of feature attributes (key) to RDF predicates (values)

multiFacetedAttrs

java.util.List<java.lang.String> multiFacetedAttrs

Internal structure that keeps the names of all multi-faceted attributes (e.g., names in various languages)

extraThematicAttrs

java.util.List<java.lang.String> extraThematicAttrs

List that retains the names of the thematic attributes to be auto-generated. These attributes MUST not appear in the original dataset to be transformed.

extraGeometricAttrs

java.util.List<java.lang.String> extraGeometricAttrs

List that retains the names of the geometric attributes to be auto-generated. These attributes MUST not appear in the original dataset to be transformed.

Constructor Detail

Mapping

public Mapping()

Constructor of the Mapping class.

Method Detail

add

public void add(java.lang.String key,
                java.lang.String[] mappings)

Create a new mapping for a specific attribute in the input dataset.

Parameters:

key - The name of the attribute in the input dataset.

mappings - The mapping properties as specified in a YML file for this attribute.

getKeys

public java.util.Set<java.lang.String> getKeys()

Provides all attribute names listed in the user-specified mapping.

Returns:

A set of attribute names.

createFromFile

public void createFromFile(java.lang.String fileName)

Creates a new mapping specification from a YML file. This file specifies mappings from attribute names of the input to RDF properties in the output triples.

Parameters:

fileName - Path to the YML file.

remove

public boolean remove(java.lang.String key)

Removes the mapping specification for a given attribute (used as key in the mapping).

Parameters:

key - The name of the attribute to be removed.

Returns:

True if attribute has been removed; otherwise, False.

find

public Mapping.mapProperties find(java.lang.String key)

Retrieve the properties associated with a given attribute.

Parameters:

key - the name of the attribute.

Returns:

The mapping specifications associated with this attribute.

findMultiFaceted

public java.lang.String findMultiFaceted(java.lang.String key)

Identifies whether a multi-faceted attribute is included in the mapping specifications.

Parameters:

key - The name of the attribute as used in the dataset.

Returns:

The name of its corresponding multi-faceted attribute in the mapping, i.e., without the suffix following the wild char '%' in the specification.

findExtraGeometricAttr

public java.util.List<java.lang.String> findExtraGeometricAttr(java.lang.String f)

Identifies the name(s) of any auto-generated attribute(s) based on geometric properties (e.g., area, length, perimeter).

Parameters:

f - The name of the built-in function that will be used to generate values for any such attribute.

Returns:

A list with the names of the auto-generated attribute(s).

getExtraThematicAttributes

public java.util.List<java.lang.String> getExtraThematicAttributes()

Provides a list with the names of all thematic attributes that will be generated on-the-fly during transformation.

Returns:

List of thematic attributes to be dynamically added to those originally defined in the dataset.

getExtraGeometricAttributes

public java.util.List<java.lang.String> getExtraGeometricAttributes()

Provides a list with the names of all geometric attributes that will be generated on-the-fly during transformation.

Returns:

List of geometric attributes to be dynamically added to those originally defined in the dataset.