public class RDFDataMgr extends Object
General purpose reader framework for RDF (triples and quads) syntaxes.
It also provides a way to lookup names in different locations and to remap URIs to other URIs.
Extensible - a new syntax can be added to the framework.
Operations fall into the follwoing categories:
read
-- Read data from a location into a Model/Dataset etcloadXXX
-- Read data and return an in-memory object holding the data.parse
-- Read data and send to an StreamRDF
open
-- Open a typed input stream to the location, using any alternative locationsModifier and Type | Field and Description |
---|---|
static Symbol |
streamManagerSymbol |
Constructor and Description |
---|
RDFDataMgr() |
Modifier and Type | Method and Description |
---|---|
static WriterDatasetRIOT |
createDatasetWriter(Lang lang)
Create a writer for an RDF language
|
static WriterDatasetRIOT |
createDatasetWriter(RDFFormat serialization)
Create a writer for an RDF language
|
static WriterGraphRIOT |
createGraphWriter(Lang lang)
Create a writer for an RDF language
|
static WriterGraphRIOT |
createGraphWriter(RDFFormat serialization)
Create a writer for an RDF language
|
static Dataset |
loadDataset(String uri)
Create a memory Dataset and read in some data
|
static Dataset |
loadDataset(String uri,
Lang lang)
Create a memory Dataset and read in some data
|
static DatasetGraph |
loadDatasetGraph(String uri)
Create a memory DatasetGraph and read in some data
|
static DatasetGraph |
loadDatasetGraph(String uri,
Lang lang)
Create a memory DatasetGraph and read in some data
|
static Graph |
loadGraph(String uri)
Create a memory Graph and read in some data
|
static Graph |
loadGraph(String uri,
Lang lang)
Create a memory Graph and read in some data
|
static Model |
loadModel(String uri)
Create a memory Model and read in some data
|
static Model |
loadModel(String uri,
Lang lang)
Create a memory Model and read in some data
|
static TypedInputStream |
open(String filenameOrURI)
Open a stream to the destination (URI or filename)
Performs content negotiation, including looking at file extension.
|
static TypedInputStream |
open(String filenameOrURI,
Context context)
Open a stream to the destination (URI or filename)
Performs content negotiation, including looking at file extension.
|
static TypedInputStream |
open(String filenameOrURI,
StreamManager streamManager)
Open a stream to the destination (URI or filename)
Performs content negotiation, including looking at file extension.
|
static void |
parse(StreamRDF sink,
InputStream in,
String base,
Lang hintLang)
Read RDF data.
|
static void |
parse(StreamRDF sink,
InputStream in,
String base,
Lang hintLang,
Context context)
Read RDF data.
|
static void |
parse(StreamRDF sink,
String uri)
Read RDF data.
|
static void |
parse(StreamRDF sink,
String uri,
Lang hintLang,
Context context)
Read RDF data.
|
static void |
parse(StreamRDF sink,
String uri,
String base,
Lang hintLang,
Context context)
Read RDF data.
|
static void |
parse(StreamRDF sink,
TypedInputStream in,
String base)
Read RDF data.
|
static void |
read(DatasetGraph dataset,
InputStream in,
Lang lang)
Read quads or triples into a dataset with bytes from an input stream.
|
static void |
read(DatasetGraph dataset,
InputStream in,
String base,
Lang lang)
Read quads or triples into a dataset with bytes from an input stream.
|
static void |
read(DatasetGraph dataset,
Reader in,
String base,
Lang lang)
Deprecated.
use an InputStream or a StringReader.
|
static void |
read(DatasetGraph dataset,
String uri)
Read quads or triples into a Dataset from the given location, with hint of language.
|
static void |
read(DatasetGraph dataset,
String uri,
Lang hintLang)
Read quads or triples into a Dataset from the given location, with hint of language.
|
static void |
read(DatasetGraph dataset,
String uri,
Lang hintLang,
Context context)
Read quads or triples into a Dataset from the given location.
|
static void |
read(DatasetGraph dataset,
StringReader in,
String base,
Lang lang)
Read quads into a dataset with chars from a StringReader.
|
static void |
read(DatasetGraph dataset,
String uri,
String base,
Lang hintLang,
Context context)
Read quads or triples into a Dataset from the given location.
|
static void |
read(Dataset dataset,
InputStream in,
Lang lang)
Read quads or triples into a dataset with bytes from an input stream.
|
static void |
read(Dataset dataset,
InputStream in,
String base,
Lang lang)
Read quads or triples into a dataset with bytes from an input stream.
|
static void |
read(Dataset dataset,
Reader in,
String base,
Lang lang)
Deprecated.
use an InputStream or a StringReader.
|
static void |
read(Dataset dataset,
String uri)
Read quads or triples into a Dataset from the given location, with hint of language.
|
static void |
read(Dataset dataset,
String uri,
Lang hintLang)
Read quads or triples into a Dataset from the given location, with hint of language.
|
static void |
read(Dataset dataset,
String uri,
Lang hintLang,
Context context)
Read quads or triples into a Dataset from the given location.
|
static void |
read(Dataset dataset,
StringReader in,
String base,
Lang lang)
Read quads into a dataset with chars from a StringReader.
|
static void |
read(Dataset dataset,
String uri,
String base,
Lang hintLang,
Context context)
Read quads or triples into a Dataset from the given location.
|
static void |
read(Graph graph,
InputStream in,
Lang lang)
Read triples into a Model with bytes from an InputStream.
|
static void |
read(Graph graph,
InputStream in,
String base,
Lang lang)
Read triples into a Model with bytes from an InputStream.
|
static void |
read(Graph graph,
Reader in,
String base,
Lang lang)
Deprecated.
Use an InputStream or StringReader.
|
static void |
read(Graph graph,
String uri)
Read triples into a Model from the given location.
|
static void |
read(Graph graph,
String uri,
Context context)
Read triples into a Model from the given location, with some parameters for the reader
|
static void |
read(Graph graph,
String uri,
Lang hintLang)
Read triples into a Model from the given location, with a hint of the language (MIME type or short name)
|
static void |
read(Graph graph,
String uri,
Lang hintLang,
Context context)
Read triples into a Model from the given location, with hint of language and with some parameters for the reader
|
static void |
read(Graph graph,
StringReader in,
String base,
Lang lang)
Read triples into a model with chars from a StringReader.
|
static void |
read(Graph graph,
String uri,
String base,
Lang hintLang)
Read triples into a Model from the given location, with hint of language and the with some parameters for the reader
|
static void |
read(Graph graph,
String uri,
String base,
Lang hintLang,
Context context)
Read triples into a Model from the given location, with hint of language and the with some parameters for the reader
Throws parse errors depending on the language and reader; the graph may be partially updated.
|
static void |
read(Model model,
InputStream in,
Lang lang)
Read triples into a Model with bytes from an InputStream.
|
static void |
read(Model model,
InputStream in,
String base,
Lang lang)
Read triples into a Model with bytes from an InputStream.
|
static void |
read(Model model,
Reader in,
String base,
Lang lang)
Deprecated.
Use an InputStream or StringReader.
|
static void |
read(Model model,
String uri)
Read triples into a Model from the given location.
|
static void |
read(Model model,
String uri,
Context context)
Read triples into a Model from the given location, with some parameters for the reader
|
static void |
read(Model model,
String uri,
Lang hintLang)
Read triples into a Model from the given location, with a hint of the language (MIME type)
|
static void |
read(Model model,
String uri,
Lang hintLang,
Context context)
Read triples into a Model from the given location, with hint of language and the with some parameters for the reader
|
static void |
read(Model model,
StringReader in,
String base,
Lang lang)
Read triples into a model with chars from a StringReader.
|
static void |
read(Model model,
String uri,
String base,
Lang hintLang)
Read triples into a Model from the given location, with hint of language and with some parameters for the reader
|
static void |
read(Model model,
String uri,
String base,
Lang hintLang,
Context context)
Read triples into a Model from the given location, with hint of language
and with some parameters for the reader.
|
static void |
write(OutputStream out,
DatasetGraph dataset,
Lang lang)
Write the DatasetGraph to the output stream in the default serialization for the language.
|
static void |
write(OutputStream out,
DatasetGraph dataset,
RDFFormat serialization)
Write the graph to the output stream in the default serialization for the language.
|
static void |
write(OutputStream out,
Dataset dataset,
Lang lang)
Write the Dataset to the output stream in the default serialization for the language.
|
static void |
write(OutputStream out,
Dataset dataset,
RDFFormat serialization)
Write the graph to the output stream in the default serialization for the language.
|
static void |
write(OutputStream out,
Graph graph,
Lang lang)
Write the graph to the output stream in the default serialization for the language.
|
static void |
write(OutputStream out,
Graph graph,
RDFFormat serialization)
Write the graph to the output stream in the default serialization for the language.
|
static void |
write(OutputStream out,
Model model,
Lang lang)
Write the model to the output stream in the default serialization for the language.
|
static void |
write(OutputStream out,
Model model,
RDFFormat serialization)
Write the model to the output stream in the default serialization for the language.
|
static void |
write(StringWriter out,
DatasetGraph dataset,
Lang lang)
Write the DatasetGraph to the output stream in the default serialization for the language.
|
static void |
write(StringWriter out,
DatasetGraph dataset,
RDFFormat serialization)
Write the graph to the output stream in the default serialization for the language.
|
static void |
write(StringWriter out,
Dataset dataset,
Lang lang)
Write the graph to the output stream in the default serialization for the language.
|
static void |
write(StringWriter out,
Dataset dataset,
RDFFormat serialization)
Write the graph to the output stream in the default serialization for the language.
|
static void |
write(StringWriter out,
Graph graph,
Lang lang)
Write the graph to the output stream in the default serialization for the language.
|
static void |
write(StringWriter out,
Graph graph,
RDFFormat serialization)
Write the graph to the output stream in the default serialization for the language.
|
static void |
write(StringWriter out,
Model model,
Lang lang)
Write the graph to the output stream in the default serialization for the language.
|
static void |
write(StringWriter out,
Model model,
RDFFormat serialization)
Write the graph to the output stream in the default serialization for the language.
|
static void |
write(Writer out,
DatasetGraph dataset,
RDFFormat serialization)
Deprecated.
Use of writers is deprecated - use an OutputStream
|
static void |
write(Writer out,
Dataset dataset,
RDFFormat serialization)
Deprecated.
Use of writers is deprecated - use an OutputStream
|
static void |
write(Writer out,
Graph graph,
RDFFormat serialization)
Deprecated.
Use of writers is deprecated - use an OutputStream
|
static void |
write(Writer out,
Model model,
RDFFormat serialization)
Deprecated.
Use of writers is deprecated - use an OutputStream
|
static void |
writeQuads(OutputStream out,
Iterator<Quad> iterator)
Write an iterator of quads (in N-Quads)
|
static void |
writeTriples(OutputStream out,
Iterator<Triple> iterator)
Write an iterator of triples (in N-Triples)
|
public static Symbol streamManagerSymbol
public static void read(Model model, String uri)
model
- Destination for the RDF read.uri
- URI to read from (includes file: and a plain file name).RiotNotFoundException
- if the location is not found - the model is unchanged.read(Model,String,Lang,Context)
public static void read(Graph graph, String uri)
graph
- Destination for the RDF read.uri
- URI to read from (includes file: and a plain file name).RiotNotFoundException
- if the location is not found - the graph is unchanged.read(Graph,String,Lang,Context)
public static void read(Model model, String uri, Lang hintLang)
model
- Destination for the RDF read.uri
- URI to read from (includes file: and a plain file name).hintLang
- Hint for the syntax.RiotNotFoundException
- if the location is not found - the model is unchanged.read(Model,String,String,Lang,Context)
public static void read(Graph graph, String uri, Lang hintLang)
graph
- Destination for the RDF read.uri
- URI to read from (includes file: and a plain file name).hintLang
- Hint for the syntax.RiotNotFoundException
- if the location is not found - the graph is unchanged.read(Graph,String,Lang,Context)
public static void read(Model model, String uri, String base, Lang hintLang)
model
- Destination for the RDF read.uri
- URI to read from (includes file: and a plain file name).base
- Base URI (defaults to uri).hintLang
- Hint for the syntaxRiotNotFoundException
- if the location is not found - the model is unchanged.Throws parse errors depending on the language and reader; the model may be partially updated.
public static void read(Graph graph, String uri, String base, Lang hintLang)
graph
- Destination for the RDF read.uri
- URI to read from (includes file: and a plain file name).base
- Base URI (defaults to uri).hintLang
- Hint for the syntaxRiotNotFoundException
- if the location is not found - the graph is unchanged.Throws parse errors depending on the language and reader; the Model model may be partially updated.
public static void read(Model model, String uri, Context context)
model
- Destination for the RDF readuri
- URI to read from (includes file: and a plain file name).context
- Content object to control reading process.RiotNotFoundException
- if the location is not found - the model is unchanged.read(Model,String,String,Lang,Context)
public static void read(Graph graph, String uri, Context context)
graph
- Destination for the RDF readuri
- URI to read from (includes file: and a plain file name).context
- Content object to control reading process.RiotNotFoundException
- if the location is not found - the graph is unchanged.read(Graph,String,String,Lang,Context)
public static void read(Model model, String uri, Lang hintLang, Context context)
model
- Destination for the RDF readuri
- URI to read from (includes file: and a plain file name).hintLang
- Hint for the syntaxcontext
- Content object to control reading process.RiotNotFoundException
- if the location is not found - the model is unchanged.read(Model,String,String,Lang,Context)
public static void read(Graph graph, String uri, Lang hintLang, Context context)
graph
- Destination for the RDF readuri
- URI to read from (includes file: and a plain file name).hintLang
- Hint for the syntaxcontext
- Content object to control reading process.RiotNotFoundException
- if the location is not found - the graph is unchanged.read(Graph,String,String,Lang,Context)
public static void read(Model model, String uri, String base, Lang hintLang, Context context)
model
- Destination for the RDF read.uri
- URI to read from (includes file: and a plain file name).base
- Base URI (defaults to uri).hintLang
- Hint for the syntaxcontext
- Content object to control reading process.RiotNotFoundException
- if the location is not found - the model is unchanged.public static void read(Graph graph, String uri, String base, Lang hintLang, Context context)
graph
- Destination for the RDF read.uri
- URI to read from (includes file: and a plain file name).base
- Base URI (defaults to uri).hintLang
- Hint for the syntaxcontext
- Content object to control reading process.RiotNotFoundException
- if the location is not found - the model is unchanged.public static void read(Model model, InputStream in, Lang lang)
model
- Destination for the RDF read.in
- InputStreamlang
- Language syntaxpublic static void read(Graph graph, InputStream in, Lang lang)
graph
- Destination for the RDF read.in
- InputStreamlang
- Language syntaxpublic static void read(Model model, InputStream in, String base, Lang lang)
model
- Destination for the RDF read.in
- InputStreambase
- Base URIlang
- Language syntaxpublic static void read(Graph graph, InputStream in, String base, Lang lang)
graph
- Destination for the RDF read.in
- InputStreambase
- Base URIlang
- Language syntax@Deprecated public static void read(Model model, Reader in, String base, Lang lang)
FileInputStream
to ensure correct character set handling.model
- Destination for the RDF read.in
- Readerbase
- Base URIlang
- Language syntax@Deprecated public static void read(Graph graph, Reader in, String base, Lang lang)
FileInputStream
to ensure correct character set handling.graph
- Destination for the RDF read.in
- Readerbase
- Base URIlang
- Language syntaxpublic static void read(Model model, StringReader in, String base, Lang lang)
model
- Destination for the RDF read.in
- InputStreambase
- Base URIlang
- Language syntaxpublic static void read(Graph graph, StringReader in, String base, Lang lang)
graph
- Destination for the RDF read.in
- InputStreambase
- Base URIlang
- Language syntaxpublic static Model loadModel(String uri)
read(Model,String)
public static Model loadModel(String uri, Lang lang)
read(Model,String,Lang)
public static Graph loadGraph(String uri)
read(Graph,String)
public static Graph loadGraph(String uri, Lang lang)
read(Graph,String,Lang)
public static Dataset loadDataset(String uri)
read(Dataset,String)
public static Dataset loadDataset(String uri, Lang lang)
read(Dataset,String,Lang)
public static DatasetGraph loadDatasetGraph(String uri)
read(DatasetGraph,String)
public static DatasetGraph loadDatasetGraph(String uri, Lang lang)
read(DatasetGraph,String,Lang)
public static void read(Dataset dataset, String uri)
dataset
- Destinationuri
- URI to read from (includes file: and a plain file name).read(Dataset, String, String, Lang, Context)
public static void read(DatasetGraph dataset, String uri)
dataset
- Destinationuri
- URI to read from (includes file: and a plain file name).read(DatasetGraph, String, String, Lang, Context)
public static void read(Dataset dataset, String uri, Lang hintLang)
dataset
- Destinationuri
- URI to read from (includes file: and a plain file name).hintLang
- Language syntaxread(Dataset, String, String, Lang, Context)
public static void read(DatasetGraph dataset, String uri, Lang hintLang)
dataset
- Destinationuri
- URI to read from (includes file: and a plain file name).hintLang
- Language syntaxread(DatasetGraph, String, String, Lang, Context)
public static void read(Dataset dataset, String uri, Lang hintLang, Context context)
dataset
- Destinationuri
- URI to read from (includes file: and a plain file name).hintLang
- Language syntaxread(Dataset, String, String, Lang, Context)
public static void read(DatasetGraph dataset, String uri, Lang hintLang, Context context)
dataset
- Destinationuri
- URI to read from (includes file: and a plain file name).hintLang
- Language syntaxread(DatasetGraph, String, String, Lang, Context)
public static void read(Dataset dataset, String uri, String base, Lang hintLang, Context context)
dataset
- Destinationuri
- URI to read from (includes file: and a plain file name).hintLang
- Language syntaxcontext
- Context for the readerRiotNotFoundException
- if the location is not found - the dataset is unchanged.
Throws parse errors depending on the language and reader; the dataset may be partially updated.read(Dataset, String, String, Lang, Context)
public static void read(DatasetGraph dataset, String uri, String base, Lang hintLang, Context context)
dataset
- Destinationuri
- URI to read from (includes file: and a plain file name).hintLang
- Language syntaxcontext
- Context for the readerRiotNotFoundException
- if the location is not found - the dataset is unchanged.
Throws parse errors depending on the language and reader; the dataset may be partially updated.read(Dataset, String, String, Lang, Context)
public static void read(Dataset dataset, InputStream in, Lang lang)
dataset
- Destinationin
- InputStreamlang
- Language syntaxpublic static void read(DatasetGraph dataset, InputStream in, Lang lang)
dataset
- Destinationin
- InputStreamlang
- Language syntaxpublic static void read(Dataset dataset, InputStream in, String base, Lang lang)
dataset
- Destinationin
- InputStreambase
- Base URIlang
- Language syntaxpublic static void read(DatasetGraph dataset, InputStream in, String base, Lang lang)
dataset
- Destinationin
- InputStreambase
- Base URIlang
- Language syntax@Deprecated public static void read(Dataset dataset, Reader in, String base, Lang lang)
FileInputStream
to ensure correct character set handling.dataset
- Destinationin
- InputStreambase
- Base URIlang
- Language syntax@Deprecated public static void read(DatasetGraph dataset, Reader in, String base, Lang lang)
FileInputStream
to ensure correct character set handling.dataset
- Destinationin
- InputStreambase
- Base URIlang
- Language syntaxpublic static void read(Dataset dataset, StringReader in, String base, Lang lang)
FileInputStream
to ensure correct character set handling.dataset
- Destinationin
- InputStreambase
- Base URIlang
- Language syntaxpublic static void read(DatasetGraph dataset, StringReader in, String base, Lang lang)
FileInputStream
to ensure correct character set handling.dataset
- Destinationin
- InputStreambase
- Base URIlang
- Language syntaxpublic static void parse(StreamRDF sink, String uri)
sink
- Destination for the RDF read.uri
- URI to read from (includes file: and a plain file name).public static void parse(StreamRDF sink, String uri, Lang hintLang, Context context)
sink
- Destination for the RDF read.uri
- URI to read from (includes file: and a plain file name).hintLang
- Hint for the syntaxcontext
- Content object to control reading process.public static void parse(StreamRDF sink, String uri, String base, Lang hintLang, Context context)
sink
- Destination for the RDF read.uri
- URI to read from (includes file: and a plain file name).base
- Base URI (defaults to uri).hintLang
- Hint for the syntaxcontext
- Content object to control reading process.public static void parse(StreamRDF sink, InputStream in, String base, Lang hintLang)
sink
- Destination for the RDF read.in
- Bytes to read.base
- Base URI (defaults to uri).hintLang
- Hint for the syntaxpublic static void parse(StreamRDF sink, InputStream in, String base, Lang hintLang, Context context)
sink
- Destination for the RDF read.in
- Bytes to read.base
- Base URI (defaults to uri).hintLang
- Hint for the syntaxcontext
- Content object to control reading process.public static void parse(StreamRDF sink, TypedInputStream in, String base)
sink
- Destination for the RDF read.in
- Bytes to read.base
- Base URIpublic static TypedInputStream open(String filenameOrURI)
filenameOrURI
- public static TypedInputStream open(String filenameOrURI, Context context)
filenameOrURI
- context
- public static TypedInputStream open(String filenameOrURI, StreamManager streamManager)
filenameOrURI
- streamManager
- public static void write(OutputStream out, Model model, Lang lang)
out
- OutputStreammodel
- Graph to writelang
- Language for the seralization.public static void write(OutputStream out, Model model, RDFFormat serialization)
out
- OutputStreammodel
- Model to writeserialization
- Serialization formatpublic static void write(StringWriter out, Model model, Lang lang)
out
- OutputStreammodel
- Model to writelang
- Serialization formatpublic static void write(StringWriter out, Model model, RDFFormat serialization)
out
- OutputStreammodel
- Model to writeserialization
- Serialization format@Deprecated public static void write(Writer out, Model model, RDFFormat serialization)
out
- OutputStreammodel
- Model to writeserialization
- Serialization formatpublic static void write(OutputStream out, Graph graph, Lang lang)
out
- OutputStreamgraph
- Graph to writelang
- Language for the seralization.public static void write(OutputStream out, Graph graph, RDFFormat serialization)
out
- OutputStreamgraph
- Graph to writeserialization
- Serialization formatpublic static void write(StringWriter out, Graph graph, Lang lang)
out
- OutputStreamgraph
- Graph to writelang
- Serialization formatpublic static void write(StringWriter out, Graph graph, RDFFormat serialization)
out
- OutputStreamgraph
- Graph to writeserialization
- Serialization format@Deprecated public static void write(Writer out, Graph graph, RDFFormat serialization)
out
- OutputStreamgraph
- Graph to writeserialization
- Serialization formatpublic static void write(OutputStream out, Dataset dataset, Lang lang)
out
- OutputStreamdataset
- Dataset to writelang
- Language for the seralization.public static void write(OutputStream out, Dataset dataset, RDFFormat serialization)
out
- OutputStreamdataset
- Dataset to writeserialization
- Serialization formatpublic static void write(StringWriter out, Dataset dataset, RDFFormat serialization)
out
- Writerdataset
- Dataset to writeserialization
- Serialization formatpublic static void write(StringWriter out, Dataset dataset, Lang lang)
out
- StringWriterdataset
- Dataset to writelang
- Language for the seralization.@Deprecated public static void write(Writer out, Dataset dataset, RDFFormat serialization)
out
- Writerdataset
- Dataset to writeserialization
- Serialization formatpublic static void write(OutputStream out, DatasetGraph dataset, Lang lang)
out
- OutputStreamdataset
- DatasetGraph to writelang
- Language for the seralization.public static void write(OutputStream out, DatasetGraph dataset, RDFFormat serialization)
out
- OutputStreamdataset
- DatasetGraph to writeserialization
- Serialization formatpublic static void write(StringWriter out, DatasetGraph dataset, Lang lang)
out
- StringWriterdataset
- DatasetGraph to writelang
- Language for the seralization.public static void write(StringWriter out, DatasetGraph dataset, RDFFormat serialization)
out
- StringWriterdataset
- DatasetGraph to writeserialization
- Serialization format@Deprecated public static void write(Writer out, DatasetGraph dataset, RDFFormat serialization)
out
- Writerdataset
- DatasetGraph to writeserialization
- Serialization formatpublic static void writeTriples(OutputStream out, Iterator<Triple> iterator)
out
- iterator
- public static void writeQuads(OutputStream out, Iterator<Quad> iterator)
out
- iterator
- public static WriterGraphRIOT createGraphWriter(Lang lang)
lang
- Language for the seralization.public static WriterGraphRIOT createGraphWriter(RDFFormat serialization)
serialization
- Serialization formatpublic static WriterDatasetRIOT createDatasetWriter(Lang lang)
lang
- Language for the seralization.public static WriterDatasetRIOT createDatasetWriter(RDFFormat serialization)
serialization
- Serialization formatLicenced under the Apache License, Version 2.0