This is an automated email from the ASF dual-hosted git repository.
jamesbognar pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/juneau.git
The following commit(s) were added to refs/heads/master by this push:
new e86ac4410a refactor: Marshaller API cleanup — rename read/write to
to/of, streaming methods to from*/to* (TODO-188)
e86ac4410a is described below
commit e86ac4410aef02dca687f10ab26d985e3a7b80d1
Author: James Bognar <[email protected]>
AuthorDate: Tue Jun 23 11:01:15 2026 -0400
refactor: Marshaller API cleanup — rename read/write to to/of, streaming
methods to from*/to* (TODO-188)
---
.../java/org/apache/juneau/marshall/jena/marshaller/JsonLd.java | 8 ++++----
.../main/java/org/apache/juneau/marshall/jena/marshaller/N3.java | 8 ++++----
.../java/org/apache/juneau/marshall/jena/marshaller/NQuads.java | 6 +++---
.../java/org/apache/juneau/marshall/jena/marshaller/NTriple.java | 8 ++++----
.../java/org/apache/juneau/marshall/jena/marshaller/RdfJson.java | 6 +++---
.../java/org/apache/juneau/marshall/jena/marshaller/RdfProto.java | 4 ++--
.../org/apache/juneau/marshall/jena/marshaller/RdfThrift.java | 4 ++--
.../java/org/apache/juneau/marshall/jena/marshaller/RdfXml.java | 8 ++++----
.../org/apache/juneau/marshall/jena/marshaller/RdfXmlAbbrev.java | 8 ++++----
.../java/org/apache/juneau/marshall/jena/marshaller/TriG.java | 6 +++---
.../java/org/apache/juneau/marshall/jena/marshaller/TriX.java | 6 +++---
.../java/org/apache/juneau/marshall/jena/marshaller/Turtle.java | 8 ++++----
.../src/main/java/org/apache/juneau/marshall/marshaller/Bson.java | 8 ++++----
.../src/main/java/org/apache/juneau/marshall/marshaller/Csv.java | 6 +++---
.../main/java/org/apache/juneau/marshall/marshaller/Hjson.java | 8 ++++----
.../main/java/org/apache/juneau/marshall/marshaller/Hocon.java | 6 +++---
.../src/main/java/org/apache/juneau/marshall/marshaller/Html.java | 8 ++++----
.../src/main/java/org/apache/juneau/marshall/marshaller/Ini.java | 8 ++++----
.../src/main/java/org/apache/juneau/marshall/marshaller/Jcs.java | 6 +++---
.../main/java/org/apache/juneau/marshall/marshaller/Json5l.java | 6 +++---
.../main/java/org/apache/juneau/marshall/marshaller/Jsonl.java | 6 +++---
.../main/java/org/apache/juneau/marshall/marshaller/Markdown.java | 8 ++++----
.../java/org/apache/juneau/marshall/marshaller/MarkdownDoc.java | 8 ++++----
.../main/java/org/apache/juneau/marshall/marshaller/MsgPack.java | 8 ++++----
.../main/java/org/apache/juneau/marshall/marshaller/OpenApi.java | 8 ++++----
.../main/java/org/apache/juneau/marshall/marshaller/Parquet.java | 4 ++--
.../java/org/apache/juneau/marshall/marshaller/PlainText.java | 8 ++++----
.../java/org/apache/juneau/marshall/marshaller/Prototext.java | 8 ++++----
.../src/main/java/org/apache/juneau/marshall/marshaller/Toml.java | 4 ++--
.../src/main/java/org/apache/juneau/marshall/marshaller/Uon.java | 8 ++++----
.../java/org/apache/juneau/marshall/marshaller/UrlEncoding.java | 8 ++++----
.../src/main/java/org/apache/juneau/marshall/marshaller/Xml.java | 8 ++++----
.../src/main/java/org/apache/juneau/marshall/marshaller/Yaml.java | 8 ++++----
33 files changed, 115 insertions(+), 115 deletions(-)
diff --git
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/JsonLd.java
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/JsonLd.java
index 098119bb07..5149e5d21c 100644
---
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/JsonLd.java
+++
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/JsonLd.java
@@ -20,17 +20,17 @@ import org.apache.juneau.marshall.jena.*;
import org.apache.juneau.marshall.marshaller.*;
/**
- * A pairing of a {@link JsonLdSerializer} and {@link JsonLdParser} into a
single class with convenience read/write methods.
+ * A pairing of a {@link JsonLdSerializer} and {@link JsonLdParser} into a
single class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* JsonLd <jv>jsonLd</jv> = <jk>new</jk> JsonLd();
- * MyPojo <jv>myPojo</jv> = <jv>jsonLd</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>jsonLd</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>jsonLd</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>jsonLd</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bcode'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/N3.java
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/N3.java
index 0c6a0bce24..e0b81e3410 100644
---
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/N3.java
+++
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/N3.java
@@ -20,17 +20,17 @@ import org.apache.juneau.marshall.jena.*;
import org.apache.juneau.marshall.marshaller.*;
/**
- * A pairing of a {@link N3Serializer} and {@link N3Parser} into a single
class with convenience read/write methods.
+ * A pairing of a {@link N3Serializer} and {@link N3Parser} into a single
class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* N3 <jv>n3</jv> = <jk>new</jk> N3();
- * MyPojo <jv>myPojo</jv> = <jv>n3</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>n3</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>n3</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>n3</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/NQuads.java
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/NQuads.java
index 11f144acec..3dd7462c0f 100644
---
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/NQuads.java
+++
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/NQuads.java
@@ -20,7 +20,7 @@ import org.apache.juneau.marshall.jena.*;
import org.apache.juneau.marshall.marshaller.*;
/**
- * A pairing of a {@link NQuadsSerializer} and {@link NQuadsParser} into a
single class with convenience read/write methods.
+ * A pairing of a {@link NQuadsSerializer} and {@link NQuadsParser} into a
single class with convenience to/of methods.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
@@ -33,8 +33,8 @@ import org.apache.juneau.marshall.marshaller.*;
* <p class='bjava'>
* <jc>// Using instance methods</jc>
* NQuads <jv>m</jv> = NQuads.<jsf>DEFAULT</jsf>;
- * <jv>nquads</jv> = <jv>m</jv>.write(<jv>myBean</jv>);
- * <jv>parsed</jv> = <jv>m</jv>.read(<jv>nquads</jv>,
MyPojo.<jk>class</jk>);
+ * <jv>nquads</jv> = <jv>m</jv>.of(<jv>myBean</jv>);
+ * <jv>parsed</jv> = <jv>m</jv>.to(<jv>nquads</jv>, MyPojo.<jk>class</jk>);
* </p>
*
* <h5 class='figure'>Example output (bean with name/age, N-Triples with
graph):</h5>
diff --git
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/NTriple.java
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/NTriple.java
index 052b4b0915..dd1e86926a 100644
---
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/NTriple.java
+++
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/NTriple.java
@@ -20,17 +20,17 @@ import org.apache.juneau.marshall.jena.*;
import org.apache.juneau.marshall.marshaller.*;
/**
- * A pairing of a {@link NTripleSerializer} and {@link NTripleParser} into a
single class with convenience read/write methods.
+ * A pairing of a {@link NTripleSerializer} and {@link NTripleParser} into a
single class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* NTriple <jv>nTriple</jv> = <jk>new</jk> NTriple();
- * MyPojo <jv>myPojo</jv> = <jv>nTriple</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>nTriple</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>nTriple</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>nTriple</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfJson.java
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfJson.java
index 36c8378d0a..e425da0a4d 100644
---
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfJson.java
+++
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfJson.java
@@ -20,7 +20,7 @@ import org.apache.juneau.marshall.jena.*;
import org.apache.juneau.marshall.marshaller.*;
/**
- * A pairing of a {@link RdfJsonSerializer} and {@link RdfJsonParser} into a
single class with convenience read/write methods.
+ * A pairing of a {@link RdfJsonSerializer} and {@link RdfJsonParser} into a
single class with convenience to/of methods.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
@@ -33,8 +33,8 @@ import org.apache.juneau.marshall.marshaller.*;
* <p class='bjava'>
* <jc>// Using instance methods</jc>
* RdfJson <jv>m</jv> = RdfJson.<jsf>DEFAULT</jsf>;
- * <jv>rdfJson</jv> = <jv>m</jv>.write(<jv>myBean</jv>);
- * <jv>parsed</jv> = <jv>m</jv>.read(<jv>rdfJson</jv>,
MyPojo.<jk>class</jk>);
+ * <jv>rdfJson</jv> = <jv>m</jv>.of(<jv>myBean</jv>);
+ * <jv>parsed</jv> = <jv>m</jv>.to(<jv>rdfJson</jv>,
MyPojo.<jk>class</jk>);
* </p>
*
* <h5 class='figure'>Example output (bean with name/age, RDF/JSON
format):</h5>
diff --git
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfProto.java
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfProto.java
index a8ad5c744a..d7fc265087 100644
---
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfProto.java
+++
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfProto.java
@@ -33,8 +33,8 @@ import org.apache.juneau.marshall.marshaller.*;
* <p class='bjava'>
* <jc>// Using instance methods</jc>
* RdfProto <jv>m</jv> = RdfProto.<jsf>DEFAULT</jsf>;
- * <jv>bytes</jv> = <jv>m</jv>.write(<jv>myBean</jv>);
- * <jv>parsed</jv> = <jv>m</jv>.read(<jv>bytes</jv>,
MyPojo.<jk>class</jk>);
+ * <jv>bytes</jv> = <jv>m</jv>.of(<jv>myBean</jv>);
+ * <jv>parsed</jv> = <jv>m</jv>.to(<jv>bytes</jv>, MyPojo.<jk>class</jk>);
* </p>
*
* <p>Output is binary (<jk>byte</jk>[]), Protocol Buffers format.</p>
diff --git
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfThrift.java
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfThrift.java
index 7ed5efe2e3..d45b8a7bec 100644
---
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfThrift.java
+++
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfThrift.java
@@ -33,8 +33,8 @@ import org.apache.juneau.marshall.marshaller.*;
* <p class='bjava'>
* <jc>// Using instance methods</jc>
* RdfThrift <jv>m</jv> = RdfThrift.<jsf>DEFAULT</jsf>;
- * <jv>bytes</jv> = <jv>m</jv>.write(<jv>myBean</jv>);
- * <jv>parsed</jv> = <jv>m</jv>.read(<jv>bytes</jv>,
MyPojo.<jk>class</jk>);
+ * <jv>bytes</jv> = <jv>m</jv>.of(<jv>myBean</jv>);
+ * <jv>parsed</jv> = <jv>m</jv>.to(<jv>bytes</jv>, MyPojo.<jk>class</jk>);
* </p>
*
* <p>Output is binary (<jk>byte</jk>[]), Apache Thrift format.</p>
diff --git
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfXml.java
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfXml.java
index b572d64945..99445dd0c0 100644
---
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfXml.java
+++
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfXml.java
@@ -20,17 +20,17 @@ import org.apache.juneau.marshall.jena.*;
import org.apache.juneau.marshall.marshaller.*;
/**
- * A pairing of a {@link RdfXmlSerializer} and {@link RdfXmlParser} into a
single class with convenience read/write methods.
+ * A pairing of a {@link RdfXmlSerializer} and {@link RdfXmlParser} into a
single class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* RdfXml <jv>rdfXml</jv> = <jk>new</jk> RdfXml();
- * MyPojo <jv>myPojo</jv> = <jv>rdfXml</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>rdfXml</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>rdfXml</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>rdfXml</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfXmlAbbrev.java
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfXmlAbbrev.java
index 9f26fb394c..93a87c4009 100644
---
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfXmlAbbrev.java
+++
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/RdfXmlAbbrev.java
@@ -20,17 +20,17 @@ import org.apache.juneau.marshall.jena.*;
import org.apache.juneau.marshall.marshaller.*;
/**
- * A pairing of a {@link RdfXmlAbbrevSerializer} and {@link RdfXmlParser} into
a single class with convenience read/write methods.
+ * A pairing of a {@link RdfXmlAbbrevSerializer} and {@link RdfXmlParser} into
a single class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* RdfXmlAbbrev <jv>rdfXmlAbbrev</jv> = <jk>new</jk> RdfXmlAbbrev();
- * MyPojo <jv>myPojo</jv> = <jv>rdfXmlAbbrev</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>rdfXmlAbbrev</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>rdfXmlAbbrev</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>rdfXmlAbbrev</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/TriG.java
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/TriG.java
index 559893d34c..b2387796f4 100644
---
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/TriG.java
+++
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/TriG.java
@@ -20,7 +20,7 @@ import org.apache.juneau.marshall.jena.*;
import org.apache.juneau.marshall.marshaller.*;
/**
- * A pairing of a {@link TriGSerializer} and {@link TriGParser} into a single
class with convenience read/write methods.
+ * A pairing of a {@link TriGSerializer} and {@link TriGParser} into a single
class with convenience to/of methods.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
@@ -33,8 +33,8 @@ import org.apache.juneau.marshall.marshaller.*;
* <p class='bjava'>
* <jc>// Using instance methods</jc>
* TriG <jv>m</jv> = TriG.<jsf>DEFAULT</jsf>;
- * <jv>trig</jv> = <jv>m</jv>.write(<jv>myBean</jv>);
- * <jv>parsed</jv> = <jv>m</jv>.read(<jv>trig</jv>, MyPojo.<jk>class</jk>);
+ * <jv>trig</jv> = <jv>m</jv>.of(<jv>myBean</jv>);
+ * <jv>parsed</jv> = <jv>m</jv>.to(<jv>trig</jv>, MyPojo.<jk>class</jk>);
* </p>
*
* <h5 class='figure'>Example output (bean with name/age, Turtle with named
graph):</h5>
diff --git
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/TriX.java
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/TriX.java
index 9e85b1d140..efab9392bf 100644
---
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/TriX.java
+++
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/TriX.java
@@ -20,7 +20,7 @@ import org.apache.juneau.marshall.jena.*;
import org.apache.juneau.marshall.marshaller.*;
/**
- * A pairing of a {@link TriXSerializer} and {@link TriXParser} into a single
class with convenience read/write methods.
+ * A pairing of a {@link TriXSerializer} and {@link TriXParser} into a single
class with convenience to/of methods.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
@@ -33,8 +33,8 @@ import org.apache.juneau.marshall.marshaller.*;
* <p class='bjava'>
* <jc>// Using instance methods</jc>
* TriX <jv>m</jv> = TriX.<jsf>DEFAULT</jsf>;
- * <jv>trix</jv> = <jv>m</jv>.write(<jv>myBean</jv>);
- * <jv>parsed</jv> = <jv>m</jv>.read(<jv>trix</jv>, MyPojo.<jk>class</jk>);
+ * <jv>trix</jv> = <jv>m</jv>.of(<jv>myBean</jv>);
+ * <jv>parsed</jv> = <jv>m</jv>.to(<jv>trix</jv>, MyPojo.<jk>class</jk>);
* </p>
*
* <h5 class='figure'>Example output (bean with name/age):</h5>
diff --git
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/Turtle.java
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/Turtle.java
index c0931b44a6..fc01721068 100644
---
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/Turtle.java
+++
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/marshall/jena/marshaller/Turtle.java
@@ -20,17 +20,17 @@ import org.apache.juneau.marshall.jena.*;
import org.apache.juneau.marshall.marshaller.*;
/**
- * A pairing of a {@link TurtleSerializer} and {@link TurtleParser} into a
single class with convenience read/write methods.
+ * A pairing of a {@link TurtleSerializer} and {@link TurtleParser} into a
single class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* Turtle <jv>turtle</jv> = <jk>new</jk> Turtle();
- * MyPojo <jv>myPojo</jv> = <jv>turtle</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>turtle</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>turtle</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>turtle</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bcode'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Bson.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Bson.java
index 7600cafaaf..fd9a44e48b 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Bson.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Bson.java
@@ -19,17 +19,17 @@ package org.apache.juneau.marshall.marshaller;
import org.apache.juneau.marshall.bson.*;
/**
- * A pairing of a {@link BsonSerializer} and {@link BsonParser} into a single
class with convenience read/write methods.
+ * A pairing of a {@link BsonSerializer} and {@link BsonParser} into a single
class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* Bson <jv>bson</jv> = <jk>new</jk> Bson();
- * MyPojo <jv>myPojo</jv> = <jv>bson</jv>.read(<jv>bytes</jv>,
MyPojo.<jk>class</jk>);
- * <jk>byte</jk>[] <jv>bytes</jv> = <jv>bson</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>bson</jv>.to(<jv>bytes</jv>,
MyPojo.<jk>class</jk>);
+ * <jk>byte</jk>[] <jv>bytes</jv> = <jv>bson</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Csv.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Csv.java
index 0c3b747c27..6ec312864c 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Csv.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Csv.java
@@ -19,7 +19,7 @@ package org.apache.juneau.marshall.marshaller;
import org.apache.juneau.marshall.csv.*;
/**
- * A pairing of a {@link CsvSerializer} and {@link CsvParser} into a single
class with convenience read/write methods.
+ * A pairing of a {@link CsvSerializer} and {@link CsvParser} into a single
class with convenience to/of methods.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
@@ -36,8 +36,8 @@ import org.apache.juneau.marshall.csv.*;
* <p class='bjava'>
* <jc>// Using instance methods</jc>
* Csv <jv>m</jv> = Csv.<jsf>DEFAULT</jsf>;
- * <jv>csv</jv> = <jv>m</jv>.write(<jv>people</jv>);
- * <jv>parsed</jv> = <jv>m</jv>.read(<jv>csv</jv>, List.<jk>class</jk>,
Person.<jk>class</jk>);
+ * <jv>csv</jv> = <jv>m</jv>.of(<jv>people</jv>);
+ * <jv>parsed</jv> = <jv>m</jv>.to(<jv>csv</jv>, List.<jk>class</jk>,
Person.<jk>class</jk>);
* </p>
*
* <h5 class='figure'>Example output (list of maps with a,b):</h5>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Hjson.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Hjson.java
index f5ba237efd..30308b6aa9 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Hjson.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Hjson.java
@@ -19,17 +19,17 @@ package org.apache.juneau.marshall.marshaller;
import org.apache.juneau.marshall.hjson.*;
/**
- * A pairing of a {@link HjsonSerializer} and {@link HjsonParser} into a
single class with convenience read/write methods.
+ * A pairing of a {@link HjsonSerializer} and {@link HjsonParser} into a
single class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* Hjson <jv>hjson</jv> = <jk>new</jk> Hjson();
- * MyPojo <jv>myPojo</jv> = <jv>hjson</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>hjson</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>hjson</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>hjson</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Hocon.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Hocon.java
index 1dbc27ea9e..d5b3126563 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Hocon.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Hocon.java
@@ -19,14 +19,14 @@ package org.apache.juneau.marshall.marshaller;
import org.apache.juneau.marshall.hocon.*;
/**
- * A pairing of a {@link HoconSerializer} and {@link HoconParser} into a
single class with convenience read/write methods.
+ * A pairing of a {@link HoconSerializer} and {@link HoconParser} into a
single class with convenience to/of methods.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Instance usage</jc>
* Hocon <jv>hocon</jv> = <jk>new</jk> Hocon();
- * MyBean <jv>bean</jv> = <jv>hocon</jv>.read(<jv>hoconString</jv>,
MyBean.<jk>class</jk>);
- * String <jv>hoconOut</jv> = <jv>hocon</jv>.write(<jv>bean</jv>);
+ * MyBean <jv>bean</jv> = <jv>hocon</jv>.to(<jv>hoconString</jv>,
MyBean.<jk>class</jk>);
+ * String <jv>hoconOut</jv> = <jv>hocon</jv>.of(<jv>bean</jv>);
* </p>
* <p class='bjava'>
* <jc>// Static DEFAULT instance</jc>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Html.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Html.java
index c35eaef5b9..be85e733c7 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Html.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Html.java
@@ -19,17 +19,17 @@ package org.apache.juneau.marshall.marshaller;
import org.apache.juneau.marshall.html.*;
/**
- * A pairing of a {@link HtmlSerializer} and {@link HtmlParser} into a single
class with convenience read/write methods.
+ * A pairing of a {@link HtmlSerializer} and {@link HtmlParser} into a single
class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* Html <jv>html</jv> = <jk>new</jk> Html();
- * MyPojo <jv>myPojo</jv> = <jv>html</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>html</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>html</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>html</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Ini.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Ini.java
index 31fa877ba7..d936068b41 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Ini.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Ini.java
@@ -19,17 +19,17 @@ package org.apache.juneau.marshall.marshaller;
import org.apache.juneau.marshall.ini.*;
/**
- * A pairing of an {@link IniSerializer} and {@link IniParser} into a single
class with convenience read/write methods.
+ * A pairing of an {@link IniSerializer} and {@link IniParser} into a single
class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* Ini <jv>ini</jv> = <jk>new</jk> Ini();
- * MyPojo <jv>myPojo</jv> = <jv>ini</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>ini</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>ini</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>ini</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Jcs.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Jcs.java
index dded2b4770..ce04ddb170 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Jcs.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Jcs.java
@@ -21,7 +21,7 @@ import org.apache.juneau.marshall.json.*;
/**
* A pairing of a {@link JcsSerializer} and {@link JsonParser} into a single
class with
- * convenience read/write methods.
+ * convenience to/of methods.
*
* <p>
* Produces canonical JSON per <a class="doclink"
href="https://www.rfc-editor.org/rfc/rfc8785";>RFC 8785</a>.
@@ -37,8 +37,8 @@ import org.apache.juneau.marshall.json.*;
* <p class='bjava'>
* <jc>// Using instance.</jc>
* Jcs <jv>jcs</jv> = <jk>new</jk> Jcs();
- * String <jv>s</jv> = <jv>jcs</jv>.write(<jv>myBean</jv>);
- * MyBean <jv>b</jv> = <jv>jcs</jv>.read(<jv>s</jv>,
MyBean.<jk>class</jk>);
+ * String <jv>s</jv> = <jv>jcs</jv>.of(<jv>myBean</jv>);
+ * MyBean <jv>b</jv> = <jv>jcs</jv>.to(<jv>s</jv>, MyBean.<jk>class</jk>);
* </p>
*
* <h5 class='figure'>Example output (bean with name/age):</h5>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Json5l.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Json5l.java
index 120aab810f..8c43c77113 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Json5l.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Json5l.java
@@ -20,14 +20,14 @@ import org.apache.juneau.marshall.json5l.*;
/**
* Pairs {@link Json5lSerializer} and {@link Json5lParser} into a single class
with convenience
- * read/write methods.
+ * to/of methods.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Serialize to JSON5L using instance</jc>
* Json5l <jv>json5l</jv> = <jk>new</jk> Json5l();
- * String <jv>out</jv> = <jv>json5l</jv>.write(<jv>myList</jv>);
- * List<MyBean> <jv>in</jv> = <jv>json5l</jv>.read(<jv>out</jv>,
List.<jk>class</jk>, MyBean.<jk>class</jk>);
+ * String <jv>out</jv> = <jv>json5l</jv>.of(<jv>myList</jv>);
+ * List<MyBean> <jv>in</jv> = <jv>json5l</jv>.to(<jv>out</jv>,
List.<jk>class</jk>, MyBean.<jk>class</jk>);
*
* <jc>// Serialize to JSON5L using DEFAULT instance</jc>
* String <jv>out</jv> = Json5l.<jsm>of</jsm>(<jv>myList</jv>);
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Jsonl.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Jsonl.java
index 5b311c8ac2..d4c371c2c8 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Jsonl.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Jsonl.java
@@ -20,14 +20,14 @@ import org.apache.juneau.marshall.jsonl.*;
/**
* Pairs {@link JsonlSerializer} and {@link JsonlParser} into a single class
with convenience
- * read/write methods.
+ * to/of methods.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Serialize to JSONL using instance</jc>
* Jsonl <jv>jsonl</jv> = <jk>new</jk> Jsonl();
- * String <jv>out</jv> = <jv>jsonl</jv>.write(<jv>myList</jv>);
- * List<MyBean> <jv>in</jv> = <jv>jsonl</jv>.read(<jv>out</jv>,
List.<jk>class</jk>, MyBean.<jk>class</jk>);
+ * String <jv>out</jv> = <jv>jsonl</jv>.of(<jv>myList</jv>);
+ * List<MyBean> <jv>in</jv> = <jv>jsonl</jv>.to(<jv>out</jv>,
List.<jk>class</jk>, MyBean.<jk>class</jk>);
*
* <jc>// Serialize to JSONL using DEFAULT instance</jc>
* String <jv>out</jv> = Jsonl.<jsm>of</jsm>(<jv>myList</jv>);
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Markdown.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Markdown.java
index 14c9fc8f0a..7dcf61d67b 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Markdown.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Markdown.java
@@ -19,17 +19,17 @@ package org.apache.juneau.marshall.marshaller;
import org.apache.juneau.marshall.markdown.*;
/**
- * A pairing of a {@link MarkdownSerializer} and {@link MarkdownParser} into a
single class with convenience read/write methods.
+ * A pairing of a {@link MarkdownSerializer} and {@link MarkdownParser} into a
single class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* Markdown <jv>md</jv> = <jk>new</jk> Markdown();
- * MyPojo <jv>myPojo</jv> = <jv>md</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>md</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>md</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>md</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/MarkdownDoc.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/MarkdownDoc.java
index 1f477d639f..962044902b 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/MarkdownDoc.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/MarkdownDoc.java
@@ -20,17 +20,17 @@ import org.apache.juneau.marshall.markdown.*;
/**
* A pairing of a {@link MarkdownDocSerializer} and {@link MarkdownDocParser}
into a single class with
- * convenience read/write methods for document-mode Markdown (headings +
tables).
+ * convenience to/of methods for document-mode Markdown (headings + tables).
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* MarkdownDoc <jv>md</jv> = <jk>new</jk> MarkdownDoc();
- * MyPojo <jv>myPojo</jv> = <jv>md</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>md</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>md</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>md</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/MsgPack.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/MsgPack.java
index 980bbc45a5..8df491318a 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/MsgPack.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/MsgPack.java
@@ -19,17 +19,17 @@ package org.apache.juneau.marshall.marshaller;
import org.apache.juneau.marshall.msgpack.*;
/**
- * A pairing of a {@link MsgPackSerializer} and {@link MsgPackParser} into a
single class with convenience read/write methods.
+ * A pairing of a {@link MsgPackSerializer} and {@link MsgPackParser} into a
single class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* MsgPack <jv>msgPack</jv> = <jk>new</jk> MsgPack();
- * MyPojo <jv>myPojo</jv> = <jv>msgPack</jv>.read(<jv>bytes</jv>,
MyPojo.<jk>class</jk>);
- * <jk>byte</jk>[] <jv>bytes</jv> =
<jv>msgPack</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>msgPack</jv>.to(<jv>bytes</jv>,
MyPojo.<jk>class</jk>);
+ * <jk>byte</jk>[] <jv>bytes</jv> = <jv>msgPack</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/OpenApi.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/OpenApi.java
index 8eea31997c..18d0bec304 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/OpenApi.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/OpenApi.java
@@ -23,17 +23,17 @@ import org.apache.juneau.marshall.parser.*;
import org.apache.juneau.marshall.serializer.*;
/**
- * A pairing of a {@link OpenApiSerializer} and {@link OpenApiParser} into a
single class with convenience read/write methods.
+ * A pairing of a {@link OpenApiSerializer} and {@link OpenApiParser} into a
single class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* OpenApi <jv>oapi</jv> = <jk>new</jk> OpenApi();
- * MyPojo <jv>myPojo</jv> = <jv>oapi</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>oapi</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>oapi</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>oapi</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Parquet.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Parquet.java
index 427d373a9b..fb918c6b57 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Parquet.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Parquet.java
@@ -33,8 +33,8 @@ import org.apache.juneau.marshall.parquet.*;
* <p class='bjava'>
* <jc>// Using instance methods</jc>
* Parquet <jv>m</jv> = Parquet.<jsf>DEFAULT</jsf>;
- * <jv>bytes</jv> = <jv>m</jv>.write(<jv>beans</jv>);
- * <jv>parsed</jv> = <jv>m</jv>.read(<jv>bytes</jv>,
MyBean.<jk>class</jk>);
+ * <jv>bytes</jv> = <jv>m</jv>.of(<jv>beans</jv>);
+ * <jv>parsed</jv> = <jv>m</jv>.to(<jv>bytes</jv>, MyBean.<jk>class</jk>);
* </p>
*
* <p>Output is binary (<jk>byte</jk>[]), Apache Parquet columnar format.</p>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/PlainText.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/PlainText.java
index 7925324f0a..f676dc8465 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/PlainText.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/PlainText.java
@@ -19,17 +19,17 @@ package org.apache.juneau.marshall.marshaller;
import org.apache.juneau.marshall.plaintext.*;
/**
- * A pairing of a {@link PlainTextSerializer} and {@link PlainTextParser} into
a single class with convenience read/write methods.
+ * A pairing of a {@link PlainTextSerializer} and {@link PlainTextParser} into
a single class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* PlainText <jv>plainText</jv> = <jk>new</jk> PlainText();
- * MyPojo <jv>myPojo</jv> = <jv>plainText</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>plainText</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>plainText</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>plainText</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Prototext.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Prototext.java
index f4c7566931..4793ae505f 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Prototext.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Prototext.java
@@ -19,17 +19,17 @@ package org.apache.juneau.marshall.marshaller;
import org.apache.juneau.marshall.prototext.*;
/**
- * A pairing of a {@link PrototextSerializer} and {@link PrototextParser} into
a single class with convenience read/write methods.
+ * A pairing of a {@link PrototextSerializer} and {@link PrototextParser} into
a single class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* Prototext <jv>proto</jv> = <jk>new</jk> Prototext();
- * MyPojo <jv>myPojo</jv> = <jv>proto</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>proto</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>proto</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>proto</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Toml.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Toml.java
index 2a1eadf56f..b71200ce21 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Toml.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Toml.java
@@ -38,8 +38,8 @@ import org.apache.juneau.marshall.toml.*;
* <p class='bjava'>
* <jc>// Using instance methods</jc>
* Toml <jv>m</jv> = Toml.<jsf>DEFAULT</jsf>;
- * String <jv>toml</jv> = <jv>m</jv>.write(<jv>config</jv>);
- * JsonMap <jv>parsed</jv> = <jv>m</jv>.read(<jv>toml</jv>,
JsonMap.<jk>class</jk>);
+ * String <jv>toml</jv> = <jv>m</jv>.of(<jv>config</jv>);
+ * JsonMap <jv>parsed</jv> = <jv>m</jv>.to(<jv>toml</jv>,
JsonMap.<jk>class</jk>);
* </p>
*
* <h5 class='figure'>Example output (Map of name/age):</h5>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Uon.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Uon.java
index 1b23a34f53..68799bbbe0 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Uon.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Uon.java
@@ -19,17 +19,17 @@ package org.apache.juneau.marshall.marshaller;
import org.apache.juneau.marshall.uon.*;
/**
- * A pairing of a {@link UonSerializer} and {@link UonParser} into a single
class with convenience read/write methods.
+ * A pairing of a {@link UonSerializer} and {@link UonParser} into a single
class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* Uon <jv>uon</jv> = <jk>new</jk> Uon();
- * MyPojo <jv>myPojo</jv> = <jv>uon</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>uon</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>uon</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>uon</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/UrlEncoding.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/UrlEncoding.java
index ec53b2466e..46a267a332 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/UrlEncoding.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/UrlEncoding.java
@@ -19,17 +19,17 @@ package org.apache.juneau.marshall.marshaller;
import org.apache.juneau.marshall.urlencoding.*;
/**
- * A pairing of a {@link UrlEncodingSerializer} and {@link UrlEncodingParser}
into a single class with convenience read/write methods.
+ * A pairing of a {@link UrlEncodingSerializer} and {@link UrlEncodingParser}
into a single class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* UrlEncoding <jv>urlEncoding</jv> = <jk>new</jk> UrlEncoding();
- * MyPojo <jv>myPojo</jv> = <jv>urlEncoding</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>urlEncoding</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>urlEncoding</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>urlEncoding</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Xml.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Xml.java
index 7695791883..ac3c74f1cd 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Xml.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Xml.java
@@ -19,17 +19,17 @@ package org.apache.juneau.marshall.marshaller;
import org.apache.juneau.marshall.xml.*;
/**
- * A pairing of a {@link XmlSerializer} and {@link XmlParser} into a single
class with convenience read/write methods.
+ * A pairing of a {@link XmlSerializer} and {@link XmlParser} into a single
class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* Xml <jv>xml</jv> = <jk>new</jk> Xml();
- * MyPojo <jv>myPojo</jv> = <jv>xml</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>xml</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>xml</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>xml</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Yaml.java
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Yaml.java
index c771997dcf..ee8fa8158a 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Yaml.java
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/marshall/marshaller/Yaml.java
@@ -19,17 +19,17 @@ package org.apache.juneau.marshall.marshaller;
import org.apache.juneau.marshall.yaml.*;
/**
- * A pairing of a {@link YamlSerializer} and {@link YamlParser} into a single
class with convenience read/write methods.
+ * A pairing of a {@link YamlSerializer} and {@link YamlParser} into a single
class with convenience to/of methods.
*
* <p>
- * The general idea is to combine a single serializer and parser inside a
simplified API for reading and writing POJOs.
+ * The general idea is to combine a single serializer and parser inside a
simplified API for serializing and parsing POJOs.
*
* <h5 class='figure'>Examples:</h5>
* <p class='bjava'>
* <jc>// Using instance.</jc>
* Yaml <jv>yaml</jv> = <jk>new</jk> Yaml();
- * MyPojo <jv>myPojo</jv> = <jv>yaml</jv>.read(<jv>string</jv>,
MyPojo.<jk>class</jk>);
- * String <jv>string</jv> = <jv>yaml</jv>.write(<jv>myPojo</jv>);
+ * MyPojo <jv>myPojo</jv> = <jv>yaml</jv>.to(<jv>string</jv>,
MyPojo.<jk>class</jk>);
+ * String <jv>string</jv> = <jv>yaml</jv>.of(<jv>myPojo</jv>);
* </p>
* <p class='bjava'>
* <jc>// Using DEFAULT instance.</jc>
