Pepper
3.6.0
A highly extensible plattform for conversion and manipulationoflinguisticdata.
|
Inherits org.corpus_tools.pepper.impl.PepperModuleImpl, and org.corpus_tools.pepper.modules.PepperExporter.
Inherited by org.corpus_tools.pepper.modules.coreModules.DoNothingExporter, org.corpus_tools.pepper.modules.coreModules.DOTExporter, org.corpus_tools.pepper.modules.coreModules.SaltXMLExporter, and org.corpus_tools.pepper.modules.coreModules.TextExporter.
Public Member Functions | |||||
List< FormatDesc > | getSupportedFormats () | ||||
{@inheritDoc PepperExporter::getSupportedFormats()} | |||||
FormatDesc | addSupportedFormat (String formatName, String formatVersion, URI formatReference) | ||||
{@inheritDoc PepperExporter::addSupportedFormat(String, String, URI)} | |||||
CorpusDesc | getCorpusDesc () | ||||
{@inheritDoc PepperExporter::getCorpusDefinition()} | |||||
void | setCorpusDesc (CorpusDesc newCorpusDefinition) | ||||
{@inheritDoc PepperExporter::setCorpusDefinition(CorpusDefinition)} | |||||
void | start () throws PepperModuleException | ||||
Adds the call of method exportCorpusStructure(SCorpusGraph), than calls PepperModule#start(). | |||||
String | getDocumentEnding () | ||||
{@inheritDoc PepperExporter::getDocumentEnding()} | |||||
void | setDocumentEnding (String sDocumentEnding) | ||||
{@inheritDoc PepperExporter::setDocumentEnding(String)} | |||||
EXPORT_MODE | getExportMode () | ||||
{@inheritDoc PepperExporter::getExportMode()} | |||||
void | setExportMode (EXPORT_MODE exportMode) | ||||
{@inheritDoc PepperExporter::setExportMode(org.corpus_tools.pepper.modules. More... | |||||
synchronized Map< Identifier, URI > | getIdentifier2ResourceTable () | ||||
{@inheritDoc PepperImporter::getIdentifier2ResourceTable()} | |||||
void | exportCorpusStructure () | ||||
{@inheritDoc PepperExporter::exportCorpusStructure()} | |||||
URI | createFolderStructure (Identifier id) | ||||
{@inheritDoc PepperExporter::createFolderStructure(Identifier)} | |||||
Public Member Functions inherited from org.corpus_tools.pepper.impl.PepperModuleImpl | |||||
PepperModuleDesc | getFingerprint () | ||||
Returns a PepperModuleDesc object, which is a kind of a fingerprint of this PepperModule.This fingerprint for instance contains information like the name, the version of this module or information about the supplier.
| |||||
String | getName () | ||||
Returns the name of this module.In most cases, the name somehow describes the task of the module.
| |||||
String | getVersion () | ||||
Returns the version of this module.
| |||||
void | setVersion (String newVersion) | ||||
Sets the version of this module.The version normally is set internally, this method only exists for dependency injection, by the modules project itself. But this method is never called by the pepper framework.
| |||||
MODULE_TYPE | getModuleType () | ||||
Returns the type of this module.
| |||||
String | getDesc () | ||||
Returns a short description of this module.Please support some information, for the user, of what task this module does.
| |||||
void | setDesc (String desc) | ||||
Sets a short description of this module.Please support some information, for the user, of what task this module does.
| |||||
URI | getSupplierContact () | ||||
Returns a uri where to find more information about this module and where to find some contact information to contact the supplier.
| |||||
void | setSupplierContact (URI supplierContact) | ||||
Sets a uri where to find more information about this module and where to find some contact information to contact the supplier.
| |||||
URI | getSupplierHomepage () | ||||
Sets the URI to the homepage describing the functionality of the module. More... | |||||
void | setSupplierHomepage (URI hp) | ||||
Returns the URI to the homepage describing the functionality of the module. More... | |||||
PepperModuleProperties | getProperties () | ||||
Returns a PepperModuleProperties object containing properties to customize the behavior of this PepperModule.
| |||||
void | setProperties (PepperModuleProperties properties) | ||||
Sets thePepperModuleProperties object containing properties to customize the behavior of this PepperModule.Please make sure, that this method is called in constructor of your module. If not, a general PepperModuleProperties object is created by the pepper framework and will be initialized. This means, when calling this method later, all properties for customizing the module will be overridden.
| |||||
SaltProject | getSaltProject () | ||||
Returns the SaltProject object, which is filled, manipulated or exported by the current module.
| |||||
synchronized void | setSaltProject (SaltProject newSaltProject) | ||||
Sets the SaltProject object, which is filled, manipulated or exported by the current module.Note: This method only should be called by the pepper framework.
| |||||
URI | getResources () | ||||
Returns the path of the folder which might contain resources for a Pepper module.This is the folder, which is delivered as part of the modules zip. Usually a Pepper module is a zip file containing a jar file and a folder having the same name as the jar file. In default configuration all files of folder "./src/main/resources" are copied to the resource folder.
| |||||
void | setResources (URI newResources) | ||||
Sets the resource folder used by getResources().This method should only be invoked by the Pepper framework. The documentation of getResources() for more details.
| |||||
URI | getTemproraries () | ||||
TODO make docu. | |||||
void | setTemproraries (URI newTemproraries) | ||||
TODO make docu. | |||||
String | getSymbolicName () | ||||
Returns the symbolic name of this OSGi bundle.
| |||||
void | setSymbolicName (String newSymbolicName) | ||||
Sets the symbolic name of this OSGi bundle.This value is set automatically inside the activate method, which is implemented in PepperModuleImpl class. If you want to manipulate that method. make sure to set the symbolic name and make sure, that it is set to the bundles symbolic name.
| |||||
ComponentContext | getComponentContext () | ||||
Returns the ComponentContext of the OSGi environment the bundle was started in. More... | |||||
Collection< String > | getStartProblems () | ||||
If isReadyToStart() has returned false, this method returns a list of reasons why this module is not ready to start.
| |||||
boolean | isReadyToStart () throws PepperModuleNotReadyException | ||||
This method is called by the pepper framework after initializing this object and directly before start processing.Initializing means setting properties PepperModuleProperties, setting temporary files, resources etc. . returns false or throws an exception in case of PepperModule instance is not ready for any reason This method is also called, when Pepper is in self-test mode, to check if module is correctly instantiated. The default implementation checks:
When overriding this method, please call super.isReadyToStart() first and in case a problem occured add it to the list getStartProblems().
| |||||
ModuleController | getModuleController () | ||||
Returns the container and controller object for the current module.The ModuleController object is a kind of communicator between a PepperModule and the pepper framework.
| |||||
void | setPepperModuleController (ModuleController newModuleController) | ||||
Sets the container and controller object for the current module.The ModuleController object is a kind of communicator between a PepperModule and the pepper framework. Also calls the inverse method ModuleController#setPepperModule_basic(PepperModule) . Note, this method only should be called by pepper framework.
| |||||
void | setPepperModuleController_basic (ModuleController newModuleController) | ||||
Sets the container and controller object for the current module.The ModuleController object is a kind of communicator between a PepperModule and the pepper framework. Note, this method only should be called by pepper framework.
| |||||
SCorpusGraph | getCorpusGraph () | ||||
Returns the SCorpusGraph object which is filled, manipulated or exported by the current module.The SCorpusGraph object is contained in the salt project getSaltProject().
| |||||
void | setCorpusGraph (SCorpusGraph newSCorpusGraph) | ||||
Sets the SCorpusGraph object which is filled, manipulated or exported by the current module.The SCorpusGraph object is contained in the salt project getSaltProject(). Note: This method only should be called by the pepper framework.
| |||||
void | setIsMultithreaded (boolean isMultithreaded) | ||||
Sets whether this PepperModule is able to run multithreaded.This method only should be called by the module itself.
| |||||
boolean | isMultithreaded () | ||||
Returns whether this PepperModule is able to run multithreaded.The behavior only should be set by the module itself via calling setIsMultithreaded(boolean).
| |||||
void | done (Identifier id, DOCUMENT_STATUS result) | ||||
This method is called by a PepperMapperController object to notify the PepperModule object, that the mapping for this object is done.
| |||||
void | done (PepperMapperController controller) | ||||
This method is called by a PepperMapperController object to notify the PepperModule object, that the mapping is done.
| |||||
void | start (Identifier sElementId) throws PepperModuleException | ||||
This method is called by method start(), if the method was not overridden by the current class. More... | |||||
PepperMapper | createPepperMapper (Identifier sElementId) | ||||
OVERRIDE THIS METHOD FOR CUSTOMIZED MAPPING.This method creates a customized PepperMapper object and returns it. You can here do some additional initialisations. Thinks like setting the Identifier of the SDocument or SCorpus object and the URI resource is done by the framework (or more in detail in method start()). The parameter sElementId , if a PepperMapper object should be created in case of the object to map is either an SDocument object or an SCorpus object of the mapper should be initialized differently. Note: Override this method.
| |||||
void | end () throws PepperModuleException | ||||
Calls method start(Identifier) for every root SCorpus of SaltProject object. | |||||
void | uncaughtException (Thread t, Throwable e) | ||||
Method catches Uncaught exceptions thrown by PepperMapperImpl while running as Thread. More... | |||||
Double | getProgress (String globalId) | ||||
This method is invoked by the Pepper framework, to get the current progress concerning the SDocument object corresponding to the given Identifier in percent.A valid value return must be between 0 and 1. Note: In case, you have overridden the method start(Identifier) or start(), please also override this method, because it accesses an internal list of all mappers, which initialized in start(Identifier).
| |||||
Double | getProgress () | ||||
{@inheritDoc PepperModule::getProgress()} | |||||
List< Identifier > | proposeImportOrder (SCorpusGraph sCorpusGraph) | ||||
This method could be overridden, to make a proposal for the import order of SDocument objects.Overriding this method is useful, in case of the order matters in the specific mapping of this PepperModule . In this case a influencing the import order can decrease the processing time. If you do not want to influence the order, just return an empty list, or don't override this method. In case you want to override this method, you can return a value for each passed SCorpusGraph. OVERRIDE THIS METHOD FOR CUSTOMIZED MAPPING.
| |||||
String | toString () | ||||
Returns a string representation of this object. More... | |||||
SelfTestDesc | getSelfTestDesc () | ||||
This method is called by the Pepper framework to run an integration test for module. More... | |||||
Protected Member Functions | |
PepperExporterImpl () | |
Creates a PepperModule of type MODULE_TYPE#EXPORTER. More... | |
PepperExporterImpl (String name) | |
Creates a PepperModule of type MODULE_TYPE#EXPORTER and sets is name to the passed one. | |
Protected Member Functions inherited from org.corpus_tools.pepper.impl.PepperModuleImpl | |
PepperModuleImpl () | |
Creates a PepperModule object, which is either a MODULE_TYPE#IMPORTER, a MODULE_TYPE#MANIPULATOR or a MODULE_TYPE#EXPORTER. More... | |
PepperModuleImpl (String name) | |
Creates a PepperModule object, which is either a MODULE_TYPE#IMPORTER, a MODULE_TYPE#MANIPULATOR or a MODULE_TYPE#EXPORTER. More... | |
void | setName (String name) |
Sets the name of this PepperModule. More... | |
void | activate (ComponentContext componentContext) |
This method is called by OSGi framework and sets the component context, this class is running in. More... | |
Map< String, PepperMapperController > | getMapperControllers () |
Returns a threadsafe map of all PepperMapperController objects which are connected with a started PepperMapper corresponding to their. More... | |
ThreadGroup | getMapperThreadGroup () |
Returns a ThreadGroup where PepperMapper objects and the corresponding threads are supposed to run in. More... | |
void | setMapperThreadGroup (ThreadGroup mapperThreadGroup) |
Sets a ThreadGroup where PepperMapper objects and the corresponding threads are supposed to run in. More... | |
Map< String, DocumentController > | getDocumentId2DC () |
Returns the map relating Identifier belonging to SDocument objects to their DocumentController container. More... | |
Protected Attributes | |
CorpusDesc | corpusDefinition |
TODO make docu. | |
Protected Attributes inherited from org.corpus_tools.pepper.impl.PepperModuleImpl | |
Logger | logger = LoggerFactory.getLogger("Pepper") |
SaltProject | saltProject = null |
Salt project which is processed by module. | |
URI | resources = null |
TODO make docu. | |
URI | temproraries = null |
TODO make docu. | |
String | symbolicName = null |
TODO make docu. | |
ModuleController | moduleController = null |
the controller object, which acts as bridge between Pepper framework and Pepper module. | |
SCorpusGraph | sCorpusGraph = null |
The SCorpusGraph object which should be processed by this module. | |
boolean | isMultithreaded = true |
Additional Inherited Members | |
Static Public Attributes inherited from org.corpus_tools.pepper.modules.PepperModule | |
static final String | ENDING_FOLDER = "FOLDER" |
A string specifying a value for a folder as ending. More... | |
static final String | ENDING_LEAF_FOLDER = "LEAF_FOLDER" |
A string specifying a value for a leaf folder as ending. More... | |
static final String | ENDING_XML = "xml" |
Ending for an xml file. More... | |
static final String | ENDING_TXT = "txt" |
Ending for an txt file. More... | |
static final String | ENDING_TAB = "tab" |
Ending for an tab file. More... | |
static final String | ENDING_ALL_FILES = "ALL_FILES" |
All kinds of file endings. | |
This class is an abstract implementation of PepperExporter and cannot be instantiated directly. To implement an exporter for Pepper, the easiest way is to derive this class. For further information, read the javadoc of PepperManipulator and the documentation of u.hu-berlin.de/saltnpepper.
|
protected |
Creates a PepperModule of type MODULE_TYPE#EXPORTER.
The name of this module is set to "MyExporter".
We recommend to use the constructor PepperExporterImpl#PepperExporterImpl(String) and pass a proper name.
void org.corpus_tools.pepper.impl.PepperExporterImpl.setExportMode | ( | EXPORT_MODE | exportMode | ) |
{@inheritDoc PepperExporter::setExportMode(org.corpus_tools.pepper.modules.
PepperExporter.EXPORT_MODE)}
Implements org.corpus_tools.pepper.modules.PepperExporter.