This is an automated email from the ASF dual-hosted git repository. andy pushed a commit to branch main5 in repository https://gitbox.apache.org/repos/asf/jena-site.git
commit dcb3a5e6691774f10c64993cc3c0b431221ea3e9 Author: Andy Seaborne <[email protected]> AuthorDate: Sun Mar 17 17:44:27 2024 +0000 Update for ARP -> RRX migration --- source/documentation/io/arp/arp.md | 8 ++++ source/documentation/io/arp/arp_sax.md | 6 +++ source/documentation/io/arp/arp_standalone.md | 6 +++ source/documentation/io/rdfxml-input.md | 54 +++++++++++++++++++++++---- source/documentation/io/rdfxml-io.md | 37 +++--------------- source/documentation/io/rdfxml-output.md | 8 +--- source/documentation/io/rdfxml_howto.md | 2 + 7 files changed, 75 insertions(+), 46 deletions(-) diff --git a/source/documentation/io/arp/arp.md b/source/documentation/io/arp/arp.md index 99d219c30..2a8b0a02e 100644 --- a/source/documentation/io/arp/arp.md +++ b/source/documentation/io/arp/arp.md @@ -2,6 +2,14 @@ title: RDF/XML Input in Jena --- +___Legacy Documentation : not up-to-date___ + +___The original ARP parser will be removed from Jena___ + +The current RDF/XML parser is RRX. + +--- + This section details the Jena RDF/XML parser. ARP is the parsing subsystem in Jena for handling the RDF/XML syntax. diff --git a/source/documentation/io/arp/arp_sax.md b/source/documentation/io/arp/arp_sax.md index a2993ad7e..74a6c1dad 100644 --- a/source/documentation/io/arp/arp_sax.md +++ b/source/documentation/io/arp/arp_sax.md @@ -2,6 +2,12 @@ title: SAX Input into Jena and ARP --- +___Legacy Documentation : not up-to-date___ + +___The original ARQ parser will be removed from Jena___ + +--- + Normally, both ARP and Jena are used to read files either from the local machine or from the Web. A different use case, addressed here, is when the XML source is available in-memory in some way. In diff --git a/source/documentation/io/arp/arp_standalone.md b/source/documentation/io/arp/arp_standalone.md index ee0882b53..e3f952c74 100644 --- a/source/documentation/io/arp/arp_standalone.md +++ b/source/documentation/io/arp/arp_standalone.md @@ -2,6 +2,12 @@ title: Using ARP Without Jena --- +__Legacy Documentation : not up-to-date__ + +__The original ARQ parser will be removed from Jena.__ + +--- + ARP can be used both as a Jena subsystem, or as a standalone RDF/XML parser. This document gives a quick guide to using ARP standalone. diff --git a/source/documentation/io/rdfxml-input.md b/source/documentation/io/rdfxml-input.md index b51885509..6ca7eae7f 100644 --- a/source/documentation/io/rdfxml-input.md +++ b/source/documentation/io/rdfxml-input.md @@ -1,14 +1,56 @@ --- -title: Jena RDF/XML Input How-To +title: Jena RDF/XML Input How-To (ARP) --- -_Legacy Documentation : may not be up-to-date_ +___Legacy Documentation : not up-to-date___ -Original [RDF/XML HowTo](rdfxml_howto.html). +___The original ARP parser will be removed from Jena.___ + +The current RDF/XML parser is RRX. --- -This is a guide to the RDF/XML legacy input subsystem of Jena, ARP. +This is a guide to the RDF/XML legacy ARP input subsystem of Jena. + + +The ARP RDF/XML parser is designed for use with RIOT and to have the same handling +of errors, IRI resolution, and treatment of base IRIs as other RIOT readers. + +The ARP0 parser is the original standalone parser. + +## RDF/XML Input + +The usual way to access the RDF/XML parser is via `RDFDataMgr` or `RDFParser`. + + Model model = RDFDataMgr.loadModel("data.arp"); + +or + + Model model = RDFParser.source("data.arp").toModel(); + +Note the file extension is _arp_. + +### Legacy ARP RDF/XML parser + +#### RIOT integrated ARP parser + +To access the parse from Java code use constants `RRX.RDFXML_ARP1`. + +The syntax name is `arp` or `arp1`. + +The file extension is _arp_ or `arp1`. + +#### Original ARP0 parser + +To access the parse from Java code use constants `RRX.RDFXML_ARP0`. + +The syntax name is `arp0`. + +The file extension is _arp0_. + +Details of the original Jena RDF/XML parser, [ARP](arp/arp.html). + +--- ## Advanced RDF/XML Input @@ -139,7 +181,3 @@ The global default IRI engine can be set with: ARPOptions.setIRIFactoryGlobal(IRIFactory.iriImplementation()) ; or other IRI rule engine from `IRIFactory`. - -## Further details - -[Details of ARP, the Jena RDF/XML parser](arp/arp.html) diff --git a/source/documentation/io/rdfxml-io.md b/source/documentation/io/rdfxml-io.md index 8b81c36af..146c2abfd 100644 --- a/source/documentation/io/rdfxml-io.md +++ b/source/documentation/io/rdfxml-io.md @@ -2,41 +2,17 @@ title: Jena RDF XML --- -This is a guide to the RDF/XML I/O subsystem of Jena. - -The RDF/XML parser is designed for use with RIOT and to have the same handling -of errors, IRI resolution, and treatment of base IRIs as other RIOT readers. - +- [RDF/XML Input](#rdfxml-input) +- [RDF/XML Output](#rdfxml-output) ## RDF/XML Input -The usual way to access the RDF/XML parser is via `RDFDataMgr` or `RDFParser`. - - Model model = RDFDataMgr.loadModel("data.rdf"); - -or - - Model model = RDFParser.source("data.rdf").toModel(); +The RIOT RDF/XML parser is called RRX. -The original "ARP" parser is still available bu tmaybe pahsed out. To access -the legacy parser, use the context symbol `RIOT.symRDFXML0` to `true` or -`"true". - Model model = RDFParser.source(""data.rdf") - .set(RIOT.symRDFXML0, true) - .parse(dest); +The ARP RDF/XML parser is stil available but wil be rmoved from Apache Jena. -This applies to the command line: - - riot --set rdfxml:rdfxml0=true data.rdf - -This can be set globally in the JVM: - - RIOT.getContext().set(RIOT.symRDFXML0, "true"); - -Details of [legacy RDF/XML input](rdfxml-input.html). - -Details of the original Jena RDF/XML parser, [ARP](arp/arp.html). +- Legacy ARP [RDF/XML input](rdfxml-input.html) ## RDF/XML Output @@ -67,5 +43,4 @@ or RDFWriter.source(model).format(RDFFormat.RDFXML_PLAIN).output(System.out); - -Details of [legacy RDF/XML output](rdfxml-output.html). +- [RDF/XML advanced output](rdfxml-output.html) diff --git a/source/documentation/io/rdfxml-output.md b/source/documentation/io/rdfxml-output.md index fd96fbdb4..1b395aa6e 100644 --- a/source/documentation/io/rdfxml-output.md +++ b/source/documentation/io/rdfxml-output.md @@ -2,19 +2,13 @@ title: Jena RDF/XML Output How-To --- -_Legacy Documentation : may not be up-to-date_ - -Original [RDF/XML HowTo](rdfxml_howto.html). - ---- - ## Advanced RDF/XML Output Two forms for output are provided: pretty printed RDF/XML ("RDF/XML-ABBREV") or plain RDF/XML While some of the code is shared, these two writers are really very different, resulting in different but -equivalent output. "RDF/XML-ABBREV" is slower, but should produce +equivalent RDF output. "RDF/XML-ABBREV" is slower, but should produce more readable XML. ### Properties to Control RDF/XML Output diff --git a/source/documentation/io/rdfxml_howto.md b/source/documentation/io/rdfxml_howto.md index 80e52fe6d..280a1d2c8 100644 --- a/source/documentation/io/rdfxml_howto.md +++ b/source/documentation/io/rdfxml_howto.md @@ -4,6 +4,8 @@ title: Jena RDF/XML How-To _Legacy Documentation : may not be up-to-date_ +* The original ARQ parser will be removed from Jena. * + --- This is a guide to the RDF/XML I/O subsystem of Jena, ARP.
