de.julielab.jcore.utility

Class JCoReFeaturePath

java.lang.Object

de.julielab.jcore.utility.JCoReFeaturePath

All Implemented Interfaces:

org.apache.uima.cas.FeaturePath

public class JCoReFeaturePath
extends Object
implements org.apache.uima.cas.FeaturePath

<<<<<<< HEAD A simple implementation of a feature path, originally adapted to the needs of the EntityEvaluatorConverter. It is currently not supposed to serve as a full UIMA FeaturePath replacement. However, it is thinkable that the implementation will be extended in the future by whomever requires a feature path more capable of what the original UIMA implementation can do. UIMA discloses the FeatureValuePath which seems to be able to handle arrays. However, it is marked deprecated and shouldn't be used any more. The new interface to use is the FeaturePath interface. Problem is, it seemingly can't handle arrays very well. The current implementation is quite preliminary. It can only be used via getValueAsString(FeatureStructure), i.e. even numeric types are returned as strings. The workflow is as follows: ======= A simple implementation of a feature path, originally adapted to the needs of the EntityEvaluatorConverter. It is currently not supposed to serve as a full UIMA FeaturePath replacement. However, it is thinkable that the implementation will be extended in the future by whomever requires a feature path more capable of what the original UIMA implementation can do. UIMA discloses the FeatureValuePath which seems to be able to handle arrays. However, it is marked deprecated and shouldn't be used any more. The new interface to use is the FeaturePath interface. Problem is, it seemingly can't handle arrays very well. The current implementation is quite preliminary. It can only be used via getValueAsString(FeatureStructure), i.e. even numeric types are returned as strings. The workflow is as follows: >>>>>>> 7ad7536ab9d5d42fc932c6811c7ffbe15d509c29

 JulesFeaturePath fp = new JulesFeaturePath();
 fp.initialize("/resourceEntryList[0]/entryId");
 String entryId = fp.getValueAsString(gene);
 

<<<<<<< HEAD This example retrieves the entry ID of the first ResourceEntry of a Gene annotation.

Feature paths can be any sequence of feature base names in the form /feature1/feature2/feature3. The last feature must be primitive-valued. If any of the features is an array, the index must be given, e.g. /feature1/feature2[2]/feature3. Otherwise, an array index out of bounds (-1) exception will be thrown. ======= This example retrieves the entry ID of the first ResourceEntry of a Gene annotation.

Feature paths can be any sequence of feature base names in the form /feature1/feature2/feature3. The last feature must be primitive-valued. If any of the features is an array, the index must be given, e.g. /feature1/feature2[2]/feature3. Otherwise, an array index out of bounds (-1) exception will be thrown. >>>>>>> 7ad7536ab9d5d42fc932c6811c7ffbe15d509c29

Author:

faessler

Constructor Summary

Constructors

Constructor and Description
JCoReFeaturePath()

Method Summary

Methods

Modifier and Type	Method and Description
void	addFeature(org.apache.uima.cas.Feature feat)
void	clearReplacementCache() Important only if using value replacements.
protected Object	getArrayElement(org.apache.uima.cas.CommonArrayFS sa, Map<?,?> replacements, Method getter, Method setter, int index)
Boolean	getBooleanValue(org.apache.uima.cas.FeatureStructure fs)
Byte	getByteValue(org.apache.uima.cas.FeatureStructure fs)
Object	getDefaultReplacementValue()
Double	getDoubleValue(org.apache.uima.cas.FeatureStructure fs)
org.apache.uima.cas.Feature	getFeature(int i)
String	getFeaturePath()
protected Object	getFeatureValueFromFeatureStructure(org.apache.uima.cas.FeatureStructure fs, org.apache.uima.cas.Feature feature, Map<?,?> replacements) Returns the value of the feature feature of the feature structure fs.
Float	getFloatValue(org.apache.uima.cas.FeatureStructure fs)
org.apache.uima.cas.FeatureStructure	getFSValue(org.apache.uima.cas.FeatureStructure fs)
Integer	getIntValue(org.apache.uima.cas.FeatureStructure fs)
Long	getLongValue(org.apache.uima.cas.FeatureStructure fs)
protected String	getObjectValueAsString(Object objectValue) Get a String representation for a single primitive value.
boolean	getReplaceUnmappedValues() Returns true if feature values not contained in the replacement map are to be replaced by a default value.
Short	getShortValue(org.apache.uima.cas.FeatureStructure fs)
String	getStringValue(org.apache.uima.cas.FeatureStructure fs)
org.apache.uima.cas.TypeClass	getTypClass(org.apache.uima.cas.FeatureStructure fs)
org.apache.uima.cas.Type	getType(org.apache.uima.cas.FeatureStructure fs)
Object	getValue(org.apache.uima.cas.FeatureStructure fs, int startFeatureIndex) Begins to traverse the feature path from position startFeatureIndex and returns whatever values lie at the end of the feature path.
String	getValueAsString(org.apache.uima.cas.FeatureStructure fs)
String	getValueAsString(org.apache.uima.cas.FeatureStructure fs, boolean doReplacements) If using replacements, please note the comment at clearReplacementCache().
String[]	getValueAsStringArray(org.apache.uima.cas.FeatureStructure fs) Returns the feature path values without performing value replacements.
String[]	getValueAsStringArray(org.apache.uima.cas.FeatureStructure fs, boolean doReplacements)
List<String>	getValueAsStringList(org.apache.uima.cas.FeatureStructure fs) Returns the feature path values without performing value replacements.
List<String>	getValueAsStringList(org.apache.uima.cas.FeatureStructure fs, boolean doReplacements)
void	initialize(String featurePath)
void	initialize(String featurePath, Map<?,?> replacements)
String	ll_getValueAsString(int fsRef, org.apache.uima.cas.impl.LowLevelCAS llCas)
void	loadReplacementsFromFile(String replacementsFile) Reads a replacement file with lines of the form originalValue=replacementValue and immediately populates the internal replacement table with those entries.
static Map<String,String>	readReplacementsFromFile(String replacementsFile) Reads a replacement file with lines of the form originalValue=replacementValue and returns the respective map.
static Map<String,String>	readReplacementsFromInputStream(InputStream is) Reads a replacement file with lines of the form originalValue=replacementValue and returns the respective map.
Object	replaceValue(org.apache.uima.cas.FeatureStructure fs) When using this method, please note the comment at clearReplacementCache().
void	setDefaultReplacementValue(Object defaultReplacementValue) Sets a default replacement value to be used when there is no replacement for a feature value and replaceUnmappedValues is set to true.
void	setReplaceUnmappedValues(boolean replaceWithNullValues) For the work with replacements, please note the comment of clearReplacementCache().
int	size()
void	typeInit(org.apache.uima.cas.Type featurePathType)

Methods inherited from class java.lang.Object

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

Constructor Detail

JCoReFeaturePath

public JCoReFeaturePath()

Method Detail

size

public int size()

Specified by:

size in interface org.apache.uima.cas.FeaturePath

getFeature

public org.apache.uima.cas.Feature getFeature(int i)

Specified by:

getFeature in interface org.apache.uima.cas.FeaturePath

addFeature

public void addFeature(org.apache.uima.cas.Feature feat)

Specified by:

addFeature in interface org.apache.uima.cas.FeaturePath

initialize

public void initialize(String featurePath)
                throws org.apache.uima.cas.CASException

Specified by:

initialize in interface org.apache.uima.cas.FeaturePath

Throws:

org.apache.uima.cas.CASException

initialize

public void initialize(String featurePath,
              Map<?,?> replacements)
                throws org.apache.uima.cas.CASException

Throws:

org.apache.uima.cas.CASException

typeInit

public void typeInit(org.apache.uima.cas.Type featurePathType)
              throws org.apache.uima.cas.CASException

Specified by:

typeInit in interface org.apache.uima.cas.FeaturePath

Throws:

org.apache.uima.cas.CASException

replaceValue

public Object replaceValue(org.apache.uima.cas.FeatureStructure fs)

When using this method, please note the comment at clearReplacementCache().

Parameters:

fs -

Returns:

getValue

public Object getValue(org.apache.uima.cas.FeatureStructure fs,
              int startFeatureIndex)

Begins to traverse the feature path from position startFeatureIndex and returns whatever values lie at the end of the feature path. This includes FeatureStructures, primitive values or even array-typed values.

Parameters:

fs -

startFeatureIndex -

Returns:

getArrayElement

protected Object getArrayElement(org.apache.uima.cas.CommonArrayFS sa,
                     Map<?,?> replacements,
                     Method getter,
                     Method setter,
                     int index)
                          throws IllegalAccessException,
                                 InvocationTargetException

Throws:

IllegalAccessException

InvocationTargetException

getFeatureValueFromFeatureStructure

protected Object getFeatureValueFromFeatureStructure(org.apache.uima.cas.FeatureStructure fs,
                                         org.apache.uima.cas.Feature feature,
                                         Map<?,?> replacements)

Returns the value of the feature feature of the feature structure fs.

Parameters:

fs -

feature -

replacements -

Returns:

getValueAsStringArray

public String[] getValueAsStringArray(org.apache.uima.cas.FeatureStructure fs,
                             boolean doReplacements)

getValueAsStringArray

public String[] getValueAsStringArray(org.apache.uima.cas.FeatureStructure fs)

Returns the feature path values without performing value replacements.

Parameters:

fs -

Returns:

getValueAsStringList

public List<String> getValueAsStringList(org.apache.uima.cas.FeatureStructure fs,
                                boolean doReplacements)

getValueAsStringList

public List<String> getValueAsStringList(org.apache.uima.cas.FeatureStructure fs)

Returns the feature path values without performing value replacements. The returned list is not held by this object and can be modified in the application without side effects.

Parameters:

fs -

Returns:

getObjectValueAsString

protected String getObjectValueAsString(Object objectValue)

Get a String representation for a single primitive value.

Parameters:

objectValue -

Returns:

getValueAsString

public String getValueAsString(org.apache.uima.cas.FeatureStructure fs)

Specified by:

getValueAsString in interface org.apache.uima.cas.FeaturePath

getValueAsString

public String getValueAsString(org.apache.uima.cas.FeatureStructure fs,
                      boolean doReplacements)

If using replacements, please note the comment at clearReplacementCache().

Parameters:

fs -

doReplacements -

Returns:

setReplaceUnmappedValues

public void setReplaceUnmappedValues(boolean replaceWithNullValues)

For the work with replacements, please note the comment of clearReplacementCache().

Parameters:

replaceWithNullValues -

getReplaceUnmappedValues

public boolean getReplaceUnmappedValues()

Returns true if feature values not contained in the replacement map are to be replaced by a default value.

Returns:

ll_getValueAsString

public String ll_getValueAsString(int fsRef,
                         org.apache.uima.cas.impl.LowLevelCAS llCas)

Specified by:

ll_getValueAsString in interface org.apache.uima.cas.FeaturePath

getType

public org.apache.uima.cas.Type getType(org.apache.uima.cas.FeatureStructure fs)

Specified by:

getType in interface org.apache.uima.cas.FeaturePath

getTypClass

public org.apache.uima.cas.TypeClass getTypClass(org.apache.uima.cas.FeatureStructure fs)

Specified by:

getTypClass in interface org.apache.uima.cas.FeaturePath

getFeaturePath

public String getFeaturePath()

Specified by:

getFeaturePath in interface org.apache.uima.cas.FeaturePath

getStringValue

public String getStringValue(org.apache.uima.cas.FeatureStructure fs)

Specified by:

getStringValue in interface org.apache.uima.cas.FeaturePath

getIntValue

public Integer getIntValue(org.apache.uima.cas.FeatureStructure fs)

Specified by:

getIntValue in interface org.apache.uima.cas.FeaturePath

getBooleanValue

public Boolean getBooleanValue(org.apache.uima.cas.FeatureStructure fs)

Specified by:

getBooleanValue in interface org.apache.uima.cas.FeaturePath

getByteValue

public Byte getByteValue(org.apache.uima.cas.FeatureStructure fs)

Specified by:

getByteValue in interface org.apache.uima.cas.FeaturePath

getDoubleValue

public Double getDoubleValue(org.apache.uima.cas.FeatureStructure fs)

Specified by:

getDoubleValue in interface org.apache.uima.cas.FeaturePath

getFloatValue

public Float getFloatValue(org.apache.uima.cas.FeatureStructure fs)

Specified by:

getFloatValue in interface org.apache.uima.cas.FeaturePath

getLongValue

public Long getLongValue(org.apache.uima.cas.FeatureStructure fs)

Specified by:

getLongValue in interface org.apache.uima.cas.FeaturePath

getShortValue

public Short getShortValue(org.apache.uima.cas.FeatureStructure fs)

Specified by:

getShortValue in interface org.apache.uima.cas.FeaturePath

getFSValue

public org.apache.uima.cas.FeatureStructure getFSValue(org.apache.uima.cas.FeatureStructure fs)

Specified by:

getFSValue in interface org.apache.uima.cas.FeaturePath

loadReplacementsFromFile

public void loadReplacementsFromFile(String replacementsFile)
                              throws FileNotFoundException,
                                     IOException

Reads a replacement file with lines of the form originalValue=replacementValue and immediately populates the internal replacement table with those entries.

Parameters:

replacementsFile -

Throws:

FileNotFoundException

IOException

readReplacementsFromFile

public static Map<String,String> readReplacementsFromFile(String replacementsFile)
                                                   throws FileNotFoundException,
                                                          IOException

Reads a replacement file with lines of the form originalValue=replacementValue and returns the respective map.

Parameters:

replacementsFile -

Returns:

Throws:

FileNotFoundException

IOException

readReplacementsFromInputStream

public static Map<String,String> readReplacementsFromInputStream(InputStream is)
                                                          throws FileNotFoundException,
                                                                 IOException

Reads a replacement file with lines of the form originalValue=replacementValue and returns the respective map.

Parameters:

replacementsFile -

Returns:

Throws:

FileNotFoundException

IOException

getDefaultReplacementValue

public Object getDefaultReplacementValue()

setDefaultReplacementValue

public void setDefaultReplacementValue(Object defaultReplacementValue)

Sets a default replacement value to be used when there is no replacement for a feature value and replaceUnmappedValues is set to true. Defaults to null.

Parameters:

defaultReplacementValue -

clearReplacementCache

public void clearReplacementCache()

Important only if using value replacements. Clears the cache of already replaced feature structures. This has to be reset after each CAS in order to avoid collisions between different annotations from different CASes, which may happen due to the fact that the hash codes may collide and that the internal annotation addresses within a case are only unique within a CAS. Thus, the next CAS could have an annotation that doesn't get its value replaced because this annotation allegedly was already replaced due to an identity collision.