SPARQLJSONTupleTest.java

/*******************************************************************************
 * Copyright (c) 2015 Eclipse RDF4J contributors, Aduna, and others.
 *
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Distribution License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/org/documents/edl-v10.php.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 *******************************************************************************/
package org.eclipse.rdf4j.query.resultio.sparqljson;

import static org.assertj.core.api.Assertions.fail;
import static org.assertj.core.api.AssertionsForClassTypes.assertThatThrownBy;
import static org.assertj.core.api.AssertionsForInterfaceTypes.assertThat;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertFalse;
import static org.junit.jupiter.api.Assertions.assertNotNull;
import static org.junit.jupiter.api.Assertions.assertNull;
import static org.junit.jupiter.api.Assertions.assertTrue;

import java.io.InputStream;

import org.eclipse.rdf4j.model.BNode;
import org.eclipse.rdf4j.model.IRI;
import org.eclipse.rdf4j.model.Literal;
import org.eclipse.rdf4j.model.Triple;
import org.eclipse.rdf4j.model.impl.SimpleValueFactory;
import org.eclipse.rdf4j.model.vocabulary.RDF;
import org.eclipse.rdf4j.model.vocabulary.XSD;
import org.eclipse.rdf4j.query.BindingSet;
import org.eclipse.rdf4j.query.resultio.BooleanQueryResultFormat;
import org.eclipse.rdf4j.query.resultio.QueryResultParseException;
import org.eclipse.rdf4j.query.resultio.TupleQueryResultFormat;
import org.eclipse.rdf4j.query.resultio.helpers.QueryResultCollector;
import org.eclipse.rdf4j.testsuite.query.resultio.AbstractQueryResultIOTupleTest;
import org.junit.jupiter.api.Test;

/**
 * @author Peter Ansell
 * @author Sebastian Schaffert
 */
public class SPARQLJSONTupleTest extends AbstractQueryResultIOTupleTest {

	@Override
	protected String getFileName() {
		return "test.srj";
	}

	@Override
	protected TupleQueryResultFormat getTupleFormat() {
		return TupleQueryResultFormat.JSON;
	}

	@Override
	protected BooleanQueryResultFormat getMatchingBooleanFormatOrNull() {
		return BooleanQueryResultFormat.JSON;
	}

	@Test
	public void testBindings1() throws Exception {
		SPARQLResultsJSONParser parser = new SPARQLResultsJSONParser(SimpleValueFactory.getInstance());
		QueryResultCollector handler = new QueryResultCollector();
		parser.setQueryResultHandler(handler);

		InputStream stream = this.getClass().getResourceAsStream("/sparqljson/bindings1.srj");
		assertNotNull(stream, "Could not find test resource");
		parser.parseQueryResult(stream);

		// there must be two variables
		assertEquals(2, handler.getBindingNames().size());

		// first must be called "book", the second "title"
		assertEquals("book", handler.getBindingNames().get(0));
		assertEquals("title", handler.getBindingNames().get(1));

		// should be 7 solutions alltogether
		assertEquals(7, handler.getBindingSets().size());

		// Results are ordered, so first should be book6
		assertEquals("http://example.org/book/book6", handler.getBindingSets().get(0).getValue("book").stringValue());

		for (BindingSet b : handler.getBindingSets()) {
			assertNotNull(b.getValue("book"));
			assertNotNull(b.getValue("title"));
			assertTrue(b.getValue("book") instanceof IRI);
			assertTrue(b.getValue("title") instanceof Literal);

			IRI book = (IRI) b.getValue("book");
			if (book.stringValue().equals("http://example.org/book/book6")) {
				assertEquals("Harry Potter and the Half-Blood Prince", b.getValue("title").stringValue());
			} else if (book.stringValue().equals("http://example.org/book/book7")) {
				assertEquals("Harry Potter and the Deathly Hallows", b.getValue("title").stringValue());
			} else if (book.stringValue().equals("http://example.org/book/book5")) {
				assertEquals("Harry Potter and the Order of the Phoenix", b.getValue("title").stringValue());
			} else if (book.stringValue().equals("http://example.org/book/book4")) {
				assertEquals("Harry Potter and the Goblet of Fire", b.getValue("title").stringValue());
			} else if (book.stringValue().equals("http://example.org/book/book2")) {
				assertEquals("Harry Potter and the Chamber of Secrets", b.getValue("title").stringValue());
			} else if (book.stringValue().equals("http://example.org/book/book3")) {
				assertEquals("Harry Potter and the Prisoner Of Azkaban", b.getValue("title").stringValue());
			} else if (book.stringValue().equals("http://example.org/book/book1")) {
				assertEquals("Harry Potter and the Philosopher's Stone", b.getValue("title").stringValue());
			} else {
				fail("Found unexpected binding set in result: " + b.toString());
			}
		}

	}

	@Test
	public void testBindings2() throws Exception {
		SPARQLResultsJSONParser parser = new SPARQLResultsJSONParser(SimpleValueFactory.getInstance());
		QueryResultCollector handler = new QueryResultCollector();
		parser.setQueryResultHandler(handler);

		InputStream stream = this.getClass().getResourceAsStream("/sparqljson/bindings2.srj");
		assertNotNull(stream, "Could not find test resource");
		parser.parseQueryResult(stream);

		// there must be 7 variables
		assertEquals(7, handler.getBindingNames().size());

		// first must be called "x", etc.,
		assertEquals("x", handler.getBindingNames().get(0));
		assertEquals("hpage", handler.getBindingNames().get(1));
		assertEquals("name", handler.getBindingNames().get(2));
		assertEquals("mbox", handler.getBindingNames().get(3));
		assertEquals("age", handler.getBindingNames().get(4));
		assertEquals("blurb", handler.getBindingNames().get(5));
		assertEquals("friend", handler.getBindingNames().get(6));

		// 2 results
		assertEquals(2, handler.getBindingSets().size());

		// Results are ordered, so first should be alice
		assertEquals("http://work.example.org/alice/", handler.getBindingSets().get(0).getValue("hpage").stringValue());

		for (BindingSet b : handler.getBindingSets()) {

			assertNotNull(b.getValue("x"));
			assertNotNull(b.getValue("hpage"));
			assertNotNull(b.getValue("name"));
			assertNotNull(b.getValue("mbox"));
			assertNotNull(b.getValue("friend"));

			assertTrue(b.getValue("x") instanceof BNode);
			assertTrue(b.getValue("hpage") instanceof IRI);
			assertTrue(b.getValue("name") instanceof Literal);
			assertTrue(b.getValue("friend") instanceof BNode);

			BNode value = (BNode) b.getValue("x");

			if (value.getID().equals("r1")) {
				assertNotNull(b.getValue("blurb"));

				assertTrue(b.getValue("mbox") instanceof Literal);
				assertTrue(b.getValue("blurb") instanceof Literal);

				assertEquals("http://work.example.org/alice/", b.getValue("hpage").stringValue());

				Literal name = (Literal) b.getValue("name");
				assertEquals("Alice", name.stringValue());
				assertFalse(name.getLanguage().isPresent());
				assertEquals(XSD.STRING, name.getDatatype());

				Literal mbox = (Literal) b.getValue("mbox");
				assertEquals("", mbox.stringValue());
				assertFalse(mbox.getLanguage().isPresent());
				assertEquals(XSD.STRING, mbox.getDatatype());

				Literal blurb = (Literal) b.getValue("blurb");
				assertEquals("<p xmlns=\"http://www.w3.org/1999/xhtml\">My name is <b>alice</b></p>",
						blurb.stringValue());
				assertFalse(blurb.getLanguage().isPresent());
				assertEquals(RDF.XMLLITERAL, blurb.getDatatype());
			} else if (value.getID().equals("r2")) {
				assertNull(b.getValue("blurb"));

				assertTrue(b.getValue("mbox") instanceof IRI);

				assertEquals("http://work.example.org/bob/", b.getValue("hpage").stringValue());

				Literal name = (Literal) b.getValue("name");
				assertEquals("Bob", name.stringValue());
				assertEquals("en", name.getLanguage().orElse(null));
				assertEquals(RDF.LANGSTRING, name.getDatatype());

				assertEquals("mailto:bob@work.example.org", b.getValue("mbox").stringValue());
			} else {
				fail("Found unexpected binding set in result: " + b.toString());
			}
		}

		assertEquals(1, handler.getLinks().size());
		assertEquals("http://www.w3.org/TR/2013/REC-sparql11-results-json-20130321/#example",
				handler.getLinks().get(0));

	}

	@Test
	public void testNonStandardDistinct() throws Exception {
		SPARQLResultsJSONParser parser = new SPARQLResultsJSONParser(SimpleValueFactory.getInstance());
		QueryResultCollector handler = new QueryResultCollector();
		parser.setQueryResultHandler(handler);

		InputStream stream = this.getClass().getResourceAsStream("/sparqljson/non-standard-distinct.srj");
		assertNotNull(stream, "Could not find test resource");
		parser.parseQueryResult(stream);

		// there must be 1 variable
		assertEquals(1, handler.getBindingNames().size());

		// first must be called "Concept", etc.,
		assertEquals("Concept", handler.getBindingNames().get(0));

		// -1 results
		assertEquals(100, handler.getBindingSets().size());
	}

	@Test
	public void testNonStandardOrdered() throws Exception {
		SPARQLResultsJSONParser parser = new SPARQLResultsJSONParser(SimpleValueFactory.getInstance());
		QueryResultCollector handler = new QueryResultCollector();
		parser.setQueryResultHandler(handler);

		InputStream stream = this.getClass().getResourceAsStream("/sparqljson/non-standard-ordered.srj");
		assertNotNull(stream, "Could not find test resource");
		parser.parseQueryResult(stream);

		// there must be 1 variable
		assertEquals(1, handler.getBindingNames().size());

		// first must be called "Concept", etc.,
		assertEquals("Concept", handler.getBindingNames().get(0));

		// -1 results
		assertEquals(100, handler.getBindingSets().size());
	}

	@Test
	public void testNonStandardDistinctOrdered() throws Exception {
		SPARQLResultsJSONParser parser = new SPARQLResultsJSONParser(SimpleValueFactory.getInstance());
		QueryResultCollector handler = new QueryResultCollector();
		parser.setQueryResultHandler(handler);

		InputStream stream = this.getClass().getResourceAsStream("/sparqljson/non-standard-distinct-ordered.srj");
		assertNotNull(stream, "Could not find test resource");
		parser.parseQueryResult(stream);

		// there must be 1 variable
		assertEquals(1, handler.getBindingNames().size());

		// first must be called "Concept", etc.,
		assertEquals("Concept", handler.getBindingNames().get(0));

		// -1 results
		assertEquals(100, handler.getBindingSets().size());
	}

	@Test
	public void testOtherKeys() throws Exception {
		SPARQLResultsJSONParser parser = new SPARQLResultsJSONParser(SimpleValueFactory.getInstance());
		QueryResultCollector handler = new QueryResultCollector();
		parser.setQueryResultHandler(handler);

		InputStream stream = this.getClass().getResourceAsStream("/sparqljson/other-keys.srj");
		assertNotNull(stream, "Could not find test resource");
		parser.parseQueryResult(stream);

		// there must be two variables
		assertEquals(2, handler.getBindingNames().size());

		// first must be called "book", the second "title"
		assertEquals("book", handler.getBindingNames().get(0));
		assertEquals("title", handler.getBindingNames().get(1));

		// should be 7 solutions alltogether
		assertEquals(7, handler.getBindingSets().size());

		// Results are ordered, so first should be book6
		assertEquals("http://example.org/book/book6", handler.getBindingSets().get(0).getValue("book").stringValue());

		for (BindingSet b : handler.getBindingSets()) {
			assertNotNull(b.getValue("book"));
			assertNotNull(b.getValue("title"));
			assertTrue(b.getValue("book") instanceof IRI);
			assertTrue(b.getValue("title") instanceof Literal);
		}

	}

	@Test
	public void testRDFStar_extendedFormatRDF4J() throws Exception {
		SPARQLResultsJSONParser parser = new SPARQLResultsJSONParser(SimpleValueFactory.getInstance());
		QueryResultCollector handler = new QueryResultCollector();
		parser.setQueryResultHandler(handler);

		InputStream stream = this.getClass().getResourceAsStream("/sparqljson/rdfstar-extendedformat-rdf4j.srj");
		assertNotNull(stream, "Could not find test resource");
		parser.parseQueryResult(stream);

		assertThat(handler.getBindingNames().size()).isEqualTo(3);
		assertThat(handler.getBindingSets()).hasSize(1).allMatch(bs -> bs.getValue("a") instanceof Triple);
		Triple a = (Triple) handler.getBindingSets().get(0).getValue("a");
		assertThat(a.getSubject().stringValue()).isEqualTo("http://example.org/bob");
		assertThat(a.getPredicate().stringValue()).isEqualTo("http://xmlns.com/foaf/0.1/age");
		assertThat(a.getObject().stringValue()).isEqualTo("23");
	}

	@Test
	public void testRDFStar_extendedFormatRDF4J_incompleteTriple() {
		SPARQLResultsJSONParser parser = new SPARQLResultsJSONParser(SimpleValueFactory.getInstance());
		QueryResultCollector handler = new QueryResultCollector();
		parser.setQueryResultHandler(handler);

		InputStream stream = this.getClass()
				.getResourceAsStream("/sparqljson/rdfstar-extendedformat-rdf4j-incompletetriple.srj");
		assertNotNull(stream, "Could not find test resource");
		assertThatThrownBy(() -> parser.parseQueryResult(stream)).isInstanceOf(QueryResultParseException.class)
				.hasMessageContaining("Incomplete or invalid triple value");
	}

	@Test
	public void testRDFStar_extendedFormatRDF4J_doubleSubject() {
		SPARQLResultsJSONParser parser = new SPARQLResultsJSONParser(SimpleValueFactory.getInstance());
		QueryResultCollector handler = new QueryResultCollector();
		parser.setQueryResultHandler(handler);

		InputStream stream = this.getClass()
				.getResourceAsStream("/sparqljson/rdfstar-extendedformat-rdf4j-doublesubject.srj");
		assertNotNull(stream, "Could not find test resource");
		assertThatThrownBy(() -> parser.parseQueryResult(stream)).isInstanceOf(QueryResultParseException.class)
				.hasMessageContaining("s field encountered twice in triple value:");
	}

	@Test
	public void testRDFStar_extendedFormatStardog() throws Exception {
		SPARQLResultsJSONParser parser = new SPARQLResultsJSONParser(SimpleValueFactory.getInstance());
		QueryResultCollector handler = new QueryResultCollector();
		parser.setQueryResultHandler(handler);

		InputStream stream = this.getClass().getResourceAsStream("/sparqljson/rdfstar-extendedformat-stardog.srj");
		assertNotNull(stream, "Could not find test resource");
		parser.parseQueryResult(stream);

		assertThat(handler.getBindingNames().size()).isEqualTo(3);
		assertThat(handler.getBindingSets()).hasSize(1).allMatch(bs -> bs.getValue("a") instanceof Triple);
		Triple a = (Triple) handler.getBindingSets().get(0).getValue("a");
		assertThat(a.getSubject().stringValue()).isEqualTo("http://example.org/bob");
		assertThat(a.getPredicate().stringValue()).isEqualTo("http://xmlns.com/foaf/0.1/age");
		assertThat(a.getObject().stringValue()).isEqualTo("23");
	}

	@Test
	public void testRDFStar_extendedFormatStardog_NamedGraph() throws Exception {
		SPARQLResultsJSONParser parser = new SPARQLResultsJSONParser(SimpleValueFactory.getInstance());
		QueryResultCollector handler = new QueryResultCollector();
		parser.setQueryResultHandler(handler);

		InputStream stream = this.getClass()
				.getResourceAsStream("/sparqljson/rdfstar-extendedformat-stardog-namedgraph.srj");
		assertNotNull(stream, "Could not find test resource");
		parser.parseQueryResult(stream);

		assertThat(handler.getBindingNames().size()).isEqualTo(3);
		assertThat(handler.getBindingSets()).hasSize(1).allMatch(bs -> bs.getValue("a") instanceof Triple);
		Triple a = (Triple) handler.getBindingSets().get(0).getValue("a");
		assertThat(a.getSubject().stringValue()).isEqualTo("http://example.org/bob");
		assertThat(a.getPredicate().stringValue()).isEqualTo("http://xmlns.com/foaf/0.1/age");
		assertThat(a.getObject().stringValue()).isEqualTo("23");
	}

	@Test
	public void testRDFStar_extendedFormatJena() throws Exception {
		SPARQLResultsJSONParser parser = new SPARQLResultsJSONParser(SimpleValueFactory.getInstance());
		QueryResultCollector handler = new QueryResultCollector();
		parser.setQueryResultHandler(handler);

		InputStream stream = this.getClass().getResourceAsStream("/sparqljson/rdfstar-extendedformat-jena.srj");
		assertNotNull(stream, "Could not find test resource");
		parser.parseQueryResult(stream);

		assertThat(handler.getBindingNames().size()).isEqualTo(3);
		assertThat(handler.getBindingSets()).hasSize(1).allMatch(bs -> bs.getValue("a") instanceof Triple);
		Triple a = (Triple) handler.getBindingSets().get(0).getValue("a");
		assertThat(a.getSubject().stringValue()).isEqualTo("http://example.org/bob");
		assertThat(a.getPredicate().stringValue()).isEqualTo("http://xmlns.com/foaf/0.1/age");
		assertThat(a.getObject().stringValue()).isEqualTo("23");
	}
}