juneau-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jamesbog...@apache.org
Subject [juneau] branch master updated: Update Javadocs.
Date Mon, 05 Mar 2018 18:48:49 GMT
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 <jamesbognar@apache.org>
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
jamesbognar@apache.org.

Mime
View raw message