Package opennlp.tools.models
Interface ClassPathModelProvider
- All Known Implementing Classes:
DefaultClassPathModelProvider
public interface ClassPathModelProvider
A provider for obtaining pre-trained OpenNLP
models
from
an application's classpath.
Providing models available in the classpath requires a finder
and a ClassPathModelLoader
at runtime. Depending on the environment,
a custom finder
can be used.
-
Method Summary
-
Method Details
-
load
Restores amodel
among all classpath models at runtime according to the specified parameterslang
andtype
.- Parameters:
lang
- The ISO language code of the requested model. Ifnull
or empty, the result will benull
as well.type
- The type string to narrow down the model variant. Note: Custom naming patterns can be applied here, as thetype
fragment will be used for a 'contains' check internally.modelType
- The class of model type parameterClassPathModelProvider
to create an instance of.- Returns:
- An model instance of type
ClassPathModelProvider
, ornull
if no match was found for the specified parameters. - Throws:
IllegalArgumentException
- Thrown if parameters were invalid.IOException
- Thrown if something went wrong during reading resources from the classpath.
-
load
<T extends BaseModel> T load(String lang, ModelType type, Class<T> modelType, boolean reloadCache) throws IOException Restores amodel
among all classpath models at runtime according to the specified parameterslang
andtype
.- Parameters:
lang
- The ISO language code of the requested model. Ifnull
or empty, the result will benull
as well.type
- The type of model to specifiy the model variant.modelType
- The class of model type parameterClassPathModelProvider
to create an instance of.reloadCache
-true
, if the internal cache of theClassPathModelFinder
should explicitly be reloaded,false
otherwise.- Returns:
- An model instance of type
ClassPathModelProvider
, ornull
if no match was found for the specified parameters. - Throws:
IllegalArgumentException
- Thrown if parameters were invalid.IOException
- Thrown if something went wrong during reading resources from the classpath.
-