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 2019/03/05 23:39:52 UTC
[any23] branch master updated: ANY23-429 Website Build Fails due to
Javadoc issues
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 c2e9436 ANY23-429 Website Build Fails due to Javadoc issues
new eed6d67 Merge pull request #137 from lewismc/ANY23-429
c2e9436 is described below
commit c2e9436a3a06f5a59e752403be78404d15830987
Author: Lewis John McGibbney <le...@gmail.com>
AuthorDate: Tue Mar 5 15:37:59 2019 -0800
ANY23-429 Website Build Fails due to Javadoc issues
---
.../org/apache/any23/cli/ExtractorsFlowTest.java | 2 +
.../java/org/apache/any23/cli/SimpleRoverTest.java | 2 +
.../java/org/apache/any23/cli/ToolTestBase.java | 6 +-
.../java/org/apache/any23/cli/YAMLRoverTest.java | 4 +-
.../org/apache/any23/AbstractAny23TestBase.java | 6 +-
core/src/test/java/org/apache/any23/Any23Test.java | 44 +++-----
.../extractor/SingleDocumentExtractionTest.java | 36 +++----
.../any23/extractor/csv/CSVReaderBuilderTest.java | 4 +-
.../extractor/html/AbstractExtractorTestCase.java | 114 +++++++++++++--------
.../apache/any23/extractor/html/EncodingTest.java | 1 +
.../any23/extractor/html/HCardExtractorTest.java | 6 +-
.../any23/extractor/html/HReviewExtractorTest.java | 3 +-
.../any23/extractor/html/SpeciesExtractorTest.java | 3 +-
.../any23/extractor/html/TagSoupParserTest.java | 8 +-
.../any23/extractor/html/TitleExtractorTest.java | 2 +-
.../extractor/html/TurtleHTMLExtractorTest.java | 8 +-
.../microdata/MicrodataExtractorTest.java | 49 ++++-----
.../extractor/microdata/MicrodataParserTest.java | 19 ++--
.../any23/extractor/rdf/TurtleExtractorTest.java | 6 +-
.../rdfa/AbstractRDFaExtractorTestCase.java | 18 ++--
.../any23/extractor/rdfa/RDFa11ExtractorTest.java | 38 +++----
.../any23/extractor/rdfa/RDFaExtractorTest.java | 8 +-
.../any23/extractor/yaml/YAMLExtractorTest.java | 7 +-
.../any23/extractor/yaml/YAMLTikaParserTest.java | 2 +-
.../org/apache/any23/util/DiscoveryUtilsTest.java | 8 +-
.../any23/mime/TikaMIMETypeDetectorTest.java | 3 +-
.../any23/plugin/crawler/SiteCrawlerTest.java | 2 +-
pom.xml | 17 ++-
.../java/org/apache/any23/servlet/ServletTest.java | 6 +-
29 files changed, 229 insertions(+), 203 deletions(-)
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 0b75f57..f72f5f1 100644
--- a/cli/src/test/java/org/apache/any23/cli/ExtractorsFlowTest.java
+++ b/cli/src/test/java/org/apache/any23/cli/ExtractorsFlowTest.java
@@ -52,6 +52,7 @@ public class ExtractorsFlowTest extends ToolTestBase {
/**
* Emulates action described in ANY23-396.
+ * @throws Exception if there is an error asserting the test data.
*/
@Test
public void runTestFor396() throws Exception {
@@ -79,6 +80,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.
*/
private boolean assertCompareModels(Model expected, File received) throws Exception {
Model receivedModel = new TreeModel();
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 587dda7..aff6df9 100644
--- a/cli/src/test/java/org/apache/any23/cli/SimpleRoverTest.java
+++ b/cli/src/test/java/org/apache/any23/cli/SimpleRoverTest.java
@@ -59,6 +59,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.
*/
@Test
public void ref310Test()
@@ -104,6 +105,7 @@ public class SimpleRoverTest extends ToolTestBase {
* 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.
*/
@Test
public void ref310ExtendedTest()
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 a815315..9cde29c 100644
--- a/cli/src/test/java/org/apache/any23/cli/ToolTestBase.java
+++ b/cli/src/test/java/org/apache/any23/cli/ToolTestBase.java
@@ -46,7 +46,7 @@ public abstract class ToolTestBase extends Any23OnlineTestBase {
*
* @param args tool arguments.
* @return the tool exit code.
- * @throws Exception
+ * @throws Exception if there is an error asserting the test data.
*/
protected int runTool(String... args) throws Exception {
final String commandName = toolClazz.getAnnotation( Parameters.class ).commandNames()[0];
@@ -63,7 +63,7 @@ public abstract class ToolTestBase extends Any23OnlineTestBase {
*
* @param args args tool arguments.
* @return the tool exit code.
- * @throws Exception
+ * @throws Exception if there is an error asserting the test data.
*/
protected int runTool(String args) throws Exception {
return runTool(args.split(" "));
@@ -73,7 +73,7 @@ public abstract class ToolTestBase extends Any23OnlineTestBase {
* Runs the underlying tool and verify the exit code to <code>0</code>.
*
* @param args tool arguments.
- * @throws Exception
+ * @throws Exception if there is an error asserting the test data.
*/
protected void runToolCheckExit0(String... args) throws Exception {
assertEquals(
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 6024110..ee9e47a 100644
--- a/cli/src/test/java/org/apache/any23/cli/YAMLRoverTest.java
+++ b/cli/src/test/java/org/apache/any23/cli/YAMLRoverTest.java
@@ -68,9 +68,9 @@ public class YAMLRoverTest extends ToolTestBase {
*
* If logging level is <tt>trace</tt> than additionally displays file content.
*
- * @param f
+ * @param f input file
* @param s Expected string in the file
- * @return
+ * @throws IOException if there is an error reading the input data.
*/
public void assertFileContainsString(File f, String s) throws IOException {
String fileContent = FileUtils.readFileToString(f, StandardCharsets.UTF_8);
diff --git a/core/src/test/java/org/apache/any23/AbstractAny23TestBase.java b/core/src/test/java/org/apache/any23/AbstractAny23TestBase.java
index 33af39f..a3818c1 100644
--- a/core/src/test/java/org/apache/any23/AbstractAny23TestBase.java
+++ b/core/src/test/java/org/apache/any23/AbstractAny23TestBase.java
@@ -68,9 +68,9 @@ public class AbstractAny23TestBase {
* @param resourceLocation
* The absolute location of the resource in the classpath, which
* can be used with this.getClass().getResourceAsStream.
- * @return
- * @throws FileNotFoundException
- * @throws IOException
+ * @return temporary {@link java.io.File}
+ * @throws FileNotFoundException if the temp file location cannot be converted to a {@link java.io.FileOutputStream}
+ * @throws IOException if there is an issue with the input
*/
protected File copyResourceToTempFile(String resourceLocation)
throws FileNotFoundException, IOException {
diff --git a/core/src/test/java/org/apache/any23/Any23Test.java b/core/src/test/java/org/apache/any23/Any23Test.java
index d3c73ea..0d91d8b 100644
--- a/core/src/test/java/org/apache/any23/Any23Test.java
+++ b/core/src/test/java/org/apache/any23/Any23Test.java
@@ -53,11 +53,9 @@ import org.junit.Test;
import org.eclipse.rdf4j.model.Statement;
import org.eclipse.rdf4j.repository.Repository;
import org.eclipse.rdf4j.repository.RepositoryConnection;
-import org.eclipse.rdf4j.repository.RepositoryException;
import org.eclipse.rdf4j.repository.RepositoryResult;
import org.eclipse.rdf4j.repository.sail.SailRepository;
import org.eclipse.rdf4j.rio.RDFParseException;
-import org.eclipse.rdf4j.sail.SailException;
import org.eclipse.rdf4j.sail.memory.MemoryStore;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
@@ -113,10 +111,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 org.apache.any23.extractor.ExtractionException
- * @throws IOException
- * @throws SailException
- * @throws RepositoryException
+ * @throws Exception if there is an error reading the input
*/
@Test
public void testExplicitEncoding() throws Exception {
@@ -129,11 +124,7 @@ public class Any23Test extends Any23OnlineTestBase {
* passing it any charset encoding. The encoding is therefore guessed using
* {@link org.apache.any23.encoding.TikaEncodingDetector} class.
*
- * @throws org.apache.any23.extractor.ExtractionException
- * @throws IOException
- * @throws SailException
- * @throws RepositoryException
- * @throws org.apache.any23.writer.TripleHandlerException
+ * @throws Exception if there is an error reading the input
*/
@Test
public void testImplicitEncoding() throws Exception {
@@ -175,8 +166,7 @@ public class Any23Test extends Any23OnlineTestBase {
/**
* Tests out the first code snipped used in <i>Developer Manual</i>.
*
- * @throws IOException
- * @throws org.apache.any23.extractor.ExtractionException
+ * @throws Exception if there is an error reading the input
*/
@Test
public void testDemoCodeSnippet1() throws Exception {
@@ -209,8 +199,7 @@ public class Any23Test extends Any23OnlineTestBase {
/**
* Tests out the second code snipped used in <i>Developer Manual</i>.
*
- * @throws IOException
- * @throws org.apache.any23.extractor.ExtractionException
+ * @throws Exception if there is an error reading the input
*/
@Test
public void testDemoCodeSnippet2() throws Exception {
@@ -253,9 +242,9 @@ public class Any23Test extends Any23OnlineTestBase {
* different behaviors between Maven and Ant. The behavior was related to a
* 2nd-level dependency introduced by Maven.
*
- * @throws org.apache.any23.extractor.ExtractionException
- * @throws IOException
- * @throws URISyntaxException
+ * @throws org.apache.any23.extractor.ExtractionException if there is an error running extraction logic
+ * @throws IOException if there is an error reading the input
+ * @throws URISyntaxException if there is an error defining input URI's
*/
@Test
public void testProgrammaticExtraction() throws ExtractionException,
@@ -301,9 +290,9 @@ 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 IOException
- * @throws URISyntaxException
- * @throws ExtractionException
+ * @throws org.apache.any23.extractor.ExtractionException if there is an error running extraction logic
+ * @throws IOException if there is an error reading the input
+ * @throws URISyntaxException if there is an error defining input URI's
*/
@Test
public void testGZippedContent() throws IOException, URISyntaxException,
@@ -423,8 +412,8 @@ public class Any23Test extends Any23OnlineTestBase {
/**
* Test correct management of general <i>XML</i> content.
*
- * @throws IOException
- * @throws ExtractionException
+ * @throws org.apache.any23.extractor.ExtractionException if there is an error running extraction logic
+ * @throws IOException if there is an error reading the input
*/
@Test
public void testXMLMimeTypeManagement() throws IOException,
@@ -447,8 +436,8 @@ public class Any23Test extends Any23OnlineTestBase {
* Test correct management of general <i>XML</i> content from <i>URL</i>
* source.
*
- * @throws IOException
- * @throws ExtractionException
+ * @throws org.apache.any23.extractor.ExtractionException if there is an error running extraction logic
+ * @throws IOException if there is an error reading the input
*/
@Test
public void testXMLMimeTypeManagementViaURL() throws IOException,
@@ -579,9 +568,8 @@ public class Any23Test extends Any23OnlineTestBase {
*
* @param in
* input string.
- * @return
- * @throws IOException
- * @throws ExtractionException
+ * @return a populated {@link org.apache.any23.ExtractionReport}
+ * @throws Exception if there is an error detecting mime type and running extraction
*/
private ExtractionReport detectAndExtract(String in) throws Exception {
Any23 any23 = new Any23();
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 b0f9f47..398cc7a 100644
--- a/core/src/test/java/org/apache/any23/extractor/SingleDocumentExtractionTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/SingleDocumentExtractionTest.java
@@ -60,7 +60,7 @@ import java.io.IOException;
* @author Michele Mostarda (mostarda@fbk.eu)
* @author Davide Palmisano (palmisano@fbk.eu)
*/
-// TODO #20 - Solve issue that hreview item and vcard item have the same BNode due they have the same XPath DOM.
+// TODO #20 - Solve issue that hreview item and vcard item have the same BNode due they have the same XPath DOM.
public class SingleDocumentExtractionTest extends AbstractAny23TestBase {
private static final SINDICE vSINDICE = SINDICE.getInstance();
@@ -110,9 +110,9 @@ public class SingleDocumentExtractionTest extends AbstractAny23TestBase {
/**
* Tests the existence of the domain triples.
*
- * @throws IOException
- * @throws ExtractionException
- * @throws RepositoryException
+ * @throws IOException if there is an error loading input data
+ * @throws ExtractionException if an exception is raised during extraction
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
*/
@Test
public void testMicroformatDomains() throws IOException, ExtractionException, RepositoryException {
@@ -131,9 +131,9 @@ public class SingleDocumentExtractionTest extends AbstractAny23TestBase {
* {@link SingleDocumentExtraction}
* consolidateResources(java.util.List, java.util.List, org.apache.any23.writer.TripleHandler)}
*
- * @throws IOException
- * @throws ExtractionException
- * @throws RepositoryException
+ * @throws IOException if there is an error loading input data
+ * @throws ExtractionException if an exception is raised during extraction
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
*/
@Test
public void testNestedMicroformats() throws IOException, ExtractionException, RepositoryException {
@@ -154,9 +154,9 @@ public class SingleDocumentExtractionTest extends AbstractAny23TestBase {
* with the {@link org.apache.any23.extractor.html.AdrExtractor}.
*
* @see org.apache.any23.extractor.html.annotations.Includes
- * @throws IOException
- * @throws ExtractionException
- * @throws RepositoryException
+ * @throws IOException if there is an error loading input data
+ * @throws ExtractionException if an exception is raised during extraction
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
*/
@Test
public void testNestedVCardAdr() throws IOException, ExtractionException, RepositoryException {
@@ -181,9 +181,9 @@ public class SingleDocumentExtractionTest extends AbstractAny23TestBase {
* See also the <a href="http://www.google.com/support/webmasters/bin/answer.py?answer=146862">Nested Entities</a>
* article that is linked by the official microformats.org doc page.
*
- * @throws IOException
- * @throws ExtractionException
- * @throws RepositoryException
+ * @throws IOException if there is an error loading input data
+ * @throws ExtractionException if an exception is raised during extraction
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
*/
@Test
public void testNestedMicroformatsInduced() throws IOException, ExtractionException, RepositoryException {
@@ -203,9 +203,9 @@ public class SingleDocumentExtractionTest extends AbstractAny23TestBase {
* when the nesting relationship is handled by the microformat extractor itself (like the HReview that is
* able to detect an inner VCard).
*
- * @throws IOException
- * @throws ExtractionException
- * @throws RepositoryException
+ * @throws IOException if there is an error loading input data
+ * @throws ExtractionException if an exception is raised during extraction
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
*/
@Test
/* NOTE: The triple (bnode http://www.w3.org/2006/vcard/ns#url http://pizza.example.com) and
@@ -252,8 +252,7 @@ public class SingleDocumentExtractionTest extends AbstractAny23TestBase {
/**
* Logs the storage content.
- *
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
*/
private void logStorageContent() throws RepositoryException {
RepositoryResult<Statement> result = conn.getStatements(null, null, null, false);
@@ -317,6 +316,7 @@ public class SingleDocumentExtractionTest extends AbstractAny23TestBase {
* @param value
* @throws RepositoryException
*/
+ @SuppressWarnings("unused")
private void assertTriple(IRI predicate, String value) throws RepositoryException {
assertTriple(predicate, SimpleValueFactory.getInstance().createLiteral(value) );
}
diff --git a/core/src/test/java/org/apache/any23/extractor/csv/CSVReaderBuilderTest.java b/core/src/test/java/org/apache/any23/extractor/csv/CSVReaderBuilderTest.java
index 4489e78..3b06467 100644
--- a/core/src/test/java/org/apache/any23/extractor/csv/CSVReaderBuilderTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/csv/CSVReaderBuilderTest.java
@@ -33,7 +33,7 @@ public class CSVReaderBuilderTest {
/**
* Tests positive CSV detection.
*
- * @throws IOException
+ * @throws IOException if there is an error interpreting the input data
*/
@Test
public void testPositiveCSVDetection() throws IOException {
@@ -54,7 +54,7 @@ public class CSVReaderBuilderTest {
/**
* Tests negative CSV detection.
*
- * @throws IOException
+ * @throws IOException if there is an error interpreting the input data
*/
@Test
public void testNegativeCSVDetection() throws IOException {
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 d9e0fe5..e351e74 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
@@ -103,7 +103,7 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
/**
* Test case initialization.
*
- * @throws Exception
+ * @throws Exception if there is an error constructing input objects
*/
@Before
public void setUp() throws Exception {
@@ -117,7 +117,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
/**
* Test case resources release.
*
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+
*/
@After
public void tearDown() throws RepositoryException {
@@ -178,8 +179,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
*
* @param resource
* resource name.
- * @throws org.apache.any23.extractor.ExtractionException
- * @throws IOException
+ * @throws org.apache.any23.extractor.ExtractionException if there is an exception during extraction
+ * @throws IOException if there is an error processing the input data
*/
// TODO: MimeType detector to null forces the execution of all extractors,
// but extraction
@@ -220,7 +221,7 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* Performs data extraction over the content of a resource and assert that
* the extraction was fine and raised no issues.
*
- * @param resource
+ * @param resource input resource to test extraction on.
*/
protected void assertExtract(String resource) {
assertExtract(resource, true);
@@ -234,7 +235,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate
* @param o
* object.
- * @throws RepositoryException
+ * @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);
@@ -248,7 +250,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate
* @param o
* object.
- * @throws RepositoryException
+ * @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));
@@ -262,7 +265,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate
* @param o
* object.
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+
*/
protected void assertNotContains(IRI p, Resource o)
throws RepositoryException {
@@ -279,7 +283,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate.
* @param o
* object.
- * @throws RepositoryException
+ * @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 {
@@ -299,7 +304,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate.
* @param o
* object.
- * @throws RepositoryException
+ * @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 {
@@ -317,7 +323,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate.
* @param o
* object.
- * @throws RepositoryException
+ * @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 {
@@ -328,7 +335,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
/**
* Asserts that the model contains at least a statement.
*
- * @throws RepositoryException
+ * @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."
@@ -344,7 +352,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate.
* @param o
* object.
- * @throws RepositoryException
+ * @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 {
@@ -355,7 +364,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
/**
* Asserts that the model is expected to contains no statements.
*
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+
*/
protected void assertModelEmpty() throws RepositoryException {
Assert.assertTrue(getFailedExtractionMessage(), conn.isEmpty());
@@ -410,7 +420,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
*
* @param statements
* list of statements to be verified.
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+
*/
public void assertContainsModel(Statement[] statements)
throws RepositoryException {
@@ -425,10 +436,11 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
*
* @param modelResource
* the resource containing the model.
- * @throws RDFHandlerException
- * @throws IOException
- * @throws RDFParseException
- * @throws RepositoryException
+ * @throws RDFHandlerException if there is an error within the {@link org.eclipse.rdf4j.rio.RDFHandler}
+ * @throws IOException if there is an error processing the input data
+ * @throws RDFParseException 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,
@@ -452,7 +464,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* object.
* @param expected
* expected matches.
- * @throws RepositoryException
+ * @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 {
@@ -475,7 +488,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* object.
* @param expected
* expected matches.
- * @throws RepositoryException
+ * @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 {
@@ -492,7 +506,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* object.
* @param expected
* expected matches.
- * @throws RepositoryException
+ * @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 {
@@ -507,7 +522,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* subject.
* @param p
* predicate.
- * @throws RepositoryException
+ * @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,
@@ -528,7 +544,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* @param o
* object.
* @return the matching blank subject.
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+
*/
protected Resource findExactlyOneBlankSubject(IRI p, Value o)
throws RepositoryException {
@@ -555,7 +572,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* @param p
* predicate.
* @return the matching object.
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+
*/
protected Value findExactlyOneObject(Resource s, IRI p)
throws RepositoryException {
@@ -576,7 +594,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* @param o
* object.
* @return list of matching subjects.
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+
*/
protected List<Resource> findSubjects(IRI p, Value o)
throws RepositoryException {
@@ -602,7 +621,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* @param p
* predicate.
* @return list of matching objects.
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+
*/
protected List<Value> findObjects(Resource s, IRI p)
throws RepositoryException {
@@ -629,7 +649,7 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* @param p
* predicate
* @return matching object.
- * @throws org.eclipse.rdf4j.repository.RepositoryException
+ * @throws org.eclipse.rdf4j.repository.RepositoryException if an error is encountered whilst loading content from a storage connection
*/
protected Value findObject(Resource s, IRI p) throws RepositoryException {
RepositoryResult<Statement> statements = conn.getStatements(s, p, null,
@@ -652,7 +672,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* @param p
* predicate.
* @return matching object.
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+
*/
protected Resource findObjectAsResource(Resource s, IRI p)
throws RepositoryException {
@@ -675,7 +696,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* @param p
* predicate.
* @return matching object.
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+
*/
protected String findObjectAsLiteral(Resource s, IRI p)
throws RepositoryException {
@@ -686,7 +708,8 @@ 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
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+
*/
protected String dumpModelToTurtle() throws RepositoryException {
StringWriter w = new StringWriter();
@@ -702,7 +725,8 @@ 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
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+
*/
protected String dumpModelToNQuads() throws RepositoryException {
StringWriter w = new StringWriter();
@@ -718,7 +742,8 @@ 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
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+
*/
protected String dumpModelToRDFXML() throws RepositoryException {
StringWriter w = new StringWriter();
@@ -734,7 +759,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* Dumps the list of statements contained in the extracted model.
*
* @return list of extracted statements.
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+
*/
protected List<Statement> dumpAsListOfStatements()
throws RepositoryException {
@@ -743,7 +769,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
/**
* @return string containing human readable statements.
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+
*/
protected String dumpHumanReadableTriples() throws RepositoryException {
StringBuilder sb = new StringBuilder();
@@ -764,8 +791,9 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* statement declares bnodes, they are replaced with <code>_</code>
* patterns.
*
- * @param statement
- * @throws RepositoryException
+ * @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)
@@ -789,7 +817,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* predicate.
* @param l
* literal content.
- * @throws RepositoryException
+ * @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 {
@@ -808,7 +837,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* literal content.
* @param lang
* literal language.
- * @throws RepositoryException
+ * @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 {
@@ -825,7 +855,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* @param o
* object.
* @return list of statements.
- * @throws RepositoryException
+ * @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 {
@@ -842,7 +873,8 @@ public abstract class AbstractExtractorTestCase extends AbstractAny23TestBase {
* @param o
* object.
* @return number of matches.
- * @throws RepositoryException
+ * @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 {
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 95ee69b..fbf5a3f 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
@@ -52,6 +52,7 @@ public class EncodingTest extends AbstractAny23TestBase {
* for the title.
*
* For this test we expect to not recognize the title.
+ * @throws Exception if there is an error asserting the test data.
*/
@Test
public void testEncodingHTML_UTF_8_DeclarationAfterTitle() throws Exception {
diff --git a/core/src/test/java/org/apache/any23/extractor/html/HCardExtractorTest.java b/core/src/test/java/org/apache/any23/extractor/html/HCardExtractorTest.java
index 37f1b44..be46930 100644
--- a/core/src/test/java/org/apache/any23/extractor/html/HCardExtractorTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/html/HCardExtractorTest.java
@@ -929,7 +929,7 @@ public class HCardExtractorTest extends AbstractExtractorTestCase {
* Tests that the HCardName data is not cumulative and is cleaned up at each
* extraction.
*
- * @throws Exception
+ * @throws Exception if there is an error asserting the test data.
*/
@Test
public void testCumulativeHNames() throws Exception {
@@ -944,8 +944,8 @@ public class HCardExtractorTest extends AbstractExtractorTestCase {
* sibling node. This test is related to issue <a
* href="https://issues.apache.org/jira/browse/ANY23-58">ANY23-58</a>.
*
- * @throws IOException
- * @throws ExtractionException
+ * @throws IOException if there is an error interpreting the input data
+ * @throws ExtractionException if there is an exception during extraction
*/
@Test
public void testInfiniteLoop() throws IOException, ExtractionException {
diff --git a/core/src/test/java/org/apache/any23/extractor/html/HReviewExtractorTest.java b/core/src/test/java/org/apache/any23/extractor/html/HReviewExtractorTest.java
index 53b715c..b5ef065 100644
--- a/core/src/test/java/org/apache/any23/extractor/html/HReviewExtractorTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/html/HReviewExtractorTest.java
@@ -28,7 +28,6 @@ import org.eclipse.rdf4j.model.Resource;
import org.eclipse.rdf4j.model.Statement;
import org.eclipse.rdf4j.model.Value;
import org.eclipse.rdf4j.model.vocabulary.RDF;
-import org.eclipse.rdf4j.repository.RepositoryException;
import org.eclipse.rdf4j.repository.RepositoryResult;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
@@ -288,7 +287,7 @@ public class HReviewExtractorTest extends AbstractExtractorTestCase {
* in presence of a <i>Microformat</i> name with a different letter
* capitalization.
*
- * @throws RepositoryException
+ * @throws Exception if there is an error asserting the test data.
*/
@Test
public void testCaseSensitiveness() throws Exception {
diff --git a/core/src/test/java/org/apache/any23/extractor/html/SpeciesExtractorTest.java b/core/src/test/java/org/apache/any23/extractor/html/SpeciesExtractorTest.java
index 56ff2f2..0756baa 100644
--- a/core/src/test/java/org/apache/any23/extractor/html/SpeciesExtractorTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/html/SpeciesExtractorTest.java
@@ -21,7 +21,6 @@ import org.apache.any23.extractor.ExtractorFactory;
import org.apache.any23.vocab.WO;
import org.junit.Test;
import org.eclipse.rdf4j.model.Value;
-import org.eclipse.rdf4j.repository.RepositoryException;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
@@ -44,7 +43,7 @@ public class SpeciesExtractorTest extends AbstractExtractorTestCase {
/**
* Test the beahvior against two <a href="http://en.wikipedia.org/wiki/Template:Taxobox">Wikipedia Taxobox</a>.
*
- * @throws RepositoryException
+ * @throws Exception if there is an error asserting the test data.
*/
@Test
public void testSpeciesMicroformatExtractOverTaxoBox() throws Exception {
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 bd0a8a8..50f5eb8 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
@@ -82,9 +82,9 @@ public class TagSoupParserTest {
* We expect that this test may fail if something changes in the Neko library, as an auto-detection of
* the encoding.
*
- * @throws IOException
- * @throws ExtractionException
- * @throws RepositoryException
+ * @throws IOException if there is an error interpreting the input data
+ * @throws ExtractionException if there is an exception during extraction
+ * @throws org.eclipse.rdf4j.repository.RepositoryException if an error is encountered whilst loading content from a storage connection
*/
@Test
public void testImplicitEncodingBehavior() throws IOException, ExtractionException, RepositoryException {
@@ -103,7 +103,7 @@ public class TagSoupParserTest {
* Test related to the issue 78 and disabled until the underlying <i>NekoHTML</i>
* bug has been fixed.
*
- * @throws IOException
+ * @throws IOException if there is an error interpreting the input data
*/
@Test
public void testEmptySpanElements() throws IOException {
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 fc29ba7..3c1583f 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
@@ -68,7 +68,7 @@ public class TitleExtractorTest extends AbstractExtractorTestCase {
/**
* This test verifies that when present the default language this is adopted by the title literal.
*
- * @throws RepositoryException
+ * @throws org.eclipse.rdf4j.repository.RepositoryException if an error is encountered whilst loading content from a storage connection
*/
@Test
public void testTitleWithDefaultLanguage() throws RepositoryException {
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 ab2b977..03544e7 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
@@ -17,10 +17,10 @@
package org.apache.any23.extractor.html;
+import org.apache.any23.extractor.ExtractionException;
import org.apache.any23.extractor.ExtractorFactory;
import org.junit.Test;
import org.eclipse.rdf4j.model.Value;
-import org.eclipse.rdf4j.repository.RepositoryException;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
@@ -43,9 +43,9 @@ public class TurtleHTMLExtractorTest extends AbstractExtractorTestCase {
/**
* Tests the extraction of the RDF content from the sample HTML file.
*
- * @throws IOException
- * @throws org.apache.any23.extractor.ExtractionException
- * @throws RepositoryException
+ * @throws IOException if there is an error interpreting the input data
+ * @throws ExtractionException if there is an exception during extraction
+ * @throws org.eclipse.rdf4j.repository.RepositoryException if an error is encountered whilst loading content from a storage connection
*/
@Test
public void testExtraction() throws Exception {
diff --git a/core/src/test/java/org/apache/any23/extractor/microdata/MicrodataExtractorTest.java b/core/src/test/java/org/apache/any23/extractor/microdata/MicrodataExtractorTest.java
index 9d27ffa..91bf103 100644
--- a/core/src/test/java/org/apache/any23/extractor/microdata/MicrodataExtractorTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/microdata/MicrodataExtractorTest.java
@@ -83,10 +83,11 @@ public class MicrodataExtractorTest extends AbstractExtractorTestCase {
/**
* Reference test for <a href="http://schema.org">Schema.org</a>.
*
- * @throws RepositoryException
- * @throws RDFHandlerException
- * @throws IOException
- * @throws RDFParseException
+ * @throws ExtractionException if an exception is raised during extraction
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+ * @throws RDFHandlerException if there is an error in the {@link org.eclipse.rdf4j.rio.RDFHandler} implementation
+ * @throws IOException if there is an error loading input data
+ * @throws RDFParseException if there is an error parsing an actual RDF stream
*/
@Test
public void testSchemaOrgNestedProps()
@@ -294,10 +295,10 @@ public class MicrodataExtractorTest extends AbstractExtractorTestCase {
/**
* Reference test as provided by <a href="http://googlewebmastercentral.blogspot.com/2010/03/microdata-support-for-rich-snippets.html">Google Rich Snippet for Microdata.</a>
*
- * @throws RDFHandlerException
- * @throws RepositoryException
- * @throws IOException
- * @throws RDFParseException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+ * @throws RDFHandlerException if there is an error in the {@link org.eclipse.rdf4j.rio.RDFHandler} implementation
+ * @throws IOException if there is an error loading input data
+ * @throws RDFParseException if there is an error parsing an actual RDF stream
*/
@Test
public void testMicrodataGoogleRichSnippet()
@@ -312,10 +313,10 @@ public class MicrodataExtractorTest extends AbstractExtractorTestCase {
/**
* First reference test for <a href="http://www.w3.org/TR/microdata/">Microdata Extraction algorithm</a>.
*
- * @throws RDFHandlerException
- * @throws RepositoryException
- * @throws IOException
- * @throws RDFParseException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+ * @throws RDFHandlerException if there is an error in the {@link org.eclipse.rdf4j.rio.RDFHandler} implementation
+ * @throws IOException if there is an error loading input data
+ * @throws RDFParseException if there is an error parsing an actual RDF stream
*/
@Test
public void testExample5221()
@@ -330,10 +331,10 @@ public class MicrodataExtractorTest extends AbstractExtractorTestCase {
/**
* Second reference test for <a href="http://www.w3.org/TR/microdata/">Microdata Extraction algorithm</a>.
*
- * @throws RDFHandlerException
- * @throws RepositoryException
- * @throws IOException
- * @throws RDFParseException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+ * @throws RDFHandlerException if there is an error in the {@link org.eclipse.rdf4j.rio.RDFHandler} implementation
+ * @throws IOException if there is an error loading input data
+ * @throws RDFParseException if there is an error parsing an actual RDF stream
*/
@Test
public void testExample5222()
@@ -348,10 +349,10 @@ public class MicrodataExtractorTest extends AbstractExtractorTestCase {
/**
* First reference test for <a href="http://schema.org/">http://schema.org/</a>.
*
- * @throws RDFHandlerException
- * @throws RepositoryException
- * @throws IOException
- * @throws RDFParseException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+ * @throws RDFHandlerException if there is an error in the {@link org.eclipse.rdf4j.rio.RDFHandler} implementation
+ * @throws IOException if there is an error loading input data
+ * @throws RDFParseException if there is an error parsing an actual RDF stream
*/
@Test
public void testExampleSchemaOrg1()
@@ -366,10 +367,10 @@ public class MicrodataExtractorTest extends AbstractExtractorTestCase {
/**
* Second reference test for <a href="http://schema.org/">http://schema.org/</a>.
*
- * @throws RDFHandlerException
- * @throws RepositoryException
- * @throws IOException
- * @throws RDFParseException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+ * @throws RDFHandlerException if there is an error in the {@link org.eclipse.rdf4j.rio.RDFHandler} implementation
+ * @throws IOException if there is an error loading input data
+ * @throws RDFParseException if there is an error parsing an actual RDF stream
*/
@Test
public void testExampleSchemaOrg2()
diff --git a/core/src/test/java/org/apache/any23/extractor/microdata/MicrodataParserTest.java b/core/src/test/java/org/apache/any23/extractor/microdata/MicrodataParserTest.java
index 8b2addd..a2cd8b6 100644
--- a/core/src/test/java/org/apache/any23/extractor/microdata/MicrodataParserTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/microdata/MicrodataParserTest.java
@@ -50,9 +50,6 @@ import static org.junit.Assert.assertFalse;
*/
public class MicrodataParserTest {
-// @Rule
-// public final Timeout timeout = new Timeout(100, TimeUnit.SECONDS);
-
private static final Logger logger = LoggerFactory.getLogger(MicrodataParserTest.class);
@Test
@@ -153,8 +150,8 @@ public class MicrodataParserTest {
/**
* Test the main use case of {@link MicrodataParser#deferProperties(String...)}
*
- * @throws IOException
- * @throws MicrodataParserException
+ * @throws IOException if there is an error processing the input data
+ * @throws MicrodataParserException if there is an error within the {@link org.apache.any23.extractor.microdata.MicrodataParser}
*/
@Test
public void testDeferProperties() throws IOException, MicrodataParserException {
@@ -167,8 +164,8 @@ public class MicrodataParserTest {
/**
* Tests the loop detection in {@link MicrodataParser#deferProperties(String...)}.
*
- * @throws IOException
- * @throws MicrodataParserException
+ * @throws IOException if there is an error processing the input data
+ * @throws MicrodataParserException if there is an error within the {@link org.apache.any23.extractor.microdata.MicrodataParser}
*/
@Test(expected = MicrodataParserException.class)
public void testDeferPropertiesLoopDetection1() throws IOException, MicrodataParserException {
@@ -181,8 +178,8 @@ public class MicrodataParserTest {
/**
* Tests the deep loop detection in {@link MicrodataParser#deferProperties(String...)}.
*
- * @throws IOException
- * @throws MicrodataParserException
+ * @throws IOException if there is an error processing the input data
+ * @throws MicrodataParserException if there is an error within the {@link org.apache.any23.extractor.microdata.MicrodataParser}
*/
@Test(expected = MicrodataParserException.class)
public void testDeferPropertiesLoopDetection2() throws IOException, MicrodataParserException {
@@ -196,8 +193,8 @@ public class MicrodataParserTest {
* Tests that the loop detection works property even with multiple calls
* of {@link MicrodataParser#deferProperties(String...)} over the same item props.
*
- * @throws java.io.IOException
- * @throws MicrodataParserException
+ * @throws java.io.IOException if there is an error processing the input data
+ * @throws MicrodataParserException if there is an error within the {@link org.apache.any23.extractor.microdata.MicrodataParser}
*/
@Test
public void testDeferPropertiesStateManagement() throws IOException, MicrodataParserException {
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 a0f618d..c6f8790 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
@@ -61,9 +61,9 @@ public class TurtleExtractorTest {
/**
* Tests the correct support for a typed literal with incompatible value.
*
- * @throws IOException
- * @throws ExtractionException
- * @throws TripleHandlerException
+ * @throws IOException if there is an error interpreting the input data
+ * @throws ExtractionException if there is an exception during extraction
+ * @throws TripleHandlerException if there is an error within the {@link org.apache.any23.writer.TripleHandler} implementation
*/
@Test
public void testTypedLiteralIncompatibleValueSupport()
diff --git a/core/src/test/java/org/apache/any23/extractor/rdfa/AbstractRDFaExtractorTestCase.java b/core/src/test/java/org/apache/any23/extractor/rdfa/AbstractRDFaExtractorTestCase.java
index 21935cb..ff4120b 100644
--- a/core/src/test/java/org/apache/any23/extractor/rdfa/AbstractRDFaExtractorTestCase.java
+++ b/core/src/test/java/org/apache/any23/extractor/rdfa/AbstractRDFaExtractorTestCase.java
@@ -41,7 +41,7 @@ public abstract class AbstractRDFaExtractorTestCase extends
/**
* Verify the basic RDFa support.
*
- * @throws org.eclipse.rdf4j.repository.RepositoryException
+ * @throws Exception if there is an issue asserting test values.
*/
@Test
public void testBasic() throws Exception {
@@ -55,13 +55,11 @@ public abstract class AbstractRDFaExtractorTestCase extends
}
/**
- * This test check if the <a
- * href=""http://www.w3.org/TR/2010/WD-rdfa-core-20100422
- * /#s_curieprocessing">RDFa1.1 CURIEs</a> expansion is correct and backward
- * compatible with <a
- * href="http://www.w3.org/TR/rdfa-syntax/#s_curieprocessing">RDFa 1.0</a>.
+ * This test check if the <a href="https://www.w3.org/TR/rdfa-core/#s_curieprocessing">RDFa1.1 CURIEs</a>
+ * expansion is correct and backward compatible with
+ * <a href="http://www.w3.org/TR/rdfa-syntax/#s_curieprocessing">RDFa 1.0</a>.
*
- * @throws Exception
+ * @throws Exception if there is an issue asserting test values.
*/
@Test
public void testRDFa11CURIEs() throws Exception {
@@ -98,7 +96,7 @@ public abstract class AbstractRDFaExtractorTestCase extends
* details see the <a href="http://www.w3.org/TR/rdfa-syntax/">RDFa in
* XHTML: Syntax and Processing</a> recommendation.
*
- * @throws Exception
+ * @throws Exception if there an error asserting test values.
*/
@Test
public void testEmptyDatatypeDeclarationWithInnerXMLTags() throws Exception {
@@ -118,7 +116,7 @@ public abstract class AbstractRDFaExtractorTestCase extends
* href="http://files.openspring.net/tmp/drupal-test-frontpage.html">Drupal
* test page</a>.
*
- * @throws org.eclipse.rdf4j.repository.RepositoryException
+ * @throws Exception if there an error asserting test values.
*/
@Test
public void testDrupalTestPage() throws Exception {
@@ -131,7 +129,7 @@ public abstract class AbstractRDFaExtractorTestCase extends
/**
* See RDFa 1.1 Specification section 6.2 .
*
- * @throws Exception
+ * @throws Exception if there an error asserting test values.
*/
@Test
public void testIncompleteTripleManagement() throws Exception {
diff --git a/core/src/test/java/org/apache/any23/extractor/rdfa/RDFa11ExtractorTest.java b/core/src/test/java/org/apache/any23/extractor/rdfa/RDFa11ExtractorTest.java
index 1bc63d4..35ae030 100644
--- a/core/src/test/java/org/apache/any23/extractor/rdfa/RDFa11ExtractorTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/rdfa/RDFa11ExtractorTest.java
@@ -47,7 +47,7 @@ public class RDFa11ExtractorTest extends AbstractRDFaExtractorTestCase {
/**
* This test verifies the correct object resource conversion.
*
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
*/
@Test
public void testObjectResourceConversion() throws RepositoryException {
@@ -140,7 +140,7 @@ public class RDFa11ExtractorTest extends AbstractRDFaExtractorTestCase {
* For details see the <a href="http://www.w3.org/TR/rdfa-syntax/">RDFa in XHTML: Syntax and Processing</a>
* recommendation.
*
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
*/
@Test
public void testExplicitDatatypeDeclaration() throws RepositoryException {
@@ -165,7 +165,7 @@ public class RDFa11ExtractorTest extends AbstractRDFaExtractorTestCase {
/**
* Tests the correct behavior of <i>REL</i> and <i>HREF</i>.
*
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
*/
@Test
public void testRelWithHref() throws RepositoryException {
@@ -187,7 +187,7 @@ public class RDFa11ExtractorTest extends AbstractRDFaExtractorTestCase {
/**
* This test verifies the correct <em>REL/REV</em> attribute usage.
*
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
*/
@Test
public void testRelRevSupport() throws RepositoryException {
@@ -209,7 +209,7 @@ public class RDFa11ExtractorTest extends AbstractRDFaExtractorTestCase {
/**
* Tests the <em>@vocab</em> support.
*
- * @throws RepositoryException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
*/
@Test
public void testVocabSupport() throws RepositoryException {
@@ -240,10 +240,10 @@ public class RDFa11ExtractorTest extends AbstractRDFaExtractorTestCase {
* Taken from the <a href="http://www.heppnetz.de/rdfa4google/testcases.html">GoodRelations test cases</a>.
* It checks if the extraction is the same when the namespaces are defined in <i>RDFa1.0</i>.
*
- * @throws RepositoryException
- * @throws java.io.IOException
- * @throws org.eclipse.rdf4j.rio.RDFHandlerException
- * @throws org.eclipse.rdf4j.rio.RDFParseException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+ * @throws java.io.IOException if there is an error processing input data
+ * @throws org.eclipse.rdf4j.rio.RDFHandlerException if there is an error in the {@link org.eclipse.rdf4j.rio.RDFHandler}
+ * @throws org.eclipse.rdf4j.rio.RDFParseException if there is an error parsing input RDF
*/
@Test
public void testRDFa10Extraction()
@@ -261,10 +261,10 @@ public class RDFa11ExtractorTest extends AbstractRDFaExtractorTestCase {
* Taken from the <a href="http://www.heppnetz.de/rdfa4google/testcases.html">GoodRelations test cases</a>.
* It checks if the extraction is the same when the namespaces are defined in <i>RDFa1.1</i>.
*
- * @throws RepositoryException
- * @throws java.io.IOException
- * @throws org.eclipse.rdf4j.rio.RDFHandlerException
- * @throws org.eclipse.rdf4j.rio.RDFParseException
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
+ * @throws java.io.IOException if there is an error processing input data
+ * @throws org.eclipse.rdf4j.rio.RDFHandlerException if there is an error in the {@link org.eclipse.rdf4j.rio.RDFHandler}
+ * @throws org.eclipse.rdf4j.rio.RDFParseException if there is an error parsing input RDF
*/
@Test
public void testRDFa11Extraction()
@@ -285,9 +285,9 @@ public class RDFa11ExtractorTest extends AbstractRDFaExtractorTestCase {
* <a href="http://ogp.me/#structured">Structured Properties</a> and
* <a href="http://ogp.me/#array">Arrays</a>.
*
- * @throws IOException
- * @throws org.apache.any23.extractor.ExtractionException
- * @throws RepositoryException
+ * @throws IOException if there is an error processing the input data
+ * @throws org.apache.any23.extractor.ExtractionException if there is an exception during extraction
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
*/
@Test
public void testOpenGraphStructuredProperties() throws IOException, ExtractionException, RepositoryException {
@@ -321,9 +321,9 @@ public class RDFa11ExtractorTest extends AbstractRDFaExtractorTestCase {
* Tests the correct support of alternate
* <a href="http://ogp.me/#types">Open Graph Protocol Object Types</a>
*
- * @throws IOException
- * @throws org.apache.any23.extractor.ExtractionException
- * @throws RepositoryException
+ * @throws IOException if there is an error processing the input data
+ * @throws org.apache.any23.extractor.ExtractionException if there is an exception during extraction
+ * @throws RepositoryException if an error is encountered whilst loading content from a storage connection
*/
@Test
public void testOpenGraphAlternateObjectTypes() throws IOException, ExtractionException, RepositoryException {
diff --git a/core/src/test/java/org/apache/any23/extractor/rdfa/RDFaExtractorTest.java b/core/src/test/java/org/apache/any23/extractor/rdfa/RDFaExtractorTest.java
index 0ca6f0f..ed93823 100644
--- a/core/src/test/java/org/apache/any23/extractor/rdfa/RDFaExtractorTest.java
+++ b/core/src/test/java/org/apache/any23/extractor/rdfa/RDFaExtractorTest.java
@@ -38,10 +38,10 @@ public class RDFaExtractorTest extends AbstractRDFaExtractorTestCase {
* It checks if the extraction is the same when the namespaces are defined in <i>RDFa1.0</i> or
* <i>RDFa1.1</i> respectively.
*
- * @throws org.eclipse.rdf4j.repository.RepositoryException
- * @throws java.io.IOException
- * @throws org.eclipse.rdf4j.rio.RDFHandlerException
- * @throws org.eclipse.rdf4j.rio.RDFParseException
+ * @throws org.eclipse.rdf4j.repository.RepositoryException if an error is encountered whilst loading content from a storage connection
+ * @throws java.io.IOException if there is an error interpreting the input data
+ * @throws org.eclipse.rdf4j.rio.RDFHandlerException if there is an error within the {@link org.eclipse.rdf4j.rio.RDFHandler}
+ * @throws org.eclipse.rdf4j.rio.RDFParseException if there is an exception parsing an RDF Stream
*/
@Test
public void testRDFa11PrefixBackwardCompatibility()
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 e510c70..3c512ea 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,6 +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.
*/
@Test
public void simpleTest312()
@@ -154,8 +155,8 @@ 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/><br/>Case 1:
+ * <br><b>NB:</b> Following yaml standard those 2 cases are parsed to different graphs:
+ * <br>Case 1:
*
* <pre>
* ---
@@ -172,7 +173,7 @@ public class YAMLExtractorTest extends AbstractExtractorTestCase {
* - key3: Some text value, maybe description
* </pre>
*
- * @throws Exception
+ * @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 c2b93a5..6180a18 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
+ * @throws Exception if there is an error asserting the test data.
*/
@Test
public void tikaStreamDetect()
diff --git a/core/src/test/java/org/apache/any23/util/DiscoveryUtilsTest.java b/core/src/test/java/org/apache/any23/util/DiscoveryUtilsTest.java
index 902e91b..07f39bd 100644
--- a/core/src/test/java/org/apache/any23/util/DiscoveryUtilsTest.java
+++ b/core/src/test/java/org/apache/any23/util/DiscoveryUtilsTest.java
@@ -35,8 +35,8 @@ public class DiscoveryUtilsTest {
/**
* Test case for {@link DiscoveryUtils#getClassesInPackage(String, Class)} with detection in classes dir.
*
- * @throws ClassNotFoundException
- * @throws IOException
+ * @throws ClassNotFoundException if there is an error location class in 'org.apache.any23.vocab' package
+ * @throws IOException if there is an error in the input
*/
@Test
public void testGetClassesInPackage() throws ClassNotFoundException, IOException {
@@ -47,8 +47,8 @@ public class DiscoveryUtilsTest {
/**
* Test case for {@link DiscoveryUtils#getClassesInPackage(String, Class)} with detection in JAR file.
*
- * @throws ClassNotFoundException
- * @throws IOException
+ * @throws ClassNotFoundException if there is an error location class in 'org.eclipse.rdf4j' package
+ * @throws IOException if there is an error in the input
*/
@Test
public void testGetClassesInJAR() throws ClassNotFoundException, IOException {
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 715db3e..1a207cd 100644
--- a/mime/src/test/java/org/apache/any23/mime/TikaMIMETypeDetectorTest.java
+++ b/mime/src/test/java/org/apache/any23/mime/TikaMIMETypeDetectorTest.java
@@ -382,8 +382,7 @@ public class TikaMIMETypeDetectorTest {
/**
* Test done only based on content is failed because the standard does not
* require to have "%YAML" header.
- *
- * @throws Exception
+ * @throws Exception if there is an error detecting the mime type from the content and name
*/
@Test
public void testYAMLByContentAndName() throws Exception {
diff --git a/plugins/basic-crawler/src/test/java/org/apache/any23/plugin/crawler/SiteCrawlerTest.java b/plugins/basic-crawler/src/test/java/org/apache/any23/plugin/crawler/SiteCrawlerTest.java
index 5958631..5c7fc02 100644
--- a/plugins/basic-crawler/src/test/java/org/apache/any23/plugin/crawler/SiteCrawlerTest.java
+++ b/plugins/basic-crawler/src/test/java/org/apache/any23/plugin/crawler/SiteCrawlerTest.java
@@ -42,7 +42,7 @@ public class SiteCrawlerTest extends Any23OnlineTestBase {
/**
* Tests the main crawler use case.
*
- * @throws Exception
+ * @throws Exception if there is an error asserting test data
*/
@Test
public void testSiteCrawling() throws Exception {
diff --git a/pom.xml b/pom.xml
index 55c59e6..97ff611 100644
--- a/pom.xml
+++ b/pom.xml
@@ -838,15 +838,22 @@
<reportSets>
<reportSet>
<reports>
- <report>cim</report>
+ <report>ci-management</report>
<report>dependencies</report>
+ <report>dependency-convergence</report>
+ <report>dependency-info</report>
+ <report>dependency-management</report>
<report>distribution-management</report>
- <report>issue-tracking</report>
- <report>license</report>
- <report>mailing-list</report>
+ <report>index</report>
+ <report>issue-management</report>
+ <report>licenses</report>
+ <report>mailing-lists</report>
<report>modules</report>
- <report>project-team</report>
+ <report>plugin-management</report>
+ <report>plugins</report>
<report>scm</report>
+ <report>summary</report>
+ <report>team</report>
</reports>
</reportSet>
</reportSets>
diff --git a/service/src/test/java/org/apache/any23/servlet/ServletTest.java b/service/src/test/java/org/apache/any23/servlet/ServletTest.java
index 96dd3c5..e29c694 100644
--- a/service/src/test/java/org/apache/any23/servlet/ServletTest.java
+++ b/service/src/test/java/org/apache/any23/servlet/ServletTest.java
@@ -225,7 +225,7 @@ public class ServletTest {
* This test has been disabled in order to avoid external resources
* dependencies
*
- * @throws Exception
+ * @throws Exception if there is an error asserting test data
*/
@Test
public void testGETwithURLEncoding() throws Exception {
@@ -238,7 +238,7 @@ public class ServletTest {
* This test has been disabled in order to avoid external resources
* dependencies
*
- * @throws Exception
+ * @throws Exception if there is an error asserting test data
*/
@Test
public void testGETwithURLEncodingWithQuery() throws Exception {
@@ -251,7 +251,7 @@ public class ServletTest {
* This test has been disabled in order to avoid external resources
* dependencies
*
- * @throws Exception
+ * @throws Exception if there is an error asserting test data
*/
@Test
public void testGETwithURLEncodingWithFragment() throws Exception {