You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@any23.apache.org by le...@apache.org on 2022/04/12 17:14:50 UTC
[any23] branch master updated: Bump formatter-maven-plugin from 2.17.1 to 2.18.0 (#274)
This is an automated email from the ASF dual-hosted git repository.
lewismc pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/any23.git
The following commit(s) were added to refs/heads/master by this push:
new 1b219823 Bump formatter-maven-plugin from 2.17.1 to 2.18.0 (#274)
1b219823 is described below
commit 1b21982331d6538018019a444a7fb0110aff3fe7
Author: dependabot[bot] <49...@users.noreply.github.com>
AuthorDate: Tue Apr 12 10:14:29 2022 -0700
Bump formatter-maven-plugin from 2.17.1 to 2.18.0 (#274)
* Bump formatter-maven-plugin from 2.17.1 to 2.18.0
Bumps [formatter-maven-plugin](https://github.com/revelc/formatter-maven-plugin) from 2.17.1 to 2.18.0.
- [Release notes](https://github.com/revelc/formatter-maven-plugin/releases)
- [Changelog](https://github.com/revelc/formatter-maven-plugin/blob/main/CHANGELOG.md)
- [Commits](https://github.com/revelc/formatter-maven-plugin/compare/formatter-maven-plugin-2.17.1...formatter-maven-plugin-2.18.0)
---
updated-dependencies:
- dependency-name: net.revelc.code.formatter:formatter-maven-plugin
dependency-type: direct:production
update-type: version-update:semver-minor
...
Signed-off-by: dependabot[bot] <su...@github.com>
* Bump maven-surefire-plugin from 3.0.0-M5 to 3.0.0-M6 (#275)
Bumps [maven-surefire-plugin](https://github.com/apache/maven-surefire) from 3.0.0-M5 to 3.0.0-M6.
- [Release notes](https://github.com/apache/maven-surefire/releases)
- [Commits](https://github.com/apache/maven-surefire/compare/surefire-3.0.0-M5...surefire-3.0.0-M6)
---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-surefire-plugin
dependency-type: direct:production
update-type: version-update:semver-patch
...
Signed-off-by: dependabot[bot] <su...@github.com>
Co-authored-by: dependabot[bot] <49...@users.noreply.github.com>
* ANY23-587 Bump formatter-maven-plugin from 2.17.1 to 2.18.0
Co-authored-by: dependabot[bot] <49...@users.noreply.github.com>
Co-authored-by: Lewis John McGibbney <le...@gmail.com>
---
api/src/main/java/org/apache/any23/cli/Tool.java | 2 +-
.../apache/any23/configuration/Configuration.java | 16 +--
.../configuration/ModifiableConfiguration.java | 2 +-
.../org/apache/any23/configuration/Setting.java | 58 ++++----
.../org/apache/any23/configuration/Settings.java | 28 ++--
.../apache/any23/encoding/EncodingDetector.java | 8 +-
.../any23/extractor/ExtractionParameters.java | 16 +--
.../apache/any23/extractor/ExtractionResult.java | 2 +-
.../java/org/apache/any23/extractor/Extractor.java | 2 +-
.../any23/extractor/ExtractorDescription.java | 2 +-
.../apache/any23/extractor/ExtractorFactory.java | 4 +-
.../org/apache/any23/extractor/ExtractorGroup.java | 4 +-
.../apache/any23/extractor/ExtractorRegistry.java | 24 ++--
.../main/java/org/apache/any23/mime/MIMEType.java | 4 +-
.../org/apache/any23/mime/MIMETypeDetector.java | 2 +-
.../org/apache/any23/mime/purifier/Purifier.java | 6 +-
.../apache/any23/plugin/Any23PluginManager.java | 40 +++---
.../org/apache/any23/plugin/ExtractorPlugin.java | 4 +-
.../org/apache/any23/source/DocumentSource.java | 4 +-
api/src/main/java/org/apache/any23/vocab/CSV.java | 2 +-
api/src/main/java/org/apache/any23/vocab/DOAP.java | 2 +-
.../main/java/org/apache/any23/vocab/HListing.java | 2 +-
.../org/apache/any23/vocab/LKIFCoreAction.java | 6 +-
.../org/apache/any23/vocab/LKIFCoreExpression.java | 2 +-
.../apache/any23/vocab/LKIFCoreLegalAction.java | 2 +-
.../org/apache/any23/vocab/LKIFCoreLegalRole.java | 2 +-
.../org/apache/any23/vocab/LKIFCoreMereology.java | 2 +-
.../java/org/apache/any23/vocab/LKIFCoreNorm.java | 2 +-
.../org/apache/any23/vocab/LKIFCoreProcess.java | 2 +-
.../apache/any23/vocab/LKIFCoreRelativePlaces.java | 2 +-
.../java/org/apache/any23/vocab/LKIFCoreRole.java | 2 +-
.../java/org/apache/any23/vocab/LKIFCoreRules.java | 2 +-
.../java/org/apache/any23/vocab/LKIFCoreTime.java | 2 +-
.../any23/vocab/LKIFCoreTimeModification.java | 2 +-
.../java/org/apache/any23/vocab/LKIFCoreTop.java | 2 +-
.../java/org/apache/any23/vocab/Programme.java | 2 +-
.../main/java/org/apache/any23/vocab/SINDICE.java | 2 +-
.../java/org/apache/any23/vocab/Vocabulary.java | 20 +--
api/src/main/java/org/apache/any23/vocab/WO.java | 2 +-
api/src/main/java/org/apache/any23/vocab/YAML.java | 14 +-
.../any23/writer/DecoratingWriterFactory.java | 6 +-
.../org/apache/any23/writer/TripleHandler.java | 14 +-
.../any23/writer/TripleHandlerException.java | 2 +-
.../java/org/apache/any23/writer/TripleWriter.java | 10 +-
.../apache/any23/writer/TripleWriterFactory.java | 6 +-
.../org/apache/any23/writer/WriterFactory.java | 10 +-
.../apache/any23/writer/WriterFactoryRegistry.java | 16 +--
.../apache/any23/cli/ExtractorDocumentation.java | 8 +-
.../java/org/apache/any23/cli/VocabPrinter.java | 2 +-
.../org/apache/any23/cli/ExtractorsFlowTest.java | 4 +-
.../java/org/apache/any23/cli/SimpleRoverTest.java | 8 +-
.../java/org/apache/any23/cli/ToolRunnerTest.java | 2 +-
.../java/org/apache/any23/cli/ToolTestBase.java | 10 +-
.../java/org/apache/any23/cli/YAMLRoverTest.java | 6 +-
core/src/main/java/org/apache/any23/Any23.java | 46 +++----
.../java/org/apache/any23/ExtractionReport.java | 4 +-
.../any23/extractor/ExtractionResultImpl.java | 2 +-
.../any23/extractor/ExtractorRegistryImpl.java | 16 +--
.../any23/extractor/SingleDocumentExtraction.java | 56 ++++----
.../extractor/SingleDocumentExtractionReport.java | 2 +-
.../apache/any23/extractor/csv/CSVExtractor.java | 8 +-
.../org/apache/any23/extractor/html/DomUtils.java | 64 ++++-----
.../extractor/html/EmbeddedJSONLDExtractor.java | 2 +-
.../html/EntityBasedMicroformatExtractor.java | 6 +-
.../any23/extractor/html/HCardExtractor.java | 2 +-
.../any23/extractor/html/HRecipeExtractor.java | 10 +-
.../extractor/html/HReviewAggregateExtractor.java | 2 +-
.../html/HReviewAggregateExtractorFactory.java | 2 +-
.../apache/any23/extractor/html/HTMLDocument.java | 28 ++--
.../any23/extractor/html/HTMLMetaExtractor.java | 2 +-
.../any23/extractor/html/MicroformatExtractor.java | 16 +--
.../extractor/html/SpanCloserInputStream.java | 6 +-
.../any23/extractor/html/SpeciesExtractor.java | 6 +-
.../apache/any23/extractor/html/TagSoupParser.java | 6 +-
.../html/TagSoupParsingConfiguration.java | 2 +-
.../any23/extractor/microdata/ItemPropValue.java | 6 +-
.../any23/extractor/microdata/MicrodataParser.java | 34 ++---
.../microdata/MicrodataParserException.java | 2 +-
.../any23/extractor/rdf/JSONLDExtractor.java | 10 +-
.../any23/extractor/rdf/RDFParserFactory.java | 22 +--
.../any23/extractor/rdfa/RDFa11Extractor.java | 10 +-
.../apache/any23/extractor/rdfa/RDFa11Parser.java | 34 ++---
.../extractor/rdfa/RDFa11ParserException.java | 2 +-
.../apache/any23/extractor/rdfa/RDFaExtractor.java | 10 +-
.../any23/extractor/rdfa/XSLTStylesheet.java | 8 +-
.../extractor/rdfa/XSLTStylesheetException.java | 2 +-
.../xpath/TemplateXPathExtractionRule.java | 4 +-
.../org/apache/any23/extractor/xpath/Term.java | 2 +-
.../org/apache/any23/extractor/xpath/Variable.java | 2 +-
.../any23/extractor/xpath/XPathExtractionRule.java | 2 +-
.../any23/extractor/xpath/XPathExtractor.java | 2 +-
.../any23/extractor/yaml/ElementsProcessor.java | 8 +-
.../org/apache/any23/http/AcceptHeaderBuilder.java | 2 +-
.../org/apache/any23/http/DefaultHTTPClient.java | 4 +-
.../java/org/apache/any23/http/HTTPClient.java | 4 +-
.../apache/any23/rdf/Any23ValueFactoryWrapper.java | 12 +-
.../java/org/apache/any23/rdf/PopularPrefixes.java | 4 +-
.../main/java/org/apache/any23/rdf/RDFUtils.java | 138 +++++++++----------
.../any23/source/ByteArrayDocumentSource.java | 2 +-
.../java/org/apache/any23/util/DiscoveryUtils.java | 10 +-
.../main/java/org/apache/any23/util/FileUtils.java | 26 ++--
.../main/java/org/apache/any23/util/LogUtils.java | 2 +-
.../org/apache/any23/util/ReaderInputStream.java | 6 +-
.../java/org/apache/any23/util/StreamUtils.java | 18 +--
.../java/org/apache/any23/util/StringUtils.java | 18 +--
.../main/java/org/apache/any23/util/URLUtils.java | 4 +-
.../org/apache/any23/validator/DOMDocument.java | 6 +-
.../any23/validator/DefaultValidationReport.java | 2 +-
.../main/java/org/apache/any23/validator/Fix.java | 2 +-
.../main/java/org/apache/any23/validator/Rule.java | 4 +-
.../org/apache/any23/validator/RuleContext.java | 8 +-
.../any23/validator/SerializationException.java | 2 +-
.../apache/any23/validator/ValidationReport.java | 12 +-
.../any23/validator/ValidationReportBuilder.java | 4 +-
.../validator/ValidationReportSerializer.java | 2 +-
.../java/org/apache/any23/validator/Validator.java | 10 +-
.../apache/any23/validator/ValidatorException.java | 2 +-
.../any23/validator/rule/MetaNameMisuseFix.java | 2 +-
.../any23/validator/rule/MetaNameMisuseRule.java | 2 +-
.../rule/MissingItemscopeAttributeValueRule.java | 4 +-
.../rule/MissingOpenGraphNamespaceRule.java | 2 +-
.../validator/rule/OpenGraphNamespaceFix.java | 2 +-
.../org/apache/any23/vocab/RDFSchemaUtils.java | 10 +-
.../any23/writer/BenchmarkTripleHandler.java | 2 +-
.../any23/writer/CompositeTripleHandler.java | 2 +-
.../org/apache/any23/writer/JSONWriterFactory.java | 2 +-
.../apache/any23/writer/NQuadsWriterFactory.java | 2 +-
.../org/apache/any23/writer/NTriplesWriter.java | 2 +-
.../apache/any23/writer/NTriplesWriterFactory.java | 2 +-
.../java/org/apache/any23/writer/RDFXMLWriter.java | 2 +-
.../apache/any23/writer/RDFXMLWriterFactory.java | 2 +-
.../org/apache/any23/writer/TriXWriterFactory.java | 2 +-
.../apache/any23/writer/TripleWriterHandler.java | 30 ++---
.../java/org/apache/any23/writer/TurtleWriter.java | 2 +-
.../apache/any23/writer/TurtleWriterFactory.java | 2 +-
.../org/apache/any23/writer/URIListWriter.java | 2 +-
.../apache/any23/writer/URIListWriterFactory.java | 2 +-
.../org/apache/any23/AbstractAny23TestBase.java | 12 +-
core/src/test/java/org/apache/any23/Any23Test.java | 42 +++---
.../any23/extractor/ExtractionResultImplTest.java | 2 +-
.../extractor/SingleDocumentExtractionTest.java | 22 +--
.../extractor/html/AbstractExtractorTestCase.java | 148 ++++++++++-----------
.../apache/any23/extractor/html/DomUtilsTest.java | 2 +-
.../apache/any23/extractor/html/EncodingTest.java | 2 +-
.../extractor/html/HCalendarExtractorTest.java | 2 +-
.../any23/extractor/html/TagSoupParserTest.java | 2 +-
.../any23/extractor/html/TitleExtractorTest.java | 4 +-
.../extractor/html/TurtleHTMLExtractorTest.java | 2 +-
.../any23/extractor/rdf/TurtleExtractorTest.java | 4 +-
.../any23/extractor/rdfa/RDFa11ParserTest.java | 2 +-
.../any23/extractor/yaml/YAMLExtractorTest.java | 14 +-
.../any23/extractor/yaml/YAMLTikaParserTest.java | 2 +-
.../apache/any23/http/AcceptHeaderBuilderTest.java | 2 +-
.../any23/extractor/csv/CSVReaderBuilder.java | 14 +-
.../any23/encoding/TikaEncodingDetector.java | 2 +-
.../any23/encoding/TikaEncodingDetectorTest.java | 2 +-
.../apache/any23/mime/NaiveMIMETypeDetector.java | 2 +-
.../apache/any23/mime/TikaMIMETypeDetector.java | 32 ++---
.../any23/mime/TikaMIMETypeDetectorTest.java | 8 +-
.../mime/purifier/WhiteSpacesPurifierTest.java | 4 +-
pom.xml | 2 +-
161 files changed, 784 insertions(+), 784 deletions(-)
diff --git a/api/src/main/java/org/apache/any23/cli/Tool.java b/api/src/main/java/org/apache/any23/cli/Tool.java
index 4fb44190..fbf5c524 100644
--- a/api/src/main/java/org/apache/any23/cli/Tool.java
+++ b/api/src/main/java/org/apache/any23/cli/Tool.java
@@ -26,7 +26,7 @@ public interface Tool {
/**
* Runs the tool and retrieves the exit code.
- *
+ *
* @throws Exception
* if there is an error running the tool.
*/
diff --git a/api/src/main/java/org/apache/any23/configuration/Configuration.java b/api/src/main/java/org/apache/any23/configuration/Configuration.java
index 20cae60e..3b96d463 100644
--- a/api/src/main/java/org/apache/any23/configuration/Configuration.java
+++ b/api/src/main/java/org/apache/any23/configuration/Configuration.java
@@ -34,7 +34,7 @@ public interface Configuration {
*
* @param propertyName
* name of property to check.
- *
+ *
* @return <code>true</code> if defined, <code>false</code> otherwise.
*/
boolean defineProperty(String propertyName);
@@ -46,7 +46,7 @@ public interface Configuration {
* name of property
* @param defaultValue
* default value if not found.
- *
+ *
* @return the value associated to <i>propertyName</i>.
*/
String getProperty(String propertyName, String defaultValue);
@@ -57,9 +57,9 @@ public interface Configuration {
*
* @param propertyName
* name of property to be returned.
- *
+ *
* @return property value.
- *
+ *
* @throws IllegalArgumentException
* if the property name is not defined or the found property value is blank or empty.
*/
@@ -71,9 +71,9 @@ public interface Configuration {
*
* @param propertyName
* name of property to be returned.
- *
+ *
* @return property value.
- *
+ *
* @throws NullPointerException
* if the property name is not defined.
* @throws IllegalArgumentException
@@ -92,9 +92,9 @@ public interface Configuration {
*
* @param propertyName
* name of property flag.
- *
+ *
* @return <code>true</code> for <code>on</code>, <code>false</code> for <code>off</code>.
- *
+ *
* @throws IllegalArgumentException
* if the <code>propertyName</code> is not declared.
*/
diff --git a/api/src/main/java/org/apache/any23/configuration/ModifiableConfiguration.java b/api/src/main/java/org/apache/any23/configuration/ModifiableConfiguration.java
index f0720a2a..46b7c587 100644
--- a/api/src/main/java/org/apache/any23/configuration/ModifiableConfiguration.java
+++ b/api/src/main/java/org/apache/any23/configuration/ModifiableConfiguration.java
@@ -31,7 +31,7 @@ public interface ModifiableConfiguration extends Configuration {
* name of property.
* @param propertyValue
* value of property.
- *
+ *
* @return the old property value.
*/
String setProperty(String propertyName, String propertyValue);
diff --git a/api/src/main/java/org/apache/any23/configuration/Setting.java b/api/src/main/java/org/apache/any23/configuration/Setting.java
index cebba6b2..7af289ba 100644
--- a/api/src/main/java/org/apache/any23/configuration/Setting.java
+++ b/api/src/main/java/org/apache/any23/configuration/Setting.java
@@ -39,12 +39,12 @@ public abstract class Setting<V> implements Cloneable {
/**
* Constructs a new setting with the specified identifier and default value. This constructor must be called with
* concrete type arguments.
- *
+ *
* @param identifier
* the identifier for this setting
* @param defaultValue
* the default value for this setting
- *
+ *
* @throws IllegalArgumentException
* if the identifier or any of the type arguments were invalid
*/
@@ -56,14 +56,14 @@ public abstract class Setting<V> implements Cloneable {
/**
* Constructs a new setting with the specified identifier, value type, and default value.
- *
+ *
* @param identifier
* the identifier for this setting
* @param valueType
* the value type for this setting
* @param defaultValue
* the default value for this setting
- *
+ *
* @throws IllegalArgumentException
* if the identifier is invalid, or the value type is primitive, mutable, or has type parameters
*/
@@ -101,7 +101,7 @@ public abstract class Setting<V> implements Cloneable {
*
* @param newValue
* the new value for this setting
- *
+ *
* @throws Exception
* if the new value for this setting is invalid
*/
@@ -130,7 +130,7 @@ public abstract class Setting<V> implements Cloneable {
* a setting that may or may not have the same key as this setting
* @param <S>
* the type of the supplied setting
- *
+ *
* @return this setting, if this setting has the same key as the supplied setting
*/
@SuppressWarnings("unchecked")
@@ -141,12 +141,12 @@ public abstract class Setting<V> implements Cloneable {
/**
* @param newValue
* a value for a new setting
- *
+ *
* @return a new {@link Setting} object with this setting's key and the supplied value.
*
* @throws IllegalArgumentException
* if the new value was invalid, as determined by:
- *
+ *
* <pre>
* {@code this.checkValue(newValue)}
* </pre>
@@ -194,14 +194,14 @@ public abstract class Setting<V> implements Cloneable {
/**
* Convenience method to create a new setting with the specified identifier and default value.
- *
+ *
* @param identifier
* the identifier for this setting
* @param defaultValue
* the default value for this setting
- *
+ *
* @return the new setting
- *
+ *
* @throws IllegalArgumentException
* if the identifier is invalid
*/
@@ -211,14 +211,14 @@ public abstract class Setting<V> implements Cloneable {
/**
* Convenience method to create a new setting with the specified identifier and default value.
- *
+ *
* @param identifier
* the identifier for this setting
* @param defaultValue
* the default value for this setting
- *
+ *
* @return the new setting
- *
+ *
* @throws IllegalArgumentException
* if the identifier is invalid
*/
@@ -228,14 +228,14 @@ public abstract class Setting<V> implements Cloneable {
/**
* Convenience method to create a new setting with the specified identifier and default value.
- *
+ *
* @param identifier
* the identifier for this setting
* @param defaultValue
* the default value for this setting
- *
+ *
* @return the new setting
- *
+ *
* @throws IllegalArgumentException
* if the identifier is invalid
*/
@@ -245,14 +245,14 @@ public abstract class Setting<V> implements Cloneable {
/**
* Convenience method to create a new setting with the specified identifier and default value.
- *
+ *
* @param identifier
* the identifier for this setting
* @param defaultValue
* the default value for this setting
- *
+ *
* @return the new setting
- *
+ *
* @throws IllegalArgumentException
* if the identifier is invalid
*/
@@ -262,14 +262,14 @@ public abstract class Setting<V> implements Cloneable {
/**
* Convenience method to create a new setting with the specified identifier and default value.
- *
+ *
* @param identifier
* the identifier for this setting
* @param defaultValue
* the default value for this setting
- *
+ *
* @return the new setting
- *
+ *
* @throws IllegalArgumentException
* if the identifier is invalid
*/
@@ -279,14 +279,14 @@ public abstract class Setting<V> implements Cloneable {
/**
* Convenience method to create a new setting with the specified identifier and default value.
- *
+ *
* @param identifier
* the identifier for this setting
* @param defaultValue
* the default value for this setting
- *
+ *
* @return the new setting
- *
+ *
* @throws IllegalArgumentException
* if the identifier is invalid
*/
@@ -296,7 +296,7 @@ public abstract class Setting<V> implements Cloneable {
/**
* Convenience method to create a new setting with the specified identifier, value type, and default value.
- *
+ *
* @param <V>
* generic setting value type
* @param identifier
@@ -305,9 +305,9 @@ public abstract class Setting<V> implements Cloneable {
* the value type for this setting
* @param defaultValue
* the default value for this setting
- *
+ *
* @return the new setting
- *
+ *
* @throws IllegalArgumentException
* if the identifier is invalid, or the value type is primitive, mutable, or has type parameters
*/
diff --git a/api/src/main/java/org/apache/any23/configuration/Settings.java b/api/src/main/java/org/apache/any23/configuration/Settings.java
index bd9c4f9c..f359f516 100644
--- a/api/src/main/java/org/apache/any23/configuration/Settings.java
+++ b/api/src/main/java/org/apache/any23/configuration/Settings.java
@@ -46,7 +46,7 @@ public final class Settings extends AbstractSet<Setting<?>> {
/**
* @param identifier
* the identifier of the setting to find
- *
+ *
* @return the setting with the identifier supplied, if present
*/
public Optional<Setting<?>> find(String identifier) {
@@ -56,16 +56,16 @@ public final class Settings extends AbstractSet<Setting<?>> {
/**
* This method is semantically equivalent to: <br>
* <br>
- *
+ *
* <pre>
* {@code find(setting.getIdentifier()).flatMap(s -> s.as(setting))}
* </pre>
- *
+ *
* @param <S>
* generic setting type
* @param setting
* a setting key
- *
+ *
* @return the setting with the same setting key as the supplied setting, if present.
*/
public <S extends Setting<?>> Optional<S> find(S setting) {
@@ -76,16 +76,16 @@ public final class Settings extends AbstractSet<Setting<?>> {
/**
* This method is semantically equivalent to: <br>
* <br>
- *
+ *
* <pre>
* {@code find(defaultSetting).orElse(defaultSetting).getValue()}
* </pre>
- *
+ *
* @param <E>
* generic setting type
* @param defaultSetting
* a default key for which to obtain a value set
- *
+ *
* @return the value set for {@code defaultSetting}'s key, if present. Otherwise, returns {@code defaultSetting}'s
* value.
*/
@@ -121,7 +121,7 @@ public final class Settings extends AbstractSet<Setting<?>> {
/**
* Returns an empty {@link Settings} object.
- *
+ *
* @return an empty {@link Settings} object
*/
public static Settings of() {
@@ -130,10 +130,10 @@ public final class Settings extends AbstractSet<Setting<?>> {
/**
* Returns a singleton {@link Settings} object, containing only the supplied Setting.
- *
+ *
* @param s
* one {@link org.apache.any23.configuration.Setting}
- *
+ *
* @return a {@link Settings} object containing the supplied Setting.
*/
public static Settings of(Setting<?> s) {
@@ -143,10 +143,10 @@ public final class Settings extends AbstractSet<Setting<?>> {
/**
* @param settings
* one or more {@link org.apache.any23.configuration.Setting}'s
- *
+ *
* @return a {@link Settings} object containing the supplied settings. For any two settings having the same key, the
* first will be overwritten by the second.
- *
+ *
* @throws IllegalArgumentException
* if any two settings have the same identifier
*/
@@ -160,9 +160,9 @@ public final class Settings extends AbstractSet<Setting<?>> {
/**
* @param c
* a populated {@link java.util.Collection} of {@link org.apache.any23.configuration.Setting}'s
- *
+ *
* @return a {@link Settings} object containing the supplied settings.
- *
+ *
* @throws IllegalArgumentException
* if any two settings have the same identifier
*/
diff --git a/api/src/main/java/org/apache/any23/encoding/EncodingDetector.java b/api/src/main/java/org/apache/any23/encoding/EncodingDetector.java
index c71e30e0..7f12983d 100644
--- a/api/src/main/java/org/apache/any23/encoding/EncodingDetector.java
+++ b/api/src/main/java/org/apache/any23/encoding/EncodingDetector.java
@@ -32,10 +32,10 @@ public interface EncodingDetector {
*
* @param input
* the input stream containing the data.
- *
+ *
* @return a string compliant to <a href="http://www.iana.org/assignments/character-sets">IANA Charset
* Specification</a>.
- *
+ *
* @throws IOException
* if there is an error whilst guessing the encoding.
*/
@@ -48,10 +48,10 @@ public interface EncodingDetector {
* the input stream containing the data.
* @param contentType
* the declared content type of the data.
- *
+ *
* @return a string compliant to <a href="http://www.iana.org/assignments/character-sets">IANA Charset
* Specification</a>.
- *
+ *
* @throws IOException
* if there is an error whilst guessing the encoding.
*/
diff --git a/api/src/main/java/org/apache/any23/extractor/ExtractionParameters.java b/api/src/main/java/org/apache/any23/extractor/ExtractionParameters.java
index 874de480..8f17bd25 100644
--- a/api/src/main/java/org/apache/any23/extractor/ExtractionParameters.java
+++ b/api/src/main/java/org/apache/any23/extractor/ExtractionParameters.java
@@ -25,7 +25,7 @@ import java.util.Map;
/**
* This class models the parameters to be used to perform an extraction. See org.apache.any23.Any23 for more details.
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
*/
public class ExtractionParameters {
@@ -100,7 +100,7 @@ public class ExtractionParameters {
public ExtractionParameters(Configuration configuration, ValidationMode extractionMode, final boolean nesting) {
this(configuration, extractionMode, new HashMap<String, Boolean>() {
/**
- *
+ *
*/
private static final long serialVersionUID = 1L;
{
@@ -112,7 +112,7 @@ public class ExtractionParameters {
/**
* @param c
* the underlying configuration.
- *
+ *
* @return the default extraction parameters.
*/
public static final ExtractionParameters newDefault(Configuration c) {
@@ -155,7 +155,7 @@ public class ExtractionParameters {
*
* @param flagName
* name of flag.
- *
+ *
* @return flag value.
*/
public boolean getFlag(String flagName) {
@@ -173,7 +173,7 @@ public class ExtractionParameters {
* flag name.
* @param value
* new flag value.
- *
+ *
* @return the previous flag value.
*/
public Boolean setFlag(String flagName, boolean value) {
@@ -188,9 +188,9 @@ public class ExtractionParameters {
*
* @param propertyName
* the property name.
- *
+ *
* @return the property value.
- *
+ *
* @throws IllegalArgumentException
* if the property name is not defined in configuration.
*/
@@ -209,7 +209,7 @@ public class ExtractionParameters {
* the property name.
* @param propertyValue
* the property value.
- *
+ *
* @return the previous property value.
*/
public String setProperty(String propertyName, String propertyValue) {
diff --git a/api/src/main/java/org/apache/any23/extractor/ExtractionResult.java b/api/src/main/java/org/apache/any23/extractor/ExtractionResult.java
index 6c338276..c722a0df 100644
--- a/api/src/main/java/org/apache/any23/extractor/ExtractionResult.java
+++ b/api/src/main/java/org/apache/any23/extractor/ExtractionResult.java
@@ -76,7 +76,7 @@ public interface ExtractionResult extends IssueReport {
*
* @param extractionContext
* the context to be used to open the sub result.
- *
+ *
* @return the instance of the nested extraction result.
*/
ExtractionResult openSubResult(ExtractionContext extractionContext);
diff --git a/api/src/main/java/org/apache/any23/extractor/Extractor.java b/api/src/main/java/org/apache/any23/extractor/Extractor.java
index 313b9a5d..0e6c72a6 100644
--- a/api/src/main/java/org/apache/any23/extractor/Extractor.java
+++ b/api/src/main/java/org/apache/any23/extractor/Extractor.java
@@ -71,7 +71,7 @@ public interface Extractor<Input> {
* The extractor input data.
* @param out
* the collector for the extracted data.
- *
+ *
* @throws IOException
* On error while reading from the input stream.
* @throws ExtractionException
diff --git a/api/src/main/java/org/apache/any23/extractor/ExtractorDescription.java b/api/src/main/java/org/apache/any23/extractor/ExtractorDescription.java
index 1c950e25..2f2f3615 100644
--- a/api/src/main/java/org/apache/any23/extractor/ExtractorDescription.java
+++ b/api/src/main/java/org/apache/any23/extractor/ExtractorDescription.java
@@ -35,7 +35,7 @@ public interface ExtractorDescription {
/**
* Returns the label for extractors created from this factory.
- *
+ *
* @return A string label describing the type of extractors created from this factory.
*/
String getExtractorLabel();
diff --git a/api/src/main/java/org/apache/any23/extractor/ExtractorFactory.java b/api/src/main/java/org/apache/any23/extractor/ExtractorFactory.java
index 9e718666..042d1898 100644
--- a/api/src/main/java/org/apache/any23/extractor/ExtractorFactory.java
+++ b/api/src/main/java/org/apache/any23/extractor/ExtractorFactory.java
@@ -38,7 +38,7 @@ public interface ExtractorFactory<T extends Extractor<?>> extends ExtractorDescr
/**
* Supports wildcards, e.g. <code>"*/*"</code> for blind extractors that merely call a web service.
- *
+ *
* @return a {@link java.util.Collection} of supported mimetypes.
*/
Collection<MIMEType> getSupportedMIMETypes();
@@ -50,7 +50,7 @@ public interface ExtractorFactory<T extends Extractor<?>> extends ExtractorDescr
* factory.getClass().getResourceAsStream(filename). The example should be a short file that produces characteristic
* output if sent through the extractor. The file will be read as UTF-8, so it should either use that encoding or
* avoid characters outside of the US-ASCII range.
- *
+ *
* @return a string representing sample input for a particular extractor.
*/
String getExampleInput();
diff --git a/api/src/main/java/org/apache/any23/extractor/ExtractorGroup.java b/api/src/main/java/org/apache/any23/extractor/ExtractorGroup.java
index c9252f75..bdeadda4 100644
--- a/api/src/main/java/org/apache/any23/extractor/ExtractorGroup.java
+++ b/api/src/main/java/org/apache/any23/extractor/ExtractorGroup.java
@@ -44,10 +44,10 @@ public class ExtractorGroup implements Iterable<ExtractorFactory<?>> {
/**
* Returns a {@link ExtractorGroup} with a set of {@link Extractor} able to process the provided mime type.
- *
+ *
* @param mimeType
* to perform the selection.
- *
+ *
* @return an {@link ExtractorGroup} able to process the provided mime type.
*/
public ExtractorGroup filterByMIMEType(MIMEType mimeType) {
diff --git a/api/src/main/java/org/apache/any23/extractor/ExtractorRegistry.java b/api/src/main/java/org/apache/any23/extractor/ExtractorRegistry.java
index 9391e75e..b0dfeff2 100644
--- a/api/src/main/java/org/apache/any23/extractor/ExtractorRegistry.java
+++ b/api/src/main/java/org/apache/any23/extractor/ExtractorRegistry.java
@@ -21,31 +21,31 @@ import java.util.List;
/**
* An interface to the enable a registry for extractors to be implemented by different implementors of this API.
- *
+ *
* @author Peter Ansell p_ansell@yahoo.com
*/
public interface ExtractorRegistry {
/**
* Registers an {@link ExtractorFactory}.
- *
+ *
* @param factory
* an {@link ExtractorFactory} to register.
- *
+ *
* @throws IllegalArgumentException
* if trying to register a {@link ExtractorFactory} that already exists in the registry.
*/
void register(ExtractorFactory<?> factory);
/**
- *
+ *
* Retrieves a {@link ExtractorFactory} given its name
- *
+ *
* @param name
* The name of the desired factory
- *
+ *
* @return The {@link ExtractorFactory} associated to the provided name
- *
+ *
* @throws IllegalArgumentException
* If there is not an {@link ExtractorFactory} associated to the provided name.
*/
@@ -58,26 +58,26 @@ public interface ExtractorRegistry {
/**
* Returns an {@link ExtractorGroup} containing the {@link ExtractorFactory} mathing the names provided as input.
- *
+ *
* @param names
* A {@link java.util.List} containing the names of the desired {@link ExtractorFactory}.
- *
+ *
* @return the extraction group.
*/
ExtractorGroup getExtractorGroup(List<String> names);
/**
- *
+ *
* @param name
* The name of the {@link ExtractorFactory}
- *
+ *
* @return <code>true</code> if is there a {@link ExtractorFactory} associated to the provided name.
*/
boolean isRegisteredName(String name);
/**
* Returns the names of all registered extractors, sorted alphabetically.
- *
+ *
* @return an alphabetically sorted {@link java.util.List}
*/
List<String> getAllNames();
diff --git a/api/src/main/java/org/apache/any23/mime/MIMEType.java b/api/src/main/java/org/apache/any23/mime/MIMEType.java
index 035b03f4..20b9b1c0 100644
--- a/api/src/main/java/org/apache/any23/mime/MIMEType.java
+++ b/api/src/main/java/org/apache/any23/mime/MIMEType.java
@@ -45,9 +45,9 @@ public class MIMEType implements Comparable<MIMEType> {
*
* @param mimeType
* a provided mimetype string.
- *
+ *
* @return the mime type instance.
- *
+ *
* @throws IllegalArgumentException
* if the <code>mimeType</code> is not well formatted.
*/
diff --git a/api/src/main/java/org/apache/any23/mime/MIMETypeDetector.java b/api/src/main/java/org/apache/any23/mime/MIMETypeDetector.java
index 8d08dd34..03e37d63 100644
--- a/api/src/main/java/org/apache/any23/mime/MIMETypeDetector.java
+++ b/api/src/main/java/org/apache/any23/mime/MIMETypeDetector.java
@@ -33,7 +33,7 @@ public interface MIMETypeDetector {
* content of the file.
* @param mimeTypeFromMetadata
* mimetype declared in metadata.
- *
+ *
* @return the supposed mime type or <code>null</code> if nothing appropriate found.
*/
public MIMEType guessMIMEType(String fileName, InputStream input, MIMEType mimeTypeFromMetadata);
diff --git a/api/src/main/java/org/apache/any23/mime/purifier/Purifier.java b/api/src/main/java/org/apache/any23/mime/purifier/Purifier.java
index df44b7de..1d239ca0 100644
--- a/api/src/main/java/org/apache/any23/mime/purifier/Purifier.java
+++ b/api/src/main/java/org/apache/any23/mime/purifier/Purifier.java
@@ -23,17 +23,17 @@ import java.io.InputStream;
/**
* This interface defines a minimum set of methods that a TikaMIMETypeDetector could call in order to clean the input
* before performing the <i>MIME type</i> detection.
- *
+ *
* @author Davide Palmisano ( dpalmisano@gmail.com )
*/
public interface Purifier {
/**
* Performs the purification of the provided resettable {@link java.io.InputStream}.
- *
+ *
* @param inputStream
* a resettable {@link java.io.InputStream} to be cleaned.
- *
+ *
* @throws IOException
* if there is an error accessing the {@link java.io.InputStream}
*/
diff --git a/api/src/main/java/org/apache/any23/plugin/Any23PluginManager.java b/api/src/main/java/org/apache/any23/plugin/Any23PluginManager.java
index 4b9057ee..29eabe87 100644
--- a/api/src/main/java/org/apache/any23/plugin/Any23PluginManager.java
+++ b/api/src/main/java/org/apache/any23/plugin/Any23PluginManager.java
@@ -94,7 +94,7 @@ public class Any23PluginManager {
*
* @param jar
* the JAR file to be loaded.
- *
+ *
* @return <code>true</code> if the JAR is added for the first time to the classpath, <code>false</code> otherwise.
*/
public synchronized boolean loadJAR(File jar) {
@@ -113,7 +113,7 @@ public class Any23PluginManager {
*
* @param jars
* list of JARs to be loaded.
- *
+ *
* @return list of exceptions raised during the loading.
*/
public synchronized Throwable[] loadJARs(File... jars) {
@@ -135,7 +135,7 @@ public class Any23PluginManager {
*
* @param classDir
* the directory to be loaded.
- *
+ *
* @return <code>true</code> if the directory is added for the first time to the classpath, <code>false</code>
* otherwise.
*/
@@ -155,7 +155,7 @@ public class Any23PluginManager {
*
* @param classDirs
* list of class dirs to be loaded.
- *
+ *
* @return list of exceptions raised during the loading.
*/
public synchronized Throwable[] loadClassDirs(File... classDirs) {
@@ -177,7 +177,7 @@ public class Any23PluginManager {
* @param jarDir
* directory containing the JARs to be loaded. Example
* '/usr/local/apache-tomcat-7.0.72/webapps/apache-any23-service-2.2-SNAPSHOT/WEB-INF/lib/apache-any23-openie'
- *
+ *
* @return <code>true</code> if all JARs in dir are loaded.
*/
public synchronized boolean loadJARDir(File jarDir) {
@@ -205,7 +205,7 @@ public class Any23PluginManager {
*
* @param files
* list of files to be loaded.
- *
+ *
* @return list of errors occurred during loading.
*/
public synchronized Throwable[] loadFiles(File... files) {
@@ -239,9 +239,9 @@ public class Any23PluginManager {
* type of filtered class.
* @param type
* of filtered class.
- *
+ *
* @return list of matching classes.
- *
+ *
* @throws IOException
* if there is an error obtaining plugins.
*/
@@ -253,7 +253,7 @@ public class Any23PluginManager {
* Returns the list of all the {@link Tool} classes declared within the classpath.
*
* @return not <code>null</code> list of tool classes.
- *
+ *
* @throws IOException
* if there is an error obtaining {@link org.apache.any23.cli.Tool}'s from the classpath.
*/
@@ -265,7 +265,7 @@ public class Any23PluginManager {
* List of {@link ExtractorPlugin} classes declared within the classpath.
*
* @return not <code>null</code> list of plugin classes.
- *
+ *
* @throws IOException
* if there is an error obtaining Extractors.
*/
@@ -279,7 +279,7 @@ public class Any23PluginManager {
*
* @param pluginLocations
* list of locations.
- *
+ *
* @return a report about the loaded plugins.
*/
public synchronized String loadPlugins(File... pluginLocations) {
@@ -308,9 +308,9 @@ public class Any23PluginManager {
*
* @param pluginLocations
* path locations of plugins.
- *
+ *
* @return full list of extractors.
- *
+ *
* @throws java.io.IOException
* if there is an error locating the plugin(s).
* @throws IllegalAccessException
@@ -353,9 +353,9 @@ public class Any23PluginManager {
*
* @param initialExtractorGroup
* initial list of extractors.
- *
+ *
* @return full list of extractors.
- *
+ *
* @throws java.io.IOException
* if there is an error locating the extractor(s).
* @throws IllegalAccessException
@@ -373,14 +373,14 @@ public class Any23PluginManager {
/**
* Returns an extractor group containing both the default extractors declared by the
* {@link org.apache.any23.extractor.ExtractorRegistry} and the {@link ExtractorPlugin}s.
- *
+ *
* @param registry
* an {@link org.apache.any23.extractor.ExtractorRegistry}
* @param pluginLocations
* optional list of plugin locations.
*
* @return a not <code>null</code> and not empty extractor group.
- *
+ *
* @throws java.io.IOException
* if there is an error locating the extractor group.
* @throws IllegalAccessException
@@ -398,9 +398,9 @@ public class Any23PluginManager {
*
* @param pluginLocations
* list of plugin locations.
- *
+ *
* @return set of detected tools.
- *
+ *
* @throws IOException
* if there is an error acessing {@link org.apache.any23.cli.Tool}'s.
*/
@@ -414,7 +414,7 @@ public class Any23PluginManager {
* Converts a column separated list of dirs in a list of files.
*
* @param pluginDirsList
- *
+ *
* @return
*/
private File[] getPluginLocations(String pluginDirsList) {
diff --git a/api/src/main/java/org/apache/any23/plugin/ExtractorPlugin.java b/api/src/main/java/org/apache/any23/plugin/ExtractorPlugin.java
index f9984879..647d5fd0 100644
--- a/api/src/main/java/org/apache/any23/plugin/ExtractorPlugin.java
+++ b/api/src/main/java/org/apache/any23/plugin/ExtractorPlugin.java
@@ -24,11 +24,11 @@ import org.apache.any23.extractor.ExtractorFactory;
* This interface defines an Any23 extractor plugin that can be detected and registered from the library classpath.
*
* @author Michele Mostarda (mostarda@fbk.eu)
- *
+ *
* @deprecated ExtractorFactory now supports
* <a href="https://docs.oracle.com/javase/8/docs/api/java/util/ServiceLoader.html"> META-INF/services</a>
* discovery via the {@link java.util.ServiceLoader}, deprecating this class.
- *
+ *
* Instead implement a subinterface of {@link org.apache.any23.extractor.Extractor} and ensure that your
* plugin is in compliance with the META-INF/services mechanism.
*/
diff --git a/api/src/main/java/org/apache/any23/source/DocumentSource.java b/api/src/main/java/org/apache/any23/source/DocumentSource.java
index 5672f3bf..06609f8b 100644
--- a/api/src/main/java/org/apache/any23/source/DocumentSource.java
+++ b/api/src/main/java/org/apache/any23/source/DocumentSource.java
@@ -31,7 +31,7 @@ public interface DocumentSource {
* Returns the input stream for accessing the content of the document.
*
* @return not <code>null</code> input stream for accessing document data.
- *
+ *
* @throws IOException
* if there is an error opening the {@link org.apache.any23.source.DocumentSource}
* {@link java.io.InputStream}
@@ -57,7 +57,7 @@ public interface DocumentSource {
* A value of <i>false</i> indicates that the document resides remotely, and that multiple successive accesses to it
* should be avoided by copying it to local storage. This can also be used for sources that do not support multiple
* calls to {@link #openInputStream()}.
- *
+ *
* @return true if the {@link org.apache.any23.source.DocumentSource} is cached locally.
*/
public boolean isLocal();
diff --git a/api/src/main/java/org/apache/any23/vocab/CSV.java b/api/src/main/java/org/apache/any23/vocab/CSV.java
index 60597625..4729ab3b 100644
--- a/api/src/main/java/org/apache/any23/vocab/CSV.java
+++ b/api/src/main/java/org/apache/any23/vocab/CSV.java
@@ -95,7 +95,7 @@ public class CSV extends Vocabulary {
*
* @param localName
* name to assign to namespace.
- *
+ *
* @return the new URI instance.
*/
public IRI createProperty(String localName) {
diff --git a/api/src/main/java/org/apache/any23/vocab/DOAP.java b/api/src/main/java/org/apache/any23/vocab/DOAP.java
index 672803b2..5a8aa20d 100644
--- a/api/src/main/java/org/apache/any23/vocab/DOAP.java
+++ b/api/src/main/java/org/apache/any23/vocab/DOAP.java
@@ -20,7 +20,7 @@ import org.eclipse.rdf4j.model.IRI;
/**
* The <a href="https://github.com/edumbill/doap/wiki">Description Of A Project</a> vocabulary.
- *
+ *
* @author lewismc
*/
public class DOAP extends Vocabulary {
diff --git a/api/src/main/java/org/apache/any23/vocab/HListing.java b/api/src/main/java/org/apache/any23/vocab/HListing.java
index 0ef633e2..7c4321e1 100644
--- a/api/src/main/java/org/apache/any23/vocab/HListing.java
+++ b/api/src/main/java/org/apache/any23/vocab/HListing.java
@@ -23,7 +23,7 @@ import org.eclipse.rdf4j.model.IRI;
* Class modeling the <a href="http://microformats.org/wiki/hlisting-proposal">hListing</a> vocabulary.
*
* @author Davide Palmisano (dpalmisano@gmail.com)
- *
+ *
*/
public class HListing extends Vocabulary {
diff --git a/api/src/main/java/org/apache/any23/vocab/LKIFCoreAction.java b/api/src/main/java/org/apache/any23/vocab/LKIFCoreAction.java
index 1d93ee0b..63687226 100644
--- a/api/src/main/java/org/apache/any23/vocab/LKIFCoreAction.java
+++ b/api/src/main/java/org/apache/any23/vocab/LKIFCoreAction.java
@@ -24,15 +24,15 @@ import org.eclipse.rdf4j.model.IRI;
* library of ontologies relevant for the legal domain. The library consists of 15 modules, each of which describes a
* set of closely related concepts from both legal and commonsense domains.
* </p>
- *
+ *
* <p>
* The action module describes the vocabulary for representing actions in general. Actions are processes which are
* performed by some agent (the actor of the action). This module does not commit itself to a particular theory on
* thematic roles.
* </p>
- *
+ *
* @author lewismc
- *
+ *
*
*/
public class LKIFCoreAction extends Vocabulary {
diff --git a/api/src/main/java/org/apache/any23/vocab/LKIFCoreExpression.java b/api/src/main/java/org/apache/any23/vocab/LKIFCoreExpression.java
index 17848075..ac36b579 100644
--- a/api/src/main/java/org/apache/any23/vocab/LKIFCoreExpression.java
+++ b/api/src/main/java/org/apache/any23/vocab/LKIFCoreExpression.java
@@ -24,7 +24,7 @@ import org.eclipse.rdf4j.model.IRI;
* library of ontologies relevant for the legal domain. The library consists of 15 modules, each of which describes a
* set of closely related concepts from both legal and commonsense domains.
* </p>
- *
+ *
* <p>
* The expression module describes a vocabulary for describing, propositions and propositional attitudes (belief,
* intention), qualifications, statements and media. It furthermore extends the role module with a number or epistemic
diff --git a/api/src/main/java/org/apache/any23/vocab/LKIFCoreLegalAction.java b/api/src/main/java/org/apache/any23/vocab/LKIFCoreLegalAction.java
index b2ca066d..df2b709f 100644
--- a/api/src/main/java/org/apache/any23/vocab/LKIFCoreLegalAction.java
+++ b/api/src/main/java/org/apache/any23/vocab/LKIFCoreLegalAction.java
@@ -24,7 +24,7 @@ import org.eclipse.rdf4j.model.IRI;
* library of ontologies relevant for the legal domain. The library consists of 15 modules, each of which describes a
* set of closely related concepts from both legal and commonsense domains.
* </p>
- *
+ *
* <p>
* The legal action module extends the action module with a number of legal concepts related to action and agent, such
* as public acts, public bodies, legal person, natural person etc.
diff --git a/api/src/main/java/org/apache/any23/vocab/LKIFCoreLegalRole.java b/api/src/main/java/org/apache/any23/vocab/LKIFCoreLegalRole.java
index cf2f6ee9..6f8ceac5 100644
--- a/api/src/main/java/org/apache/any23/vocab/LKIFCoreLegalRole.java
+++ b/api/src/main/java/org/apache/any23/vocab/LKIFCoreLegalRole.java
@@ -24,7 +24,7 @@ import org.eclipse.rdf4j.model.IRI;
* library of ontologies relevant for the legal domain. The library consists of 15 modules, each of which describes a
* set of closely related concepts from both legal and commonsense domains.
* </p>
- *
+ *
* <p>
* The legal role module extends the role module with a small number of legal concepts related to roles, legal
* professions etc.
diff --git a/api/src/main/java/org/apache/any23/vocab/LKIFCoreMereology.java b/api/src/main/java/org/apache/any23/vocab/LKIFCoreMereology.java
index 5f57789e..47b83055 100644
--- a/api/src/main/java/org/apache/any23/vocab/LKIFCoreMereology.java
+++ b/api/src/main/java/org/apache/any23/vocab/LKIFCoreMereology.java
@@ -24,7 +24,7 @@ import org.eclipse.rdf4j.model.IRI;
* library of ontologies relevant for the legal domain. The library consists of 15 modules, each of which describes a
* set of closely related concepts from both legal and commonsense domains.
* </p>
- *
+ *
* <p>
* The mereology module defines mereological concepts such as parts and wholes, and typical mereological relations such
* as part of, component of, containment, membership etc.
diff --git a/api/src/main/java/org/apache/any23/vocab/LKIFCoreNorm.java b/api/src/main/java/org/apache/any23/vocab/LKIFCoreNorm.java
index 2a92ffeb..0c76a47c 100644
--- a/api/src/main/java/org/apache/any23/vocab/LKIFCoreNorm.java
+++ b/api/src/main/java/org/apache/any23/vocab/LKIFCoreNorm.java
@@ -24,7 +24,7 @@ import org.eclipse.rdf4j.model.IRI;
* library of ontologies relevant for the legal domain. The library consists of 15 modules, each of which describes a
* set of closely related concepts from both legal and commonsense domains.
* </p>
- *
+ *
* <p>
* The norm module is an extension primarily on the expression module where norms are defined as qualifications. Please
* refer to Deliverable 1.1 for a more in-depth description of the underlying theory. It furthermore defines a number of
diff --git a/api/src/main/java/org/apache/any23/vocab/LKIFCoreProcess.java b/api/src/main/java/org/apache/any23/vocab/LKIFCoreProcess.java
index 19508f73..98928a41 100644
--- a/api/src/main/java/org/apache/any23/vocab/LKIFCoreProcess.java
+++ b/api/src/main/java/org/apache/any23/vocab/LKIFCoreProcess.java
@@ -24,7 +24,7 @@ import org.eclipse.rdf4j.model.IRI;
* library of ontologies relevant for the legal domain. The library consists of 15 modules, each of which describes a
* set of closely related concepts from both legal and commonsense domains.
* </p>
- *
+ *
* <p>
* The process module extends the LKIF top ontology module with a definition of changes, processes (being causal
* changes) and physical objects. It introduces a limited set of properties for describing participant roles of
diff --git a/api/src/main/java/org/apache/any23/vocab/LKIFCoreRelativePlaces.java b/api/src/main/java/org/apache/any23/vocab/LKIFCoreRelativePlaces.java
index a23b1f7e..2caae33e 100644
--- a/api/src/main/java/org/apache/any23/vocab/LKIFCoreRelativePlaces.java
+++ b/api/src/main/java/org/apache/any23/vocab/LKIFCoreRelativePlaces.java
@@ -24,7 +24,7 @@ import org.eclipse.rdf4j.model.IRI;
* library of ontologies relevant for the legal domain. The library consists of 15 modules, each of which describes a
* set of closely related concepts from both legal and commonsense domains.
* </p>
- *
+ *
* <p>
* The place module partially implements the theory of relative places (Donnelly, 2005) in OWL DL.
* </p>
diff --git a/api/src/main/java/org/apache/any23/vocab/LKIFCoreRole.java b/api/src/main/java/org/apache/any23/vocab/LKIFCoreRole.java
index 243754db..035012ab 100644
--- a/api/src/main/java/org/apache/any23/vocab/LKIFCoreRole.java
+++ b/api/src/main/java/org/apache/any23/vocab/LKIFCoreRole.java
@@ -24,7 +24,7 @@ import org.eclipse.rdf4j.model.IRI;
* library of ontologies relevant for the legal domain. The library consists of 15 modules, each of which describes a
* set of closely related concepts from both legal and commonsense domains.
* </p>
- *
+ *
* <p>
* The role module defines a typology of roles (epistemic roles, functions, person roles, organisation roles) and the
* plays-property for relating a role filler to a role.
diff --git a/api/src/main/java/org/apache/any23/vocab/LKIFCoreRules.java b/api/src/main/java/org/apache/any23/vocab/LKIFCoreRules.java
index 62eacac2..089a86a0 100644
--- a/api/src/main/java/org/apache/any23/vocab/LKIFCoreRules.java
+++ b/api/src/main/java/org/apache/any23/vocab/LKIFCoreRules.java
@@ -24,7 +24,7 @@ import org.eclipse.rdf4j.model.IRI;
* library of ontologies relevant for the legal domain. The library consists of 15 modules, each of which describes a
* set of closely related concepts from both legal and commonsense domains.
* </p>
- *
+ *
* <p>
* The rules & argumentation module defines roles central to argumentation, and describes the vocabulary for LKIF
* rules as defined in Deliverable 1.1, chapter 5. The module leaves room for further extension to complex argumentation
diff --git a/api/src/main/java/org/apache/any23/vocab/LKIFCoreTime.java b/api/src/main/java/org/apache/any23/vocab/LKIFCoreTime.java
index 586b49b6..4b1d5cb6 100644
--- a/api/src/main/java/org/apache/any23/vocab/LKIFCoreTime.java
+++ b/api/src/main/java/org/apache/any23/vocab/LKIFCoreTime.java
@@ -24,7 +24,7 @@ import org.eclipse.rdf4j.model.IRI;
* library of ontologies relevant for the legal domain. The library consists of 15 modules, each of which describes a
* set of closely related concepts from both legal and commonsense domains.
* </p>
- *
+ *
* <p>
* The time module provides an OWL DL implementation of the theory of time by Allen (1984).
* </p>
diff --git a/api/src/main/java/org/apache/any23/vocab/LKIFCoreTimeModification.java b/api/src/main/java/org/apache/any23/vocab/LKIFCoreTimeModification.java
index 5025353e..06846d92 100644
--- a/api/src/main/java/org/apache/any23/vocab/LKIFCoreTimeModification.java
+++ b/api/src/main/java/org/apache/any23/vocab/LKIFCoreTimeModification.java
@@ -24,7 +24,7 @@ import org.eclipse.rdf4j.model.IRI;
* library of ontologies relevant for the legal domain. The library consists of 15 modules, each of which describes a
* set of closely related concepts from both legal and commonsense domains.
* </p>
- *
+ *
* <p>
* The modification module is both an extension of the time module and the legal action module. The time module is
* extended with numerous intervals and moments describing the efficacy and being in force of legal documents. The
diff --git a/api/src/main/java/org/apache/any23/vocab/LKIFCoreTop.java b/api/src/main/java/org/apache/any23/vocab/LKIFCoreTop.java
index bb6bd108..74d615de 100644
--- a/api/src/main/java/org/apache/any23/vocab/LKIFCoreTop.java
+++ b/api/src/main/java/org/apache/any23/vocab/LKIFCoreTop.java
@@ -24,7 +24,7 @@ import org.eclipse.rdf4j.model.IRI;
* library of ontologies relevant for the legal domain. The library consists of 15 modules, each of which describes a
* set of closely related concepts from both legal and commonsense domains.
* </p>
- *
+ *
* <p>
* The LKIF top ontology is largely based on the top-level of LRI-Core but has less ontological commitment in the sense
* that it imposes less restrictions on subclasses of the top categories.
diff --git a/api/src/main/java/org/apache/any23/vocab/Programme.java b/api/src/main/java/org/apache/any23/vocab/Programme.java
index 4069ba1b..23acc4c8 100644
--- a/api/src/main/java/org/apache/any23/vocab/Programme.java
+++ b/api/src/main/java/org/apache/any23/vocab/Programme.java
@@ -27,7 +27,7 @@ import org.eclipse.rdf4j.model.IRI;
* It covers brands, series (seasons), episodes, broadcast events, broadcast services, etc. Its development was funded
* by the BBC, and is heavily grounded on previous programmes data modeling work done there.
* </p>
- *
+ *
* @author lewismc
*/
public class Programme extends Vocabulary {
diff --git a/api/src/main/java/org/apache/any23/vocab/SINDICE.java b/api/src/main/java/org/apache/any23/vocab/SINDICE.java
index 49d6517d..d5839c60 100644
--- a/api/src/main/java/org/apache/any23/vocab/SINDICE.java
+++ b/api/src/main/java/org/apache/any23/vocab/SINDICE.java
@@ -77,7 +77,7 @@ public class SINDICE extends Vocabulary {
/**
* This property links the resource with a <i>node</i> representing the nested <i>Microformat</i>
- *
+ *
*/
public final IRI nesting_structured = createProperty(NESTING_STRUCTURED);
diff --git a/api/src/main/java/org/apache/any23/vocab/Vocabulary.java b/api/src/main/java/org/apache/any23/vocab/Vocabulary.java
index 1b41b76f..c2d4a72b 100644
--- a/api/src/main/java/org/apache/any23/vocab/Vocabulary.java
+++ b/api/src/main/java/org/apache/any23/vocab/Vocabulary.java
@@ -34,7 +34,7 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
* Base class for the definition of a vocabulary.
*
* @author Michele Mostarda ( michele.mostarda@gmail.com )
- *
+ *
* @version $Id$
*/
public abstract class Vocabulary {
@@ -94,7 +94,7 @@ public abstract class Vocabulary {
*
* @param name
* class name.
- *
+ *
* @return the IRI associated to such resource.
*/
public IRI getClass(String name) {
@@ -110,7 +110,7 @@ public abstract class Vocabulary {
*
* @param name
* property name.
- *
+ *
* @return the IRI associated to such property.
*/
public IRI getProperty(String name) {
@@ -128,7 +128,7 @@ public abstract class Vocabulary {
* property name.
* @param defaultValue
* the default value if property name not found.
- *
+ *
* @return the IRI associated to such property.
*/
public IRI getProperty(String name, IRI defaultValue) {
@@ -145,7 +145,7 @@ public abstract class Vocabulary {
*
* @param property
* property name.
- *
+ *
* @return property IRI.
*/
public IRI getPropertyCamelCase(String property) {
@@ -195,7 +195,7 @@ public abstract class Vocabulary {
*
* @param resource
* input resource to have a comment.
- *
+ *
* @return the human readable comment associated to the given resource.
*/
public String getCommentFor(IRI resource) {
@@ -208,7 +208,7 @@ public abstract class Vocabulary {
*
* @param iriStr
* the IRI string
- *
+ *
* @return the IRI instance.
*/
protected static IRI createIRI(String iriStr) {
@@ -222,7 +222,7 @@ public abstract class Vocabulary {
* vocabulary namespace.
* @param resource
* name of the resource.
- *
+ *
* @return the created resource IRI.
*/
protected IRI createClass(String namespace, String resource) {
@@ -241,7 +241,7 @@ public abstract class Vocabulary {
* vocabulary namespace.
* @param property
* name of the property.
- *
+ *
* @return the created property IRI.
*/
protected IRI createProperty(String namespace, String property) {
@@ -258,7 +258,7 @@ public abstract class Vocabulary {
*
* @param namespace
* @param localName
- *
+ *
* @return
*/
private static IRI createIRI(String namespace, String localName) {
diff --git a/api/src/main/java/org/apache/any23/vocab/WO.java b/api/src/main/java/org/apache/any23/vocab/WO.java
index a0891876..eee04664 100644
--- a/api/src/main/java/org/apache/any23/vocab/WO.java
+++ b/api/src/main/java/org/apache/any23/vocab/WO.java
@@ -26,7 +26,7 @@ import org.eclipse.rdf4j.model.IRI;
* A simple vocabulary for describing biological species and related taxa. The vocabulary defines terms for describing
* the names and ranking of taxa, as well as providing support for describing their habitats, conservation status, and
* behavioural characteristics, etc
- *
+ *
* @author lewismc
* @author Davide Palmisano (dpalmisano@gmail.com)
*/
diff --git a/api/src/main/java/org/apache/any23/vocab/YAML.java b/api/src/main/java/org/apache/any23/vocab/YAML.java
index 945cf97b..8902cb07 100644
--- a/api/src/main/java/org/apache/any23/vocab/YAML.java
+++ b/api/src/main/java/org/apache/any23/vocab/YAML.java
@@ -20,7 +20,7 @@ import org.eclipse.rdf4j.model.IRI;
/**
* This vocabulary describes model of the yaml file.
- *
+ *
* @author Jacek Grzebyta (grzebyta.dev [at] gmail.com)
*/
public class YAML extends Vocabulary {
@@ -64,12 +64,12 @@ public class YAML extends Vocabulary {
* </p>
* <p>
* <code>
- * %YAML 1.2
- * ---
- * - data1
- * - data2
- * ---
- * - data3
+ * %YAML 1.2
+ * ---
+ * - data1
+ * - data2
+ * ---
+ * - data3
* </code>
* </p>
* Contains two documents.
diff --git a/api/src/main/java/org/apache/any23/writer/DecoratingWriterFactory.java b/api/src/main/java/org/apache/any23/writer/DecoratingWriterFactory.java
index f3be0f96..01f6679c 100644
--- a/api/src/main/java/org/apache/any23/writer/DecoratingWriterFactory.java
+++ b/api/src/main/java/org/apache/any23/writer/DecoratingWriterFactory.java
@@ -21,7 +21,7 @@ import org.apache.any23.configuration.Settings;
/**
* Base interface used for constructors of decorating {@link TripleHandler} implementations.
- *
+ *
* @author Hans Brende (hansbrende@apache.org)
*/
public interface DecoratingWriterFactory extends BaseWriterFactory<TripleHandler> {
@@ -38,9 +38,9 @@ public interface DecoratingWriterFactory extends BaseWriterFactory<TripleHandler
* the {@link TripleWriter} to delegate input to
* @param settings
* the settings with which to configure the returned handler
- *
+ *
* @return a {@link TripleHandler} which writes to the specified delegate
- *
+ *
* @throws NullPointerException
* if the delegate or settings is null
* @throws IllegalArgumentException
diff --git a/api/src/main/java/org/apache/any23/writer/TripleHandler.java b/api/src/main/java/org/apache/any23/writer/TripleHandler.java
index b3b75cf5..ad545daf 100644
--- a/api/src/main/java/org/apache/any23/writer/TripleHandler.java
+++ b/api/src/main/java/org/apache/any23/writer/TripleHandler.java
@@ -32,10 +32,10 @@ public interface TripleHandler extends AutoCloseable {
/**
* Informs the handler that a new context has been established. Contexts are not guaranteed to receive any triples,
* so they might be closed without any triple.
- *
+ *
* @param context
* an instantiated {@link org.apache.any23.extractor.ExtractionContext}
- *
+ *
* @throws TripleHandlerException
* if there is an errr opening the {@link org.apache.any23.extractor.ExtractionContext}
*/
@@ -54,7 +54,7 @@ public interface TripleHandler extends AutoCloseable {
* triple graph, can be <code>null</code>.
* @param context
* extraction context.
- *
+ *
* @throws TripleHandlerException
* if there is an error receiving the triple.
*/
@@ -69,7 +69,7 @@ public interface TripleHandler extends AutoCloseable {
* namespace <i>IRI</i>.
* @param context
* namespace context.
- *
+ *
* @throws TripleHandlerException
* if there is an error receiving the namespace.
*/
@@ -82,7 +82,7 @@ public interface TripleHandler extends AutoCloseable {
*
* @param context
* the context to be closed.
- *
+ *
* @throws TripleHandlerException
* if there is an error closing the {@link org.apache.any23.extractor.ExtractionContext}.
*/
@@ -93,7 +93,7 @@ public interface TripleHandler extends AutoCloseable {
*
* @param documentIRI
* document IRI.
- *
+ *
* @throws TripleHandlerException
* if there is an error ending the document.
*/
@@ -109,7 +109,7 @@ public interface TripleHandler extends AutoCloseable {
/**
* Will be called last and exactly once.
- *
+ *
* @throws TripleHandlerException
* if there is an error closing the {@link org.apache.any23.writer.TripleHandler} implementation.
*/
diff --git a/api/src/main/java/org/apache/any23/writer/TripleHandlerException.java b/api/src/main/java/org/apache/any23/writer/TripleHandlerException.java
index 48bc7186..d935ce38 100644
--- a/api/src/main/java/org/apache/any23/writer/TripleHandlerException.java
+++ b/api/src/main/java/org/apache/any23/writer/TripleHandlerException.java
@@ -19,7 +19,7 @@ package org.apache.any23.writer;
/**
* Defines a generic exception raised when accessing to {@link TripleHandler} class.
- *
+ *
* @author Davide Palmisano (palmisano@fbk.eu)
*/
public class TripleHandlerException extends Exception {
diff --git a/api/src/main/java/org/apache/any23/writer/TripleWriter.java b/api/src/main/java/org/apache/any23/writer/TripleWriter.java
index fbc27d99..5f3912f0 100644
--- a/api/src/main/java/org/apache/any23/writer/TripleWriter.java
+++ b/api/src/main/java/org/apache/any23/writer/TripleWriter.java
@@ -30,7 +30,7 @@ public interface TripleWriter extends AutoCloseable {
/**
* Writes a triple and, optionally, a graph resource name.
- *
+ *
* @param s
* the subject to write
* @param p
@@ -39,7 +39,7 @@ public interface TripleWriter extends AutoCloseable {
* the object to write
* @param g
* the graph name to write, or null
- *
+ *
* @throws TripleHandlerException
* if there is an error writing the triple
*/
@@ -49,12 +49,12 @@ public interface TripleWriter extends AutoCloseable {
* Writes a prefix-namespace mapping. <br>
* <b>NOTE:</b> this method should be called <b>before</b> writing out any triples. Calling this method <b>after</b>
* writing out a triple may result in the prefix-namespace mapping being ignored.
- *
+ *
* @param prefix
* the namespace prefix
* @param uri
* the namespace uri
- *
+ *
* @throws TripleHandlerException
* if there was an error writing out the prefix-namespace mapping
*/
@@ -64,7 +64,7 @@ public interface TripleWriter extends AutoCloseable {
* Releases resources associated with this {@link TripleWriter}, and flushes (but by default does not close) any
* underlying {@link java.io.OutputStream}s. Future invocations of methods of this writer produce <b>undefined
* behavior</b> after this method has been called.
- *
+ *
* @throws TripleHandlerException
* if there was an error closing this {@link TripleWriter}
*/
diff --git a/api/src/main/java/org/apache/any23/writer/TripleWriterFactory.java b/api/src/main/java/org/apache/any23/writer/TripleWriterFactory.java
index d4eae83e..0c22102a 100644
--- a/api/src/main/java/org/apache/any23/writer/TripleWriterFactory.java
+++ b/api/src/main/java/org/apache/any23/writer/TripleWriterFactory.java
@@ -30,7 +30,7 @@ import java.io.OutputStream;
/**
* Base interface for constructors of {@link TripleHandler} implementations that write to an {@link OutputStream} using
* a particular {@link FileFormat}.
- *
+ *
* @author Hans Brende (hansbrende@apache.org)
*/
public interface TripleWriterFactory extends BaseWriterFactory<OutputStream> {
@@ -131,9 +131,9 @@ public interface TripleWriterFactory extends BaseWriterFactory<OutputStream> {
* the {@link OutputStream} to write to
* @param settings
* the settings with which to configure the writer
- *
+ *
* @return a {@link TripleHandler} which writes to the specified {@link OutputStream}
- *
+ *
* @throws NullPointerException
* if the output stream or settings is null
* @throws IllegalArgumentException
diff --git a/api/src/main/java/org/apache/any23/writer/WriterFactory.java b/api/src/main/java/org/apache/any23/writer/WriterFactory.java
index 995a0b63..c150961b 100644
--- a/api/src/main/java/org/apache/any23/writer/WriterFactory.java
+++ b/api/src/main/java/org/apache/any23/writer/WriterFactory.java
@@ -25,7 +25,7 @@ import org.eclipse.rdf4j.rio.RDFFormat;
/**
* The superinterface of all {@link TripleHandler} factory interfaces. Do not implement this interface directly.
* Instead, implement one of the subinterfaces {@link TripleWriterFactory} or {@link DecoratingWriterFactory}.
- *
+ *
* @author Peter Ansell (p_ansell@yahoo.com)
* @author Hans Brende (hansbrende@apache.org)
*/
@@ -33,7 +33,7 @@ public interface WriterFactory {
/**
* @deprecated since 2.3. Use {@link TripleWriterFactory#getTripleFormat()} instead.
- *
+ *
* @return the {@link org.eclipse.rdf4j.rio.RDFFormat} being handled
*/
@Deprecated
@@ -44,7 +44,7 @@ public interface WriterFactory {
/**
* @deprecated since 2.3. Use {@link TripleWriterFactory#getTripleFormat()}.{@link TripleFormat#getMimeType()
* getMimeType()} instead.
- *
+ *
* @return a String representing the Mimetype being handled in this Writer
*/
@Deprecated
@@ -52,10 +52,10 @@ public interface WriterFactory {
/**
* @deprecated since 2.3. Use {@link TripleWriterFactory#getTripleWriter(OutputStream, Settings)} instead.
- *
+ *
* @param os
* a {@link java.io.OutputStream} to be written to the FormatWriter handler
- *
+ *
* @return a {@link org.apache.any23.writer.FormatWriter} ready to be implemented
*/
@Deprecated
diff --git a/api/src/main/java/org/apache/any23/writer/WriterFactoryRegistry.java b/api/src/main/java/org/apache/any23/writer/WriterFactoryRegistry.java
index f8cb7ea5..9780f2f1 100644
--- a/api/src/main/java/org/apache/any23/writer/WriterFactoryRegistry.java
+++ b/api/src/main/java/org/apache/any23/writer/WriterFactoryRegistry.java
@@ -103,7 +103,7 @@ public class WriterFactoryRegistry {
*
* @param writerClass
* writer class.
- *
+ *
* @return identifier.
*/
public static String getIdentifier(WriterFactory writerClass) {
@@ -115,7 +115,7 @@ public class WriterFactoryRegistry {
*
* @param writerClass
* writer class.
- *
+ *
* @return MIME type.
*/
public static String getMimeType(WriterFactory writerClass) {
@@ -186,7 +186,7 @@ public class WriterFactoryRegistry {
*
* @param f
* the writer factory to be registered.
- *
+ *
* @throws IllegalArgumentException
* if the id or the mimetype are null or empty strings or if the identifier has been already defined.
*/
@@ -250,7 +250,7 @@ public class WriterFactoryRegistry {
*
* @param id
* identifier.
- *
+ *
* @return <code>true</code> if the identifier has been registered, <code>false</code> otherwise.
*/
public boolean hasIdentifier(String id) {
@@ -288,7 +288,7 @@ public class WriterFactoryRegistry {
*
* @param id
* the writer identifier.
- *
+ *
* @return the {@link WriterFactory} matching the <code>id</code> or <code>null</code> if not found.
*/
public WriterFactory getWriterByIdentifier(String id) {
@@ -302,7 +302,7 @@ public class WriterFactoryRegistry {
*
* @param mimeType
* a MIMEType.
- *
+ *
* @return a list of matching writers or an empty list.
*/
public Collection<WriterFactory> getWritersByMimeType(String mimeType) {
@@ -319,9 +319,9 @@ public class WriterFactoryRegistry {
* the identifier of the {@link FormatWriter} to instantiate.
* @param os
* the output stream.
- *
+ *
* @return the not <code>null</code> {@link FormatWriter} instance.
- *
+ *
* @throws NullPointerException
* if the <code>id</code> doesn't match any registered writer.
*
diff --git a/cli/src/main/java/org/apache/any23/cli/ExtractorDocumentation.java b/cli/src/main/java/org/apache/any23/cli/ExtractorDocumentation.java
index f0b84924..45cb85dc 100644
--- a/cli/src/main/java/org/apache/any23/cli/ExtractorDocumentation.java
+++ b/cli/src/main/java/org/apache/any23/cli/ExtractorDocumentation.java
@@ -90,7 +90,7 @@ public class ExtractorDocumentation extends BaseTool {
/**
* Prints the list of all the available extractor names, labels and supported mimetypes.
- *
+ *
* @param registry
* the {@link org.apache.any23.extractor.ExtractorRegistry} containing all extractors
*/
@@ -108,7 +108,7 @@ public class ExtractorDocumentation extends BaseTool {
* the name of the extractor
* @param registry
* the {@link org.apache.any23.extractor.ExtractorRegistry} containing all extractors
- *
+ *
* @throws IOException
* raised if no extractor is found with that name
*/
@@ -129,7 +129,7 @@ public class ExtractorDocumentation extends BaseTool {
* the extractor name
* @param registry
* the {@link org.apache.any23.extractor.ExtractorRegistry} containing all extractors
- *
+ *
* @throws IOException
* raised if no extractor is found with that name
* @throws ExtractionException
@@ -151,7 +151,7 @@ public class ExtractorDocumentation extends BaseTool {
*
* @param registry
* the {@link org.apache.any23.extractor.ExtractorRegistry} containing all extractors
- *
+ *
* @throws IOException
* raised if no extractor is found with that name
* @throws ExtractionException
diff --git a/cli/src/main/java/org/apache/any23/cli/VocabPrinter.java b/cli/src/main/java/org/apache/any23/cli/VocabPrinter.java
index 42e09128..ec6472ed 100644
--- a/cli/src/main/java/org/apache/any23/cli/VocabPrinter.java
+++ b/cli/src/main/java/org/apache/any23/cli/VocabPrinter.java
@@ -30,7 +30,7 @@ import java.io.PrintStream;
/**
* Prints out the vocabulary <i>RDFSchema</i> as <i>NQuads</i>.
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
*/
@Parameters(commandNames = {
diff --git a/cli/src/test/java/org/apache/any23/cli/ExtractorsFlowTest.java b/cli/src/test/java/org/apache/any23/cli/ExtractorsFlowTest.java
index c4b3667c..d54f2181 100644
--- a/cli/src/test/java/org/apache/any23/cli/ExtractorsFlowTest.java
+++ b/cli/src/test/java/org/apache/any23/cli/ExtractorsFlowTest.java
@@ -53,7 +53,7 @@ public class ExtractorsFlowTest extends ToolTestBase {
/**
* Emulates action described in ANY23-396.
- *
+ *
* @throws Exception
* if there is an error asserting the test data.
*/
@@ -81,7 +81,7 @@ public class ExtractorsFlowTest extends ToolTestBase {
/**
* Compare expected model and received from input File.
- *
+ *
* @throws Exception
* if there is an error asserting the test data.
*/
diff --git a/cli/src/test/java/org/apache/any23/cli/SimpleRoverTest.java b/cli/src/test/java/org/apache/any23/cli/SimpleRoverTest.java
index 09a523c9..9805e10c 100644
--- a/cli/src/test/java/org/apache/any23/cli/SimpleRoverTest.java
+++ b/cli/src/test/java/org/apache/any23/cli/SimpleRoverTest.java
@@ -57,7 +57,7 @@ public class SimpleRoverTest extends ToolTestBase {
/**
* Ref <a href="https://issues.apache.org/jira/browse/ANY23-310">ANY23-310</a> unit test.
- *
+ *
* @throws Exception
* if there is an error asserting the test data.
*/
@@ -98,11 +98,11 @@ public class SimpleRoverTest extends ToolTestBase {
/**
* Ref <a href="https://issues.apache.org/jira/browse/ANY23-310">ANY23-310</a> unit test.
- *
+ *
* Example without the logging file.
- *
+ *
* By default that test is not active. It might be useful for debugging.
- *
+ *
* @throws Exception
* if there is an error asserting the test data.
*/
diff --git a/cli/src/test/java/org/apache/any23/cli/ToolRunnerTest.java b/cli/src/test/java/org/apache/any23/cli/ToolRunnerTest.java
index fa9e9fc6..e970e485 100644
--- a/cli/src/test/java/org/apache/any23/cli/ToolRunnerTest.java
+++ b/cli/src/test/java/org/apache/any23/cli/ToolRunnerTest.java
@@ -36,7 +36,7 @@ public class ToolRunnerTest {
private final Set<Class<? extends Tool>> coreTools = new HashSet<Class<? extends Tool>>() {
/**
- *
+ *
*/
private static final long serialVersionUID = 1L;
diff --git a/cli/src/test/java/org/apache/any23/cli/ToolTestBase.java b/cli/src/test/java/org/apache/any23/cli/ToolTestBase.java
index e4ff8ac4..74ae3032 100644
--- a/cli/src/test/java/org/apache/any23/cli/ToolTestBase.java
+++ b/cli/src/test/java/org/apache/any23/cli/ToolTestBase.java
@@ -48,9 +48,9 @@ public abstract class ToolTestBase extends Any23OnlineTestBase {
*
* @param args
* tool arguments.
- *
+ *
* @return the tool exit code.
- *
+ *
* @throws Exception
* if there is an error asserting the test data.
*/
@@ -69,9 +69,9 @@ public abstract class ToolTestBase extends Any23OnlineTestBase {
*
* @param args
* args tool arguments.
- *
+ *
* @return the tool exit code.
- *
+ *
* @throws Exception
* if there is an error asserting the test data.
*/
@@ -84,7 +84,7 @@ public abstract class ToolTestBase extends Any23OnlineTestBase {
*
* @param args
* tool arguments.
- *
+ *
* @throws Exception
* if there is an error asserting the test data.
*/
diff --git a/cli/src/test/java/org/apache/any23/cli/YAMLRoverTest.java b/cli/src/test/java/org/apache/any23/cli/YAMLRoverTest.java
index 8947239e..98c5abd3 100644
--- a/cli/src/test/java/org/apache/any23/cli/YAMLRoverTest.java
+++ b/cli/src/test/java/org/apache/any23/cli/YAMLRoverTest.java
@@ -63,14 +63,14 @@ public class YAMLRoverTest extends ToolTestBase {
/**
* Asserts if file contains wanted string.
- *
+ *
* If logging level is <code>trace</code> than additionally displays file content.
- *
+ *
* @param f
* input file
* @param s
* Expected string in the file
- *
+ *
* @throws IOException
* if there is an error reading the input data.
*/
diff --git a/core/src/main/java/org/apache/any23/Any23.java b/core/src/main/java/org/apache/any23/Any23.java
index 6c0bd9c2..38de0db2 100644
--- a/core/src/main/java/org/apache/any23/Any23.java
+++ b/core/src/main/java/org/apache/any23/Any23.java
@@ -145,7 +145,7 @@ public class Any23 {
/**
* Constructor accepting {@link Configuration}.
- *
+ *
* @param configuration
* a {@link Configuration} object
*/
@@ -194,7 +194,7 @@ public class Any23 {
*
* @param httpClient
* a valid client instance.
- *
+ *
* @throws IllegalStateException
* if invoked after client has been initialized.
*/
@@ -212,7 +212,7 @@ public class Any23 {
* Returns the current {@link org.apache.any23.http.HTTPClient} implementation.
*
* @return instance of HTTPClient.
- *
+ *
* @throws IOException
* if the HTTP client has not initialized.
*/
@@ -262,9 +262,9 @@ public class Any23 {
*
* @param documentIRI
* the document <i>IRI</i>.
- *
+ *
* @return a new instance of DocumentSource.
- *
+ *
* @throws URISyntaxException
* if an error occurs while parsing the <code>documentIRI</code> as a <i>IRI</i>.
* @throws IOException
@@ -298,9 +298,9 @@ public class Any23 {
* @param encoding
* explicit encoding see <a href="http://www.iana.org/assignments/character-sets">available
* encodings</a>.
- *
+ *
* @return <code>true</code> if some extraction occurred, <code>false</code> otherwise.
- *
+ *
* @throws IOException
* if there is an error reading the {@link org.apache.any23.source.DocumentSource}
* @throws org.apache.any23.extractor.ExtractionException
@@ -332,9 +332,9 @@ public class Any23 {
* declared data encoding.
* @param outputHandler
* handler responsible for collecting of the extracted metadata.
- *
+ *
* @return <code>true</code> if some extraction occurred, <code>false</code> otherwise.
- *
+ *
* @throws IOException
* if there is an error reading the {@link org.apache.any23.source.DocumentSource}
* @throws org.apache.any23.extractor.ExtractionException
@@ -355,9 +355,9 @@ public class Any23 {
* IRI from which the raw data has been extracted.
* @param outputHandler
* handler responsible for collecting of the extracted metadata.
- *
+ *
* @return <code>true</code> if some extraction occurred, <code>false</code> otherwise.
- *
+ *
* @throws IOException
* if there is an error reading the {@link org.apache.any23.source.DocumentSource}
* @throws org.apache.any23.extractor.ExtractionException
@@ -376,9 +376,9 @@ public class Any23 {
* file containing raw data.
* @param outputHandler
* handler responsible for collecting of the extracted metadata.
- *
+ *
* @return <code>true</code> if some extraction occurred, <code>false</code> otherwise.
- *
+ *
* @throws IOException
* if there is an error reading the {@link org.apache.any23.source.DocumentSource}
* @throws org.apache.any23.extractor.ExtractionException
@@ -399,9 +399,9 @@ public class Any23 {
* the IRI from which retrieve document.
* @param outputHandler
* handler responsible for collecting of the extracted metadata.
- *
+ *
* @return <code>true</code> if some extraction occurred, <code>false</code> otherwise.
- *
+ *
* @throws IOException
* if there is an error reading the {@link org.apache.any23.source.DocumentSource}
* @throws org.apache.any23.extractor.ExtractionException
@@ -425,9 +425,9 @@ public class Any23 {
* the IRI from which retrieve document.
* @param outputHandler
* handler responsible for collecting of the extracted metadata.
- *
+ *
* @return <code>true</code> if some extraction occurred, <code>false</code> otherwise.
- *
+ *
* @throws IOException
* if there is an error reading the {@link org.apache.any23.source.DocumentSource}
* @throws org.apache.any23.extractor.ExtractionException
@@ -449,9 +449,9 @@ public class Any23 {
* @param encoding
* explicit encoding see <a href="http://www.iana.org/assignments/character-sets">available
* encodings</a>.
- *
+ *
* @return <code>true</code> if some extraction occurred, <code>false</code> otherwise.
- *
+ *
* @throws IOException
* if there is an error reading the {@link org.apache.any23.source.DocumentSource}
* @throws org.apache.any23.extractor.ExtractionException
@@ -470,9 +470,9 @@ public class Any23 {
* the input document source.
* @param outputHandler
* handler responsible for collecting of the extracted metadata.
- *
+ *
* @return <code>true</code> if some extraction occurred, <code>false</code> otherwise.
- *
+ *
* @throws IOException
* if there is an error reading the {@link org.apache.any23.source.DocumentSource}
* @throws org.apache.any23.extractor.ExtractionException
@@ -493,9 +493,9 @@ public class Any23 {
* the input document source.
* @param outputHandler
* handler responsible for collecting of the extracted metadata.
- *
+ *
* @return <code>true</code> if some extraction occurred, <code>false</code> otherwise.
- *
+ *
* @throws IOException
* if there is an error reading the {@link org.apache.any23.source.DocumentSource}
* @throws org.apache.any23.extractor.ExtractionException
diff --git a/core/src/main/java/org/apache/any23/ExtractionReport.java b/core/src/main/java/org/apache/any23/ExtractionReport.java
index e04bb5bd..b82850a1 100644
--- a/core/src/main/java/org/apache/any23/ExtractionReport.java
+++ b/core/src/main/java/org/apache/any23/ExtractionReport.java
@@ -30,7 +30,7 @@ import java.util.Map;
* This class contains some statistics and general information about an extraction.
*
* @see Any23
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
* @author Davide Palmisano (palmisano@fbk.eu)
*/
@@ -101,7 +101,7 @@ public class ExtractionReport {
/**
* @param extractorName
* name of the extractor.
- *
+ *
* @return the (unmodifiable) map of issues per extractor.
*/
public Collection<IssueReport.Issue> getExtractorIssues(String extractorName) {
diff --git a/core/src/main/java/org/apache/any23/extractor/ExtractionResultImpl.java b/core/src/main/java/org/apache/any23/extractor/ExtractionResultImpl.java
index ff040488..dd830660 100644
--- a/core/src/main/java/org/apache/any23/extractor/ExtractionResultImpl.java
+++ b/core/src/main/java/org/apache/any23/extractor/ExtractionResultImpl.java
@@ -50,7 +50,7 @@ import java.util.Set;
*
* @see org.apache.any23.writer.TripleHandler
* @see ExtractionContext
- *
+ *
* @author Richard Cyganiak (richard@cyganiak.de)
* @author Michele Mostarda (michele.mostarda@gmail.com)
*/
diff --git a/core/src/main/java/org/apache/any23/extractor/ExtractorRegistryImpl.java b/core/src/main/java/org/apache/any23/extractor/ExtractorRegistryImpl.java
index 900af543..13bbfb90 100644
--- a/core/src/main/java/org/apache/any23/extractor/ExtractorRegistryImpl.java
+++ b/core/src/main/java/org/apache/any23/extractor/ExtractorRegistryImpl.java
@@ -79,7 +79,7 @@ public class ExtractorRegistryImpl extends
*
* @param factory
* the {@link org.apache.any23.extractor.ExtractorFactory} to register
- *
+ *
* @throws IllegalArgumentException
* if trying to register a {@link ExtractorFactory} with a that already exists in the registry.
*/
@@ -90,7 +90,7 @@ public class ExtractorRegistryImpl extends
/**
* Unregisters the {@link ExtractorFactory} with the given name.
- *
+ *
* @param name
* The name of the ExtractorFactory to unregister.
*/
@@ -107,9 +107,9 @@ public class ExtractorRegistryImpl extends
*
* @param name
* of the desired factory
- *
+ *
* @return the {@link ExtractorFactory} associated to the provided name
- *
+ *
* @throws IllegalArgumentException
* if there is not a {@link ExtractorFactory} associated to the provided name.
*/
@@ -128,10 +128,10 @@ public class ExtractorRegistryImpl extends
/**
* Returns an {@link ExtractorGroup} containing the {@link ExtractorFactory} mathing the names provided as input.
- *
+ *
* @param names
* a {@link java.util.List} containing the names of the desired {@link ExtractorFactory}.
- *
+ *
* @return the extraction group.
*/
@Override
@@ -144,10 +144,10 @@ public class ExtractorRegistryImpl extends
}
/**
- *
+ *
* @param name
* of the {@link ExtractorFactory}
- *
+ *
* @return <code>true</code> if is there a {@link ExtractorFactory} associated to the provided name.
*/
@Override
diff --git a/core/src/main/java/org/apache/any23/extractor/SingleDocumentExtraction.java b/core/src/main/java/org/apache/any23/extractor/SingleDocumentExtraction.java
index a09e8fe9..18597cee 100644
--- a/core/src/main/java/org/apache/any23/extractor/SingleDocumentExtraction.java
+++ b/core/src/main/java/org/apache/any23/extractor/SingleDocumentExtraction.java
@@ -178,7 +178,7 @@ public class SingleDocumentExtraction {
*
* @param copyFactory
* local copy factory.
- *
+ *
* @see org.apache.any23.source.DocumentSource
*/
public void setLocalCopyFactory(LocalCopyFactory copyFactory) {
@@ -202,9 +202,9 @@ public class SingleDocumentExtraction {
*
* @param extractionParameters
* the parameters applied to the run execution.
- *
+ *
* @return the report generated by the extraction.
- *
+ *
* @throws ExtractionException
* if an error occurred during the data extraction.
* @throws IOException
@@ -358,7 +358,7 @@ public class SingleDocumentExtraction {
* if there is an error reading input from the document source
* @throws ExtractionException
* if there is an error duing distraction
- *
+ *
* @return the extraction report.
*/
public SingleDocumentExtractionReport run() throws IOException, ExtractionException {
@@ -369,7 +369,7 @@ public class SingleDocumentExtraction {
* Returns the detected mimetype for the given {@link org.apache.any23.source.DocumentSource}.
*
* @return string containing the detected mimetype.
- *
+ *
* @throws IOException
* if an error occurred while accessing the data.
*/
@@ -383,7 +383,7 @@ public class SingleDocumentExtraction {
* extractor.
*
* @return <code>true</code> if at least an extractor is activated, <code>false</code> otherwise.
- *
+ *
* @throws IOException
* if there is an error locating matching extractors
*/
@@ -429,7 +429,7 @@ public class SingleDocumentExtraction {
* Chech whether the given {@link org.apache.any23.source.DocumentSource} is an <b>HTML</b> document.
*
* @return <code>true</code> if the document source is an HTML document.
- *
+ *
* @throws IOException
* if an error occurs while accessing data.
*/
@@ -443,9 +443,9 @@ public class SingleDocumentExtraction {
*
* @param extractionParameters
* extraction parameters to be applied to determine the document language.
- *
+ *
* @return the document language if any, <code>null</code> otherwise.
- *
+ *
* @throws java.io.IOException
* if an error occurs during the document analysis.
* @throws org.apache.any23.validator.ValidatorException
@@ -488,19 +488,19 @@ public class SingleDocumentExtraction {
/**
* Triggers the execution of a specific {@link Extractor}.
- *
+ *
* @param extractionParameters
* the parameters used for the extraction.
* @param extractor
* the {@link Extractor} to be executed.
- *
+ *
* @throws ExtractionException
* if an error specific to an extractor happens.
* @throws IOException
* if an IO error occurs during the extraction.
- *
+ *
* @return the roots of the resources that have been extracted.
- *
+ *
* @throws org.apache.any23.validator.ValidatorException
* if an error occurs during validation.
*/
@@ -579,9 +579,9 @@ public class SingleDocumentExtraction {
*
* @param extractionParameters
* parameters to be used during extraction.
- *
+ *
* @return document report.
- *
+ *
* @throws IOException
* if an error occurs during data access.
* @throws ValidatorException
@@ -608,7 +608,7 @@ public class SingleDocumentExtraction {
/**
* Detects the encoding of the local document source input stream.
- *
+ *
* @return a valid encoding value.
*/
private String detectEncoding() {
@@ -630,7 +630,7 @@ public class SingleDocumentExtraction {
* a list of strings.
* @param candidateSub
* a list of strings.
- *
+ *
* @return <code>true</code> if <i>candidateSub</i> is a sub path of <i>list</i>, <code>false</code> otherwise.
*/
private boolean subPath(String[] list, String[] candidateSub) {
@@ -652,7 +652,7 @@ public class SingleDocumentExtraction {
* list of resource roots.
* @param context
* extraction context to produce triples.
- *
+ *
* @throws ExtractionException
*/
private void addDomainTriplesPerResourceRoots(List<ResourceRoot> resourceRoots, ExtractionContext context)
@@ -697,7 +697,7 @@ public class SingleDocumentExtraction {
* @param resourceRoots
* @param propertyPaths
* @param context
- *
+ *
* @throws TripleHandlerException
*/
private void addNestingRelationship(List<ResourceRoot> resourceRoots, List<PropertyPath> propertyPaths,
@@ -732,7 +732,7 @@ public class SingleDocumentExtraction {
* <li>triples indicating the nesting relationship among a microformat root and property paths of other nested
* microformats.</li>
* </ul>
- *
+ *
* @param resourceRoots
* list of RDF nodes representing roots of extracted microformat graphs and the corresponding HTML paths.
* @param propertyPaths
@@ -741,9 +741,9 @@ public class SingleDocumentExtraction {
* @param addDomainTriples
* @param output
* a triple handler event collector.
- *
+ *
* @return
- *
+ *
* @throws ExtractionException
*/
private ExtractionContext consolidateResources(List<ResourceRoot> resourceRoots, List<PropertyPath> propertyPaths,
@@ -780,16 +780,16 @@ public class SingleDocumentExtraction {
* <ul>
* <li>for every microformat root node a triple indicating the original Web page domain;</li>
* </ul>
- *
+ *
* @param resourceRoots
* list of RDF nodes representing roots of extracted microformat graphs and the corresponding HTML paths.
* from which such properties have been extracted.
* @param addDomainTriples
* @param output
* a triple handler event collector.
- *
+ *
* @return
- *
+ *
* @throws ExtractionException
*/
private ExtractionContext consolidateResources(List<ResourceRoot> resourceRoots, boolean addDomainTriples,
@@ -822,7 +822,7 @@ public class SingleDocumentExtraction {
* Adds metadata triples containing the number of extracted triples and the extraction timestamp.
*
* @param context
- *
+ *
* @throws TripleHandlerException
*/
private void addExtractionTimeSizeMetaTriples(ExtractionContext context) throws TripleHandlerException {
@@ -852,7 +852,7 @@ public class SingleDocumentExtraction {
/**
* Creates a nesting relationship triple.
- *
+ *
* @param from
* the property containing the nested microformat.
* @param to
@@ -861,7 +861,7 @@ public class SingleDocumentExtraction {
* the triple handler.
* @param ec
* the extraction context used to add such information.
- *
+ *
* @throws org.apache.any23.writer.TripleHandlerException
*/
private void createNestingRelationship(PropertyPath from, ResourceRoot to, TripleHandler th, ExtractionContext ec)
diff --git a/core/src/main/java/org/apache/any23/extractor/SingleDocumentExtractionReport.java b/core/src/main/java/org/apache/any23/extractor/SingleDocumentExtractionReport.java
index 0b6d52ad..85b7761e 100644
--- a/core/src/main/java/org/apache/any23/extractor/SingleDocumentExtractionReport.java
+++ b/core/src/main/java/org/apache/any23/extractor/SingleDocumentExtractionReport.java
@@ -26,7 +26,7 @@ import java.util.Map;
* This class provides the report for a {@link SingleDocumentExtraction} run.
*
* @see SingleDocumentExtraction
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
*/
public class SingleDocumentExtractionReport {
diff --git a/core/src/main/java/org/apache/any23/extractor/csv/CSVExtractor.java b/core/src/main/java/org/apache/any23/extractor/csv/CSVExtractor.java
index 3041ec0e..97a49bcf 100644
--- a/core/src/main/java/org/apache/any23/extractor/csv/CSVExtractor.java
+++ b/core/src/main/java/org/apache/any23/extractor/csv/CSVExtractor.java
@@ -47,7 +47,7 @@ import java.util.Locale;
* able uses the one provided in the <i>Any23</i> configuration.
*
* @see CSVReaderBuilder
- *
+ *
* @author Davide Palmisano ( dpalmisano@gmail.com )
*/
public class CSVExtractor implements Extractor.ContentExtractor {
@@ -108,7 +108,7 @@ public class CSVExtractor implements Extractor.ContentExtractor {
* Check whether a number is an integer.
*
* @param number
- *
+ *
* @return
*/
private boolean isInteger(String number) {
@@ -124,7 +124,7 @@ public class CSVExtractor implements Extractor.ContentExtractor {
* Check whether a number is a float.
*
* @param number
- *
+ *
* @return
*/
private boolean isFloat(String number) {
@@ -164,7 +164,7 @@ public class CSVExtractor implements Extractor.ContentExtractor {
* {@link org.apache.any23.vocab.CSV} vocabulary is used.
*
* @param header
- *
+ *
* @return an array of {@link IRI}s identifying the column names.
*/
private IRI[] processHeader(CSVRecord header, IRI documentIRI) {
diff --git a/core/src/main/java/org/apache/any23/extractor/html/DomUtils.java b/core/src/main/java/org/apache/any23/extractor/html/DomUtils.java
index 043e873b..9b423584 100644
--- a/core/src/main/java/org/apache/any23/extractor/html/DomUtils.java
+++ b/core/src/main/java/org/apache/any23/extractor/html/DomUtils.java
@@ -73,7 +73,7 @@ public class DomUtils {
*
* @param n
* the node of which returning the index.
- *
+ *
* @return a non negative number.
*/
public static int getIndexInParent(Node n) {
@@ -101,7 +101,7 @@ public class DomUtils {
*
* @param node
* the input node.
- *
+ *
* @return the XPath location of node as String.
*/
public static String getXPathForNode(Node node) {
@@ -123,7 +123,7 @@ public class DomUtils {
*
* @param n
* the node for which retrieve the path.
- *
+ *
* @return a sequence of HTML tag names.
*/
public static String[] getXPathListForNode(Node n) {
@@ -145,7 +145,7 @@ public class DomUtils {
*
* @param n
* input node.
- *
+ *
* @return an array of two elements of type
* <code>[<begin-row>, <begin-col>, <end-row> <end-col>]</code> or <code>null</code>
* if not possible to extract such data.
@@ -170,7 +170,7 @@ public class DomUtils {
* the candidate sibling node.
* @param strict
* if <code>true</code> is not allowed that the ancestor and sibling can be the same node.
- *
+ *
* @return <code>true</code> if <code>candidateSibling</code> is ancestor of <code>candidateSibling</code>,
* <code>false</code> otherwise.
*/
@@ -198,7 +198,7 @@ public class DomUtils {
* the candidate ancestor node.
* @param candidateSibling
* the candidate sibling node.
- *
+ *
* @return <code>true</code> if <code>candidateSibling</code> is ancestor of <code>candidateSibling</code>,
* <code>false</code> otherwise.
*/
@@ -209,12 +209,12 @@ public class DomUtils {
/**
* Finds all nodes that have a declared class. Note that the className is transformed to lower case before being
* matched against the DOM.
- *
+ *
* @param root
* the root node from which start searching.
* @param className
* the name of the filtered class.
- *
+ *
* @return list of matching nodes or an empty list.
*/
public static List<Node> findAllByClassName(Node root, String className) {
@@ -224,12 +224,12 @@ public class DomUtils {
/**
* Finds all nodes that have a declared attribute. Note that the className is transformed to lower case before being
* matched against the DOM.
- *
+ *
* @param root
* the root node from which start searching.
* @param attrName
* the name of the filtered attribue.
- *
+ *
* @return list of matching nodes or an empty list.
*/
public static List<Node> findAllByAttributeName(Node root, String attrName) {
@@ -250,12 +250,12 @@ public class DomUtils {
/**
* Mimics the JS DOM API, or prototype's $()
- *
+ *
* @param root
* the node to locate
* @param id
* the id of the node to locate
- *
+ *
* @return the {@link org.w3c.dom.Node} if one exists
*/
public static Node findNodeById(Node root, String id) {
@@ -271,12 +271,12 @@ public class DomUtils {
/**
* Returns a NodeList composed of all the nodes that match an XPath expression, which must be valid.
- *
+ *
* @param node
* the node object to locate
* @param xpath
* an xpath expression
- *
+ *
* @return a list of {@link org.w3c.dom.Node}'s if they exists
*/
public static List<Node> findAll(Node node, String xpath) {
@@ -297,12 +297,12 @@ public class DomUtils {
/**
* Gets the string value of an XPath expression.
- *
+ *
* @param node
* the node object to locate
* @param xpath
* an xpath expression
- *
+ *
* @return a string xpath value
*/
public static String find(Node node, String xpath) {
@@ -319,12 +319,12 @@ public class DomUtils {
/**
* Tells if an element has a class name <b>not checking the parents in the hierarchy</b> mimicking the <i>CSS</i>
* .foo match.
- *
+ *
* @param node
* the node object to locate
* @param className
* the CSS class name
- *
+ *
* @return true if the class name exists
*/
public static boolean hasClassName(Node node, String className) {
@@ -334,14 +334,14 @@ public class DomUtils {
/**
* Checks the presence of an attribute value in attributes that contain whitespace-separated lists of values. The
* semantic is the CSS classes' ones: "foo" matches "bar foo", "foo" but not "foob"
- *
+ *
* @param node
* the node object to locate
* @param attributeName
* attribute value
* @param className
* the CSS class name
- *
+ *
* @return true if the class has the attribute name
*/
public static boolean hasAttribute(Node node, String attributeName, String className) {
@@ -361,7 +361,7 @@ public class DomUtils {
* the node container.
* @param attributeName
* the name of the attribute.
- *
+ *
* @return true if the attribute is present
*/
public static boolean hasAttribute(Node node, String attributeName) {
@@ -373,7 +373,7 @@ public class DomUtils {
*
* @param target
* target node to check
- *
+ *
* @return <code>true</code> if the element the node is an element, <code>false</code> otherwise.
*/
public static boolean isElementNode(Node target) {
@@ -390,7 +390,7 @@ public class DomUtils {
* attribute name.
* @param defaultValue
* the default value to return if attribute is not found.
- *
+ *
* @return the attribute value or <code>defaultValue</code> if not found.
*/
public static String readAttribute(Node node, String attribute, String defaultValue) {
@@ -413,7 +413,7 @@ public class DomUtils {
* attribute prefix.
* @param defaultValue
* default returned value.
- *
+ *
* @return the value found or default.
*/
public static String readAttributeWithPrefix(Node node, String attributePrefix, String defaultValue) {
@@ -438,7 +438,7 @@ public class DomUtils {
* node to read the attribute.
* @param attribute
* attribute name.
- *
+ *
* @return the attribute value or <code>""</code> if not found.
*/
public static String readAttribute(Node node, String attribute) {
@@ -452,9 +452,9 @@ public class DomUtils {
* node to be serialized.
* @param indent
* if <code>true</code> the output is indented.
- *
+ *
* @return the XML serialization.
- *
+ *
* @throws TransformerException
* if an error occurs during the serializator initialization and activation.
* @throws java.io.IOException
@@ -488,7 +488,7 @@ public class DomUtils {
* name of attribute filter.
* @param attrContains
* expected content for attribute.
- *
+ *
* @return a {@link java.util.List} of {@link org.w3c.dom.Node}'s
*/
private static List<Node> findAllBy(Node root, final String tagName, final String attrName, String attrContains) {
@@ -546,10 +546,10 @@ public class DomUtils {
/**
* Given a {@link org.w3c.dom.Document} this method will return an input stream representing that document.
- *
+ *
* @param doc
* the input {@link org.w3c.dom.Document}
- *
+ *
* @return an {@link java.io.InputStream}
*/
public static InputStream documentToInputStream(Document doc) {
@@ -577,10 +577,10 @@ public class DomUtils {
/**
* Convert a w3c dom node to a InputStream
- *
+ *
* @param node
* {@link org.w3c.dom.Node} to convert
- *
+ *
* @return the converted {@link java.io.InputStream}
*/
public static InputStream nodeToInputStream(Node node) {
diff --git a/core/src/main/java/org/apache/any23/extractor/html/EmbeddedJSONLDExtractor.java b/core/src/main/java/org/apache/any23/extractor/html/EmbeddedJSONLDExtractor.java
index d3fd414b..c93608bb 100644
--- a/core/src/main/java/org/apache/any23/extractor/html/EmbeddedJSONLDExtractor.java
+++ b/core/src/main/java/org/apache/any23/extractor/html/EmbeddedJSONLDExtractor.java
@@ -93,7 +93,7 @@ public class EmbeddedJSONLDExtractor implements Extractor.TagSoupDOMExtractor {
*
* @param in
* a instance of {@link Document}.
- *
+ *
* @return the language declared, could be <code>null</code>.
*/
private String getDocumentLanguage(Document in) {
diff --git a/core/src/main/java/org/apache/any23/extractor/html/EntityBasedMicroformatExtractor.java b/core/src/main/java/org/apache/any23/extractor/html/EntityBasedMicroformatExtractor.java
index 1316bf68..6823bab2 100644
--- a/core/src/main/java/org/apache/any23/extractor/html/EntityBasedMicroformatExtractor.java
+++ b/core/src/main/java/org/apache/any23/extractor/html/EntityBasedMicroformatExtractor.java
@@ -51,9 +51,9 @@ public abstract class EntityBasedMicroformatExtractor extends MicroformatExtract
* the DOM node.
* @param out
* the extraction result collector.
- *
+ *
* @return <code>true</code> if the extraction has produces something, <code>false</code> otherwise.
- *
+ *
* @throws ExtractionException
* if there is an error during extraction
*/
@@ -78,7 +78,7 @@ public abstract class EntityBasedMicroformatExtractor extends MicroformatExtract
/**
* @param node
* a DOM node representing a blank node
- *
+ *
* @return an RDF blank node corresponding to that DOM node, by using a blank node ID like "MD5 of
* http://doc-uri/#xpath/to/node"
*/
diff --git a/core/src/main/java/org/apache/any23/extractor/html/HCardExtractor.java b/core/src/main/java/org/apache/any23/extractor/html/HCardExtractor.java
index 18b5a22c..ad6d5559 100644
--- a/core/src/main/java/org/apache/any23/extractor/html/HCardExtractor.java
+++ b/core/src/main/java/org/apache/any23/extractor/html/HCardExtractor.java
@@ -214,7 +214,7 @@ public class HCardExtractor extends EntityBasedMicroformatExtractor {
* @param className
* @param resource
* @param property
- *
+ *
* @return <code>true</code> if the multi property has been added, <code>false</code> otherwise.
*/
private boolean addStringMultiProperty(String className, Resource resource, IRI property) {
diff --git a/core/src/main/java/org/apache/any23/extractor/html/HRecipeExtractor.java b/core/src/main/java/org/apache/any23/extractor/html/HRecipeExtractor.java
index fc8d1c72..db3ce525 100644
--- a/core/src/main/java/org/apache/any23/extractor/html/HRecipeExtractor.java
+++ b/core/src/main/java/org/apache/any23/extractor/html/HRecipeExtractor.java
@@ -97,7 +97,7 @@ public class HRecipeExtractor extends EntityBasedMicroformatExtractor {
*
* @param fragment
* @param ingredient
- *
+ *
* @return
*/
private BNode addIngredient(HTMLDocument fragment, HTMLDocument.TextField ingredient) {
@@ -115,7 +115,7 @@ public class HRecipeExtractor extends EntityBasedMicroformatExtractor {
*
* @param fragment
* @param recipe
- *
+ *
* @return
*/
private void addIngredients(HTMLDocument fragment, BNode recipe) {
@@ -151,7 +151,7 @@ public class HRecipeExtractor extends EntityBasedMicroformatExtractor {
*
* @param fragment
* @param duration
- *
+ *
* @return
*/
// TODO: USE http://microformats.org/wiki/value-class-pattern to read correct date format.
@@ -181,7 +181,7 @@ public class HRecipeExtractor extends EntityBasedMicroformatExtractor {
*
* @param fragment
* @param recipe
- *
+ *
* @throws ExtractionException
*/
private void addPhoto(HTMLDocument fragment, BNode recipe) throws ExtractionException {
@@ -230,7 +230,7 @@ public class HRecipeExtractor extends EntityBasedMicroformatExtractor {
*
* @param fragment
* @param nutrition
- *
+ *
* @return
*/
private BNode addNutrition(HTMLDocument fragment, HTMLDocument.TextField nutrition) {
diff --git a/core/src/main/java/org/apache/any23/extractor/html/HReviewAggregateExtractor.java b/core/src/main/java/org/apache/any23/extractor/html/HReviewAggregateExtractor.java
index f050db6f..b8388cea 100644
--- a/core/src/main/java/org/apache/any23/extractor/html/HReviewAggregateExtractor.java
+++ b/core/src/main/java/org/apache/any23/extractor/html/HReviewAggregateExtractor.java
@@ -34,7 +34,7 @@ import org.w3c.dom.Node;
/**
* Extractor for the <a href="http://microformats.org/wiki/hreview-aggregate">hReview-aggregate</a> microformat.
- *
+ *
* @author Sebastien Richard
*/
public class HReviewAggregateExtractor extends EntityBasedMicroformatExtractor {
diff --git a/core/src/main/java/org/apache/any23/extractor/html/HReviewAggregateExtractorFactory.java b/core/src/main/java/org/apache/any23/extractor/html/HReviewAggregateExtractorFactory.java
index c72439cf..ab261339 100644
--- a/core/src/main/java/org/apache/any23/extractor/html/HReviewAggregateExtractorFactory.java
+++ b/core/src/main/java/org/apache/any23/extractor/html/HReviewAggregateExtractorFactory.java
@@ -26,7 +26,7 @@ import org.apache.any23.rdf.PopularPrefixes;
import org.apache.any23.rdf.Prefixes;
/**
- *
+ *
* @author Peter Ansell p_ansell@yahoo.com
*/
public class HReviewAggregateExtractorFactory extends SimpleExtractorFactory<HReviewAggregateExtractor>
diff --git a/core/src/main/java/org/apache/any23/extractor/html/HTMLDocument.java b/core/src/main/java/org/apache/any23/extractor/html/HTMLDocument.java
index 9a358071..78e96cce 100644
--- a/core/src/main/java/org/apache/any23/extractor/html/HTMLDocument.java
+++ b/core/src/main/java/org/apache/any23/extractor/html/HTMLDocument.java
@@ -61,7 +61,7 @@ public class HTMLDocument {
*
* @param node
* the node from which read the content.
- *
+ *
* @return a valid TextField
*/
public static TextField readTextField(Node node) {
@@ -183,7 +183,7 @@ public class HTMLDocument {
*
* @param hrefAttributeContent
* the content of the <i>href</i> attribute.
- *
+ *
* @return the rel-tag specification.
*/
public static String extractRelTag(String hrefAttributeContent) {
@@ -203,7 +203,7 @@ public class HTMLDocument {
*
* @param attributes
* the list of attributes of a node.
- *
+ *
* @return the rel-tag specification.
*/
public static String extractRelTag(NamedNodeMap attributes) {
@@ -218,7 +218,7 @@ public class HTMLDocument {
* node to read content.
* @param prettify
* if <code>true</code> blank chars will be removed.
- *
+ *
* @return the read text.
*/
public static String readNodeContent(Node node, boolean prettify) {
@@ -228,7 +228,7 @@ public class HTMLDocument {
/**
* Constructor accepting the root node.
- *
+ *
* @param document
* a {@link org.w3c.dom.Node}
*/
@@ -241,9 +241,9 @@ public class HTMLDocument {
/**
* @param uri
* string to resolve to {@link org.eclipse.rdf4j.model.IRI}
- *
+ *
* @return An absolute IRI, or null if the IRI is not fixable
- *
+ *
* @throws org.apache.any23.extractor.ExtractionException
* If the base IRI is invalid
*/
@@ -294,7 +294,7 @@ public class HTMLDocument {
*
* @param className
* name of class containing text.
- *
+ *
* @return if multiple values are found just the first is returned, if we want to check that there are no n-ary
* values use plural finder
*/
@@ -307,10 +307,10 @@ public class HTMLDocument {
/**
* Returns a plural text field.
- *
+ *
* @param className
* name of class node containing text.
- *
+ *
* @return list of fields.
*/
public TextField[] getPluralTextField(String className) {
@@ -327,7 +327,7 @@ public class HTMLDocument {
*
* @param className
* name of node class containing the URL field.
- *
+ *
* @return if multiple values are found just the first is returned, if we want to check that there are no n-ary
* values use plural finder
*/
@@ -343,7 +343,7 @@ public class HTMLDocument {
*
* @param className
* name of node class containing the URL field.
- *
+ *
* @return the list of {@link HTMLDocument.TextField} found.
*/
public TextField[] getPluralUrlField(String className) {
@@ -366,7 +366,7 @@ public class HTMLDocument {
*
* @param attribute
* the attribute name.
- *
+ *
* @return the string representing the attribute.
*/
public String readAttribute(String attribute) {
@@ -378,7 +378,7 @@ public class HTMLDocument {
*
* @param clazz
* the class name.
- *
+ *
* @return list of matching nodes.
*/
public List<Node> findAllByClassName(String clazz) {
diff --git a/core/src/main/java/org/apache/any23/extractor/html/HTMLMetaExtractor.java b/core/src/main/java/org/apache/any23/extractor/html/HTMLMetaExtractor.java
index 0d8d1ecd..83df06df 100644
--- a/core/src/main/java/org/apache/any23/extractor/html/HTMLMetaExtractor.java
+++ b/core/src/main/java/org/apache/any23/extractor/html/HTMLMetaExtractor.java
@@ -101,7 +101,7 @@ public class HTMLMetaExtractor implements Extractor.TagSoupDOMExtractor {
*
* @param in
* a instance of {@link Document}.
- *
+ *
* @return the language declared, could be <code>null</code>.
*/
private String getDocumentLanguage(Document in) {
diff --git a/core/src/main/java/org/apache/any23/extractor/html/MicroformatExtractor.java b/core/src/main/java/org/apache/any23/extractor/html/MicroformatExtractor.java
index 3ba9c1f8..532e5f11 100644
--- a/core/src/main/java/org/apache/any23/extractor/html/MicroformatExtractor.java
+++ b/core/src/main/java/org/apache/any23/extractor/html/MicroformatExtractor.java
@@ -68,9 +68,9 @@ public abstract class MicroformatExtractor implements TagSoupDOMExtractor {
* Performs the extraction of the data and writes them to the model. The nodes generated in the model can have any
* name or implicit label but if possible they <i>SHOULD</i> have names (either URIs or AnonId) that are uniquely
* derivable from their position in the DOM tree, so that multiple extractors can merge information.
- *
+ *
* @return true if extraction is successful
- *
+ *
* @throws ExtractionException
* if there is an error during extraction
*/
@@ -130,7 +130,7 @@ public abstract class MicroformatExtractor implements TagSoupDOMExtractor {
* the property IRI.
* @param value
* the property value.
- *
+ *
* @return returns <code>true</code> if the value has been accepted and added, <code>false</code> otherwise.
*/
protected boolean conditionallyAddStringProperty(Node n, Resource subject, IRI p, String value) {
@@ -151,7 +151,7 @@ public abstract class MicroformatExtractor implements TagSoupDOMExtractor {
* the property IRI.
* @param literal
* value the property value.
- *
+ *
* @return returns <code>true</code> if the literal has been accepted and added, <code>false</code> otherwise.
*/
protected boolean conditionallyAddLiteralProperty(Node n, Resource subject, IRI property, Literal literal) {
@@ -169,14 +169,14 @@ public abstract class MicroformatExtractor implements TagSoupDOMExtractor {
/**
* Helper method that adds a IRI property to a node.
- *
+ *
* @param subject
* the property subject.
* @param property
* the property IRI.
* @param uri
* the property object.
- *
+ *
* @return <code>true</code> if the the resource has been added, <code>false</code> otherwise.
*/
protected boolean conditionallyAddResourceProperty(Resource subject, IRI property, IRI uri) {
@@ -253,12 +253,12 @@ public abstract class MicroformatExtractor implements TagSoupDOMExtractor {
* This method checks if there is a native nesting relationship between two {@link MicroformatExtractor}.
*
* @see org.apache.any23.extractor.html.annotations.Includes
- *
+ *
* @param including
* the including {@link MicroformatExtractor}
* @param included
* the included {@link MicroformatExtractor}
- *
+ *
* @return <code>true</code> if there is a declared nesting relationship
*/
public static boolean includes(Class<? extends MicroformatExtractor> including,
diff --git a/core/src/main/java/org/apache/any23/extractor/html/SpanCloserInputStream.java b/core/src/main/java/org/apache/any23/extractor/html/SpanCloserInputStream.java
index bdf37269..82efd49b 100644
--- a/core/src/main/java/org/apache/any23/extractor/html/SpanCloserInputStream.java
+++ b/core/src/main/java/org/apache/any23/extractor/html/SpanCloserInputStream.java
@@ -22,13 +22,13 @@ import java.io.InputStream;
/**
* Extension of {@link java.io.InputStream} meant to detect and replace any occurrence of inline <i>span</i>:
- *
+ *
* <pre>
* <span/>
* </pre>
- *
+ *
* with an open close tag sequence:
- *
+ *
* <pre>
* <span></span>
* </pre>
diff --git a/core/src/main/java/org/apache/any23/extractor/html/SpeciesExtractor.java b/core/src/main/java/org/apache/any23/extractor/html/SpeciesExtractor.java
index 4eda43cc..3d0c3594 100644
--- a/core/src/main/java/org/apache/any23/extractor/html/SpeciesExtractor.java
+++ b/core/src/main/java/org/apache/any23/extractor/html/SpeciesExtractor.java
@@ -35,7 +35,7 @@ import org.w3c.dom.Node;
* represented using the <a href="http://www.bbc.co.uk/ontologies/wildlife/2010-02-22.shtml">BBC Wildlife Ontology</a>.
*
* @see org.apache.any23.vocab.WO
- *
+ *
* @author Davide Palmisano (dpalmisano@gmail.com)
*/
public class SpeciesExtractor extends EntityBasedMicroformatExtractor {
@@ -79,9 +79,9 @@ public class SpeciesExtractor extends EntityBasedMicroformatExtractor {
* the DOM node.
* @param out
* the extraction result collector.
- *
+ *
* @return <code>true</code> if the extraction has produces something, <code>false</code> otherwise.
- *
+ *
* @throws org.apache.any23.extractor.ExtractionException
* if there is an error during extraction
*
diff --git a/core/src/main/java/org/apache/any23/extractor/html/TagSoupParser.java b/core/src/main/java/org/apache/any23/extractor/html/TagSoupParser.java
index a741606d..4490bc01 100644
--- a/core/src/main/java/org/apache/any23/extractor/html/TagSoupParser.java
+++ b/core/src/main/java/org/apache/any23/extractor/html/TagSoupParser.java
@@ -88,7 +88,7 @@ public class TagSoupParser {
* Returns the DOM of the given document IRI.
*
* @return the <i>HTML</i> DOM.
- *
+ *
* @throws IOException
* if there is an error whilst accessing the DOM
*/
@@ -111,11 +111,11 @@ public class TagSoupParser {
*
* @param applyFix
* whether to apply fixes to the DOM
- *
+ *
* @return a report containing the <i>HTML</i> DOM that has been validated and fixed if <i>applyFix</i> if
* <code>true</code>. The reports contains also information about the activated rules and the the detected
* issues.
- *
+ *
* @throws IOException
* if there is an error accessing the DOM
* @throws org.apache.any23.validator.ValidatorException
diff --git a/core/src/main/java/org/apache/any23/extractor/html/TagSoupParsingConfiguration.java b/core/src/main/java/org/apache/any23/extractor/html/TagSoupParsingConfiguration.java
index 995db0dc..9cb15e7e 100644
--- a/core/src/main/java/org/apache/any23/extractor/html/TagSoupParsingConfiguration.java
+++ b/core/src/main/java/org/apache/any23/extractor/html/TagSoupParsingConfiguration.java
@@ -29,7 +29,7 @@ import java.io.InputStream;
/**
* The parsing configuration for a {@link TagSoupParser}
- *
+ *
* @author Hans Brende
*/
abstract class TagSoupParsingConfiguration {
diff --git a/core/src/main/java/org/apache/any23/extractor/microdata/ItemPropValue.java b/core/src/main/java/org/apache/any23/extractor/microdata/ItemPropValue.java
index 3c625159..4d65fe1e 100644
--- a/core/src/main/java/org/apache/any23/extractor/microdata/ItemPropValue.java
+++ b/core/src/main/java/org/apache/any23/extractor/microdata/ItemPropValue.java
@@ -205,7 +205,7 @@ public class ItemPropValue {
/**
* @return the content value as integer, or raises an exception.
- *
+ *
* @throws NumberFormatException
* if the content is not an integer.
* @throws ClassCastException
@@ -217,7 +217,7 @@ public class ItemPropValue {
/**
* @return the content value as float, or raises an exception.
- *
+ *
* @throws NumberFormatException
* if the content is not an float.
* @throws ClassCastException
@@ -229,7 +229,7 @@ public class ItemPropValue {
/**
* @return the content as {@link Date} if <code>type == Type.DateTime</code>,
- *
+ *
* @throws ClassCastException
* if content is not a valid date.
*/
diff --git a/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataParser.java b/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataParser.java
index f4087f6b..e6b49319 100644
--- a/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataParser.java
+++ b/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataParser.java
@@ -125,7 +125,7 @@ public class MicrodataParser {
*
* @param node
* root node to search in.
- *
+ *
* @return list of detected items.
*/
public static List<Node> getItemScopeNodes(Node node) {
@@ -137,7 +137,7 @@ public class MicrodataParser {
*
* @param node
* node to check.
- *
+ *
* @return <code>true</code> if the node is an <i>itemScope</i>., <code>false</code> otherwise.
*/
public static boolean isItemScope(Node node) {
@@ -149,7 +149,7 @@ public class MicrodataParser {
*
* @param node
* root node to search in.
- *
+ *
* @return list of detected items.
*/
public static List<Node> getItemPropNodes(Node node) {
@@ -161,7 +161,7 @@ public class MicrodataParser {
*
* @param node
* node to check.
- *
+ *
* @return <code>true</code> if the node is an <i>itemProp</i>., <code>false</code> otherwise.
*/
public static boolean isItemProp(Node node) {
@@ -194,7 +194,7 @@ public class MicrodataParser {
*
* @param node
* root node to search in.
- *
+ *
* @return list of detected top item scopes.
*/
public static List<Node> getTopLevelItemScopeNodes(Node node) {
@@ -230,9 +230,9 @@ public class MicrodataParser {
* document to be processed.
* @param errorMode
* error management policy.
- *
+ *
* @return list of <b>itemscope</b> items.
- *
+ *
* @throws MicrodataParserException
* if
* <code>errorMode == {@link org.apache.any23.extractor.microdata.MicrodataParser.ErrorMode#STOP_AT_FIRST_ERROR}</code>
@@ -256,7 +256,7 @@ public class MicrodataParser {
*
* @param document
* document to be processed.
- *
+ *
* @return list of <b>itemscope</b> items.
*/
public static MicrodataParserReport getMicrodata(Document document) {
@@ -329,9 +329,9 @@ public class MicrodataParser {
*
* @param node
* itemprop node.
- *
+ *
* @return value detected within the given <code>node</code>.
- *
+ *
* @throws MicrodataParserException
* if an error occurs while extracting a nested item scope.
*/
@@ -507,9 +507,9 @@ public class MicrodataParser {
* @param skipRoot
* if <code>true</code> the given root <code>node</code> will be not read as a property, even if it
* contains the <b>itemprop</b> attribute.
- *
+ *
* @return the list of <b>itemprop</b>s detected within the given <b>itemscope</b>.
- *
+ *
* @throws MicrodataParserException
* if an error occurs while retrieving an property value.
*/
@@ -598,12 +598,12 @@ public class MicrodataParser {
/**
* Given a document and a list of <b>itemprop</b> names this method will return such <b>itemprops</b>.
- *
+ *
* @param refs
* list of references.
- *
+ *
* @return list of retrieved <b>itemprop</b>s.
- *
+ *
* @throws MicrodataParserException
* if a loop is detected or a property name is missing.
*/
@@ -653,9 +653,9 @@ public class MicrodataParser {
*
* @param node
* node describing an <i>itemscope</i>.
- *
+ *
* @return instance of ItemScope object.
- *
+ *
* @throws MicrodataParserException
* if an error occurs while dereferencing properties.
*/
diff --git a/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataParserException.java b/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataParserException.java
index af7ac0f8..f6cd73f5 100644
--- a/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataParserException.java
+++ b/core/src/main/java/org/apache/any23/extractor/microdata/MicrodataParserException.java
@@ -26,7 +26,7 @@ import org.w3c.dom.Node;
* Defines an exception occurring while parsing <i>Microdata</i>.
*
* @see MicrodataParser
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
*/
public class MicrodataParserException extends Exception {
diff --git a/core/src/main/java/org/apache/any23/extractor/rdf/JSONLDExtractor.java b/core/src/main/java/org/apache/any23/extractor/rdf/JSONLDExtractor.java
index 585aac20..5f1d45eb 100644
--- a/core/src/main/java/org/apache/any23/extractor/rdf/JSONLDExtractor.java
+++ b/core/src/main/java/org/apache/any23/extractor/rdf/JSONLDExtractor.java
@@ -57,7 +57,7 @@ public class JSONLDExtractor extends BaseRDFExtractor {
/**
* @deprecated since 2.4. This extractor has never supported these settings. Use {@link #JSONLDExtractor()} instead.
- *
+ *
* @param verifyDataType
* has no effect
* @param stopAtFirstError
@@ -108,7 +108,7 @@ public class JSONLDExtractor extends BaseRDFExtractor {
/**
* @deprecated since 2.4. This extractor has never supported this setting. Do not use.
- *
+ *
* @param stopAtFirstError
* has no effect
*/
@@ -120,7 +120,7 @@ public class JSONLDExtractor extends BaseRDFExtractor {
/**
* @deprecated since 2.4. This extractor has never supported this setting. Do not use.
- *
+ *
* @param verifyDataType
* has no effect
*/
@@ -132,12 +132,12 @@ public class JSONLDExtractor extends BaseRDFExtractor {
/**
* @deprecated since 2.4. This extractor no longer wraps an RDF4J {@link RDFParser}. Do not use this method.
- *
+ *
* @param extractionContext
* the extraction context
* @param extractionResult
* the extraction result
- *
+ *
* @return a {@link RDFParser}
*/
@Deprecated
diff --git a/core/src/main/java/org/apache/any23/extractor/rdf/RDFParserFactory.java b/core/src/main/java/org/apache/any23/extractor/rdf/RDFParserFactory.java
index 579b2246..9a667553 100644
--- a/core/src/main/java/org/apache/any23/extractor/rdf/RDFParserFactory.java
+++ b/core/src/main/java/org/apache/any23/extractor/rdf/RDFParserFactory.java
@@ -72,7 +72,7 @@ public class RDFParserFactory {
* the extraction context where the parser is used.
* @param extractionResult
* the output extraction result.
- *
+ *
* @return a new instance of a configured Turtle parser.
*/
public RDFParser getTurtleParserInstance(final boolean verifyDataType, final boolean stopAtFirstError,
@@ -96,7 +96,7 @@ public class RDFParserFactory {
* the extraction context where the parser is used.
* @param extractionResult
* the output extraction result.
- *
+ *
* @return a new instance of a configured RDFXML parser.
*/
public RDFParser getRDFa10Parser(final boolean verifyDataType, final boolean stopAtFirstError,
@@ -118,7 +118,7 @@ public class RDFParserFactory {
* the extraction context where the parser is used.
* @param extractionResult
* the output extraction result.
- *
+ *
* @return a new instance of a configured RDFXML parser.
*/
public RDFParser getRDFa11Parser(final boolean verifyDataType, final boolean stopAtFirstError,
@@ -140,7 +140,7 @@ public class RDFParserFactory {
* the extraction context where the parser is used.
* @param extractionResult
* the output extraction result.
- *
+ *
* @return a new instance of a configured RDFXML parser.
*/
public RDFParser getRDFXMLParser(final boolean verifyDataType, final boolean stopAtFirstError,
@@ -161,7 +161,7 @@ public class RDFParserFactory {
* the extraction context where the parser is used.
* @param extractionResult
* the output extraction result.
- *
+ *
* @return a new instance of a configured NTriples parser.
*/
public RDFParser getNTriplesParser(final boolean verifyDataType, final boolean stopAtFirstError,
@@ -182,7 +182,7 @@ public class RDFParserFactory {
* the extraction context where the parser is used.
* @param extractionResult
* the output extraction result.
- *
+ *
* @return a new instance of a configured NQuads parser.
*/
public RDFParser getNQuadsParser(final boolean verifyDataType, final boolean stopAtFirstError,
@@ -203,7 +203,7 @@ public class RDFParserFactory {
* the extraction context where the parser is used.
* @param extractionResult
* the output extraction result.
- *
+ *
* @return a new instance of a configured Manchester Syntax parser.
*/
public RDFParser getManchesterSyntaxParser(final boolean verifyDataType, final boolean stopAtFirstError,
@@ -224,7 +224,7 @@ public class RDFParserFactory {
* the extraction context where the parser is used.
* @param extractionResult
* the output extraction result.
- *
+ *
* @return a new instance of a configured Functional Syntax parser.
*/
public RDFParser getFunctionalSyntaxParser(final boolean verifyDataType, final boolean stopAtFirstError,
@@ -245,7 +245,7 @@ public class RDFParserFactory {
* the extraction context where the parser is used.
* @param extractionResult
* the output extraction result.
- *
+ *
* @return a new instance of a configured TriX parser.
*/
public RDFParser getTriXParser(final boolean verifyDataType, final boolean stopAtFirstError,
@@ -257,7 +257,7 @@ public class RDFParserFactory {
/**
* Returns a new instance of a configured <i>SesameJSONLDParser</i>.
- *
+ *
* @param verifyDataType
* data verification enable if <code>true</code>.
* @param stopAtFirstError
@@ -266,7 +266,7 @@ public class RDFParserFactory {
* the extraction context where the parser is used.
* @param extractionResult
* the output extraction result.
- *
+ *
* @return a new instance of a configured JSONLDParser parser.
*/
public RDFParser getJSONLDParser(final boolean verifyDataType, final boolean stopAtFirstError,
diff --git a/core/src/main/java/org/apache/any23/extractor/rdfa/RDFa11Extractor.java b/core/src/main/java/org/apache/any23/extractor/rdfa/RDFa11Extractor.java
index 74e47146..ff5533af 100644
--- a/core/src/main/java/org/apache/any23/extractor/rdfa/RDFa11Extractor.java
+++ b/core/src/main/java/org/apache/any23/extractor/rdfa/RDFa11Extractor.java
@@ -35,7 +35,7 @@ public class RDFa11Extractor extends BaseRDFaExtractor {
/**
* @deprecated since 2.4. This extractor has never supported these settings. Use {@link #RDFa11Extractor()} instead.
- *
+ *
* @param verifyDataType
* has no effect
* @param stopAtFirstError
@@ -48,7 +48,7 @@ public class RDFa11Extractor extends BaseRDFaExtractor {
/**
* @deprecated since 2.4. This extractor has never supported this setting. Do not use.
- *
+ *
* @param stopAtFirstError
* has no effect
*/
@@ -60,7 +60,7 @@ public class RDFa11Extractor extends BaseRDFaExtractor {
/**
* @deprecated since 2.4. This extractor has never supported this setting. Do not use.
- *
+ *
* @param verifyDataType
* has no effect
*/
@@ -81,12 +81,12 @@ public class RDFa11Extractor extends BaseRDFaExtractor {
/**
* @deprecated since 2.4. This extractor no longer wraps an RDF4J {@link RDFParser}. Do not use this method.
- *
+ *
* @param extractionContext
* the extraction context
* @param extractionResult
* the extraction result
- *
+ *
* @return a {@link RDFParser}
*/
@Override
diff --git a/core/src/main/java/org/apache/any23/extractor/rdfa/RDFa11Parser.java b/core/src/main/java/org/apache/any23/extractor/rdfa/RDFa11Parser.java
index 4028ac1e..73bd5f27 100644
--- a/core/src/main/java/org/apache/any23/extractor/rdfa/RDFa11Parser.java
+++ b/core/src/main/java/org/apache/any23/extractor/rdfa/RDFa11Parser.java
@@ -47,11 +47,11 @@ import org.w3c.dom.NodeList;
/**
* This parser is able to extract <a href="http://www.w3.org/TR/rdfa-syntax/">RDFa 1.0</a> and
* <a href="http://www.w3.org/TR/rdfa-core/">RDFa 1.1</a> statements from any <i>(X)HTML</i> document.
- *
+ *
* @deprecated since 2.3 the {@link org.eclipse.rdf4j.rio.Rio} implementations are used to parse RDFa. Look at
* {@link org.apache.any23.extractor.rdf.RDFParserFactory#getRDFa10Parser} and
* {@link org.apache.any23.extractor.rdf.RDFParserFactory#getRDFa11Parser}.
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
*/
@Deprecated
@@ -130,7 +130,7 @@ public class RDFa11Parser {
*
* @param prefixesDeclaration
* input prefix
- *
+ *
* @return list of extracted prefixes.
*/
protected static String[] extractPrefixSections(String prefixesDeclaration) {
@@ -223,7 +223,7 @@ public class RDFa11Parser {
* a {@link org.apache.any23.extractor.ExtractionResult} to populate
* @param document
* the {@link org.w3c.dom.Document} to populate with parse content
- *
+ *
* @throws RDFa11ParserException
* if there is an error parsing the document
*/
@@ -321,7 +321,7 @@ public class RDFa11Parser {
*
* @param prefix
* input prefix.
- *
+ *
* @return IRI mapping.
*/
protected IRI getMapping(String prefix) {
@@ -343,9 +343,9 @@ public class RDFa11Parser {
* list of CURIE/URI.
* @param termAllowed
* determine whether the term should be whitelisted.
- *
+ *
* @return list of resolved URIs.
- *
+ *
* @throws URISyntaxException
* if there is an error processing CURIE or URL
*/
@@ -374,7 +374,7 @@ public class RDFa11Parser {
*
* @param iriStr
* (partial) IRI string to be resolved.
- *
+ *
* @return the resolved IRI.
*/
protected IRI resolveIRI(String iriStr) {
@@ -388,7 +388,7 @@ public class RDFa11Parser {
* individual of CURIE/URI to resolve
* @param termAllowed
* if <code>true</code> the resolution can be a term.
- *
+ *
* @return the resolved resource.
*/
protected Resource resolveCURIEOrIRI(String curieOrIRI, boolean termAllowed) {
@@ -555,7 +555,7 @@ public class RDFa11Parser {
*
* @param currentElement
* @param extractionResult
- *
+ *
* @throws Exception
*/
// TODO: add references to the RDFa 1.1 algorithm.
@@ -720,7 +720,7 @@ public class RDFa11Parser {
*
* @param node
* @param currentEvaluationContext
- *
+ *
* @throws URISyntaxException
*/
private void establishNewSubject(Node node, EvaluationContext currentEvaluationContext) throws URISyntaxException {
@@ -761,7 +761,7 @@ public class RDFa11Parser {
*
* @param node
* @param currentEvaluationContext
- *
+ *
* @throws URISyntaxException
*/
private void establishNewSubjectCurrentObjectResource(Node node, EvaluationContext currentEvaluationContext)
@@ -832,9 +832,9 @@ public class RDFa11Parser {
* section 7.5.11</i>.
*
* @param node
- *
+ *
* @return
- *
+ *
* @throws URISyntaxException
* @throws IOException
* @throws TransformerException
@@ -880,9 +880,9 @@ public class RDFa11Parser {
* Extracts the current typed literal from the given node. See <i>RDFa 1.0 Specification section 5.5.9.1</i>.
*
* @param node
- *
+ *
* @return
- *
+ *
* @throws URISyntaxException
*/
private Literal getAsTypedLiteral(Node node) throws URISyntaxException {
@@ -918,7 +918,7 @@ public class RDFa11Parser {
*
* @param mapping
* @param resolutionPolicy
- *
+ *
* @return
*/
private Resource resolveNamespacedIRI(String mapping, ResolutionPolicy resolutionPolicy) {
diff --git a/core/src/main/java/org/apache/any23/extractor/rdfa/RDFa11ParserException.java b/core/src/main/java/org/apache/any23/extractor/rdfa/RDFa11ParserException.java
index 543d9b54..62e613b1 100644
--- a/core/src/main/java/org/apache/any23/extractor/rdfa/RDFa11ParserException.java
+++ b/core/src/main/java/org/apache/any23/extractor/rdfa/RDFa11ParserException.java
@@ -21,7 +21,7 @@ package org.apache.any23.extractor.rdfa;
* Exception class raised by {@link RDFa11Parser}.
*
* @deprecated since 2.3 the {@link org.eclipse.rdf4j.rio.Rio} implementations are used to parse RDFa.
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
*/
@Deprecated
diff --git a/core/src/main/java/org/apache/any23/extractor/rdfa/RDFaExtractor.java b/core/src/main/java/org/apache/any23/extractor/rdfa/RDFaExtractor.java
index 390f3537..ca81c994 100644
--- a/core/src/main/java/org/apache/any23/extractor/rdfa/RDFaExtractor.java
+++ b/core/src/main/java/org/apache/any23/extractor/rdfa/RDFaExtractor.java
@@ -35,7 +35,7 @@ public class RDFaExtractor extends BaseRDFaExtractor {
/**
* @deprecated since 2.4. This extractor has never supported these settings. Use {@link #RDFaExtractor()} instead.
- *
+ *
* @param verifyDataType
* has no effect
* @param stopAtFirstError
@@ -48,7 +48,7 @@ public class RDFaExtractor extends BaseRDFaExtractor {
/**
* @deprecated since 2.4. This extractor has never supported this setting. Do not use.
- *
+ *
* @param stopAtFirstError
* has no effect
*/
@@ -60,7 +60,7 @@ public class RDFaExtractor extends BaseRDFaExtractor {
/**
* @deprecated since 2.4. This extractor has never supported this setting. Do not use.
- *
+ *
* @param verifyDataType
* has no effect
*/
@@ -81,12 +81,12 @@ public class RDFaExtractor extends BaseRDFaExtractor {
/**
* @deprecated since 2.4. This extractor no longer wraps an RDF4J {@link RDFParser}. Do not use this method.
- *
+ *
* @param extractionContext
* the extraction context
* @param extractionResult
* the extraction result
- *
+ *
* @return a {@link RDFParser}
*/
@Override
diff --git a/core/src/main/java/org/apache/any23/extractor/rdfa/XSLTStylesheet.java b/core/src/main/java/org/apache/any23/extractor/rdfa/XSLTStylesheet.java
index a5611623..50514871 100644
--- a/core/src/main/java/org/apache/any23/extractor/rdfa/XSLTStylesheet.java
+++ b/core/src/main/java/org/apache/any23/extractor/rdfa/XSLTStylesheet.java
@@ -59,12 +59,12 @@ public class XSLTStylesheet {
/**
* Applies the XSLT transformation
- *
+ *
* @param document
* where apply the transformation
* @param output
* the {@link java.io.Writer} where write on
- *
+ *
* @throws XSLTStylesheetException
* if there is an error applying the transformation
*/
@@ -74,7 +74,7 @@ public class XSLTStylesheet {
/**
* Applies the XSLT transformation
- *
+ *
* @param document
* where apply the transformation
* @param output
@@ -82,7 +82,7 @@ public class XSLTStylesheet {
* @param parameters
* the parameters to be passed to {@link Transformer}. Pass an empty {@link Map} if no parameters are
* foreseen.
- *
+ *
* @throws XSLTStylesheetException
* if there is an error applying the transformation
*/
diff --git a/core/src/main/java/org/apache/any23/extractor/rdfa/XSLTStylesheetException.java b/core/src/main/java/org/apache/any23/extractor/rdfa/XSLTStylesheetException.java
index 18e8489e..82fdb42b 100644
--- a/core/src/main/java/org/apache/any23/extractor/rdfa/XSLTStylesheetException.java
+++ b/core/src/main/java/org/apache/any23/extractor/rdfa/XSLTStylesheetException.java
@@ -21,7 +21,7 @@ package org.apache.any23.extractor.rdfa;
* Defines an exception raised by the {@link XSLTStylesheet} class.
*
* @see XSLTStylesheet
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
*/
public class XSLTStylesheetException extends Exception {
diff --git a/core/src/main/java/org/apache/any23/extractor/xpath/TemplateXPathExtractionRule.java b/core/src/main/java/org/apache/any23/extractor/xpath/TemplateXPathExtractionRule.java
index b5138e9b..40006071 100644
--- a/core/src/main/java/org/apache/any23/extractor/xpath/TemplateXPathExtractionRule.java
+++ b/core/src/main/java/org/apache/any23/extractor/xpath/TemplateXPathExtractionRule.java
@@ -42,7 +42,7 @@ public interface TemplateXPathExtractionRule extends XPathExtractionRule {
*
* @param variable
* variable to be removed.
- *
+ *
* @return <i>true</i> if the <code>variable</code> argument was found.
*/
public boolean remove(Variable variable);
@@ -60,7 +60,7 @@ public interface TemplateXPathExtractionRule extends XPathExtractionRule {
*
* @param template
* template to be removed.
- *
+ *
* @return <code>true</code> if the <code>template</code> argument was found.
*/
public boolean remove(QuadTemplate template);
diff --git a/core/src/main/java/org/apache/any23/extractor/xpath/Term.java b/core/src/main/java/org/apache/any23/extractor/xpath/Term.java
index 956d18ae..2da2a6e8 100644
--- a/core/src/main/java/org/apache/any23/extractor/xpath/Term.java
+++ b/core/src/main/java/org/apache/any23/extractor/xpath/Term.java
@@ -72,7 +72,7 @@ public abstract class Term<T extends Value> {
*
* @param varMapping
* a map representing values of variables.
- *
+ *
* @return the value for this term.
*/
public T getValue(Map<String, String> varMapping) {
diff --git a/core/src/main/java/org/apache/any23/extractor/xpath/Variable.java b/core/src/main/java/org/apache/any23/extractor/xpath/Variable.java
index 62ef716e..d9ce2007 100644
--- a/core/src/main/java/org/apache/any23/extractor/xpath/Variable.java
+++ b/core/src/main/java/org/apache/any23/extractor/xpath/Variable.java
@@ -21,7 +21,7 @@ package org.apache.any23.extractor.xpath;
* Represents a variable in {@link TemplateXPathExtractionRule}.
*
* @see TemplateXPathExtractionRule
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
*/
public class Variable {
diff --git a/core/src/main/java/org/apache/any23/extractor/xpath/XPathExtractionRule.java b/core/src/main/java/org/apache/any23/extractor/xpath/XPathExtractionRule.java
index ae08de1c..f8196d09 100644
--- a/core/src/main/java/org/apache/any23/extractor/xpath/XPathExtractionRule.java
+++ b/core/src/main/java/org/apache/any23/extractor/xpath/XPathExtractionRule.java
@@ -38,7 +38,7 @@ public interface XPathExtractionRule {
*
* @param uri
* input document IRI.
- *
+ *
* @return <code>true</code> if applied, <code>false</code> otherwise.
*/
boolean acceptIRI(IRI uri);
diff --git a/core/src/main/java/org/apache/any23/extractor/xpath/XPathExtractor.java b/core/src/main/java/org/apache/any23/extractor/xpath/XPathExtractor.java
index c090a695..045c9059 100644
--- a/core/src/main/java/org/apache/any23/extractor/xpath/XPathExtractor.java
+++ b/core/src/main/java/org/apache/any23/extractor/xpath/XPathExtractor.java
@@ -35,7 +35,7 @@ import java.util.List;
* {@link XPathExtractionRule}s and generate <i>quads</i>.
*
* @see XPathExtractionRule
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
*/
public class XPathExtractor implements Extractor.TagSoupDOMExtractor {
diff --git a/core/src/main/java/org/apache/any23/extractor/yaml/ElementsProcessor.java b/core/src/main/java/org/apache/any23/extractor/yaml/ElementsProcessor.java
index b7cb88c6..b5761e49 100644
--- a/core/src/main/java/org/apache/any23/extractor/yaml/ElementsProcessor.java
+++ b/core/src/main/java/org/apache/any23/extractor/yaml/ElementsProcessor.java
@@ -101,7 +101,7 @@ public class ElementsProcessor {
* Object (or data structure) converting to RDF graph
* @param rootNode
* root node of the graph. If not given then blank node is created.
- *
+ *
* @return instance of {@link ModelHolder},
*/
@SuppressWarnings("unchecked")
@@ -122,16 +122,16 @@ public class ElementsProcessor {
/**
* This method processes a map with non bnode root.
- *
+ *
* If a map has instantiated root (not a blank node) it is simpler to create SPARQL query.
- *
+ *
* @param ns
* the namespace to associated with statements
* @param object
* a populated {@link java.util.Map}
* @param parentNode
* a {@link org.eclipse.rdf4j.model.Value} subject node to use in the new statement
- *
+ *
* @return instance of {@link ModelHolder}.
*/
protected ModelHolder processMap(IRI ns, Map<String, Object> object, Value parentNode) {
diff --git a/core/src/main/java/org/apache/any23/http/AcceptHeaderBuilder.java b/core/src/main/java/org/apache/any23/http/AcceptHeaderBuilder.java
index 8d6f905c..9ab046a6 100644
--- a/core/src/main/java/org/apache/any23/http/AcceptHeaderBuilder.java
+++ b/core/src/main/java/org/apache/any23/http/AcceptHeaderBuilder.java
@@ -58,7 +58,7 @@ public class AcceptHeaderBuilder {
/**
* Builds and returns an accept header.
- *
+ *
* @return the accept header.
*/
public String getAcceptHeader() {
diff --git a/core/src/main/java/org/apache/any23/http/DefaultHTTPClient.java b/core/src/main/java/org/apache/any23/http/DefaultHTTPClient.java
index d5fc168d..9f13c27a 100644
--- a/core/src/main/java/org/apache/any23/http/DefaultHTTPClient.java
+++ b/core/src/main/java/org/apache/any23/http/DefaultHTTPClient.java
@@ -79,9 +79,9 @@ public class DefaultHTTPClient implements HTTPClient {
*
* @param uri
* to be opened
- *
+ *
* @return {@link java.io.InputStream}
- *
+ *
* @throws IOException
* if there is an error opening the {@link java.io.InputStream} located at the URI.
*/
diff --git a/core/src/main/java/org/apache/any23/http/HTTPClient.java b/core/src/main/java/org/apache/any23/http/HTTPClient.java
index 4ae42bd0..146477a4 100644
--- a/core/src/main/java/org/apache/any23/http/HTTPClient.java
+++ b/core/src/main/java/org/apache/any23/http/HTTPClient.java
@@ -40,9 +40,9 @@ public interface HTTPClient {
*
* @param uri
* target IRI.
- *
+ *
* @return input stream to access IRI content.
- *
+ *
* @throws IOException
* if any error occurs while reading the IRI content.
*/
diff --git a/core/src/main/java/org/apache/any23/rdf/Any23ValueFactoryWrapper.java b/core/src/main/java/org/apache/any23/rdf/Any23ValueFactoryWrapper.java
index 0adcf893..eb6e405e 100644
--- a/core/src/main/java/org/apache/any23/rdf/Any23ValueFactoryWrapper.java
+++ b/core/src/main/java/org/apache/any23/rdf/Any23ValueFactoryWrapper.java
@@ -204,7 +204,7 @@ public class Any23ValueFactoryWrapper implements ValueFactory {
/**
* @param uriStr
* input string to create URI from.
- *
+ *
* @return a valid sesame IRI or null if any exception occurred
*/
@Override
@@ -236,7 +236,7 @@ public class Any23ValueFactoryWrapper implements ValueFactory {
* A IRI, relative or absolute, can have typical syntax errors
* @param baseIRI
* A base IRI to use for resolving relative IRIs
- *
+ *
* @return An absolute IRI, sytnactically valid, or null if not fixable
*/
public IRI resolveIRI(String uri, java.net.URI baseIRI) {
@@ -251,7 +251,7 @@ public class Any23ValueFactoryWrapper implements ValueFactory {
/**
* @param iri
* IRI to fix
- *
+ *
* @return a valid sesame IRI or null if any exception occurred
*/
public IRI fixIRI(String iri) {
@@ -265,12 +265,12 @@ public class Any23ValueFactoryWrapper implements ValueFactory {
/**
* Helper method to conditionally add a schema to a URI unless it's there, or null if link is empty.
- *
+ *
* @param link
* string representation of the URI
* @param defaultSchema
* schema to add the URI
- *
+ *
* @return a valid sesame IRI or null if any exception occurred
*/
public IRI fixLink(String link, String defaultSchema) {
@@ -291,7 +291,7 @@ public class Any23ValueFactoryWrapper implements ValueFactory {
/**
* Reports an error in the most appropriate way.
- *
+ *
* @param e
* error to be reported.
*/
diff --git a/core/src/main/java/org/apache/any23/rdf/PopularPrefixes.java b/core/src/main/java/org/apache/any23/rdf/PopularPrefixes.java
index 1ba1463f..ef00ec96 100644
--- a/core/src/main/java/org/apache/any23/rdf/PopularPrefixes.java
+++ b/core/src/main/java/org/apache/any23/rdf/PopularPrefixes.java
@@ -67,7 +67,7 @@ public class PopularPrefixes {
*
* @param prefixes
* the input prefixes where perform the lookup
- *
+ *
* @return a {@link Prefixes} containing all the prefixes mathing the input parameter
*/
public static Prefixes createSubset(String... prefixes) {
@@ -86,7 +86,7 @@ public class PopularPrefixes {
*
* @param stringUri
* the string of the IRI to be checked
- *
+ *
* @return <code>true</code> if <i> stringUri</i> is a valid IRI, <code>false</code> otherwise.
*/
private static boolean testIRICompliance(String stringUri) {
diff --git a/core/src/main/java/org/apache/any23/rdf/RDFUtils.java b/core/src/main/java/org/apache/any23/rdf/RDFUtils.java
index e229d280..d72535b9 100644
--- a/core/src/main/java/org/apache/any23/rdf/RDFUtils.java
+++ b/core/src/main/java/org/apache/any23/rdf/RDFUtils.java
@@ -82,9 +82,9 @@ public class RDFUtils {
*
* @param uri
* An absolute org.eclipse.rdf4j.model.IRI, can have typical syntax errors
- *
+ *
* @return An absolute org.eclipse.rdf4j.model.IRI that is valid against the org.eclipse.rdf4j.model.IRI syntax
- *
+ *
* @throws IllegalArgumentException
* if org.eclipse.rdf4j.model.IRI is not fixable
*/
@@ -107,9 +107,9 @@ public class RDFUtils {
* the String containing the date.
* @param format
* the pattern as descibed in {@link java.text.SimpleDateFormat}
- *
+ *
* @return a {@link String} representing the date
- *
+ *
* @throws java.text.ParseException
* if there is an error parsing the given date.
* @throws javax.xml.datatype.DatatypeConfigurationException
@@ -131,7 +131,7 @@ public class RDFUtils {
*
* @param date
* date to be printed.
- *
+ *
* @return the string representation of the input date.
*/
public static String toXSDDateTime(Date date) {
@@ -153,7 +153,7 @@ public class RDFUtils {
*
* @param unescapedIRI
* uri string to be unescaped.
- *
+ *
* @return the unescaped string.
*/
public static String fixIRIWithException(String unescapedIRI) {
@@ -199,10 +199,10 @@ public class RDFUtils {
/**
* Creates a {@link org.eclipse.rdf4j.model.IRI}.
- *
+ *
* @param iri
* a base string for the {@link org.eclipse.rdf4j.model.IRI}
- *
+ *
* @return a valid {@link org.eclipse.rdf4j.model.IRI}
*/
public static org.eclipse.rdf4j.model.IRI iri(String iri) {
@@ -211,12 +211,12 @@ public class RDFUtils {
/**
* Creates a {@link org.eclipse.rdf4j.model.IRI}.
- *
+ *
* @param namespace
* a base namespace for the {@link org.eclipse.rdf4j.model.IRI}
* @param localName
* a local name to associate with the namespace
- *
+ *
* @return a valid {@link org.eclipse.rdf4j.model.IRI}
*/
public static org.eclipse.rdf4j.model.IRI iri(String namespace, String localName) {
@@ -225,10 +225,10 @@ public class RDFUtils {
/**
* Creates a {@link Literal}.
- *
+ *
* @param s
* string representation of the {@link org.eclipse.rdf4j.model.Literal}
- *
+ *
* @return valid {@link org.eclipse.rdf4j.model.Literal}
*/
public static Literal literal(String s) {
@@ -237,10 +237,10 @@ public class RDFUtils {
/**
* Creates a {@link Literal}.
- *
+ *
* @param b
* boolean representation of the {@link org.eclipse.rdf4j.model.Literal}
- *
+ *
* @return valid {@link org.eclipse.rdf4j.model.Literal}
*/
public static Literal literal(boolean b) {
@@ -249,10 +249,10 @@ public class RDFUtils {
/**
* Creates a {@link Literal}.
- *
+ *
* @param b
* byte representation of the {@link org.eclipse.rdf4j.model.Literal}
- *
+ *
* @return valid {@link org.eclipse.rdf4j.model.Literal}
*/
public static Literal literal(byte b) {
@@ -261,10 +261,10 @@ public class RDFUtils {
/**
* Creates a {@link Literal}.
- *
+ *
* @param s
* short representation of the {@link org.eclipse.rdf4j.model.Literal}
- *
+ *
* @return valid {@link org.eclipse.rdf4j.model.Literal}
*/
public static Literal literal(short s) {
@@ -273,10 +273,10 @@ public class RDFUtils {
/**
* Creates a {@link Literal}.
- *
+ *
* @param i
* int representation of the {@link org.eclipse.rdf4j.model.Literal}
- *
+ *
* @return valid {@link org.eclipse.rdf4j.model.Literal}
*/
public static Literal literal(int i) {
@@ -285,10 +285,10 @@ public class RDFUtils {
/**
* Creates a {@link Literal}.
- *
+ *
* @param l
* long representation of the {@link org.eclipse.rdf4j.model.Literal}
- *
+ *
* @return valid {@link org.eclipse.rdf4j.model.Literal}
*/
public static Literal literal(long l) {
@@ -297,10 +297,10 @@ public class RDFUtils {
/**
* Creates a {@link Literal}.
- *
+ *
* @param f
* float representation of the {@link org.eclipse.rdf4j.model.Literal}
- *
+ *
* @return valid {@link org.eclipse.rdf4j.model.Literal}
*/
public static Literal literal(float f) {
@@ -309,10 +309,10 @@ public class RDFUtils {
/**
* Creates a {@link Literal}.
- *
+ *
* @param d
* double representation of the {@link org.eclipse.rdf4j.model.Literal}
- *
+ *
* @return valid {@link org.eclipse.rdf4j.model.Literal}
*/
public static Literal literal(double d) {
@@ -321,12 +321,12 @@ public class RDFUtils {
/**
* Creates a {@link Literal}.
- *
+ *
* @param s
* the literal's label
* @param l
* the literal's language
- *
+ *
* @return valid {@link org.eclipse.rdf4j.model.Literal}
*/
public static Literal literal(String s, String l) {
@@ -340,12 +340,12 @@ public class RDFUtils {
/**
* Creates a {@link Literal}.
- *
+ *
* @param s
* the literal's label
* @param datatype
* the literal's datatype
- *
+ *
* @return valid {@link org.eclipse.rdf4j.model.Literal}
*/
public static Literal literal(String s, org.eclipse.rdf4j.model.IRI datatype) {
@@ -354,10 +354,10 @@ public class RDFUtils {
/**
* Creates a {@link BNode}.
- *
+ *
* @param id
* string representation of the {@link org.eclipse.rdf4j.model.BNode}
- *
+ *
* @return the valid {@link org.eclipse.rdf4j.model.BNode}
*/
// TODO: replace this with all occurrences of #getBNode()
@@ -374,11 +374,11 @@ public class RDFUtils {
/**
* Creates a {@link BNode} with an MD5 digest as part of the ID.
- *
+ *
* @param id
* string representation of the {@link org.eclipse.rdf4j.model.BNode} name for which we will create a md5
* hash.
- *
+ *
* @return the valid {@link org.eclipse.rdf4j.model.BNode}
*/
public static BNode getBNode(String id) {
@@ -387,14 +387,14 @@ public class RDFUtils {
/**
* Creates a {@link Statement}.
- *
+ *
* @param s
* subject {@link org.eclipse.rdf4j.model.Resource}
* @param p
* predicate {@link org.eclipse.rdf4j.model.URI}
* @param o
* object {@link org.eclipse.rdf4j.model.Value}
- *
+ *
* @return valid {@link org.eclipse.rdf4j.model.Statement}
*/
public static Statement triple(Resource s, org.eclipse.rdf4j.model.IRI p, Value o) {
@@ -410,7 +410,7 @@ public class RDFUtils {
* predicate.
* @param o
* object.
- *
+ *
* @return a statement instance.
*/
public static Statement triple(String s, String p, String o) {
@@ -420,7 +420,7 @@ public class RDFUtils {
/**
* Creates a {@link Statement}.
- *
+ *
* @param s
* subject.
* @param p
@@ -429,7 +429,7 @@ public class RDFUtils {
* object.
* @param g
* quad resource
- *
+ *
* @return a statement instance.
*/
public static Statement quad(Resource s, org.eclipse.rdf4j.model.IRI p, Value o, Resource g) {
@@ -438,7 +438,7 @@ public class RDFUtils {
/**
* Creates a statement of type: <code>toValue(s), toValue(p), toValue(o), toValue(g)</code>
- *
+ *
* @param s
* subject.
* @param p
@@ -447,7 +447,7 @@ public class RDFUtils {
* object.
* @param g
* quad resource
- *
+ *
* @return a statement instance.
*/
public static Statement quad(String s, String p, String o, String g) {
@@ -461,7 +461,7 @@ public class RDFUtils {
*
* @param s
* string representation of value.
- *
+ *
* @return a value instance.
*/
public static Value toValue(String s) {
@@ -488,9 +488,9 @@ public class RDFUtils {
*
* @param format
* parser format.
- *
+ *
* @return parser instance.
- *
+ *
* @throws IllegalArgumentException
* if format is not supported.
*/
@@ -505,9 +505,9 @@ public class RDFUtils {
* output format.
* @param writer
* data output writer.
- *
+ *
* @return writer instance.
- *
+ *
* @throws IllegalArgumentException
* if format is not supported.
*/
@@ -522,9 +522,9 @@ public class RDFUtils {
* output format.
* @param os
* output stream.
- *
+ *
* @return writer instance.
- *
+ *
* @throws IllegalArgumentException
* if format is not supported.
*/
@@ -537,9 +537,9 @@ public class RDFUtils {
*
* @param ext
* input extension.
- *
+ *
* @return parser matching the extension.
- *
+ *
* @throws IllegalArgumentException
* if no extension matches.
*/
@@ -559,9 +559,9 @@ public class RDFUtils {
* input stream containing <code>RDF</code>.
* @param baseIRI
* base uri.
- *
+ *
* @return list of statements detected within the input stream.
- *
+ *
* @throws IOException
* if there is an error reading the {@link java.io.InputStream}
*/
@@ -583,9 +583,9 @@ public class RDFUtils {
* input format type.
* @param is
* input stream containing <code>RDF</code>.
- *
+ *
* @return list of statements detected within the input stream.
- *
+ *
* @throws IOException
* if there is an error reading the {@link java.io.InputStream}
*/
@@ -601,9 +601,9 @@ public class RDFUtils {
* input format type.
* @param in
* input string containing <code>RDF</code>.
- *
+ *
* @return list of statements detected within the input string.
- *
+ *
* @throws IOException
* if there is an error reading the {@link java.io.InputStream}
*/
@@ -616,9 +616,9 @@ public class RDFUtils {
*
* @param resource
* resource name.
- *
+ *
* @return the statements declared within the resource file.
- *
+ *
* @throws java.io.IOException
* if an error occurs while reading file.
*/
@@ -636,7 +636,7 @@ public class RDFUtils {
*
* @param href
* candidate org.eclipse.rdf4j.model.IRI.
- *
+ *
* @return <code>true</code> if <code>href</code> is absolute, <code>false</code> otherwise.
*/
public static boolean isAbsoluteIRI(String href) {
@@ -655,11 +655,11 @@ public class RDFUtils {
/**
* {@link #makeIRI(java.lang.String, org.eclipse.rdf4j.model.IRI, boolean) }.
- *
+ *
* @param docUri
* It is a namespace. If it ends with '/' character than stays unchanged otherwise the hash character '#'
* is added to the end.
- *
+ *
* @return instance of {@link Resource}.
*/
public static Resource makeIRI(IRI docUri) {
@@ -668,14 +668,14 @@ public class RDFUtils {
/**
* {@link #makeIRI(java.lang.String, org.eclipse.rdf4j.model.IRI, boolean) }.
- *
+ *
* @param type
* This argument is converted following Java naming conventions with
* {@link StringUtils#implementJavaNaming(java.lang.String) }.
* @param docIRI
* It is a namespace. If it ends with '/' character than stays unchanged otherwise the hash character '#'
* is added to the end.
- *
+ *
* @return instance of {@link Resource}.
*/
public static Resource makeIRI(String type, IRI docIRI) {
@@ -684,10 +684,10 @@ public class RDFUtils {
/**
* Creates implementation of {@link Resource} from given arguments: <i>type</i> and <i>docIRI</i>.
- *
+ *
* <b>NB:</b> The Java Naming Conventions is described by
* <a href='http://www.geeksforgeeks.org/java-naming-conventions/'>GeeksForGeeks</a>.
- *
+ *
* @param type
* This argument is converted following Java naming conventions with
* {@link StringUtils#implementJavaNaming(java.lang.String) }.
@@ -697,7 +697,7 @@ public class RDFUtils {
* @param addId
* If argument is <b>TRUE</b> than the node identifier is added to the end formated
* <code>'_{int}'</code>.
- *
+ *
* @return instance of {@link Resource}.
*/
public static Resource makeIRI(String type, IRI docIRI, boolean addId) {
@@ -726,13 +726,13 @@ public class RDFUtils {
/**
* Convert string to either IRI or Literal.
- *
+ *
* If string value expresses valid IRI than {@link IRI} is created. Otherwise method creates simple {@link Literal}
* xsd:string.
- *
+ *
* @param inString
* an input string to manifest as {@link org.eclipse.rdf4j.model.Value}
- *
+ *
* @return either {@link IRI} or {@link Literal}.
*/
public static Value makeIRI(String inString) {
diff --git a/core/src/main/java/org/apache/any23/source/ByteArrayDocumentSource.java b/core/src/main/java/org/apache/any23/source/ByteArrayDocumentSource.java
index 827805d5..d5a5eb39 100644
--- a/core/src/main/java/org/apache/any23/source/ByteArrayDocumentSource.java
+++ b/core/src/main/java/org/apache/any23/source/ByteArrayDocumentSource.java
@@ -23,7 +23,7 @@ import java.io.InputStream;
/**
* ByteArray implementation of {@link DocumentSource}.
- *
+ *
* @author Richard Cyganiak (richard@cyganiak.de)
*/
public class ByteArrayDocumentSource implements DocumentSource {
diff --git a/core/src/main/java/org/apache/any23/util/DiscoveryUtils.java b/core/src/main/java/org/apache/any23/util/DiscoveryUtils.java
index 975e4077..b47ddefb 100644
--- a/core/src/main/java/org/apache/any23/util/DiscoveryUtils.java
+++ b/core/src/main/java/org/apache/any23/util/DiscoveryUtils.java
@@ -44,7 +44,7 @@ public class DiscoveryUtils {
*
* @param packageName
* the root package.
- *
+ *
* @return list of matching classes.
*/
public static List<Class> getClassesInPackage(String packageName) {
@@ -85,7 +85,7 @@ public class DiscoveryUtils {
* the root package.
* @param filter
* the interface/class filter.
- *
+ *
* @return list of matching classes.
*/
public static List<Class> getClassesInPackage(String packageName, Class<?> filter) {
@@ -112,7 +112,7 @@ public class DiscoveryUtils {
* class location.
* @param packageName
* package name.
- *
+ *
* @return list of detected classes.
*/
private static List<Class> findClasses(File location, String packageName) {
@@ -128,7 +128,7 @@ public class DiscoveryUtils {
*
* @param location
* package location.
- *
+ *
* @return list of detected classes.
*/
private static List<Class> findClassesInJAR(String location) {
@@ -177,7 +177,7 @@ public class DiscoveryUtils {
* The base directory
* @param packageName
* The package name for classes found inside the base directory
- *
+ *
* @return The classes
*/
private static List<Class> findClassesInDir(File directory, String packageName) {
diff --git a/core/src/main/java/org/apache/any23/util/FileUtils.java b/core/src/main/java/org/apache/any23/util/FileUtils.java
index dc0c2456..684e9bb0 100644
--- a/core/src/main/java/org/apache/any23/util/FileUtils.java
+++ b/core/src/main/java/org/apache/any23/util/FileUtils.java
@@ -49,7 +49,7 @@ public class FileUtils {
* file to be moved.
* @param dest
* dest dir.
- *
+ *
* @return destination file.
*/
public static File mv(File target, File dest) {
@@ -108,7 +108,7 @@ public class FileUtils {
* source file.
* @param dest
* destination file.
- *
+ *
* @throws java.io.FileNotFoundException
* if file cannot be copied or created.
*/
@@ -129,7 +129,7 @@ public class FileUtils {
* file target.
* @param content
* content to be dumped.
- *
+ *
* @throws IOException
* if there is an error dumping the content
*/
@@ -150,7 +150,7 @@ public class FileUtils {
* file to generate dump.
* @param t
* exception to be dumped.
- *
+ *
* @throws IOException
* if there is an error dumping the content
*/
@@ -169,9 +169,9 @@ public class FileUtils {
* the class to use load the resource.
* @param resource
* the resource to be load.
- *
+ *
* @return the string representing the file content.
- *
+ *
* @throws java.io.IOException
* if there is an error loading the resource
*/
@@ -184,9 +184,9 @@ public class FileUtils {
*
* @param resource
* the resource to be load.
- *
+ *
* @return the string representing the file content.
- *
+ *
* @throws java.io.IOException
* if there is an error loading the resource
*/
@@ -199,9 +199,9 @@ public class FileUtils {
*
* @param f
* the file to read.
- *
+ *
* @return the content of file.
- *
+ *
* @throws IOException
* if an error occurs while locating or accessing the file.
*/
@@ -215,9 +215,9 @@ public class FileUtils {
*
* @param f
* the file to read.
- *
+ *
* @return a not <code>null</code> array with not <code>null</code> line strings.
- *
+ *
* @throws IOException
* if an error occurs while locating or accessing the file.
*/
@@ -233,7 +233,7 @@ public class FileUtils {
* directory root.
* @param filenameFilter
* filter to be applied.
- *
+ *
* @return list of matching files.
*/
public static File[] listFilesRecursively(File dir, FilenameFilter filenameFilter) {
diff --git a/core/src/main/java/org/apache/any23/util/LogUtils.java b/core/src/main/java/org/apache/any23/util/LogUtils.java
index 00559b7c..e3fc9059 100644
--- a/core/src/main/java/org/apache/any23/util/LogUtils.java
+++ b/core/src/main/java/org/apache/any23/util/LogUtils.java
@@ -24,7 +24,7 @@ import java.lang.invoke.MethodHandles;
/**
* Provides specific application logger configuration methods.
- *
+ *
* @deprecated since 2.3. JUL is no longer used in this project.
*/
@Deprecated
diff --git a/core/src/main/java/org/apache/any23/util/ReaderInputStream.java b/core/src/main/java/org/apache/any23/util/ReaderInputStream.java
index 7a53216e..4f71e180 100644
--- a/core/src/main/java/org/apache/any23/util/ReaderInputStream.java
+++ b/core/src/main/java/org/apache/any23/util/ReaderInputStream.java
@@ -106,9 +106,9 @@ public class ReaderInputStream extends InputStream {
* the offset in the byte array
* @param len
* the length in the byte array to fill
- *
+ *
* @return the actual number read into the byte array, -1 at the end of the stream
- *
+ *
* @exception IOException
* if an error occurs
*/
@@ -158,7 +158,7 @@ public class ReaderInputStream extends InputStream {
/**
* @return the current number of bytes ready for reading
- *
+ *
* @exception IOException
* if an error occurs
*/
diff --git a/core/src/main/java/org/apache/any23/util/StreamUtils.java b/core/src/main/java/org/apache/any23/util/StreamUtils.java
index 375da6b3..0cfd8bc4 100644
--- a/core/src/main/java/org/apache/any23/util/StreamUtils.java
+++ b/core/src/main/java/org/apache/any23/util/StreamUtils.java
@@ -65,9 +65,9 @@ public class StreamUtils {
*
* @param is
* input stream.
- *
+ *
* @return list of not <code>null</code> lines.
- *
+ *
* @throws IOException
* if an error occurs while consuming the <code>is</code> stream.
*/
@@ -92,9 +92,9 @@ public class StreamUtils {
* input stream.
* @param preserveNL
* preserves new line chars.
- *
+ *
* @return the string content.
- *
+ *
* @throws IOException
* if an error occurs while consuming the <code>is</code> stream.
*/
@@ -122,9 +122,9 @@ public class StreamUtils {
*
* @param is
* input stream.
- *
+ *
* @return the string content.
- *
+ *
* @throws IOException
* if an error occurs while consuming the <code>is</code> stream.
*/
@@ -150,12 +150,12 @@ public class StreamUtils {
/**
* Converts a {@link org.w3c.dom.Document} to an {@link java.io.InputStream}
- *
+ *
* @param doc
* the {@link org.w3c.dom.Document} to convert
- *
+ *
* @return an {@link java.io.InputStream} representing the contents of the input {@link org.w3c.dom.Document}
- *
+ *
* @throws TransformerFactoryConfigurationError
* thrown when there is a problem with configuration with the Transformer Factories
* @throws TransformerConfigurationException
diff --git a/core/src/main/java/org/apache/any23/util/StringUtils.java b/core/src/main/java/org/apache/any23/util/StringUtils.java
index 435ab2cf..396c5cd1 100644
--- a/core/src/main/java/org/apache/any23/util/StringUtils.java
+++ b/core/src/main/java/org/apache/any23/util/StringUtils.java
@@ -32,7 +32,7 @@ public class StringUtils {
* string delimiter.
* @param data
* list of data to be joined.
- *
+ *
* @return the joined string.
*/
public static String join(String delimiter, String... data) {
@@ -54,7 +54,7 @@ public class StringUtils {
* container string.
* @param content
* content string.
- *
+ *
* @return occurrences count.
*/
public static int countOccurrences(String container, String content) {
@@ -75,7 +75,7 @@ public class StringUtils {
*
* @param in
* input string.
- *
+ *
* @return the number of new line chars.
*/
public static int countNL(String in) {
@@ -89,7 +89,7 @@ public class StringUtils {
* prefix to check
* @param container
* container to check against
- *
+ *
* @return <code>true</code> if <code>candidatePrefix</code> is prefix of <code>container</code>, <code>false</code>
* otherwise.
*/
@@ -115,7 +115,7 @@ public class StringUtils {
* suffix to check
* @param container
* container to check against
- *
+ *
* @return <code>true</code> if <code>candidateSuffix</code> is prefix of <code>container</code>, <code>false</code>
* otherwise.
*/
@@ -140,7 +140,7 @@ public class StringUtils {
*
* @param in
* input string.
- *
+ *
* @return unescaped output.
*/
public static String escapeDoubleQuotes(String in) {
@@ -164,7 +164,7 @@ public class StringUtils {
*
* @param in
* string to be escaped.
- *
+ *
* @return escaped string.
*/
public static String escapeAsJSONString(String in) {
@@ -178,7 +178,7 @@ public class StringUtils {
* char to be multiplied.
* @param times
* number of times.
- *
+ *
* @return the string containing the multiplied char.
*/
public static String multiply(char c, int times) {
@@ -202,7 +202,7 @@ public class StringUtils {
*
* @param in
* an input string to convert to Java code convention
- *
+ *
* @return the correctly formatter string as per Java spec.
*/
public static String implementJavaNaming(String in) {
diff --git a/core/src/main/java/org/apache/any23/util/URLUtils.java b/core/src/main/java/org/apache/any23/util/URLUtils.java
index f1f0115e..1369c8d9 100644
--- a/core/src/main/java/org/apache/any23/util/URLUtils.java
+++ b/core/src/main/java/org/apache/any23/util/URLUtils.java
@@ -34,9 +34,9 @@ public class URLUtils {
*
* @param url
* input URL.
- *
+ *
* @return <code>true</code> if the resource can be accessed, <code>false</code> otherwise.
- *
+ *
* @throws MalformedURLException
* if <code>url</code> is malformed.
*/
diff --git a/core/src/main/java/org/apache/any23/validator/DOMDocument.java b/core/src/main/java/org/apache/any23/validator/DOMDocument.java
index 44847a19..dc4b0fa5 100644
--- a/core/src/main/java/org/apache/any23/validator/DOMDocument.java
+++ b/core/src/main/java/org/apache/any23/validator/DOMDocument.java
@@ -48,7 +48,7 @@ public interface DOMDocument {
*
* @param xPath
* a valid XPath
- *
+ *
* @return a not null list of nodes.
*/
List<Node> getNodes(String xPath);
@@ -58,7 +58,7 @@ public interface DOMDocument {
*
* @param xPath
* a valid XPath.
- *
+ *
* @return a node or <code>null</code> if nothing found.
*/
Node getNode(String xPath);
@@ -80,7 +80,7 @@ public interface DOMDocument {
*
* @param attrName
* name of attribute to use for filtering.
- *
+ *
* @return a list of nodes. <i>null</i> if no matches found.
*/
List<Node> getNodesWithAttribute(String attrName);
diff --git a/core/src/main/java/org/apache/any23/validator/DefaultValidationReport.java b/core/src/main/java/org/apache/any23/validator/DefaultValidationReport.java
index 1d1709dc..24a9a431 100644
--- a/core/src/main/java/org/apache/any23/validator/DefaultValidationReport.java
+++ b/core/src/main/java/org/apache/any23/validator/DefaultValidationReport.java
@@ -21,7 +21,7 @@ import java.util.List;
/**
* Default implementation of {@link ValidationReport}.
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
*/
@XMLValidationReportSerializer.NodeName("validationReport")
diff --git a/core/src/main/java/org/apache/any23/validator/Fix.java b/core/src/main/java/org/apache/any23/validator/Fix.java
index 4d1d282d..a898bda9 100644
--- a/core/src/main/java/org/apache/any23/validator/Fix.java
+++ b/core/src/main/java/org/apache/any23/validator/Fix.java
@@ -21,7 +21,7 @@ package org.apache.any23.validator;
* This interface models a fix for an issue.
*
* @see Rule
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
* @author Davide Palmisano (palmisano@fbk.eu)
*/
diff --git a/core/src/main/java/org/apache/any23/validator/Rule.java b/core/src/main/java/org/apache/any23/validator/Rule.java
index efd98cca..19be9766 100644
--- a/core/src/main/java/org/apache/any23/validator/Rule.java
+++ b/core/src/main/java/org/apache/any23/validator/Rule.java
@@ -21,7 +21,7 @@ package org.apache.any23.validator;
* Models a rule for an issue detection.
*
* @see Fix
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
* @author Davide Palmisano (palmisano@fbk.eu)
*/
@@ -41,7 +41,7 @@ public interface Rule {
* the context used to pass data to an eventual {@link Fix}.
* @param validationReportBuilder
* the report builder used to collect rule reporting.
- *
+ *
* @return <code>true</code> if al least an issue is detected, <code>false</code> otherwise.
*/
boolean applyOn(DOMDocument document, RuleContext<?> context, ValidationReportBuilder validationReportBuilder);
diff --git a/core/src/main/java/org/apache/any23/validator/RuleContext.java b/core/src/main/java/org/apache/any23/validator/RuleContext.java
index 7651d9fb..703bcb10 100644
--- a/core/src/main/java/org/apache/any23/validator/RuleContext.java
+++ b/core/src/main/java/org/apache/any23/validator/RuleContext.java
@@ -21,7 +21,7 @@ package org.apache.any23.validator;
* This context is used to pass data from a {@link Rule} to a {@link Fix}.
*
* @see Rule
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
* @author Davide Palmisano (palmisano@fbk.eu)
*/
@@ -39,17 +39,17 @@ public interface RuleContext<T> {
/**
* Retrieves a registered object.
- *
+ *
* @param name
* rule key
- *
+ *
* @return a registered object, <code>null</code> if not found.
*/
T getData(String name);
/**
* Removes a data from the context.
- *
+ *
* @param name
* remove entry with this name
*/
diff --git a/core/src/main/java/org/apache/any23/validator/SerializationException.java b/core/src/main/java/org/apache/any23/validator/SerializationException.java
index 0fab14c2..d6394d3b 100644
--- a/core/src/main/java/org/apache/any23/validator/SerializationException.java
+++ b/core/src/main/java/org/apache/any23/validator/SerializationException.java
@@ -21,7 +21,7 @@ package org.apache.any23.validator;
* Defines an error raised from the {@link ValidationReportSerializer}.
*
* @see ValidationReportSerializer
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
*/
public class SerializationException extends Exception {
diff --git a/core/src/main/java/org/apache/any23/validator/ValidationReport.java b/core/src/main/java/org/apache/any23/validator/ValidationReport.java
index 48953e41..d9289291 100644
--- a/core/src/main/java/org/apache/any23/validator/ValidationReport.java
+++ b/core/src/main/java/org/apache/any23/validator/ValidationReport.java
@@ -29,7 +29,7 @@ import java.util.Locale;
*
* @see Validator
* @see ValidationReportBuilder
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
* @author Davide Palmisano (palmisano@fbk.eu)
*/
@@ -70,7 +70,7 @@ public interface ValidationReport extends Serializable {
class Issue implements Serializable {
/**
- *
+ *
*/
private static final long serialVersionUID = 1L;
private final IssueLevel level;
@@ -116,7 +116,7 @@ public interface ValidationReport extends Serializable {
class RuleActivation implements Serializable {
/**
- *
+ *
*/
private static final long serialVersionUID = 1L;
private final String ruleStr;
@@ -144,7 +144,7 @@ public interface ValidationReport extends Serializable {
abstract class Error implements Serializable {
/**
- *
+ *
*/
private static final long serialVersionUID = 1L;
private final Exception cause;
@@ -181,7 +181,7 @@ public interface ValidationReport extends Serializable {
class RuleError extends Error {
/**
- *
+ *
*/
private static final long serialVersionUID = 1L;
private final Rule origin;
@@ -210,7 +210,7 @@ public interface ValidationReport extends Serializable {
class FixError extends Error {
/**
- *
+ *
*/
private static final long serialVersionUID = 1L;
private final Fix origin;
diff --git a/core/src/main/java/org/apache/any23/validator/ValidationReportBuilder.java b/core/src/main/java/org/apache/any23/validator/ValidationReportBuilder.java
index 5784504e..27b00475 100644
--- a/core/src/main/java/org/apache/any23/validator/ValidationReportBuilder.java
+++ b/core/src/main/java/org/apache/any23/validator/ValidationReportBuilder.java
@@ -56,7 +56,7 @@ public interface ValidationReportBuilder {
/**
* Traces that a rule has been applied.
- *
+ *
* @param r
* activated rule.
*/
@@ -76,7 +76,7 @@ public interface ValidationReportBuilder {
/**
* Reports an error occurred while executing a {@link Fix}.
- *
+ *
* @param f
* fix originating the error.
* @param e
diff --git a/core/src/main/java/org/apache/any23/validator/ValidationReportSerializer.java b/core/src/main/java/org/apache/any23/validator/ValidationReportSerializer.java
index f9f2735b..41ee5ae9 100644
--- a/core/src/main/java/org/apache/any23/validator/ValidationReportSerializer.java
+++ b/core/src/main/java/org/apache/any23/validator/ValidationReportSerializer.java
@@ -33,7 +33,7 @@ public interface ValidationReportSerializer {
* the validation report to be serialized.
* @param os
* the output stream used to produce the serialization.
- *
+ *
* @throws SerializationException
* if there is an error serializing data
*/
diff --git a/core/src/main/java/org/apache/any23/validator/Validator.java b/core/src/main/java/org/apache/any23/validator/Validator.java
index 14d0ad44..21312803 100644
--- a/core/src/main/java/org/apache/any23/validator/Validator.java
+++ b/core/src/main/java/org/apache/any23/validator/Validator.java
@@ -38,9 +38,9 @@ public interface Validator {
* the {@link DOMDocument} instance wrapping the original <i>HTML</i> document.
* @param applyFix
* if <code>true</code> tries to fix the document.
- *
+ *
* @return a report of the detected issues.
- *
+ *
* @throws ValidatorException
* if an error occurs during the validation process.
*/
@@ -55,9 +55,9 @@ public interface Validator {
* the original <i>HTML</i> document.
* @param applyFix
* if <code>true</code> tries to fix the document.
- *
+ *
* @return a report of the detected issues.
- *
+ *
* @throws ValidatorException
* if an error occurs during the validation process.
*/
@@ -101,7 +101,7 @@ public interface Validator {
*
* @param rule
* {@link org.apache.any23.validator.Rule} to obtain fixes for.
- *
+ *
* @return a not null list of fixes.
*/
List<Class<? extends Fix>> getFixes(Class<? extends Rule> rule);
diff --git a/core/src/main/java/org/apache/any23/validator/ValidatorException.java b/core/src/main/java/org/apache/any23/validator/ValidatorException.java
index 57bf8ceb..e6632949 100644
--- a/core/src/main/java/org/apache/any23/validator/ValidatorException.java
+++ b/core/src/main/java/org/apache/any23/validator/ValidatorException.java
@@ -21,7 +21,7 @@ package org.apache.any23.validator;
* Models any exception raised by the {@link Validator}.
*
* @see Validator
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
* @author Davide Palmisano (palmisano@fbk.eu)
*/
diff --git a/core/src/main/java/org/apache/any23/validator/rule/MetaNameMisuseFix.java b/core/src/main/java/org/apache/any23/validator/rule/MetaNameMisuseFix.java
index 9dd998ad..99a08295 100644
--- a/core/src/main/java/org/apache/any23/validator/rule/MetaNameMisuseFix.java
+++ b/core/src/main/java/org/apache/any23/validator/rule/MetaNameMisuseFix.java
@@ -29,7 +29,7 @@ import java.util.List;
* Fixes the misuse of the meta name attribute.
*
* @see MetaNameMisuseRule
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
* @author Davide Palmisano (palmisano@fbk.eu)
*/
diff --git a/core/src/main/java/org/apache/any23/validator/rule/MetaNameMisuseRule.java b/core/src/main/java/org/apache/any23/validator/rule/MetaNameMisuseRule.java
index 5484532d..15c1ce8f 100644
--- a/core/src/main/java/org/apache/any23/validator/rule/MetaNameMisuseRule.java
+++ b/core/src/main/java/org/apache/any23/validator/rule/MetaNameMisuseRule.java
@@ -31,7 +31,7 @@ import java.util.List;
* Checks whether the meta attribute name is used to contain a property.
*
* @see MetaNameMisuseFix
- *
+ *
* @author Davide Palmisano (palmisano@fbk.eu)
* @author Michele Mostarda (mostarda@fbk.eu)
*/
diff --git a/core/src/main/java/org/apache/any23/validator/rule/MissingItemscopeAttributeValueRule.java b/core/src/main/java/org/apache/any23/validator/rule/MissingItemscopeAttributeValueRule.java
index 43bad898..aa4d4651 100644
--- a/core/src/main/java/org/apache/any23/validator/rule/MissingItemscopeAttributeValueRule.java
+++ b/core/src/main/java/org/apache/any23/validator/rule/MissingItemscopeAttributeValueRule.java
@@ -30,13 +30,13 @@ import org.w3c.dom.Node;
* This fixes missing attribute values for the 'itemscope' attribute Typically when such a snippet of XHTML is fed
* through the {@link org.apache.any23.extractor.rdfa.RDFa11Extractor}, and subsequently to Sesame's SesameRDFaParser,
* it will result in the following behavior.
- *
+ *
* <pre>
* {@code
* [Fatal Error] :23:15: Attribute name "itemscope" associated with an element type "div" must be followed by the ' = ' character.
* }
* </pre>
- *
+ *
* This Rule identifies that happening.
*
*/
diff --git a/core/src/main/java/org/apache/any23/validator/rule/MissingOpenGraphNamespaceRule.java b/core/src/main/java/org/apache/any23/validator/rule/MissingOpenGraphNamespaceRule.java
index cdd81198..049355c4 100644
--- a/core/src/main/java/org/apache/any23/validator/rule/MissingOpenGraphNamespaceRule.java
+++ b/core/src/main/java/org/apache/any23/validator/rule/MissingOpenGraphNamespaceRule.java
@@ -30,7 +30,7 @@ import java.util.List;
* This rule detects the issue of missing Open Graph namespace.
*
* @see OpenGraphNamespaceFix
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
* @author Davide Palmisano (palmisano@fbk.eu)
*/
diff --git a/core/src/main/java/org/apache/any23/validator/rule/OpenGraphNamespaceFix.java b/core/src/main/java/org/apache/any23/validator/rule/OpenGraphNamespaceFix.java
index 27d33232..600da6da 100644
--- a/core/src/main/java/org/apache/any23/validator/rule/OpenGraphNamespaceFix.java
+++ b/core/src/main/java/org/apache/any23/validator/rule/OpenGraphNamespaceFix.java
@@ -27,7 +27,7 @@ import org.apache.any23.vocab.OGP;
* This fixes the missing <i>Open Graph</i> protocol.
*
* @see MissingOpenGraphNamespaceRule
- *
+ *
* @author Michele Mostarda (mostarda@fbk.eu)
* @author Davide Palmisano (palmisano@fbk.eu)
*/
diff --git a/core/src/main/java/org/apache/any23/vocab/RDFSchemaUtils.java b/core/src/main/java/org/apache/any23/vocab/RDFSchemaUtils.java
index 7ad546bb..a2d60ca5 100644
--- a/core/src/main/java/org/apache/any23/vocab/RDFSchemaUtils.java
+++ b/core/src/main/java/org/apache/any23/vocab/RDFSchemaUtils.java
@@ -61,7 +61,7 @@ public class RDFSchemaUtils {
* map of resource comments.
* @param writer
* writer to print out the RDF Schema triples.
- *
+ *
* @throws RDFHandlerException
* if there is an error handling the RDF
*/
@@ -92,7 +92,7 @@ public class RDFSchemaUtils {
* vocabulary to be serialized.
* @param writer
* output writer.
- *
+ *
* @throws RDFHandlerException
* if there is an error handling the RDF
*/
@@ -112,7 +112,7 @@ public class RDFSchemaUtils {
* if <code>true</code> another vocab will be printed in the same stream.
* @param ps
* output stream.
- *
+ *
* @throws RDFHandlerException
* if there is an error handling the RDF
*/
@@ -138,9 +138,9 @@ public class RDFSchemaUtils {
* vocabulary to be serialized.
* @param format
* output format for vocabulary.
- *
+ *
* @return string contained serialization.
- *
+ *
* @throws RDFHandlerException
* if there is an error handling the RDF
*/
diff --git a/core/src/main/java/org/apache/any23/writer/BenchmarkTripleHandler.java b/core/src/main/java/org/apache/any23/writer/BenchmarkTripleHandler.java
index 3e777634..e5478821 100644
--- a/core/src/main/java/org/apache/any23/writer/BenchmarkTripleHandler.java
+++ b/core/src/main/java/org/apache/any23/writer/BenchmarkTripleHandler.java
@@ -44,7 +44,7 @@ public class BenchmarkTripleHandler implements TripleHandler {
/**
* Constructor.
- *
+ *
* @param tripleHandler
* a configured {@link org.apache.any23.writer.TripleHandler}
*/
diff --git a/core/src/main/java/org/apache/any23/writer/CompositeTripleHandler.java b/core/src/main/java/org/apache/any23/writer/CompositeTripleHandler.java
index 793d0c56..f6a1ffa1 100644
--- a/core/src/main/java/org/apache/any23/writer/CompositeTripleHandler.java
+++ b/core/src/main/java/org/apache/any23/writer/CompositeTripleHandler.java
@@ -45,7 +45,7 @@ public class CompositeTripleHandler implements TripleHandler {
/**
* Constructor with initial list of decorated handlers.
- *
+ *
* @param children
* list of decorated handlers.
*/
diff --git a/core/src/main/java/org/apache/any23/writer/JSONWriterFactory.java b/core/src/main/java/org/apache/any23/writer/JSONWriterFactory.java
index f290ea63..074a46cd 100644
--- a/core/src/main/java/org/apache/any23/writer/JSONWriterFactory.java
+++ b/core/src/main/java/org/apache/any23/writer/JSONWriterFactory.java
@@ -39,7 +39,7 @@ public class JSONWriterFactory implements TripleWriterFactory {
StandardCharsets.UTF_8, Collections.emptySet(), null, TripleFormat.QUADS);
/**
- *
+ *
*/
public JSONWriterFactory() {
}
diff --git a/core/src/main/java/org/apache/any23/writer/NQuadsWriterFactory.java b/core/src/main/java/org/apache/any23/writer/NQuadsWriterFactory.java
index 767f2ae9..31cff95a 100644
--- a/core/src/main/java/org/apache/any23/writer/NQuadsWriterFactory.java
+++ b/core/src/main/java/org/apache/any23/writer/NQuadsWriterFactory.java
@@ -31,7 +31,7 @@ public class NQuadsWriterFactory implements TripleWriterFactory {
public static final String IDENTIFIER = "nquads";
/**
- *
+ *
*/
public NQuadsWriterFactory() {
}
diff --git a/core/src/main/java/org/apache/any23/writer/NTriplesWriter.java b/core/src/main/java/org/apache/any23/writer/NTriplesWriter.java
index b12bf667..8e5b612b 100644
--- a/core/src/main/java/org/apache/any23/writer/NTriplesWriter.java
+++ b/core/src/main/java/org/apache/any23/writer/NTriplesWriter.java
@@ -25,7 +25,7 @@ import java.io.OutputStream;
/**
* Implementation of an <i>N-Triples</i> {@link TripleWriter}.
- *
+ *
* @author Hans Brende (hansbrende@apache.org)
*/
public class NTriplesWriter extends RDFWriterTripleHandler {
diff --git a/core/src/main/java/org/apache/any23/writer/NTriplesWriterFactory.java b/core/src/main/java/org/apache/any23/writer/NTriplesWriterFactory.java
index a6313471..2026545f 100644
--- a/core/src/main/java/org/apache/any23/writer/NTriplesWriterFactory.java
+++ b/core/src/main/java/org/apache/any23/writer/NTriplesWriterFactory.java
@@ -31,7 +31,7 @@ public class NTriplesWriterFactory implements TripleWriterFactory {
public static final String IDENTIFIER = "ntriples";
/**
- *
+ *
*/
public NTriplesWriterFactory() {
}
diff --git a/core/src/main/java/org/apache/any23/writer/RDFXMLWriter.java b/core/src/main/java/org/apache/any23/writer/RDFXMLWriter.java
index 82ff2edf..d1ad3760 100644
--- a/core/src/main/java/org/apache/any23/writer/RDFXMLWriter.java
+++ b/core/src/main/java/org/apache/any23/writer/RDFXMLWriter.java
@@ -24,7 +24,7 @@ import java.io.OutputStream;
/**
* <i>RDF/XML</i> {@link TripleWriter} implementation.
- *
+ *
* @author Hans Brende (hansbrende@apache.org)
*/
public class RDFXMLWriter extends RDFWriterTripleHandler {
diff --git a/core/src/main/java/org/apache/any23/writer/RDFXMLWriterFactory.java b/core/src/main/java/org/apache/any23/writer/RDFXMLWriterFactory.java
index a3dceb61..67f97123 100644
--- a/core/src/main/java/org/apache/any23/writer/RDFXMLWriterFactory.java
+++ b/core/src/main/java/org/apache/any23/writer/RDFXMLWriterFactory.java
@@ -31,7 +31,7 @@ public class RDFXMLWriterFactory implements TripleWriterFactory {
public static final String IDENTIFIER = "rdfxml";
/**
- *
+ *
*/
public RDFXMLWriterFactory() {
}
diff --git a/core/src/main/java/org/apache/any23/writer/TriXWriterFactory.java b/core/src/main/java/org/apache/any23/writer/TriXWriterFactory.java
index 09fbfb8a..ce9dbf09 100644
--- a/core/src/main/java/org/apache/any23/writer/TriXWriterFactory.java
+++ b/core/src/main/java/org/apache/any23/writer/TriXWriterFactory.java
@@ -31,7 +31,7 @@ public class TriXWriterFactory implements TripleWriterFactory {
public static final String IDENTIFIER = "trix";
/**
- *
+ *
*/
public TriXWriterFactory() {
}
diff --git a/core/src/main/java/org/apache/any23/writer/TripleWriterHandler.java b/core/src/main/java/org/apache/any23/writer/TripleWriterHandler.java
index 8b995c92..8d4121ea 100644
--- a/core/src/main/java/org/apache/any23/writer/TripleWriterHandler.java
+++ b/core/src/main/java/org/apache/any23/writer/TripleWriterHandler.java
@@ -31,11 +31,11 @@ public abstract class TripleWriterHandler implements TripleHandler, TripleWriter
/**
* Writers may override this method to handle a "receiveTriple" extraction event. The default implementation calls:
- *
+ *
* <pre>
* {@code this.writeTriple(s, p, o, context == null || g != null ? g : context.getDocumentIRI())}
* </pre>
- *
+ *
* @param s
* the subject received
* @param p
@@ -46,7 +46,7 @@ public abstract class TripleWriterHandler implements TripleHandler, TripleWriter
* the graph name received, or null
* @param context
* the extraction context
- *
+ *
* @throws TripleHandlerException
* if there was an error responding to a received triple
*/
@@ -59,18 +59,18 @@ public abstract class TripleWriterHandler implements TripleHandler, TripleWriter
/**
* Writers may override this method to handle a "receiveNamespace" extraction event. The default implementation
* calls:
- *
+ *
* <pre>
* {@code this.writeNamespace(prefix, uri)}
* </pre>
- *
+ *
* @param prefix
* namespace prefix.
* @param uri
* namespace <i>IRI</i>.
* @param context
* the extraction context
- *
+ *
* @throws TripleHandlerException
* if there was an error responding to the received namepsace.
*/
@@ -82,10 +82,10 @@ public abstract class TripleWriterHandler implements TripleHandler, TripleWriter
/**
* Writers may override this method to handle a "startDocument" extraction event. The default implementation does
* nothing.
- *
+ *
* @param documentIRI
* the name of the document that was started
- *
+ *
* @throws TripleHandlerException
* if an error occurred while responding to a "startDocument" extraction event.
*/
@@ -96,10 +96,10 @@ public abstract class TripleWriterHandler implements TripleHandler, TripleWriter
/**
* Writers may override this method to handle an "openContext" extraction event. The default implementation does
* nothing.
- *
+ *
* @param context
* the context that was opened
- *
+ *
* @throws TripleHandlerException
* if an error occurred while responding to a "startDocument" extraction event.
*/
@@ -110,10 +110,10 @@ public abstract class TripleWriterHandler implements TripleHandler, TripleWriter
/**
* Writers may override this method to handle a "closeContext" extraction event. The default implementation does
* nothing.
- *
+ *
* @param context
* the context to be closed.
- *
+ *
* @throws TripleHandlerException
* if an error occurred while responding to a "closeContext" extraction event.
*/
@@ -124,10 +124,10 @@ public abstract class TripleWriterHandler implements TripleHandler, TripleWriter
/**
* Writers may override this method to handle an "endDocument" extraction event. The default implementation does
* nothing.
- *
+ *
* @param documentIRI
* the document IRI.
- *
+ *
* @throws TripleHandlerException
* if an error occurred while responding to a "endDocument" extraction event.
*/
@@ -138,7 +138,7 @@ public abstract class TripleWriterHandler implements TripleHandler, TripleWriter
/**
* Writers may override this method to handle a "setContentLength" extraction event. The default implementation does
* nothing.
- *
+ *
* @param contentLength
* length of the content being processed.
*/
diff --git a/core/src/main/java/org/apache/any23/writer/TurtleWriter.java b/core/src/main/java/org/apache/any23/writer/TurtleWriter.java
index d1cc9fe5..099fd238 100644
--- a/core/src/main/java/org/apache/any23/writer/TurtleWriter.java
+++ b/core/src/main/java/org/apache/any23/writer/TurtleWriter.java
@@ -29,7 +29,7 @@ import java.net.URISyntaxException;
/**
* <i>N3</i> notation {@link TripleWriter} implementation.
- *
+ *
* @author Hans Brende (hansbrende@apache.org)
*/
public class TurtleWriter extends RDFWriterTripleHandler {
diff --git a/core/src/main/java/org/apache/any23/writer/TurtleWriterFactory.java b/core/src/main/java/org/apache/any23/writer/TurtleWriterFactory.java
index a0db9854..a01c4657 100644
--- a/core/src/main/java/org/apache/any23/writer/TurtleWriterFactory.java
+++ b/core/src/main/java/org/apache/any23/writer/TurtleWriterFactory.java
@@ -31,7 +31,7 @@ public class TurtleWriterFactory implements TripleWriterFactory {
public static final String IDENTIFIER = "turtle";
/**
- *
+ *
*/
public TurtleWriterFactory() {
}
diff --git a/core/src/main/java/org/apache/any23/writer/URIListWriter.java b/core/src/main/java/org/apache/any23/writer/URIListWriter.java
index ada2f9c1..237884ba 100644
--- a/core/src/main/java/org/apache/any23/writer/URIListWriter.java
+++ b/core/src/main/java/org/apache/any23/writer/URIListWriter.java
@@ -33,7 +33,7 @@ import java.util.TreeSet;
/**
* This writer simply produces a list of unique <i>IRI</i> present in the subject or in the object of every single
* extracted <i>RDF Statement</i>.
- *
+ *
* @author Davide Palmisano (palmisano@fbk.eu)
* @author Hans Brende (hansbrende@apache.org)
*/
diff --git a/core/src/main/java/org/apache/any23/writer/URIListWriterFactory.java b/core/src/main/java/org/apache/any23/writer/URIListWriterFactory.java
index 0fa008af..425c3e57 100644
--- a/core/src/main/java/org/apache/any23/writer/URIListWriterFactory.java
+++ b/core/src/main/java/org/apache/any23/writer/URIListWriterFactory.java
@@ -31,7 +31,7 @@ public class URIListWriterFactory implements TripleWriterFactory {
public static final String IDENTIFIER = "uri";
/**
- *
+ *
*/
public URIListWriterFactory() {
}
diff --git a/core/src/test/java/org/apache/any23/AbstractAny23TestBase.java b/core/src/test/java/org/apache/any23/AbstractAny23TestBase.java
index c7a0c7e4..d6233958 100644
--- a/core/src/test/java/org/apache/any23/AbstractAny23TestBase.java
+++ b/core/src/test/java/org/apache/any23/AbstractAny23TestBase.java
@@ -4,9 +4,9 @@
* copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance with the License. You may obtain a
* copy of the License at
- *
+ *
* http://www.apache.org/licenses/LICENSE-2.0
- *
+ *
* Unless required by applicable law or agreed to in writing, software distributed under the License
* is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
* or implied. See the License for the specific language governing permissions and limitations under
@@ -32,7 +32,7 @@ import org.junit.rules.TemporaryFolder;
/**
* This file encapsulates access to test resource files using temporary files that are automatically cleaned up by JUnit
* after each test.
- *
+ *
* @author Peter Ansell p_ansell@yahoo.com
*/
public class AbstractAny23TestBase {
@@ -61,13 +61,13 @@ public class AbstractAny23TestBase {
/**
* Copies a resource to a temporary directory and returns a file handle that can be used to access the resource as a
* file from the temp directory.
- *
+ *
* @param resourceLocation
* The absolute location of the resource in the classpath, which can be used with
* this.getClass().getResourceAsStream.
- *
+ *
* @return temporary {@link java.io.File}
- *
+ *
* @throws FileNotFoundException
* if the temp file location cannot be converted to a {@link java.io.FileOutputStream}
* @throws IOException
diff --git a/core/src/test/java/org/apache/any23/Any23Test.java b/core/src/test/java/org/apache/any23/Any23Test.java
index 1bdd12e9..34290ab9 100644
--- a/core/src/test/java/org/apache/any23/Any23Test.java
+++ b/core/src/test/java/org/apache/any23/Any23Test.java
@@ -74,7 +74,7 @@ import static org.apache.any23.extractor.ExtractionParameters.ValidationMode;
/**
* Test case for {@link Any23} facade.
- *
+ *
* @author Davide Palmisano ( dpalmisano@gmail.com )
* @author Michele Mostarda ( michele.mostarda@gmail.com )
*/
@@ -110,7 +110,7 @@ public class Any23Test extends Any23OnlineTestBase {
/**
* This tests the behavior of <i>Any23</i> to execute the extraction explicitly specifying the charset encoding of
* the input.
- *
+ *
* @throws Exception
* if there is an error reading the input
*/
@@ -122,7 +122,7 @@ public class Any23Test extends Any23OnlineTestBase {
/**
* This tests the behavior of <i>Any23</i> to perform the extraction without passing it any charset encoding. The
* encoding is therefore guessed using {@link org.apache.any23.encoding.TikaEncodingDetector} class.
- *
+ *
* @throws Exception
* if there is an error reading the input
*/
@@ -160,7 +160,7 @@ public class Any23Test extends Any23OnlineTestBase {
/**
* Tests out the first code snipped used in <i>Developer Manual</i>.
- *
+ *
* @throws Exception
* if there is an error reading the input
*/
@@ -191,7 +191,7 @@ public class Any23Test extends Any23OnlineTestBase {
/**
* Tests out the second code snipped used in <i>Developer Manual</i>.
- *
+ *
* @throws Exception
* if there is an error reading the input
*/
@@ -230,7 +230,7 @@ public class Any23Test extends Any23OnlineTestBase {
* This test checks the extraction behavior when the library is used programatically. This test is related to the
* issue #45, to verify the different behaviors between Maven and Ant. The behavior was related to a 2nd-level
* dependency introduced by Maven.
- *
+ *
* @throws org.apache.any23.extractor.ExtractionException
* if there is an error running extraction logic
* @throws IOException
@@ -277,7 +277,7 @@ public class Any23Test extends Any23OnlineTestBase {
/**
* This test checks if a URL that is supposed to be GZIPPED is correctly opened and parsed with the {@link Any23}
* facade.
- *
+ *
* @throws org.apache.any23.extractor.ExtractionException
* if there is an error running extraction logic
* @throws IOException
@@ -384,7 +384,7 @@ public class Any23Test extends Any23OnlineTestBase {
/**
* Test correct management of general <i>XML</i> content.
- *
+ *
* @throws org.apache.any23.extractor.ExtractionException
* if there is an error running extraction logic
* @throws IOException
@@ -406,7 +406,7 @@ public class Any23Test extends Any23OnlineTestBase {
/**
* Test correct management of general <i>XML</i> content from <i>URL</i> source.
- *
+ *
* @throws org.apache.any23.extractor.ExtractionException
* if there is an error running extraction logic
* @throws IOException
@@ -525,7 +525,7 @@ public class Any23Test extends Any23OnlineTestBase {
* {@link org.apache.any23.extractor.SingleDocumentExtraction#run(ExtractionParameters)} will ultimately filter the
* extractors based upon the detected mimetype. This results in no available extractors and a largely empty
* {@link ExtractionReport}.
- *
+ *
* @throws Exception
* if a extraction anomaly arises
*/
@@ -546,12 +546,12 @@ public class Any23Test extends Any23OnlineTestBase {
/**
* Performs detection and extraction on the given input string and return the {@link ExtractionReport}.
- *
+ *
* @param in
* input string.
- *
+ *
* @return a populated {@link org.apache.any23.ExtractionReport}
- *
+ *
* @throws Exception
* if there is an error detecting mime type and running extraction
*/
@@ -567,10 +567,10 @@ public class Any23Test extends Any23OnlineTestBase {
/**
* Asserts that a list an {@link Extractor} has been activated for the given input data.
- *
+ *
* @param in
* input data as string.
- *
+ *
* @throws IOException
* @throws ExtractionException
*/
@@ -582,11 +582,11 @@ public class Any23Test extends Any23OnlineTestBase {
/**
* Assert the correct activation of the given list of {@link Extractor}s for the given input string.
- *
+ *
* @param in
* input data as string.
* @param expectedExtractors
- *
+ *
* @throws IOException
* @throws ExtractionException
*/
@@ -604,12 +604,12 @@ public class Any23Test extends Any23OnlineTestBase {
/**
* Asserts the correct encoding detection for a specified data.
- *
+ *
* @param encoding
* the expected specified encoding, if <code>null</code> will be auto detected.
* @param input
* @param expectedContent
- *
+ *
* @throws Exception
*/
private void assertEncodingDetection(String encoding, String input, String expectedContent) throws Exception {
@@ -650,10 +650,10 @@ public class Any23Test extends Any23OnlineTestBase {
/**
* Will try to detect the <i>content</i> trying sequentially with all specified parser.
- *
+ *
* @param content
* @param parsers
- *
+ *
* @throws Exception
*/
private void assertDetection(String content, String... parsers) throws Exception {
diff --git a/core/src/test/java/org/apache/any23/extractor/ExtractionResultImplTest.java b/core/src/test/java/org/apache/any23/extractor/ExtractionResultImplTest.java
index 55c5b749..47547e4b 100644
--- a/core/src/test/java/org/apache/any23/extractor/ExtractionResultImplTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/ExtractionResultImplTest.java
@@ -38,7 +38,7 @@ import java.util.Locale;
* Test case for {@link ExtractionResultImpl} class.
*
* @author Michele Mostarda ( michele.mostarda@gmail.com )
- *
+ *
* @version $Id$
*/
public class ExtractionResultImplTest {
diff --git a/core/src/test/java/org/apache/any23/extractor/SingleDocumentExtractionTest.java b/core/src/test/java/org/apache/any23/extractor/SingleDocumentExtractionTest.java
index 64955712..2fd7f7cd 100644
--- a/core/src/test/java/org/apache/any23/extractor/SingleDocumentExtractionTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/SingleDocumentExtractionTest.java
@@ -164,7 +164,7 @@ public class SingleDocumentExtractionTest extends AbstractAny23TestBase {
* {@link org.apache.any23.extractor.html.AdrExtractor}.
*
* @see org.apache.any23.extractor.html.annotations.Includes
- *
+ *
* @throws IOException
* if there is an error loading input data
* @throws ExtractionException
@@ -253,7 +253,7 @@ public class SingleDocumentExtractionTest extends AbstractAny23TestBase {
* Tests that the {@link org.apache.any23.extractor.rdf.TriXExtractor} is NOT activated for a given HTML document.
* This tests that a private method within {@link org.apache.any23.extractor.SingleDocumentExtraction} works as
* expected.
- *
+ *
* @see <a href=
* "https://issues.apache.org/jira/browse/ANY23-504">https://issues.apache.org/jira/browse/ANY23-504</a>
*
@@ -297,7 +297,7 @@ public class SingleDocumentExtractionTest extends AbstractAny23TestBase {
/**
* Logs the storage content.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
*/
@@ -311,11 +311,11 @@ public class SingleDocumentExtractionTest extends AbstractAny23TestBase {
/**
* Asserts that the triple pattern is present within the storage exactly n times.
- *
+ *
* @param predicate
* @param value
* @param occurrences
- *
+ *
* @throws RepositoryException
*/
private void assertTripleCount(IRI predicate, Value value, int occurrences) throws RepositoryException {
@@ -336,7 +336,7 @@ public class SingleDocumentExtractionTest extends AbstractAny23TestBase {
* @param predicate
* @param value
* @param occurrences
- *
+ *
* @throws RepositoryException
*/
private void assertTripleCount(IRI predicate, String value, int occurrences) throws RepositoryException {
@@ -348,7 +348,7 @@ public class SingleDocumentExtractionTest extends AbstractAny23TestBase {
*
* @param predicate
* @param value
- *
+ *
* @throws RepositoryException
*/
private void assertTriple(IRI predicate, Value value) throws RepositoryException {
@@ -360,7 +360,7 @@ public class SingleDocumentExtractionTest extends AbstractAny23TestBase {
*
* @param predicate
* @param value
- *
+ *
* @throws RepositoryException
*/
@SuppressWarnings("unused")
@@ -370,14 +370,14 @@ public class SingleDocumentExtractionTest extends AbstractAny23TestBase {
/**
* Retrieves the triple object matching with the given pattern that is expected to be just one.
- *
+ *
* @param sub
* the triple subject, <code>null</code> for any.
* @param prop
* the triple property, <code>null</code> for any.
- *
+ *
* @return the object of the unique triple matching the given pattern.
- *
+ *
* @throws RepositoryException
* if an error occurred during the search.
*/
diff --git a/core/src/test/java/org/apache/any23/extractor/html/AbstractExtractorTestCase.java b/core/src/test/java/org/apache/any23/extractor/html/AbstractExtractorTestCase.java
index 1b27f930..d1a51276 100644
--- a/core/src/test/java/org/apache/any23/extractor/html/AbstractExtractorTestCase.java
+++ b/core/src/test/java/org/apache/any23/extractor/html/AbstractExtractorTestCase.java
@@ -104,7 +104,7 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
/**
* Test case initialization.
- *
+ *
* @throws Exception
* if there is an error constructing input objects
*/
@@ -122,7 +122,7 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
*
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
@After
public void tearDown() throws RepositoryException {
@@ -156,7 +156,7 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
*
* @param extractorName
* name of the extractor.
- *
+ *
* @return collection of issues.
*/
protected Collection<IssueReport.Issue> getIssues(String extractorName) {
@@ -182,7 +182,7 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
*
* @param resource
* resource name.
- *
+ *
* @throws org.apache.any23.extractor.ExtractionException
* if there is an exception during extraction
* @throws IOException
@@ -237,10 +237,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate
* @param o
* object.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected void assertContains(IRI p, Resource o) throws RepositoryException {
assertContains(null, p, o);
@@ -253,10 +253,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate
* @param o
* object.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected void assertContains(IRI p, String o) throws RepositoryException {
assertContains(null, p, RDFUtils.literal(o));
@@ -269,10 +269,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate
* @param o
* object.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected void assertNotContains(IRI p, Resource o) throws RepositoryException {
assertNotContains(null, p, o);
@@ -287,10 +287,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate.
* @param o
* object.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected void assertContains(Resource s, IRI p, Value o) throws RepositoryException {
Assert.assertTrue(
@@ -307,10 +307,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate.
* @param o
* object.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected void assertNotContains(Resource s, IRI p, String o) throws RepositoryException {
Assert.assertFalse(getFailedExtractionMessage(), conn.hasStatement(s, p, RDFUtils.literal(o), false));
@@ -325,10 +325,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate.
* @param o
* object.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected void assertNotContains(Resource s, IRI p, Resource o) throws RepositoryException {
Assert.assertFalse(getFailedExtractionMessage(), conn.hasStatement(s, p, o, false));
@@ -339,7 +339,7 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
*
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected void assertModelNotEmpty() throws RepositoryException {
Assert.assertFalse("The model is expected to not be empty." + getFailedExtractionMessage(), conn.isEmpty());
@@ -354,10 +354,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate.
* @param o
* object.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected void assertNotContains(Resource s, IRI p, Literal o) throws RepositoryException {
Assert.assertFalse(getFailedExtractionMessage(), conn.hasStatement(s, p, o, false));
@@ -368,7 +368,7 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
*
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected void assertModelEmpty() throws RepositoryException {
Assert.assertTrue(getFailedExtractionMessage(), conn.isEmpty());
@@ -416,10 +416,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
*
* @param statements
* list of statements to be verified.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
public void assertContainsModel(Statement[] statements) throws RepositoryException {
for (Statement statement : statements) {
@@ -432,7 +432,7 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
*
* @param modelResource
* the resource containing the model.
- *
+ *
* @throws RDFHandlerException
* if there is an error within the {@link org.eclipse.rdf4j.rio.RDFHandler}
* @throws IOException
@@ -441,7 +441,7 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* if there is an exception parsing the RDF stream
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
public void assertContainsModel(String modelResource)
throws RDFHandlerException, IOException, RDFParseException, RepositoryException {
@@ -461,10 +461,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* object.
* @param expected
* expected matches.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected void assertStatementsSize(Resource s, IRI p, Value o, int expected)
throws RDFHandlerException, RepositoryException {
@@ -487,10 +487,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* object.
* @param expected
* expected matches.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected void assertStatementsSize(IRI p, Value o, int expected) throws RDFHandlerException, RepositoryException {
assertStatementsSize(null, p, o, expected);
@@ -505,10 +505,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* object.
* @param expected
* expected matches.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected void assertStatementsSize(IRI p, String o, int expected) throws RDFHandlerException, RepositoryException {
assertStatementsSize(p, o == null ? null : RDFUtils.literal(o), expected);
@@ -521,10 +521,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* subject.
* @param p
* predicate.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected void assertNotFound(Resource s, IRI p) throws RepositoryException {
RepositoryResult<Statement> statements = conn.getStatements(s, p, null, true);
@@ -542,12 +542,12 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate.
* @param o
* object.
- *
+ *
* @return the matching blank subject.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected Resource findExactlyOneBlankSubject(IRI p, Value o) throws RepositoryException {
RepositoryResult<Statement> it = conn.getStatements(null, p, o, false);
@@ -570,12 +570,12 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* subject.
* @param p
* predicate.
- *
+ *
* @return the matching object.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected Value findExactlyOneObject(Resource s, IRI p) throws RepositoryException {
RepositoryResult<Statement> it = conn.getStatements(s, p, null, false);
@@ -594,12 +594,12 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate.
* @param o
* object.
- *
+ *
* @return list of matching subjects.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected List<Resource> findSubjects(IRI p, Value o) throws RepositoryException {
RepositoryResult<Statement> it = conn.getStatements(null, p, o, false);
@@ -623,12 +623,12 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate.
* @param p
* predicate.
- *
+ *
* @return list of matching objects.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected List<Value> findObjects(Resource s, IRI p) throws RepositoryException {
RepositoryResult<Statement> it = conn.getStatements(s, p, null, false);
@@ -652,9 +652,9 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* subject.
* @param p
* predicate
- *
+ *
* @return matching object.
- *
+ *
* @throws org.eclipse.rdf4j.repository.RepositoryException
* if an error is encountered whilst loading content from a storage connection
*/
@@ -675,12 +675,12 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* subject.
* @param p
* predicate.
- *
+ *
* @return matching object.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected Resource findObjectAsResource(Resource s, IRI p) throws RepositoryException {
final Value v = findObject(s, p);
@@ -699,12 +699,12 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* subject.
* @param p
* predicate.
- *
+ *
* @return matching object.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected String findObjectAsLiteral(Resource s, IRI p) throws RepositoryException {
return findObject(s, p).stringValue();
@@ -714,10 +714,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* Dumps the extracted model in <i>Turtle</i> format.
*
* @return a string containing the model in Turtle.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected String dumpModelToTurtle() throws RepositoryException {
StringWriter w = new StringWriter();
@@ -733,10 +733,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* Dumps the extracted model in <i>NQuads</i> format.
*
* @return a string containing the model in NQuads.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected String dumpModelToNQuads() throws RepositoryException {
StringWriter w = new StringWriter();
@@ -752,10 +752,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* Dumps the extracted model in <i>RDFXML</i> format.
*
* @return a string containing the model in RDFXML.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected String dumpModelToRDFXML() throws RepositoryException {
StringWriter w = new StringWriter();
@@ -771,10 +771,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* Dumps the list of statements contained in the extracted model.
*
* @return list of extracted statements.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected List<Statement> dumpAsListOfStatements() throws RepositoryException {
return Iterations.asList(conn.getStatements(null, null, null, false));
@@ -782,10 +782,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
/**
* @return string containing human readable statements.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected String dumpHumanReadableTriples() throws RepositoryException {
StringBuilder sb = new StringBuilder();
@@ -805,10 +805,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
*
* @param statement
* an RDF {@link org.eclipse.rdf4j.model.Statement} implementation
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
// TODO: bnode check is too weak, introduce graph omomorphism check.
protected void assertContains(Statement statement) throws RepositoryException {
@@ -827,10 +827,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate.
* @param l
* literal content.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected void assertContains(Resource s, IRI p, String l) throws RepositoryException {
assertContains(s, p, RDFUtils.literal(l));
@@ -847,10 +847,10 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* literal content.
* @param lang
* literal language.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected void assertContains(Resource s, IRI p, String l, String lang) throws RepositoryException {
assertContains(s, p, RDFUtils.literal(l, lang));
@@ -865,12 +865,12 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate.
* @param o
* object.
- *
+ *
* @return list of statements.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected RepositoryResult<Statement> getStatements(Resource s, IRI p, Value o) throws RepositoryException {
return conn.getStatements(s, p, o, false);
@@ -885,12 +885,12 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate.
* @param o
* object.
- *
+ *
* @return number of matches.
- *
+ *
* @throws RepositoryException
* if an error is encountered whilst loading content from a storage connection
- *
+ *
*/
protected int getStatementsSize(Resource s, IRI p, Value o) throws RepositoryException {
RepositoryResult<Statement> result = getStatements(s, p, o);
diff --git a/core/src/test/java/org/apache/any23/extractor/html/DomUtilsTest.java b/core/src/test/java/org/apache/any23/extractor/html/DomUtilsTest.java
index c9bbdd17..adafee56 100644
--- a/core/src/test/java/org/apache/any23/extractor/html/DomUtilsTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/html/DomUtilsTest.java
@@ -40,7 +40,7 @@ import java.util.List;
/**
* Reference test class for the {@link DomUtils} class.
- *
+ *
* @author Davide Palmisano (dpalmisano@gmail.com)
*/
public class DomUtilsTest extends AbstractAny23TestBase {
diff --git a/core/src/test/java/org/apache/any23/extractor/html/EncodingTest.java b/core/src/test/java/org/apache/any23/extractor/html/EncodingTest.java
index 60680b8e..ae729c3f 100644
--- a/core/src/test/java/org/apache/any23/extractor/html/EncodingTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/html/EncodingTest.java
@@ -49,7 +49,7 @@ public class EncodingTest extends AbstractAny23TestBase {
* not use the declared encoding for the title.
*
* For this test we expect to not recognize the title.
- *
+ *
* @throws Exception
* if there is an error asserting the test data.
*/
diff --git a/core/src/test/java/org/apache/any23/extractor/html/HCalendarExtractorTest.java b/core/src/test/java/org/apache/any23/extractor/html/HCalendarExtractorTest.java
index 614de34a..74761fb2 100644
--- a/core/src/test/java/org/apache/any23/extractor/html/HCalendarExtractorTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/html/HCalendarExtractorTest.java
@@ -38,7 +38,7 @@ import java.io.IOException;
*
* @author Davide Palmisano ( dpalmisano@gmail.com )
* @author Michele Mostarda ( michele.mostarda@gmail.com )
- *
+ *
* @version $Id$
*/
public class HCalendarExtractorTest extends AbstractExtractorTestCase {
diff --git a/core/src/test/java/org/apache/any23/extractor/html/TagSoupParserTest.java b/core/src/test/java/org/apache/any23/extractor/html/TagSoupParserTest.java
index 7fe27807..2c8146dd 100644
--- a/core/src/test/java/org/apache/any23/extractor/html/TagSoupParserTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/html/TagSoupParserTest.java
@@ -94,7 +94,7 @@ public class TagSoupParserTest {
/**
* Test related to the issue 78 and disabled until the underlying <i>NekoHTML</i> bug has been fixed.
- *
+ *
* @throws IOException
* if there is an error interpreting the input data
*/
diff --git a/core/src/test/java/org/apache/any23/extractor/html/TitleExtractorTest.java b/core/src/test/java/org/apache/any23/extractor/html/TitleExtractorTest.java
index 75683ad4..8497e176 100644
--- a/core/src/test/java/org/apache/any23/extractor/html/TitleExtractorTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/html/TitleExtractorTest.java
@@ -27,7 +27,7 @@ import org.eclipse.rdf4j.repository.RepositoryException;
/**
* Reference Test class for the {@link TitleExtractor} extractor.
- *
+ *
*/
public class TitleExtractorTest extends AbstractExtractorTestCase {
@@ -67,7 +67,7 @@ public class TitleExtractorTest extends AbstractExtractorTestCase {
/**
* This test verifies that when present the default language this is adopted by the title literal.
- *
+ *
* @throws org.eclipse.rdf4j.repository.RepositoryException
* if an error is encountered whilst loading content from a storage connection
*/
diff --git a/core/src/test/java/org/apache/any23/extractor/html/TurtleHTMLExtractorTest.java b/core/src/test/java/org/apache/any23/extractor/html/TurtleHTMLExtractorTest.java
index b72a5dcc..48152f38 100644
--- a/core/src/test/java/org/apache/any23/extractor/html/TurtleHTMLExtractorTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/html/TurtleHTMLExtractorTest.java
@@ -42,7 +42,7 @@ public class TurtleHTMLExtractorTest extends AbstractExtractorTestCase {
/**
* Tests the extraction of the RDF content from the sample HTML file.
- *
+ *
* @throws IOException
* if there is an error interpreting the input data
* @throws ExtractionException
diff --git a/core/src/test/java/org/apache/any23/extractor/rdf/TurtleExtractorTest.java b/core/src/test/java/org/apache/any23/extractor/rdf/TurtleExtractorTest.java
index 0517ad58..e9e06161 100644
--- a/core/src/test/java/org/apache/any23/extractor/rdf/TurtleExtractorTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/rdf/TurtleExtractorTest.java
@@ -41,7 +41,7 @@ import java.nio.charset.StandardCharsets;
* Test case for {@link NTriplesExtractor}.
*
* @author Michele Mostarda ( michele.mostarda@gmail.com )
- *
+ *
* @version $Id$
*/
public class TurtleExtractorTest {
@@ -62,7 +62,7 @@ public class TurtleExtractorTest {
/**
* Tests the correct support for a typed literal with incompatible value.
- *
+ *
* @throws IOException
* if there is an error interpreting the input data
* @throws ExtractionException
diff --git a/core/src/test/java/org/apache/any23/extractor/rdfa/RDFa11ParserTest.java b/core/src/test/java/org/apache/any23/extractor/rdfa/RDFa11ParserTest.java
index bc17f795..7e9304e1 100644
--- a/core/src/test/java/org/apache/any23/extractor/rdfa/RDFa11ParserTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/rdfa/RDFa11ParserTest.java
@@ -37,7 +37,7 @@ import static org.mockito.Mockito.mock;
/**
* @author Michele Mostarda (mostarda@fbk.eu)
- *
+ *
* @deprecated since 2.3
*/
@Deprecated
diff --git a/core/src/test/java/org/apache/any23/extractor/yaml/YAMLExtractorTest.java b/core/src/test/java/org/apache/any23/extractor/yaml/YAMLExtractorTest.java
index 75a52a1b..01677713 100644
--- a/core/src/test/java/org/apache/any23/extractor/yaml/YAMLExtractorTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/yaml/YAMLExtractorTest.java
@@ -55,7 +55,7 @@ public class YAMLExtractorTest extends AbstractExtractorTestCase {
/**
* Test to validate simple yaml file for ANY23-312
- *
+ *
* @throws Exception
* if there is an error asserting the test data.
*/
@@ -149,30 +149,30 @@ public class YAMLExtractorTest extends AbstractExtractorTestCase {
/**
* This test covers a typical situation when a document is a map.
- *
+ *
* <br>
* <b>NB:</b> Following yaml standard those 2 cases are parsed to different graphs: <br>
* Case 1:
- *
+ *
* <pre>
* ---
* key1: value1
* key2: value2
* key3: Some text value, maybe description
* </pre>
- *
+ *
* Case 2:
- *
+ *
* <pre>
* ---
* - key1: value1
* - key2: value2
* - key3: Some text value, maybe description
* </pre>
- *
+ *
* @throws Exception
* if there is an error asserting the test data.
- *
+ *
* @see #treeTest()
*/
@Test
diff --git a/core/src/test/java/org/apache/any23/extractor/yaml/YAMLTikaParserTest.java b/core/src/test/java/org/apache/any23/extractor/yaml/YAMLTikaParserTest.java
index 8e1a1a11..c73d6a45 100644
--- a/core/src/test/java/org/apache/any23/extractor/yaml/YAMLTikaParserTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/yaml/YAMLTikaParserTest.java
@@ -45,7 +45,7 @@ public class YAMLTikaParserTest {
/**
* Yaml type is detected by file name only so detector returns octet type.
- *
+ *
* @throws Exception
* if there is an error asserting the test data.
*/
diff --git a/core/src/test/java/org/apache/any23/http/AcceptHeaderBuilderTest.java b/core/src/test/java/org/apache/any23/http/AcceptHeaderBuilderTest.java
index 459283ad..6db9799f 100644
--- a/core/src/test/java/org/apache/any23/http/AcceptHeaderBuilderTest.java
+++ b/core/src/test/java/org/apache/any23/http/AcceptHeaderBuilderTest.java
@@ -28,7 +28,7 @@ import java.util.Collections;
/**
* Reference test for {@link AcceptHeaderBuilder}
- *
+ *
*/
public class AcceptHeaderBuilderTest {
diff --git a/csvutils/src/main/java/org/apache/any23/extractor/csv/CSVReaderBuilder.java b/csvutils/src/main/java/org/apache/any23/extractor/csv/CSVReaderBuilder.java
index a19cd235..7cf0dd73 100644
--- a/csvutils/src/main/java/org/apache/any23/extractor/csv/CSVReaderBuilder.java
+++ b/csvutils/src/main/java/org/apache/any23/extractor/csv/CSVReaderBuilder.java
@@ -62,9 +62,9 @@ public class CSVReaderBuilder {
*
* @param is
* {@link InputStream} of the <i>CSV</i> file where guess the configuration.
- *
+ *
* @return a {@link CSVParser}
- *
+ *
* @throws java.io.IOException
* if there is an error building the parser
*/
@@ -80,10 +80,10 @@ public class CSVReaderBuilder {
*
* @param is
* input stream to be verified.
- *
+ *
* @return <code>true</code> if the given <code>is</code> input stream contains a <i>CSV</i> content.
* <code>false</code> otherwise.
- *
+ *
* @throws IOException
* if there is an error processing the input stream
*/
@@ -123,11 +123,11 @@ public class CSVReaderBuilder {
* input stream to be checked
* @param strategy
* strategy to be verified.
- *
+ *
* @return
- *
+ *
* @throws IOException
- *
+ *
* @param is
*/
private static boolean testStrategy(InputStream is, CSVFormat strategy) throws IOException {
diff --git a/encoding/src/main/java/org/apache/any23/encoding/TikaEncodingDetector.java b/encoding/src/main/java/org/apache/any23/encoding/TikaEncodingDetector.java
index b27a2dfd..92fbf2d7 100644
--- a/encoding/src/main/java/org/apache/any23/encoding/TikaEncodingDetector.java
+++ b/encoding/src/main/java/org/apache/any23/encoding/TikaEncodingDetector.java
@@ -48,7 +48,7 @@ import static java.nio.charset.StandardCharsets.ISO_8859_1;
* @author Michele Mostarda ( michele.mostarda@gmail.com )
* @author Davide Palmisano ( dpalmisano@gmail.com )
* @author Hans Brende (hansbrende@apache.org)
- *
+ *
* @version $Id$
*/
public class TikaEncodingDetector implements EncodingDetector {
diff --git a/encoding/src/test/java/org/apache/any23/encoding/TikaEncodingDetectorTest.java b/encoding/src/test/java/org/apache/any23/encoding/TikaEncodingDetectorTest.java
index 816f18a5..abc9c81e 100644
--- a/encoding/src/test/java/org/apache/any23/encoding/TikaEncodingDetectorTest.java
+++ b/encoding/src/test/java/org/apache/any23/encoding/TikaEncodingDetectorTest.java
@@ -36,7 +36,7 @@ import static org.junit.Assert.assertEquals;
*
* @author Michele Mostarda ( michele.mostarda@gmail.com )
* @author Davide Palmisano ( dpalmisano@gmail.com )
- *
+ *
* @version $Id$
*/
public class TikaEncodingDetectorTest {
diff --git a/mime/src/main/java/org/apache/any23/mime/NaiveMIMETypeDetector.java b/mime/src/main/java/org/apache/any23/mime/NaiveMIMETypeDetector.java
index cbcfc022..90b6d56b 100644
--- a/mime/src/main/java/org/apache/any23/mime/NaiveMIMETypeDetector.java
+++ b/mime/src/main/java/org/apache/any23/mime/NaiveMIMETypeDetector.java
@@ -34,7 +34,7 @@ public class NaiveMIMETypeDetector implements MIMETypeDetector {
private final static Map<String, String> extensions = new HashMap<String, String>() {
/**
- *
+ *
*/
private static final long serialVersionUID = 1L;
diff --git a/mime/src/main/java/org/apache/any23/mime/TikaMIMETypeDetector.java b/mime/src/main/java/org/apache/any23/mime/TikaMIMETypeDetector.java
index 89759bfe..a8ce8640 100644
--- a/mime/src/main/java/org/apache/any23/mime/TikaMIMETypeDetector.java
+++ b/mime/src/main/java/org/apache/any23/mime/TikaMIMETypeDetector.java
@@ -87,9 +87,9 @@ public class TikaMIMETypeDetector implements MIMETypeDetector {
*
* @param is
* input stream to be verified.
- *
+ *
* @return <code>true</code> if <i>N3</i> patterns are detected, <code>false</code> otherwise.
- *
+ *
* @throws IOException
* if there is an error checking the {@link java.io.InputStream}
*/
@@ -102,9 +102,9 @@ public class TikaMIMETypeDetector implements MIMETypeDetector {
*
* @param is
* input stream to be verified.
- *
+ *
* @return <code>true</code> if <i>N3</i> patterns are detected, <code>false</code> otherwise.
- *
+ *
* @throws IOException
* if there is an error checking the {@link java.io.InputStream}
*/
@@ -117,9 +117,9 @@ public class TikaMIMETypeDetector implements MIMETypeDetector {
*
* @param is
* input stream to be verified.
- *
+ *
* @return <code>true</code> if <i>Turtle</i> patterns are detected, <code>false</code> otherwise.
- *
+ *
* @throws IOException
* if there is an error checking the {@link java.io.InputStream}
*/
@@ -141,9 +141,9 @@ public class TikaMIMETypeDetector implements MIMETypeDetector {
*
* @param is
* input stream to be verified.
- *
+ *
* @return <code>true</code> if <i>CSV</i> patterns are detected, <code>false</code> otherwise.
- *
+ *
* @throws IOException
* if there is an error checking the {@link java.io.InputStream}
*/
@@ -160,9 +160,9 @@ public class TikaMIMETypeDetector implements MIMETypeDetector {
* the delimiter of the sample.
* @param is
* the input stream to sample.
- *
+ *
* @return <code>true</code> if a pattern has been applied, <code>false</code> otherwise.
- *
+ *
* @throws IOException
* if there is an error finding the pattern within the {@link java.io.InputStream}
*/
@@ -183,9 +183,9 @@ public class TikaMIMETypeDetector implements MIMETypeDetector {
* the input stream to sample.
* @param breakChar
* the char to break to sample.
- *
+ *
* @return the sample string.
- *
+ *
* @throws IOException
* if an error occurs during sampling.
*/
@@ -257,9 +257,9 @@ public class TikaMIMETypeDetector implements MIMETypeDetector {
* <code>null</code> or a <i>resettable</i> input stream containing data.
* @param mimeTypeFromMetadata
* mimetype declared in metadata.
- *
+ *
* @return the supposed mime type or <code>null</code> if nothing appropriate found.
- *
+ *
* @throws IllegalArgumentException
* if <i>input</i> is not <code>null</code> and is not resettable.
*/
@@ -334,9 +334,9 @@ public class TikaMIMETypeDetector implements MIMETypeDetector {
* document stream
* @param metadata
* metadata hints
- *
+ *
* @return MIME type of the document
- *
+ *
* @throws IOException
* if the document stream could not be read
*/
diff --git a/mime/src/test/java/org/apache/any23/mime/TikaMIMETypeDetectorTest.java b/mime/src/test/java/org/apache/any23/mime/TikaMIMETypeDetectorTest.java
index a97a5c6a..d2787919 100644
--- a/mime/src/test/java/org/apache/any23/mime/TikaMIMETypeDetectorTest.java
+++ b/mime/src/test/java/org/apache/any23/mime/TikaMIMETypeDetectorTest.java
@@ -377,7 +377,7 @@ public class TikaMIMETypeDetectorTest {
/**
* Test done only based on content is failed because the standard does not require to have "%YAML" header.
- *
+ *
* @throws Exception
* if there is an error detecting the mime type from the content and name
*/
@@ -420,7 +420,7 @@ public class TikaMIMETypeDetectorTest {
* the expected mime type.
* @param testDir
* the target file.
- *
+ *
* @throws IOException
*/
private void detectMIMEtypeByContent(String expectedMimeType, Collection<String> manifest) throws IOException {
@@ -444,7 +444,7 @@ public class TikaMIMETypeDetectorTest {
*
* @param expectedMimeType
* @param contentTypeHeader
- *
+ *
* @throws IOException
*/
private void detectMIMETypeByMimeTypeHint(String expectedMimeType, String contentTypeHeader) throws IOException {
@@ -457,7 +457,7 @@ public class TikaMIMETypeDetectorTest {
*
* @param expectedMimeType
* @param testDir
- *
+ *
* @throws IOException
*/
private void detectMIMETypeByContentAndName(String expectedMimeType, Collection<String> manifest)
diff --git a/mime/src/test/java/org/apache/any23/mime/purifier/WhiteSpacesPurifierTest.java b/mime/src/test/java/org/apache/any23/mime/purifier/WhiteSpacesPurifierTest.java
index d101e662..56b62ea9 100644
--- a/mime/src/test/java/org/apache/any23/mime/purifier/WhiteSpacesPurifierTest.java
+++ b/mime/src/test/java/org/apache/any23/mime/purifier/WhiteSpacesPurifierTest.java
@@ -59,9 +59,9 @@ public class WhiteSpacesPurifierTest {
/**
* Checks if a {@link String} starts with a propert character.
- *
+ *
* @param string
- *
+ *
* @return
*/
private boolean validatePurification(String string) {
diff --git a/pom.xml b/pom.xml
index e9d3e637..b5b24640 100644
--- a/pom.xml
+++ b/pom.xml
@@ -321,7 +321,7 @@
<maven-invoker-plugin.version>3.2.2</maven-invoker-plugin.version>
<spotbugs-maven-plugin.version>4.5.3.0</spotbugs-maven-plugin.version>
<forbiddenapis.version>3.2</forbiddenapis.version>
- <formatter-maven-plugin.version>2.17.1</formatter-maven-plugin.version>
+ <formatter-maven-plugin.version>2.18.0</formatter-maven-plugin.version>
<ossindex-maven-plugin.version>3.2.0</ossindex-maven-plugin.version>
<maven-enforcer-plugin.version>3.0.0</maven-enforcer-plugin.version>
<jacoco-maven-plugin.version>0.8.7</jacoco-maven-plugin.version>