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 6d5b67c Update Javadocs.
6d5b67c is described below
commit 6d5b67ca9d63d9f9d3b7600a6935a276afaa898c
Author: JamesBognar <[email protected]>
AuthorDate: Mon Mar 5 13:48:48 2018 -0500
Update Javadocs.
---
.../main/java/org/apache/juneau/jena/package.html | 59 -----
.../main/java/org/apache/juneau/json/package.html | 37 ---
.../main/java/org/apache/juneau/uon/package.html | 44 ---
.../org/apache/juneau/urlencoding/package.html | 43 ---
.../main/java/org/apache/juneau/xml/package.html | 47 ----
juneau-doc/src/main/javadoc/doc-files/rfc_uon.txt | 294 +++++++++++++++++++++
juneau-doc/src/main/javadoc/overview.html | 55 +++-
7 files changed, 343 insertions(+), 236 deletions(-)
diff --git
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/package.html
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/package.html
index 426d991..db4f100 100644
---
a/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/package.html
+++
b/juneau-core/juneau-marshall-rdf/src/main/java/org/apache/juneau/jena/package.html
@@ -75,65 +75,6 @@
<a id="RdfOverview"></a>
<h2 class='topic' onclick='toggle(this)'>1 - RDF support overview</h2>
<div class='topic'>
- <p>
- Juneau supports serializing and parsing arbitrary POJOs to and
from the following RDF formats:
- </p>
- <ul>
- <li>RDF/XML
- <li>Abbreviated RDF/XML
- <li>N-Triple
- <li>Turtle
- <li>N3
- </ul>
- <p>
- Juneau can serialize and parse instances of any of the
following POJO types:
- </p>
- <ul class='spaced-list'>
- <li>
- Java primitive objects (e.g. <code>String</code>,
<code>Integer</code>, <code>Boolean</code>,
- <code>Float</code>).
- <li>
- Java collections framework objects (e.g.
<code>HashSet</code>, <code>TreeMap</code>) containing anything on
- this list.
- <li>
- Multi-dimensional arrays of any type on this list.
- <li>
- Java Beans with properties of any type on this list.
- <li>
- Classes with standard transformations to and from
<code>Strings</code> (e.g. classes containing
- <code>toString()</code>, <code>fromString()</code>,
<code>valueOf()</code>, <code>constructor(String)</code>).
- </ul>
- <p>
- In addition to the types shown above, Juneau includes the
ability to define 'swaps' to transform non-standard
- object and property types to serializable forms (e.g. to
transform <code>Calendars</code> to and from
- <code>ISO8601</code> strings, or <code>byte[]</code> arrays to
and from base-64 encoded strings).
- <br>These can be associated with serializers/parsers, or can
be associated with classes or bean properties through
- type and method annotations.
- </p>
- <p>
- Refer to <a
href='../../../../overview-summary.html#juneau-marshall.PojoCategories'
class='doclink'>POJO Categories</a>
- for a complete definition of supported POJOs.
- </p>
-
- <h5 class='topic'>Prerequisites</h5>
- <p>
- Juneau uses the Jena library for these formats.
- <br>The predefined serializers and parsers convert POJOs to and
from RDF models and then uses Jena to convert
- them to and from the various RDF languages.
- </p>
- <p>
- Jena libraries must be provided on the classpath separately if
you plan on making use of the RDF support.
- </p>
- <p>
- The minimum list of required jars are:
- </p>
- <ul>
- <li><code>jena-core-2.7.1.jar</code>
- <li><code>jena-iri-0.9.2.jar</code>
- <li><code>log4j-1.2.16.jar</code>
- <li><code>slf4j-api-1.6.4.jar</code>
- <li><code>slf4j-log4j12-1.6.4.jar</code>
- </ul>
<!--
========================================================================================================
-->
<a id="RdfOverviewExample"></a>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/package.html
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/package.html
index 41c80b3..f4de010 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/package.html
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/json/package.html
@@ -73,43 +73,6 @@
<a id="Overview"></a>
<h2 class='topic' onclick='toggle(this)'>1 -JSON support overview</h2>
<div class='topic'>
- <p>
- Juneau supports converting arbitrary POJOs to and from JSON
using ultra-efficient serializers and parsers.
- <br>The JSON serializer converts POJOs directly to JSON without
the need for intermediate DOM objects using a
- highly-efficient state machine.
- <br>Likewise, the JSON parser creates POJOs directly from JSON
without the need for intermediate DOM objects.
- </p>
- <p>
- Juneau can serialize and parse instances of any of the
following POJO types:
- </p>
- <ul class='spaced-list'>
- <li>
- Java primitives and primitive objects (e.g.
<code>String</code>, <code>Integer</code>, <code>Boolean</code>,
- <code>Float</code>).
- <li>
- Java Collections Framework objects (e.g.
<code>HashSet</code>, <code>TreeMap</code>) containing anything on
- this list.
- <li>
- Multi-dimensional arrays of any type on this list.
- <li>
- Java Beans with properties of any type on this list.
- <li>
- Classes with standard transformations to and from
<code>Strings</code> (e.g. classes containing
- <code>toString()</code>, <code>fromString()</code>,
<code>valueOf()</code>, <code>constructor(String)</code>).
- <li>
- Non-serializable classes and properties with associated
<code>PojoSwaps</code> that convert them to
- serializable forms.
- </ul>
- <p>
- Refer to <a
href='../../../../overview-summary.html#juneau-marshall.PojoCategories'
class='doclink'>POJO Categories</a>
- for a complete definition of supported POJOs.
- </p>
-
- <h5 class='topic'>Prerequisites</h5>
- <p>
- The Juneau JSON serialization and parsing support does not
require any external prerequisites.
- It only requires Java 1.6 or above.
- </p>
<!--
========================================================================================================
-->
<a id="OverviewExample"></a>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/uon/package.html
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/uon/package.html
index 152e263..48ce2b7 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/uon/package.html
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/uon/package.html
@@ -69,50 +69,6 @@
<a id="Overview"></a>
<h2 class='topic' onclick='toggle(this)'>1 - URL encoding support overview</h2>
<div class='topic'>
- <p>
- Juneau supports converting arbitrary POJOs to and from
URL-encoded strings using ultra-efficient serializers
- and parsers.
- <br>The serializer converts POJOs directly to URL-encoded
strings without the need for intermediate DOM objects
- using a highly-efficient state machine.
- <br>Likewise, the parser creates POJOs directly from
URL-encoded strings without the need for intermediate DOM
- objects.
- </p>
- <p>
- Juneau uses UON (URL-Encoded Object Notation) for representing
POJOs.
- The UON specification can be found <a
href='doc-files/rfc_uon.txt'>here</a>.
- </p>
- <p>
- Juneau can serialize and parse instances of any of the
following POJO types:
- </p>
- <ul class='spaced-list'>
- <li>
- Java primitives and primitive objects (e.g.
<code>String</code>, <code>Integer</code>, <code>Boolean</code>,
- <code>Float</code>).
- <li>
- Java Collections Framework objects (e.g.
<code>HashSet</code>, <code>TreeMap</code>) containing anything
- on this list.
- <li>
- Multi-dimensional arrays of any type on this list.
- <li>
- Java Beans with properties of any type on this list.
- <li>
- Classes with standard transformations to and from
<code>Strings</code> (e.g. classes containing
- <code>toString()</code>, <code>fromString()</code>,
<code>valueOf()</code>,
- <code>constructor(String)</code>).
- <li>
- Non-serializable classes and properties with associated
<code>PojoSwaps</code> that convert them to
- serializable forms.
- </ul>
- <p>
- Refer to <a
href='../../../../overview-summary.html#juneau-marshall.PojoCategories'
class='doclink'>POJO Categories</a>
- for a complete definition of supported POJOs.
- </p>
-
- <h5 class='topic'>Prerequisites</h5>
- <p>
- The Juneau URL-encoding serialization and parsing support does
not require any external prerequisites.
- It only requires Java 1.6 or above.
- </p>
<!--
========================================================================================================
-->
<a id="OverviewExample"></a>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/urlencoding/package.html
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/urlencoding/package.html
index 6a23232..2860594 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/urlencoding/package.html
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/urlencoding/package.html
@@ -69,49 +69,6 @@
<a id="Overview"></a>
<h2 class='topic' onclick='toggle(this)'>1 - URL encoding support overview</h2>
<div class='topic'>
- <p>
- Juneau supports converting arbitrary POJOs to and from
URL-encoded strings using ultra-efficient serializers
- and parsers.
- <br>The serializer converts POJOs directly to URL-encoded
strings without the need for intermediate DOM objects
- using a highly-efficient state machine.
- <br>Likewise, the parser creates POJOs directly from
URL-encoded strings without the need for intermediate DOM
- objects.
- </p>
- <p>
- Juneau uses UON (URL-Encoded Object Notation) for representing
POJOs.
- The UON specification can be found <a
href='doc-files/rfc_uon.txt'>here</a>.
- </p>
- <p>
- Juneau can serialize and parse instances of any of the
following POJO types:
- </p>
- <ul class='spaced-list'>
- <li>
- Java primitives and primitive objects (e.g.
<code>String</code>, <code>Integer</code>, <code>Boolean</code>,
- <code>Float</code>).
- <li>
- Java Collections Framework objects (e.g.
<code>HashSet</code>, <code>TreeMap</code>) containing anything
- on this list.
- <li>
- Multi-dimensional arrays of any type on this list.
- <li>
- Java Beans with properties of any type on this list.
- <li>
- Classes with standard transformations to and from
<code>Strings</code> (e.g. classes containing
- <code>toString()</code>, <code>fromString()</code>,
<code>valueOf()</code>, <code>constructor(String)</code>).
- <li>
- Non-serializable classes and properties with associated
<code>PojoSwaps</code> that convert them to
- serializable forms.
- </ul>
- <p>
- Refer to <a
href='../../../../overview-summary.html#juneau-marshall.PojoCategories'
class='doclink'>POJO Categories</a>
- for a complete definition of supported POJOs.
- </p>
-
- <h5 class='topic'>Prerequisites</h5>
- <p>
- The Juneau URL-encoding serialization and parsing support does
not require any external prerequisites.
- It only requires Java 1.6 or above.
- </p>
<!--
========================================================================================================
-->
<a id="OverviewExample"></a>
diff --git
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/package.html
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/package.html
index 499dbfe..7de0b06 100644
---
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/package.html
+++
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/xml/package.html
@@ -84,53 +84,6 @@
<a id="Overview"></a>
<h2 class='topic' onclick='toggle(this)'>1 - XML support overview</h2>
<div class='topic'>
- <p>
- Juneau supports converting arbitrary POJOs to and from XML
using ultra-efficient serializers and parsers.
- <br>The XML serializer converts POJOs directly to XML without
the need for intermediate DOM objects.
- <br>Likewise, the XML parser uses a STaX parser and creates
POJOs directly without intermediate DOM objects.
- </p>
- <p>
- Unlike frameworks such as JAXB, Juneau does not require POJO
classes to be annotated to produce and consume
- XML.
- <br>For example, it can serialize and parse instances of any of
the following POJO types:
- </p>
- <ul class='spaced-list'>
- <li>
- Java primitive objects (e.g. <code>String</code>,
<code>Integer</code>, <code>Boolean</code>,
- <code>Float</code>).
- <li>
- Java collections framework objects (e.g.
<code>HashSet</code>, <code>TreeMap</code>) containing anything
- on this list.
- <li>
- Multi-dimensional arrays of any type on this list.
- <li>
- Java Beans with properties of any type on this list.
- <li>
- Classes with standard transformations to and from
<code>Strings</code> (e.g. classes containing
- <code>toString()</code>, <code>fromString()</code>,
<code>valueOf()</code>,
- <code>constructor(String)</code>).
- </ul>
- <p>
- In addition to the types shown above, Juneau includes the
ability to define transforms to transform
- non-standard object and property types to serializable forms
(e.g. to transform <code>Calendars</code> to and
- from <code>ISO8601</code> strings, or <code>byte[]</code>
arrays to and from base-64 encoded strings).
- <br>These transforms can be associated with
serializers/parsers, or can be associated with classes or bean
- properties through type and method annotations.
- </p>
- <p>
- Refer to <a
href='../../../../overview-summary.html#juneau-marshall.PojoCategories'
class='doclink'>POJO Categories</a>
- for a complete definition of supported POJOs.
- </p>
- <p>
- While annotations are not required to produce or consume XML,
several XML annotations are provided for handling
- namespaces and fine-tuning the format of the XML produced.
- </p>
-
- <h5 class='topic'>Prerequisites</h5>
- <p>
- The Juneau XML serialization and parsing support does not
require any external prerequisites.
- It only requires Java 1.6 or above.
- </p>
<!--
========================================================================================================
-->
<a id="OverviewExample"></a>
diff --git a/juneau-doc/src/main/javadoc/doc-files/rfc_uon.txt
b/juneau-doc/src/main/javadoc/doc-files/rfc_uon.txt
new file mode 100644
index 0000000..7880064
--- /dev/null
+++ b/juneau-doc/src/main/javadoc/doc-files/rfc_uon.txt
@@ -0,0 +1,294 @@
+Network Working Group J. Bognar
+Request for Comments: 9999
+Category: Informational Salesforce
+ Feb 2017
+
+ ***DRAFT***
+ URI Object Notation (UON): Generic Syntax
+
+
+About this document
+
+ This memo provides information for the Internet community. It does
+ not specify an Internet standard of any kind. Distribution of this
+ memo is unlimited.
+
+Copyright Notice
+
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Abstract
+
+ This document describes a grammar that builds upon RFC2396
+ (Uniform Resource Identifiers). Its purpose is to define a
+ generalized object notation for URI query parameter values similar in
+ concept to Javascript Object Notation (RFC4627). The goal is a
+ syntax that allows for array and map structures to be
+ such that any data structure defined in JSON can be losslessly
+ defined in an equivalent URI-based grammar, yet be fully compliant
+ with the RFC2396 specification.
+
+ This grammar provides the ability to construct the following data
+ structures in URL parameter values:
+
+ OBJECT
+ ARRAY
+ NUMBER
+ BOOLEAN
+ STRING
+ NULL
+
+ Example:
+
+ The following shows a sample object defined in Javascript:
+
+ var x = {
+ id: 1,
+ name: 'John Smith',
+ uri: 'http://sample/addressBook/person/1',
+ addressBookUri: 'http://sample/addressBook',
+ birthDate: '1946-08-12T00:00:00Z',
+ otherIds: null,
+ addresses: [
+ {
+ uri: 'http://sample/addressBook/address/1',
+ personUri: 'http://sample/addressBook/person/1',
+ id: 1,
+ street: '100 Main Street',
+ city: 'Anywhereville',
+ state: 'NY',
+ zip: 12345,
+ isCurrent: true,
+ }
+ ]
+ }
+
+ Using the syntax defined in this document, the equivalent
+ UON notation would be as follows:
+
+ x=(id=1,name='John+Smith',uri=http://sample/
+ addressBook/person/1,addressBookUri=http://sample/
+ addressBook,birthDate=1946-08-12T00:00:00Z,otherIds=null,
+ addresses=@((uri=http://sample/addressBook/
+ address/1,personUri=http://sample/addressBook/
+ person/1,id=1,street='100+Main+Street',city=
+ Anywhereville,state=NY,zip=12345,isCurrent=true)))
+
+1. Language constraints
+
+ The grammar syntax is constrained to usage of characters allowed by
+ URI notation:
+
+ uric = reserved | unreserved | escaped
+ reserved = ";" | "/" | "?" | ":" | "@" | "&" | "=" | "+" |
+ "$" | ","
+ unreserved = alphanum | mark
+ mark = "-" | "_" | "." | "!" | "~" | "*" | "'" | "(" | ")"
+
+ In particular, the URI specification disallows the following
+ characters in unencoded form:
+
+ unwise = "{" | "}" | "|" | "\" | "^" | "[" | "]" | "`"
+ delims = "<" | ">" | "#" | "%" | <">
+
+ The exclusion of {} and [] characters eliminates the possibility of
+ using JSON as parameter values.
+
+
+2. Grammar constructs
+
+ The grammar consists of the following language constructs:
+
+ Objects - Values consisting of one or more child name/value pairs.
+ Arrays - Values consisting of zero or more child values.
+ Booleans - Values consisting of true/false values.
+ Numbers - Decimal and floating point values.
+ Strings - Everything else.
+
+2.1. Objects
+
+ Objects are values consisting of one or more child name/value pairs.
+ The (...) construct is used to define an object.
+
+ Example: A simple map with two key/value pairs:
+
+ a1=(b1=x1,b2=x2)
+
+ Example: A nested map:
+
+ a1=(b1=(c1=x1,c2=x2))
+
+2.2. Arrays
+
+ Arrays are values consisting of zero or more child values.
+ The @(...) construct is used to define an array.
+
+ Example: An array of two string values:
+
+ a1=@(x1,x2)
+
+ Example: A 2-dimensional array:
+
+ a1=@(@(x1,x2),@(x3,x4))
+
+ Example: An array of objects:
+
+ a1=@((b1=x1,b2=x2),(c1=x1,c2=x2))
+
+2.3. Booleans
+
+ Booleans are values that can only take on values "true" or "false".
+
+ Example: Two boolean values:
+
+ a1=true&a2=false
+
+2.4. Numbers
+
+ Numbers are represented without constructs.
+ Both decimal and float numbers are supported.
+
+ Example: Two numerical values, one decimal and one float:
+
+ a1=123&a2=1.23e1
+
+2.5. Null values
+
+ Nulls are represented by the keyword 'null':
+
+ a1=null
+
+2.6. Strings
+
+ Strings are encapsulated in single quote (') characters.
+
+ Example: Simple string values:
+
+ a1='foobar'&a2='123'&a3='true'
+
+ The quotes are optional when the string cannot be confused
+ with one of the constructs listed above (i.e. objects/arrays/
+ booleans/numbers/null).
+
+ Example: A simple string value, unquoted:
+
+ a1=foobar
+
+ Strings must be quoted for the following cases:
+
+ - The string can be confused with a boolean or number.
+ - The string is empty.
+ - The string contains one or more whitespace characters.
+ - The string starts with one of the following characters:
+ @ (
+ - The string contains any of the following characters:
+ ) , =
+
+ For example, the string literal "(b1=x)" should be
+ represented as follows:
+
+ a1='(b1=x)'
+
+ The tilde character (~) is used for escaping characters to prevent
+ them from being confused with syntax characters.
+
+ The following characters must be escaped in string literals:
+
+ ' ~
+
+ Example: The string "foo'bar~baz"
+
+ a1='foo~'bar~~baz'
+
+2.7. Top-level attribute names
+
+ Top-level attribute names (e.g. "a1" in "&a1=foobar") are treated
+ as strings but for one exception. The '=' character must be
+ encoded so as not to be confused as a key/value separator.
+ Note that the '=' character must also be escaped per the UON
+ notation.
+
+ For example, the UON equivalent of {"a=b":"a=b"} constructed as
+ a top-level query parameter string would be as follows:
+
+ a~%3Db=a~=b
+
+ Note that the '=' character is encoded in the attribute name,
+ but it is not necessary to have it encoded in the attribute value.
+
+2.8. URL-encoded characters
+
+ UON notation allows for any character, even UON grammar
+ characters, to be URL-encoded.
+
+ The following query strings are fully equivalent in structure:
+
+ a1=(b1='x1',b2='x2')
+ %61%31=%79%6f%75%20%61%72%65%20%61%20%6e%65%72%64%21
+
+
+3. BNF
+
+ The following BNF describes the syntax for top-level URI query
+ parameter values (e.g. ?<attrname>=<value>).
+
+ attrname = (string | null)
+ value = (var | string | null)
+
+ string = ("'" litchar* "'") | litchar*
+ null = "null"
+
+ var = ovar | avar | nvar | boolean | number
+ ovar = "(" [pairs] ")"
+ avar = "@(" [values] ")"
+
+ pairs = pair ["," pairs]
+ pair = key "=" value
+ values = value ["," values]
+ key = (string | null)
+ boolean = "true" | "false"
+
+ escape_seq = "~" escaped
+ encode_seq = "%" digithex digithex
+
+ number = [-] (decimal | float) [exp]
+ decimal = "0" | (digit19 digit*)
+ float = decimal "." digit+
+ exp = "e" [("+" | "-")] digit+
+
+ litchar = unencoded | encode_seq | escape_seq
+ escaped = "@" | "," | "(" | ")" | "~" | "="
+ unencoded = alpha | digit |
+ ";" | "/" | "?" | ":" | "@" |
+ "-" | "_" | "." | "!" | "*" | "'"
+ alpha = "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" |
+ "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" |
+ "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z" |
+ "A" | "B" | "C" | "D" | "E" | "F" | "G" | "H" | "I" |
+ "J" | "K" | "L" | "M" | "N" | "O" | "P" | "Q" | "R" |
+ "S" | "T" | "U" | "V" | "W" | "X" | "Y" | "Z"
+ digit = "0" | digit19
+ digit19 = "1" | "2" | "3" | "4" | "5" | "6" | "7" |
+ "8" | "9"
+ digithex = digit |
+ "A" | "B" | "C" | "D" | "E" | "F" |
+ "a" | "b" | "c" | "d" | "e" | "f"
+
+
+
+
diff --git a/juneau-doc/src/main/javadoc/overview.html
b/juneau-doc/src/main/javadoc/overview.html
index a0e3483..d447f21 100644
--- a/juneau-doc/src/main/javadoc/overview.html
+++ b/juneau-doc/src/main/javadoc/overview.html
@@ -3901,12 +3901,6 @@
<br>Likewise, the JSON parser creates POJOs directly
from JSON without the need for intermediate DOM objects.
</p>
- <h5 class='topic'>Prerequisites</h5>
- <p>
- The Juneau JSON serialization and parsing support does
not require any external prerequisites.
- <br>It only requires Java 1.6 or above.
- </p>
-
<h5 class='toc'>Additional Information -
org.apache.juneau.json</h5>
<ol class='toc'>
<li><p><a class='doclink'
href='org/apache/juneau/json/package-summary.html#Overview'>JSON support
overview</a></p>
@@ -4023,6 +4017,17 @@
<a id="juneau-marshall.XmlDetails"></a>
<h3 class='topic' onclick='toggle(this)'>2.17 - XML Details</h3>
<div class='topic'>
+ <p>
+ Juneau supports converting arbitrary POJOs to and from
XML using ultra-efficient serializers and parsers.
+ <br>The XML serializer converts POJOs directly to XML
without the need for intermediate DOM objects.
+ <br>Likewise, the XML parser uses a STaX parser and
creates POJOs directly without intermediate DOM objects.
+ </p>
+ <p>
+ Unlike frameworks such as JAXB, Juneau does not require
POJO classes to be annotated to produce and consume
+ XML.
+ <br>However, several XML annotations are provided for
handling namespaces and fine-tuning the format of the XML produced.
+ </p>
+
<h5 class='toc'>Additional Information -
org.apache.juneau.xml</h5>
<ol class='toc'>
<li><p><a class='doclink'
href='org/apache/juneau/xml/package-summary.html#Overview'>XML support
overview</a></p>
@@ -4141,6 +4146,20 @@
<a id="juneau-marshall.UonDetails"></a>
<h3 class='topic' onclick='toggle(this)'>2.19 - UON Details</h3>
<div class='topic'>
+
+ <p>
+ Juneau supports converting arbitrary POJOs to and from
UON strings using ultra-efficient serializers
+ and parsers.
+ <br>The serializer converts POJOs directly to UON
strings without the need for intermediate DOM objects
+ using a highly-efficient state machine.
+ <br>Likewise, the parser creates POJOs directly from
UON strings without the need for intermediate DOM
+ objects.
+ </p>
+ <p>
+ Juneau uses UON (URL-Encoded Object Notation) for
representing POJOs.
+ The UON specification can be found <a
href='doc-files/rfc_uon.txt'>here</a>.
+ </p>
+
<h5 class='toc'>Additional Information -
org.apache.juneau.uon</h5>
<ol class='toc'>
<li><p><a class='doclink'
href='org/apache/juneau/uon/package-summary.html#Overview'>UON support
overview</a></p>
@@ -4180,6 +4199,19 @@
<a id="juneau-marshall.UrlEncodingDetails"></a>
<h3 class='topic' onclick='toggle(this)'>2.20 - URL-Encoding
Details</h3>
<div class='topic'>
+ <p>
+ Juneau supports converting arbitrary POJOs to and from
URL-encoded strings using ultra-efficient serializers
+ and parsers.
+ <br>The serializer converts POJOs directly to
URL-encoded strings without the need for intermediate DOM objects
+ using a highly-efficient state machine.
+ <br>Likewise, the parser creates POJOs directly from
URL-encoded strings without the need for intermediate DOM
+ objects.
+ </p>
+ <p>
+ Juneau uses UON (URL-Encoded Object Notation) for
representing POJOs.
+ The UON specification can be found <a
href='doc-files/rfc_uon.txt'>here</a>.
+ </p>
+
<h5 class='toc'>Additional Information -
org.apache.juneau.urlencoding</h5>
<ol class='toc'>
<li><p><a class='doclink'
href='org/apache/juneau/urlencoding/package-summary.html#Overview'>URL encoding
support overview</a></p>
@@ -4295,6 +4327,17 @@
<a id="juneau-marshall-rdf.RdfDetails"></a>
<h3 class='topic' onclick='toggle(this)'>3.1 - RDF Details</h3>
<div class='topic'>
+ <p>
+ Juneau supports serializing and parsing arbitrary POJOs
to and from the following RDF formats:
+ </p>
+ <ul>
+ <li>RDF/XML
+ <li>Abbreviated RDF/XML
+ <li>N-Triple
+ <li>Turtle
+ <li>N3
+ </ul>
+
<h5 class='toc'>Additional Information -
org.apache.juneau.jena</h5>
<ol class='toc'>
<li><p><a class='doclink'
href='org/apache/juneau/jena/package-summary.html#RdfOverview'>RDF support
overview</a></p>
--
To stop receiving notification emails like this one, please contact
[email protected].
