Module org.apache.jena.core
Package org.apache.jena.graph

Class GraphMemFactory

java.lang.Object
org.apache.jena.graph.GraphMemFactory
public class GraphMemFactory extends Object
A factory class for creating memory Graphs.

All the graphs that this factory creates are not thread-safe. Note that if the memory Graph is structurally modified at any time after the iterator has been created by any of the find* or stream* methods, the iterator may throw a ConcurrentModificationException if continued with it after this modification. This may happen even if the queried data does not relate directly to the modified data (i.e. when triple search pattern does not match added or deleted triple).

The good practice is to explicitly close any ExtendedIterator immediately after a read operation. For GraphMem implementations ExtendedIterator's materializing methods (such as ExtendedIterator.toList()) could be used safely without explicit close. The same is true for Java Stream's terminal operations.

  • Method Details

    • createDefaultGraph

      public static Graph createDefaultGraph()
      Answer a memory-based graph. This is the system default. This implementation of Graph is not thread-safe; the application is responsible for thread control.

      Use GraphFactory.createTxnGraph for a memory graph with transaction support.

    • createGraphMemForModel

      public static Graph createGraphMemForModel()
      This function will track the preferred general purpose graph for the Model API. It is value-based, to align with the Java-object mapping, rather than RDF-term based (Integers +001 and 1 are the same value).

    • createDefaultGraphSameValue

      public static Graph createDefaultGraphSameValue()
      Answer a memory-based graph with "same value" semantics. used in Jena2, Jena3 and Jena4 for in-memory graphs. Jena5 changed to "same term" semantics. This method will continue to provide a "same value" graph. This is used for the Model API.

    • createDefaultGraphSameTerm

      public static Graph createDefaultGraphSameTerm()
      Answer a memory-based graph with "same term" semantics. This method will continue to provide the preferred general purpose "same term" graph.

    • createGraphMemBasic

      public static Graph createGraphMemBasic()
      A graph that stores triples in memory. This class is not thread-safe.

      • This graph provides term equality.
      • Iterator over this graph does not provide Iterator.remove

      It has improved performance compared to GraphMemValue with a simpler implementation, primarily due to not providing support for Iterator.remove().

      See GraphMemLegacy for details.

    • createGraphMem2

      @Deprecated(forRemoval=true) public static Graph createGraphMem2()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Use createDefaultGraph()
      A graph that stores triples in memory. This class is not thread-safe.

      • This graph provides term equality.
      • Iterator over this graph does not provide Iterator.remove

      This graph implementation provides improved performance with a minor increase in memory usage.

      See GraphMemFast for details.

    • createGraphMemRoaring

      public static Graph createGraphMemRoaring()
      A graph that stores triples in memory. This class is not thread-safe.

      • This graph provides term equality.
      • Iterator over this graph does not provide Iterator.remove

      GraphMemRoaring is focused on handling large in-memory graphs. It uses Roaring bitmaps for indexing.

      See GraphMemRoaring for details.

    • createGraphMemIndexedSet

      public static Graph createGraphMemIndexedSet()
      A graph that stores triples in memory. This class is not thread-safe.

      • This graph provides term equality.
      • Iterator over this graph does not provide Iterator.remove

      GraphMemIndexedSet is supposed to replace GraphMemRoaring in the future.

      See GraphMemIndexedSet for details.

    • empty

      public static Graph empty()
      Immutable graph with no triples