Reto Bachmann-Gmür created STANBOL-967:
------------------------------------------

             Summary: enhancer.servicesapi.ServiceProperties documentation 
improvement
                 Key: STANBOL-967
                 URL: https://issues.apache.org/jira/browse/STANBOL-967
             Project: Stanbol
          Issue Type: Improvement
            Reporter: Reto Bachmann-Gmür
            Priority: Minor


The javadoc of enhancer.servicesapi.ServiceProperties isn't very clear.

"Stanbol Enhancer components might implement this interface to parse additional 
properties to other components."

What does it mean to "parse additional properties". If an "Enhancer component" 
is a EnhancementEngine why doesn't this interface extend it? And what is the 
"other component"?

Why does getServiceProperties return a Map with Objects as values while the 
constants are all integers? What are the possible keys expect 
ENHANCEMENT_ENGINE_ORDERING? Is anything else but the EnhancementJobManager 
expected to read/use this properties?

javadoc to DEFAULT_ORDERING:
     * The default ordering uses {@link 
ServiceProperties#ORDERING_EXTRACTION_ENHANCEMENT}
     * -1 . So by default EnhancementEngines are called after all engines that
     * use an value within the ordering range defined by
     * {@link ServiceProperties#ORDERING_EXTRACTION_ENHANCEMENT}

As ORDERING_EXTRACTION_ENHANCEMENT is 1 ORDERING_EXTRACTION_ENHANCEMENT-1 is 0. 
Is the first sentence ust a convuted wy of saying that this constant has value 
0?
An what is the value range defined by ORDERING_EXTRACTION_ENHANCEMENT, is this 
the range [1,1]?

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Reply via email to