Interface JCas
-
- All Superinterfaces:
AbstractCas
- All Known Implementing Classes:
JCasImpl
public interface JCas extends AbstractCas
Java Cover Classes based Object-oriented CAS (Common Analysis System) API.A
JCas
object provides the starting point for working with the CAS using Java Cover Classes for each type, generated by the utility JCasGen.This interface extends the CAS Interface, providing all the same functionality, plus some specific to the JCas.
It supports the creation of new instances of CAS types, using the normal Java "new" operator.
You can create a
JCas
object from a CAS object by calling the getJCas() method on the CAS object.
-
-
Field Summary
Fields Modifier and Type Field Description static int
INVALID_FEATURE_CODE
(internal use)
-
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description void
addFsToIndexes(FeatureStructure fs)
Add a feature structure to all appropriate indexes in the repository associated with this CAS View.void
checkArrayBounds(int fsRef, int pos)
FeaturePath
createFeaturePath()
Create a feature path.FeatureValuePath
createFeatureValuePath(java.lang.String featureValuePath)
Create a feature-value path from a string.<T extends FeatureStructure>
FSIterator<T>createFilteredIterator(FSIterator<T> it, FSMatchConstraint cons)
Create an iterator over structures satisfying a given constraint.SofaFS
createSofa(SofaID sofaID, java.lang.String mimeType)
Deprecated.As of v2.0, usecreateView(String)
instead.JCas
createView(java.lang.String sofaID)
Create a view and its underlying Sofa (subject of analysis).<T extends FeatureStructure>
java.util.ListIterator<T>fs2listIterator(FSIterator<T> it)
Wrap a standard JavaListIterator
around an FSListIterator.<T extends TOP>
FSIterator<T>getAllIndexedFS(java.lang.Class<T> clazz)
Gets an iterator over all indexed FeatureStructures of the specified Type (and any of its subtypes).AnnotationIndex<Annotation>
getAnnotationIndex()
Get the standard annotation index.<T extends Annotation>
AnnotationIndex<T>getAnnotationIndex(int type)
Get the standard annotation index restricted to a specific annotation type.<T extends Annotation>
AnnotationIndex<T>getAnnotationIndex(java.lang.Class<T> clazz)
Get the standard annotation index restricted to a specific annotation type.<T extends Annotation>
AnnotationIndex<T>getAnnotationIndex(Type type)
Get the standard annotation index restricted to a specific annotation type.CAS
getCas()
CASImpl
getCasImpl()
Type
getCasType(int i)
Given Foo.type, return the corresponding CAS Type object.ConstraintFactory
getConstraintFactory()
Get a constraint factory.TOP
getDocumentAnnotationFs()
Gets the document annotation.java.lang.String
getDocumentLanguage()
Gets the language code for this document from the language feature of the special instance of the DocumentationAnnotation associated with this CAS.java.lang.String
getDocumentText()
Get the document text.FSArray
getFSArray0L()
A constant for each cas which holds a 0-length instance.FSIndexRepository
getFSIndexRepository()
<T extends TOP>
FSIndex<T>getIndex(java.lang.String label, java.lang.Class<T> clazz)
Retrieve an index according to a label and a type specified using a JCas class.FSIndexRepository
getIndexRepository()
Get the index repository.IntegerArray
getIntegerArray0L()
A constant for each cas which holds a 0-length instance.JCas
getJCas(Sofa sofa)
Create a JCas view for a Sofa.<T extends TOP>
TgetJfsFromCaddr(int casAddr)
JFSIndexRepository
getJFSIndexRepository()
Gets the JCas-based interface to the Index Repository.LowLevelCAS
getLowLevelCas()
LowLevelIndexRepository
getLowLevelIndexRepository()
Feature
getRequiredFeature(Type t, java.lang.String s)
Feature
getRequiredFeatureDE(Type t, java.lang.String s, java.lang.String rangeName, boolean featOkTst)
Type
getRequiredType(java.lang.String s)
Sofa
getSofa()
Get the Sofa feature structure associated with this JCas view.Sofa
getSofa(SofaID sofaID)
Deprecated.As of v2.0, use {#getView(String)}.FeatureStructure
getSofaDataArray()
Get the Sofa data array.java.io.InputStream
getSofaDataStream()
Get the Sofa data as a byte stream.java.lang.String
getSofaDataString()
Get the Sofa Data String (a.k.a.java.lang.String
getSofaDataURI()
Get the Sofa data array.FSIterator<SofaFS>
getSofaIterator()
Get iterator for all SofaFS in the CAS.java.lang.String
getSofaMimeType()
Get the mime type of the Sofa data being analyzed.StringArray
getStringArray0L()
A constant for each cas which holds a 0-length instance.TOP_Type
getType(int i)
get the JCas _Type instance for a particular CAS type constantTOP_Type
getType(TOP instance)
Deprecated.use instance.jcasType instead - fasterTypeSystem
getTypeSystem()
Return the type system of this CAS instance.JCas
getView(java.lang.String localViewName)
Get the view for a Sofa (subject of analysis).JCas
getView(SofaFS aSofa)
Get the view for a Sofa (subject of analysis).java.util.Iterator<JCas>
getViewIterator()
Get iterator over all views in this JCas.java.util.Iterator<JCas>
getViewIterator(java.lang.String localViewNamePrefix)
Get iterator over all views with the given name prefix.java.lang.String
getViewName()
Get the view name.void
processInit()
Deprecated.not required, does nothingjava.lang.AutoCloseable
protectIndexes()
Call this method to set up a region, ended by a close() call on the returned object, You can use this or theprotectIndexes(Runnable)
method to protected the indexes.void
protectIndexes(java.lang.Runnable runnable)
Runs the code in the runnable inside a protection block, where any modifications to features done while in this block will be done in a way to protect any indexes which otherwise might become corrupted by the update action; the protection is achieved by temporarily removing the FS (if it is in the indexes), before the update happens.void
putJfsFromCaddr(int casAddr, FeatureStructure fs)
void
removeAllExcludingSubtypes(int i)
Remove all feature structures of a given type (excluding subtypes) from all indexes in the repository associated with this CAS View.void
removeAllIncludingSubtypes(int i)
Remove all feature structures of a given type (including subtypes) from all indexes in the repository associated with this CAS View.void
removeFsFromIndexes(FeatureStructure fs)
Remove a feature structure from all indexes in the repository associated with this CAS View.void
reset()
Reset the CAS, emptying it of all content.void
setDocumentLanguage(java.lang.String languageCode)
Sets the language for this document.void
setDocumentText(java.lang.String text)
Set the document text.void
setSofaDataArray(FeatureStructure array, java.lang.String mime)
Set the Sofa data as an ArrayFS.void
setSofaDataString(java.lang.String text, java.lang.String mimetype)
Set the document text.void
setSofaDataURI(java.lang.String uri, java.lang.String mime)
Set the Sofa data as a URI.int
size()
Estimate the memory consumption of this CAS instance (in bytes).void
throwFeatMissing(java.lang.String feat, java.lang.String type)
-
Methods inherited from interface org.apache.uima.cas.AbstractCas
release
-
-
-
-
Field Detail
-
INVALID_FEATURE_CODE
static final int INVALID_FEATURE_CODE
(internal use)- See Also:
- Constant Field Values
-
-
Method Detail
-
getFSIndexRepository
FSIndexRepository getFSIndexRepository()
- Returns:
- the FSIndexRepository object for this Cas
-
getLowLevelIndexRepository
LowLevelIndexRepository getLowLevelIndexRepository()
-
getCas
CAS getCas()
- Returns:
- the CAS object for this JCas instantiation
-
getCasImpl
CASImpl getCasImpl()
-
getLowLevelCas
LowLevelCAS getLowLevelCas()
-
getType
TOP_Type getType(int i)
get the JCas _Type instance for a particular CAS type constant- Parameters:
i
- the CAS type constant, written as Foo.type- Returns:
- the instance of the JCas xxx_Type object for the specified type
-
getCasType
Type getCasType(int i)
Given Foo.type, return the corresponding CAS Type object. This is useful in the methods which require a CAS Type, for instance iterator creation.- Parameters:
i
- - index returned by Foo.type- Returns:
- the CAS Java Type object for this CAS Type.
-
getType
@Deprecated TOP_Type getType(TOP instance)
Deprecated.use instance.jcasType instead - fasterget the JCas x_Type instance for a particular Java instance of a type- Parameters:
instance
- instance- Returns:
- the associated xxx_Type instance
-
getRequiredType
Type getRequiredType(java.lang.String s) throws CASException
- Throws:
CASException
-
getRequiredFeature
Feature getRequiredFeature(Type t, java.lang.String s) throws CASException
- Throws:
CASException
-
getRequiredFeatureDE
Feature getRequiredFeatureDE(Type t, java.lang.String s, java.lang.String rangeName, boolean featOkTst)
-
putJfsFromCaddr
void putJfsFromCaddr(int casAddr, FeatureStructure fs)
-
getJfsFromCaddr
<T extends TOP> T getJfsFromCaddr(int casAddr)
-
checkArrayBounds
void checkArrayBounds(int fsRef, int pos)
-
throwFeatMissing
void throwFeatMissing(java.lang.String feat, java.lang.String type)
-
getSofa
@Deprecated Sofa getSofa(SofaID sofaID)
Deprecated.As of v2.0, use {#getView(String)}. From the view you can access the Sofa data, or callgetSofa()
if you truly need to access the SofaFS object.- Parameters:
sofaID
- -- Returns:
- the Sofa
-
getSofa
Sofa getSofa()
Get the Sofa feature structure associated with this JCas view.- Returns:
- The SofaFS associated with this JCas view.
-
createView
JCas createView(java.lang.String sofaID) throws CASException
Create a view and its underlying Sofa (subject of analysis). The view provides access to the Sofa data and the index repository that contains metadata (annotations and other feature structures) pertaining to that Sofa.This method creates the underlying Sofa feature structure, but does not set the Sofa data. Setting ths Sofa data must be done by calling
setSofaDataArray(FeatureStructure, String)
,setSofaDataString(String, String)
orsetSofaDataURI(String, String)
on the JCas view returned by this method.- Parameters:
sofaID
- the local view name, before any sofa name mapping is done, for this view (note: this is the same as the associated Sofa name).- Returns:
- The view corresponding to this local name.
- Throws:
CASException
- - if a View with this name already exists in this CAS
-
getJCas
JCas getJCas(Sofa sofa) throws CASException
Create a JCas view for a Sofa.- Parameters:
sofa
- a Sofa feature structure in this CAS.- Returns:
- The JCas view for the given Sofa.
- Throws:
CASException
- -
-
getJFSIndexRepository
JFSIndexRepository getJFSIndexRepository()
Gets the JCas-based interface to the Index Repository. Provides the same functionality asgetFSIndexRepository()
except that the methods that take a "type" argument take type arguments obtainable easily from the JCas type.- Returns:
- the JCas-based interface to the index repository
-
getDocumentAnnotationFs
TOP getDocumentAnnotationFs()
Gets the document annotation. The object returned from this method can be typecast to org.apache.uima.jcas.tcas.DocumentAnnotationThe reason that the return type of this method is not DocumentAnnotation is because of problems that arise when using the UIMA Extension ClassLoader to load annotator classes. The DocumentAnnotation type may be defined in the UIMA extension ClassLoader, differently than in the framework ClassLoader.
- Returns:
- The one instance of the DocumentAnnotation annotation.
- See Also:
CAS.getDocumentAnnotation()
-
getStringArray0L
StringArray getStringArray0L()
A constant for each cas which holds a 0-length instance. Since this can be a common value, we avoid creating multiple copies of it. All uses can use the same valuee because it is not updatable (it has no subfields). This is initialized lazily on first reference, and reset when the CAS is reset.- Returns:
- 0-length instance of a StringArray
-
getIntegerArray0L
IntegerArray getIntegerArray0L()
A constant for each cas which holds a 0-length instance. Since this can be a common value, we avoid creating multiple copies of it. All uses can use the same valuee because it is not updatable (it has no subfields). This is initialized lazily on first reference, and reset when the CAS is reset.- Returns:
- 0-length instance of an IntegerArray
-
getFSArray0L
FSArray getFSArray0L()
A constant for each cas which holds a 0-length instance. Since this can be a common value, we avoid creating multiple copies of it. All uses can use the same valuee because it is not updatable (it has no subfields). This is initialized lazily on first reference, and reset when the CAS is reset.- Returns:
- 0-length instance of a FloatArray public abstract FloatArray getFloatArray0L(); /** A constant for each cas which holds a 0-length instance. Since this can be a common value, we avoid creating multiple copies of it. All uses can use the same valuee because it is not updatable (it has no subfields). This is initialized lazily on first reference, and reset when the CAS is reset.
-
processInit
@Deprecated void processInit()
Deprecated.not required, does nothinginitialize the JCas for new Cas content. Not used, does nothing.
-
getView
JCas getView(java.lang.String localViewName) throws CASException
Get the view for a Sofa (subject of analysis). The view provides access to the Sofa data and the index repository that contains metadata (annotations and other feature structures) pertaining to that Sofa.- Parameters:
localViewName
- the local name, before any sofa name mapping is done, for this view (note: this is the same as the associated Sofa name).- Returns:
- The view corresponding to this local name.
- Throws:
CASException
- passthru
-
getView
JCas getView(SofaFS aSofa) throws CASException
Get the view for a Sofa (subject of analysis). The view provides access to the Sofa data and the index repository that contains metadata (annotations and other feature structures) pertaining to that Sofa.- Parameters:
aSofa
- a Sofa feature structure in the CAS- Returns:
- The view for the given Sofa
- Throws:
CASException
- passthru
-
getTypeSystem
TypeSystem getTypeSystem() throws CASRuntimeException
Return the type system of this CAS instance.- Returns:
- The type system, or
null
if none is available. - Throws:
CASRuntimeException
- If the type system has not been committed.
-
createSofa
@Deprecated SofaFS createSofa(SofaID sofaID, java.lang.String mimeType)
Deprecated.As of v2.0, usecreateView(String)
instead.Create a Subject of Analysis. The new sofaFS is automatically added to the SofaIndex.- Parameters:
sofaID
- the SofA IDmimeType
- the mime type- Returns:
- The sofaFS.
-
getSofaIterator
FSIterator<SofaFS> getSofaIterator()
Get iterator for all SofaFS in the CAS.- Returns:
- an iterator over SofaFS.
-
createFilteredIterator
<T extends FeatureStructure> FSIterator<T> createFilteredIterator(FSIterator<T> it, FSMatchConstraint cons)
Create an iterator over structures satisfying a given constraint. Constraints are described in the javadocs forConstraintFactory
and related classes.- Type Parameters:
T
- the particular FeatureStructure type- Parameters:
it
- The input iterator.cons
- The constraint specifying what structures should be returned.- Returns:
- An iterator over FSs.
-
getConstraintFactory
ConstraintFactory getConstraintFactory()
Get a constraint factory. A constraint factory is a simple way of creatingFSMatchConstraints
.- Returns:
- A constraint factory to create new FS constraints.
-
createFeaturePath
FeaturePath createFeaturePath()
Create a feature path. This is mainly useful for creatingFSMatchConstraints
.- Returns:
- A new, empty feature path.
-
getIndexRepository
FSIndexRepository getIndexRepository()
Get the index repository.- Returns:
- The index repository, or
null
if none is available.
-
fs2listIterator
<T extends FeatureStructure> java.util.ListIterator<T> fs2listIterator(FSIterator<T> it)
Wrap a standard JavaListIterator
around an FSListIterator. Use if you feel more comfortable with java style iterators.- Type Parameters:
T
- The particular Feature Structure type- Parameters:
it
- TheFSListIterator
to be wrapped.- Returns:
- An equivalent
ListIterator
.
-
reset
void reset() throws CASAdminException
Reset the CAS, emptying it of all content. Feature structures and iterators will no longer be valid. Note: this method may only be called from an application. Calling it from an annotator will trigger a runtime exception.- Throws:
CASRuntimeException
- When called out of sequence.CASAdminException
- See Also:
CASMgr
-
getViewName
java.lang.String getViewName()
Get the view name. The view name is the same as the name of the view's Sofa, retrieved by getSofa().getSofaID(), except for the initial View before its Sofa has been created.- Returns:
- The name of the view
-
size
int size()
Estimate the memory consumption of this CAS instance (in bytes).- Returns:
- The estimated memory used by this CAS instance.
-
createFeatureValuePath
FeatureValuePath createFeatureValuePath(java.lang.String featureValuePath) throws CASRuntimeException
Create a feature-value path from a string.- Parameters:
featureValuePath
- String representation of the feature-value path.- Returns:
- Feature-value path object.
- Throws:
CASRuntimeException
- If the input string is not well-formed.
-
setDocumentText
void setDocumentText(java.lang.String text) throws CASRuntimeException
Set the document text. Once set, Sofa data is immutable, and cannot be set again until the CAS has been reset.- Parameters:
text
- The text to be analyzed.- Throws:
CASRuntimeException
- If the Sofa data has already been set.
-
setSofaDataString
void setSofaDataString(java.lang.String text, java.lang.String mimetype) throws CASRuntimeException
Set the document text. Once set, Sofa data is immutable, and cannot be set again until the CAS has been reset.- Parameters:
text
- The text to be analyzed.mimetype
- The mime type of the data- Throws:
CASRuntimeException
- If the Sofa data has already been set.
-
getDocumentText
java.lang.String getDocumentText()
Get the document text.- Returns:
- The text being analyzed.
-
getSofaDataString
java.lang.String getSofaDataString()
Get the Sofa Data String (a.k.a. the document text).- Returns:
- The Sofa data string.
-
setDocumentLanguage
void setDocumentLanguage(java.lang.String languageCode) throws CASRuntimeException
Sets the language for this document. This value sets the language feature of the special instance of DocumentAnnotation associated with this CAS.- Parameters:
languageCode
- the language code- Throws:
CASRuntimeException
- passthru
-
getDocumentLanguage
java.lang.String getDocumentLanguage()
Gets the language code for this document from the language feature of the special instance of the DocumentationAnnotation associated with this CAS.- Returns:
- language identifier
-
setSofaDataArray
void setSofaDataArray(FeatureStructure array, java.lang.String mime) throws CASRuntimeException
Set the Sofa data as an ArrayFS. Once set, Sofa data is immutable, and cannot be set again until the CAS has been reset.- Parameters:
array
- The ArrayFS to be analyzed.mime
- The mime type of the data- Throws:
CASRuntimeException
- If the Sofa data has already been set.
-
getSofaDataArray
FeatureStructure getSofaDataArray()
Get the Sofa data array.- Returns:
- The Sofa Data being analyzed.
-
setSofaDataURI
void setSofaDataURI(java.lang.String uri, java.lang.String mime) throws CASRuntimeException
Set the Sofa data as a URI. Once set, Sofa data is immutable, and cannot be set again until the CAS has been reset.- Parameters:
uri
- The URI of the data to be analyzed.mime
- The mime type of the data- Throws:
CASRuntimeException
- If the Sofa data has already been set.
-
getSofaDataURI
java.lang.String getSofaDataURI()
Get the Sofa data array.- Returns:
- The Sofa Data being analyzed.
-
getSofaDataStream
java.io.InputStream getSofaDataStream()
Get the Sofa data as a byte stream.- Returns:
- A stream handle to the Sofa Data.
-
getSofaMimeType
java.lang.String getSofaMimeType()
Get the mime type of the Sofa data being analyzed.- Returns:
- the mime type of the Sofa
-
addFsToIndexes
void addFsToIndexes(FeatureStructure fs)
Add a feature structure to all appropriate indexes in the repository associated with this CAS View.Important: after you have called
addFsToIndexes(...)
on a FS, do not change the values of any features used for indexing. If you do, the index will become corrupted and may be unusable. If you need to change an index feature value, first callremoveFsFromIndexes(...)
on the FS, change the feature values, then calladdFsToIndexes(...)
again.- Parameters:
fs
- The Feature Structure to be added.- Throws:
java.lang.NullPointerException
- If thefs
parameter isnull
.
-
removeFsFromIndexes
void removeFsFromIndexes(FeatureStructure fs)
Remove a feature structure from all indexes in the repository associated with this CAS View.- Parameters:
fs
- The Feature Structure to be removed.- Throws:
java.lang.NullPointerException
- If thefs
parameter isnull
.
-
removeAllIncludingSubtypes
void removeAllIncludingSubtypes(int i)
Remove all feature structures of a given type (including subtypes) from all indexes in the repository associated with this CAS View.- Parameters:
i
- the CAS type constant, written as Foo.type (for a given JCas Type) or anInstanceOfFoo.getTypeIndexID(), for an instance
-
removeAllExcludingSubtypes
void removeAllExcludingSubtypes(int i)
Remove all feature structures of a given type (excluding subtypes) from all indexes in the repository associated with this CAS View.- Parameters:
i
- the CAS type constant, written as Foo.type (for a given JCas Type) or anInstanceOfFoo.getTypeIndexID(), for an instance
-
getAnnotationIndex
AnnotationIndex<Annotation> getAnnotationIndex()
Get the standard annotation index.- Returns:
- The standard annotation index.
-
getAnnotationIndex
<T extends Annotation> AnnotationIndex<T> getAnnotationIndex(Type type) throws CASRuntimeException
Get the standard annotation index restricted to a specific annotation type.- Type Parameters:
T
- the Java class corresponding to type- Parameters:
type
- The annotation type the index is restricted to.- Returns:
- The standard annotation index, restricted to
type
. - Throws:
CASRuntimeException
-
getAnnotationIndex
<T extends Annotation> AnnotationIndex<T> getAnnotationIndex(int type) throws CASRuntimeException
Get the standard annotation index restricted to a specific annotation type.- Type Parameters:
T
- the Java class corresponding to type- Parameters:
type
- The annotation type the index is restricted to, passed as an integer using the form MyAnnotationType.type- Returns:
- The standard annotation index, restricted to
type
. - Throws:
CASRuntimeException
- -
-
getAnnotationIndex
<T extends Annotation> AnnotationIndex<T> getAnnotationIndex(java.lang.Class<T> clazz) throws CASRuntimeException
Get the standard annotation index restricted to a specific annotation type.- Type Parameters:
T
- the Java class clazz- Parameters:
clazz
- The JCas cover class for the annotation type the index is restricted to,- Returns:
- The standard annotation index, restricted to
type
. - Throws:
CASRuntimeException
- -
-
getAllIndexedFS
<T extends TOP> FSIterator<T> getAllIndexedFS(java.lang.Class<T> clazz)
Gets an iterator over all indexed FeatureStructures of the specified Type (and any of its subtypes). The elements are returned in arbitrary order, and duplicates (if they exist) are not removed.- Type Parameters:
T
- the Java clazz- Parameters:
clazz
- - the JCas Java class specifing which type and subtypes are included- Returns:
- An iterator that returns all indexed FeatureStructures of the JCas clazz and its subtypes, in no particular order.
-
getViewIterator
java.util.Iterator<JCas> getViewIterator() throws CASException
Get iterator over all views in this JCas. Each view provides access to Sofa data and the index repository that contains metadata (annotations and other feature structures) pertaining to that Sofa.- Returns:
- an iterator which returns all views. Each object returned by the iterator is of type JCas.
- Throws:
CASException
- -
-
getViewIterator
java.util.Iterator<JCas> getViewIterator(java.lang.String localViewNamePrefix) throws CASException
Get iterator over all views with the given name prefix. Each view provides access to Sofa data and the index repository that contains metadata (annotations and other feature structures) pertaining to that Sofa.When passed the prefix namePrefix, the iterator will return all views who name is either exactly equal to namePrefix or is of the form namePrefix
.
suffix, where suffix can be any String.- Parameters:
localViewNamePrefix
- the local name prefix, before any sofa name mapping is done, for this view (note: this is the same as the associated Sofa name prefix).- Returns:
- an iterator which returns all views with the given name prefix. Each object returned by the iterator is of type JCas.
- Throws:
CASException
- -
-
protectIndexes
java.lang.AutoCloseable protectIndexes()
Call this method to set up a region, ended by a close() call on the returned object, You can use this or theprotectIndexes(Runnable)
method to protected the indexes.This approach allows arbitrary code between the protectIndexes and the associated close method.
The close method is best done in a finally block, or using the try-with-resources statement in Java 8.
- Returns:
- an object used to record things that need adding back
-
protectIndexes
void protectIndexes(java.lang.Runnable runnable)
Runs the code in the runnable inside a protection block, where any modifications to features done while in this block will be done in a way to protect any indexes which otherwise might become corrupted by the update action; the protection is achieved by temporarily removing the FS (if it is in the indexes), before the update happens. At the end of the block, affected indexes have any removed-under-the-covers FSs added back.- Parameters:
runnable
- code to execute while protecting the indexes.
-
getIndex
<T extends TOP> FSIndex<T> getIndex(java.lang.String label, java.lang.Class<T> clazz)
Retrieve an index according to a label and a type specified using a JCas class. The type is used to narrow down the index of a more general type to a more specific one. Generics: T is the associated Java cover class for the type.- Type Parameters:
T
- the Java clazz- Parameters:
label
- The name of the index.clazz
- The JCas class (mostly likely written as MyJCasClass.class), which must correspond to a subtype of the type of the index.- Returns:
- The specified, or
null
if an index with that name doesn't exist. - Throws:
CASRuntimeException
- Whenclazz
doesn't correspond to a subtype of the index's type.
-
-