Revise populating a SparqlService from different input sources

[psiotwo]

Currently, the class allows to:

• execute a SPARQL update query - executeUpdateQuery
• upload a TTL file - uploadTtlFile
• update/replace Graph - upload/updateGraph/

The goal is to unify the update/replace mechanism for both named/default graphs from file/SPARQL/Model/...
(cc @natan-cox-cognizone)

[psiotwo]

Here I would suggest to deprecate uploadTtlFile and introduce the following methods instead:

  /**
   * Adds the triples in the file into the graph:
   * Note: In case the file contains quads, the graph information is ignored, and they are added as triples to the designated graph.
   *
   * @param graphIri IRI of graph being updated, or null if the default graph shall be used
   * @param file     file to replace the graph with.
   */
  void updateGraph(String graphIri, File file);

  /**
   * Adds the quads in the file into the graph:
   * Note: In case the file is a triple format not a quad format, an exception is thrown.
   *
   * @param file     file to replace the dataset with.
   */
  void update(File file);

  /**
   * Replaces the given graph with triples in the file:
   * Note: In case the file contains quads, the graph information is ignored, and they are added as triples to the designated graph.
   *
   * @param graphIri IRI of graph being updated, or null if the default graph shall be used
   * @param file     file to replace the graph with.
   */
  void replaceGraph(String graphIri, File file);


  /**
   * Replaces the data with quads in the file:
   * Note: In case the file is a triple format not a quad format, an exception is thrown.
   *
   * @param file     file to replace the dataset with.
   */
  void replace(File file);

}

What do you think @alexey-lukashov @natan-cox-cognizone?

[natan-cox-cognizone]

I think update with File does not make a lot of sense. Assume you have a file, the it will typically be the full file, not just the new triples. So, doing it is a bit weird.

Thinking a bit more an update is seldom purely additive. So, I think if we would do update we would need something like

void update(String graphUri, Supplier<Model> addedTriples, Supplier<Model> removedTriples)

Where you can add and remove triples. There could be a method for add only I guess by dropping the last parameter.

Finally, I am not a big fan of File in general. There are probably other resources too (spring Resource?). Or possible even more generic Supplier<Model> as I did in my example.

So

void replaceGraph(String graphIri, Supplier<Model> modelSupplier);

void replaceGraph(String graphIri, Model model);