View Javadoc
1   /**
2    * Licensed to the Apache Software Foundation (ASF) under one
3    * or more contributor license agreements.  See the NOTICE file
4    * distributed with this work for additional information
5    * regarding copyright ownership.  The ASF licenses this file
6    * to you under the Apache License, Version 2.0 (the
7    * "License"); you may not use this file except in compliance
8    * with the License.  You may obtain a copy of the License at
9    *
10   *     http://www.apache.org/licenses/LICENSE-2.0
11   *
12   * Unless required by applicable law or agreed to in writing, software
13   * distributed under the License is distributed on an "AS IS" BASIS,
14   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15   * See the License for the specific language governing permissions and
16   * limitations under the License.
17   */
18  package org.apache.commons.rdf.jena;
19  
20  import static org.junit.Assert.assertEquals;
21  import static org.junit.Assert.assertFalse;
22  import static org.junit.Assert.assertTrue;
23  
24  import org.apache.commons.rdf.api.IRI;
25  import org.apache.commons.rdf.simple.SimpleRDF;
26  import org.apache.jena.graph.Node;
27  import org.apache.jena.graph.NodeFactory;
28  import org.apache.jena.sparql.core.Quad;
29  import org.junit.Test;
30  
31  /**
32   * COMMONSRDF-55: Handling of
33   * Jena's default graph IRI urn:x-arq:DefaultGraph
34   */
35  public class DefaultGraphInQuadTest {
36  
37      JenaRDF rdf = new JenaRDF();
38      SimpleRDF simpleRDF = new SimpleRDF();
39      IRI example = rdf.createIRI("http://example.com/");
40      Node exampleJena = NodeFactory.createURI("http://example.com/");
41  
42      @Test
43      public void createFromNull() throws Exception {
44          final JenaQuad q = rdf.createQuad(null, example, example, example);
45          assertFalse(q.getGraphName().isPresent());
46          assertTrue(q.asJenaQuad().isDefaultGraph());
47          assertEquals(Quad.defaultGraphIRI,  q.asJenaQuad().getGraph());
48      }
49  
50      @Test
51      public void createFromDefaultGraphIRI() throws Exception {
52          final JenaIRI defaultGraph = (JenaIRI) rdf.asRDFTerm(Quad.defaultGraphIRI);
53          final JenaQuad q = rdf.createQuad(defaultGraph, example, example, example);
54          // NOTE: JenaRDF specially recognize this JenaIRI constant,
55          // even if this breaks the SHOULD of RDF.createQuad()
56          assertTrue(q.asJenaQuad().isDefaultGraph());
57          assertEquals(Quad.defaultGraphIRI,  q.asJenaQuad().getGraph());
58          assertFalse(q.getGraphName().isPresent());
59          // thus we can't require
60          //assertEquals(defaultGraph, q.getGraphName().get());
61      }
62  
63      @Test
64      public void createFromForeignDefaultGraph() throws Exception {
65          // What if <urn:x-arq:DefaultGraph> appear in a non-Jena IRI?
66          final IRI foreignDefaultGraph = simpleRDF.createIRI(Quad.defaultGraphIRI.getURI());
67          final JenaQuad q = rdf.createQuad(foreignDefaultGraph, example, example, example);
68          // As the IRI was NOT a JenaIRI we preserve it as-is,
69          // rather than replacing it with Optional.empty()
70          assertTrue(q.asJenaQuad().isDefaultGraph());
71          assertTrue(q.getGraphName().isPresent()); // INCONSISTENT with above
72          assertEquals(Quad.defaultGraphIRI,  q.asJenaQuad().getGraph());
73          assertEquals(foreignDefaultGraph, q.getGraphName().get());
74          // Note that adding such a quad to a Dataset would still "convert" it to
75          // Optional.empty()
76      }
77  
78  
79      @Test
80      public void createFromDefaultGraphNodeGeneratedIRINode() throws Exception {
81          // What if <urn:x-arq:DefaultGraphNode> appear as an IRI instance?
82          final IRI foreignDefaultGraph = rdf.createIRI(Quad.defaultGraphNodeGenerated.getURI());
83          final JenaQuad q = rdf.createQuad(foreignDefaultGraph, example, example, example);
84          // NOTE: JenaRDF specially recognize this JenaIRI constant,
85          // even if this breaks the SHOULD of RDF.createQuad()
86          assertTrue(q.asJenaQuad().isDefaultGraph());
87          assertFalse(q.getGraphName().isPresent()); // CONSISTENT with above
88          // Unfortunately Quad.defaultGraphNodeGenerated is not preserved:
89          //assertEquals(Quad.defaultGraphNodeGenerated, q.asJenaQuad().getGraph());
90      }
91  
92      @Test
93      public void createFromDefaultGraphNodeGeneratedIRIString() throws Exception {
94          // What if <urn:x-arq:DefaultGraphNode> appear in a non-Jena IRI?
95          final IRI foreignDefaultGraph = simpleRDF.createIRI(Quad.defaultGraphNodeGenerated.getURI());
96          final JenaQuad q = rdf.createQuad(foreignDefaultGraph, example, example, example);
97          // We'll expect JenaRDF to preserve the graph IRI as-is
98          assertTrue(q.asJenaQuad().isDefaultGraph());
99          assertTrue(q.getGraphName().isPresent()); // INCONSISTENT WITH above
100         // Now Quad.defaultGraphNodeGenerated is preserved at both ends
101         assertEquals(Quad.defaultGraphNodeGenerated,  q.asJenaQuad().getGraph());
102         assertEquals(foreignDefaultGraph, q.getGraphName().get());
103     }
104 
105 
106     @Test
107     public void defaultGraphIRI() throws Exception {
108         final Quad jenaQuad = Quad.create(Quad.defaultGraphIRI, exampleJena, exampleJena, exampleJena);
109         final JenaQuad q = rdf.asQuad(jenaQuad);
110         assertFalse(q.getGraphName().isPresent());
111         assertTrue(q.asJenaQuad().isDefaultGraph());
112     }
113 
114     @Test
115     public void defaultGraphNodeGenerated() throws Exception {
116         // <urn:x-arq:DefaultGraphNode> might appear in parser output
117         final Quad jenaQuad = Quad.create(Quad.defaultGraphNodeGenerated, exampleJena, exampleJena, exampleJena);
118         final JenaQuad q = rdf.asQuad(jenaQuad);
119         assertFalse(q.getGraphName().isPresent());
120         assertTrue(q.asJenaQuad().isDefaultGraph());
121         // Preserves <urn:x-arq:DefaultGraphNode>
122         assertEquals(Quad.defaultGraphNodeGenerated, q.asJenaQuad().getGraph());
123     }
124 
125     @Test
126     public void unionGraph() throws Exception {
127         // unionGraph shouldn't really appear as a quad except
128         // in a pattern
129         final Quad jenaQuad = Quad.create(Quad.unionGraph, exampleJena, exampleJena, exampleJena);
130         final JenaQuad q = rdf.asQuad(jenaQuad);
131         // But at least we can agree it is NOT (necessarily) in the
132         // default graph
133         assertFalse(q.asJenaQuad().isDefaultGraph());
134         assertTrue(q.getGraphName().isPresent());
135     }
136 }