subject:"\[juneau\] branch master updated\: Javadoc updates."

[juneau] branch master updated: Javadoc updates.

2019-09-06 Thread jamesbognar

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 b5a6b8b  Javadoc updates.
b5a6b8b is described below

commit b5a6b8bf35cc839e71b47b443612b2505d0f63b3
Author: JamesBognar 
AuthorDate: Fri Sep 6 17:54:28 2019 -0400

Javadoc updates.
---
 juneau-doc/docs/ReleaseNotes/8.1.1.html|  7 ---
 juneau-doc/docs/Topics/01.Introduction/01.Features.html|  2 +-
 .../06.ConfigurableProperties/02.CommonSerializer.html |  2 +-
 .../02.juneau-marshall/07.ConfigurableAnnotations.html |  2 +-
 .../02.juneau-marshall/11.Transforms/01.PojoSwaps.html |  2 +-
 .../02.juneau-marshall/11.Transforms/03.AutoPojoSwaps.html |  2 +-
 .../11.Transforms/04.PerMediaTypePojoSwaps.html|  2 +-
 .../11.Transforms/10.BeanPropertyAnnotation.html   |  2 +-
 .../11.Transforms/11.BeanConstructorAnnotation.html|  2 +-
 juneau-doc/docs/Topics/05.juneau-svl/02.SvlVariables.html  |  2 +-
 .../docs/Topics/05.juneau-svl/04.DefaultVarResolver.html   |  2 +-
 juneau-doc/docs/Topics/06.juneau-config/11.Imports.html|  2 +-
 .../Topics/06.juneau-config/15.SystemDefaultConfig.html|  2 +-
 .../Topics/07.juneau-rest-server/02.ClassHierarchy.html|  2 +-
 .../03.Instantiation/02.BasicRestServlet.html  |  2 +-
 .../03.Instantiation/03.BasicRest.html |  2 +-
 .../03.Instantiation/05.BasicRestServletGroup.html |  2 +-
 .../03.Instantiation/06.BasicRestGroup.html|  2 +-
 .../04.RestResource/02.RestResourcePath.html   |  2 +-
 .../06.RestMethod/06.RequestAttributes.html|  2 +-
 .../10.HttpPartAnnotations/01.Body.html|  2 +-
 .../10.HttpPartAnnotations/02.FormData.html|  2 +-
 .../07.juneau-rest-server/15.ConfigurableProperties.html   |  2 +-
 .../07.juneau-rest-server/16.ConfigurableAnnotations.html  |  2 +-
 .../docs/Topics/07.juneau-rest-server/17.Transforms.html   |  2 +-
 .../docs/Topics/07.juneau-rest-server/20.RoleGuards.html   |  2 +-
 .../29.Swagger/01.BasicRestServlet.html|  2 +-
 .../29.Swagger/06.ParameterExamples.html   |  2 +-
 .../Topics/07.juneau-rest-server/30.HtmlDocAnnotation.html |  2 +-
 .../30.HtmlDocAnnotation/05.Stylesheets.html   |  2 +-
 .../07.juneau-rest-server/32.LoggingAndDebugging.html  |  2 +-
 .../32.LoggingAndErrorHandling/01.LOG4J.html   |  2 +-
 .../02.ChildResources.html |  2 +-
 .../docs/Topics/10.juneau-rest-client/01.RestProxies.html  |  6 +++---
 .../01.RestProxies/01.RemoteResource.html  |  8 
 .../01.RestProxies/02.RemoteMethod.html| 14 +++---
 juneau-doc/docs/Topics/11.juneau-rest-mock.html|  4 ++--
 .../docs/Topics/11.juneau-rest-mock/01.MockRest.html   |  2 +-
 .../Topics/11.juneau-rest-mock/02.MockRemoteResource.html  |  4 ++--
 .../Topics/17.juneau-examples-rest/01.RootResources.html   |  2 +-
 .../Topics/17.juneau-examples-rest/04.DtoExamples.html |  2 +-
 .../rest/client/{remote => }/BodyAnnotationTest.java   |  0
 .../rest/client/{remote => }/EndToEndInterfaceTest.java|  0
 .../rest/client/{remote => }/FormDataAnnotationTest.java   |  0
 .../rest/client/{remote => }/HeaderAnnotationTest.java |  0
 .../rest/client/{remote => }/PathAnnotationTest.java   |  0
 .../rest/client/{remote => }/QueryAnnotationTest.java  |  0
 .../client/{remote => }/RemoteMethodAnnotationTest.java|  0
 .../client/{remote => }/RemoteResourceAnnotationTest.java  |  0
 .../rest/client/{remote => }/RequestAnnotationTest.java|  0
 .../rest/client/{remote => }/ResponseAnnotationTest.java   |  0
 51 files changed, 57 insertions(+), 56 deletions(-)

diff --git a/juneau-doc/docs/ReleaseNotes/8.1.1.html 
b/juneau-doc/docs/ReleaseNotes/8.1.1.html
index 2e9bbcf..fd78f42 100644
--- a/juneau-doc/docs/ReleaseNotes/8.1.1.html
+++ b/juneau-doc/docs/ReleaseNotes/8.1.1.html
@@ -27,13 +27,14 @@
Fixed a bug in the parsers where the generic subtype of a 
complex bean property type involving both collections and arrays
was not being found.  (e.g. ListLong[])

-   New packages of HTTP response/exceptions beans moved from 
juneau-rest-server bundle so that they can be 
-   used when building REST proxy interfaces without having to pull 
in the server bundle.
+   New packages of HTTP response/exceptions beans from 
juneau-rest-server bundle and REST proxy annotations from 
juneau-rest-client 
+   so that they can be used when building REST proxy interfaces 
while only pulling in the marshall bundle.

{@link oaj.http.response}

[juneau] branch master updated: Javadoc updates.

2018-03-05 Thread jamesbognar

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 58d8c06  Javadoc updates.
58d8c06 is described below

commit 58d8c06aee8d1502a5e6e10665a352ec07ead2a7
Author: JamesBognar 
AuthorDate: Mon Mar 5 13:30:17 2018 -0500

Javadoc updates.
---
 .../main/java/org/apache/juneau/jena/package.html  | 164 ---
 .../main/java/org/apache/juneau/json/package.html  | 143 
 .../main/java/org/apache/juneau/uon/package.html   | 180 
 .../org/apache/juneau/urlencoding/package.html | 182 -
 .../main/java/org/apache/juneau/xml/package.html   | 146 -
 juneau-doc/src/main/javadoc/overview.html  |  46 +-
 6 files changed, 3 insertions(+), 858 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 281451c..426d991 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
@@ -65,18 +65,10 @@

Namespaces
URI 
properties
-   Collections
Root 
property
Typed 
literals
-   Configurable properties
-   Other 
notes
   
RdfParser class 
-   
-   Configurable properties
-   Other 
notes
-  
-
 
 
 
@@ -469,101 +461,6 @@



-   
-   2.4 - Collections
-   
-   
-   Collections and arrays are converted to RDF sequences.
-   In our example, let's add a list-of-beans property 
to our sample class:
-   
-   
-   public class Person {
-   
-   // Bean properties
-   public LinkedListAddress addresses = 
new LinkedListAddress();
-   ...
-   }
-   
-   
-   The Address class has the following 
properties defined:
-   
-   
-   @Rdf(prefix="addr")
-   public class Address {
-
-   // Bean properties
-   @Rdf(beanUri=true) public URI 
uri;
-   public URI personUri;
-   
-   public int id;
-   
-   @Rdf(prefix="mail") 
-   public String street, city, 
state;
-   
-   @Rdf(prefix="mail") 
-   public int zip;
-   
-   public boolean isCurrent;
-   }
-   
-   
-   Next, add some quick-and-dirty code to add an address 
to our person bean:
-   
-   
-   // Create a new serializer (revert back to namespace 
autodetection).
-   RdfSerializer s = 
RdfSerializer.create().xmlabbrev().set(RdfProperties.RDF_rdfxml_tab,
 3).build();
-
-   // Create our bean.
-   Person p = new Person(1, "John Smith", 
"http://sample/addressBook/person/1;, 
-   "http://sample/addressBook;, "Aug 12, 1946");
-   Address a = new Address();
-   a.uri = new 
URI("http://sample/addressBook/address/1;);
-   a.personUri = new 
URI("http://sample/addressBook/person/1;);
-   a.id = 1;
-   a.street = "100 Main Street";
-   a.city = "Anywhereville";
-   a.state = "NY";
-   a.zip = 12345;
-   a.isCurrent = true;
-   p.addresses.add(a);
-   
-   
-   Now when we run the sample code, we get the following:
-   
-   
-   rdf:RDF
-   
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#;
-   xmlns:j="http://www.apache.org/juneau/;
-   xmlns:jp="http://www.apache.org/juneaubp/;
-   xmlns:per="http://www.apache.org/person/;
-   xmlns:mail="http://www.apache.org/mail/;
-   
xmlns:addr="http://www.apache.org/address/;
-  rdf:Description 
rdf:about="http://sample/addressBook/person/1;
- per:addressBookUri 
rdf:resource="http://sample/addressBook;/
- per:id1/per:id
- per:nameJohn Smith/per:name
- per:addresses
-rdf:Seq
-   rdf:li
-  rdf:Description 
rdf:about="http://sample/addressBook/address/1;
- addr:personUri 
rdf:resource="http://sample/addressBook/person/1;/
- addr:id1/addr:id
- mail:street100 Main 
Street/mail:street
- 
mail:cityAnywhereville/mail:city
-

[juneau] branch master updated: Javadoc updates.

2018-03-05 Thread jamesbognar

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 8fef5f5  Javadoc updates.
8fef5f5 is described below

commit 8fef5f55fc7673bff907ee22b172d4be02807b4e
Author: JamesBognar 
AuthorDate: Mon Mar 5 13:14:32 2018 -0500

Javadoc updates.
---
 .../main/java/org/apache/juneau/jena/package.html  | 209 
 .../main/java/org/apache/juneau/json/package.html  | 291 ---
 .../main/java/org/apache/juneau/uon/package.html   | 282 ---
 .../org/apache/juneau/urlencoding/package.html | 282 ---
 .../main/java/org/apache/juneau/xml/package.html   | 202 
 juneau-doc/src/main/javadoc/overview.html  | 563 -
 6 files changed, 537 insertions(+), 1292 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 e50b908..281451c 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
@@ -65,17 +65,14 @@

Namespaces
URI 
properties
-   @Bean and 
@BeanProperty annotations
Collections
Root 
property
Typed 
literals
-   Non-tree models and 
recursion detection
Configurable properties
Other 
notes
   
RdfParser class 

-   Parsing into 
generic POJO models
Configurable properties
Other 
notes
   
@@ -470,78 +467,6 @@



-   
-   
-   2.3 - @Bean and @BeanProperty 
annotations
-   
-   
-   The {@link org.apache.juneau.annotation.Bean @Bean} and 
{@link org.apache.juneau.annotation.BeanProperty @BeanProperty} 
-   annotations are used to customize the behavior of beans 
across the entire framework.
-   In addition to using them to identify the resource 
URI for the bean shown above, they have various other 
-   uses:
-   
-   
-   
-   Hiding bean properties.
-   
-   Specifying the ordering of bean properties.
-   
-   Overriding the names of bean properties.
-   
-   Associating transforms at both the class and 
property level (to convert non-serializable POJOs to 
-   serializable forms).
-   
-   
-   For example, we now add a birthDate 
property, and associate a swap with it to transform
-   it to an ISO8601 date-time string in GMT time.
-   By default, Calendars are treated as 
beans by the framework, which is usually not how you want 
-   them serialized.
-   Using swaps, we can convert them to standardized 
string forms.
-   
-  
-   public class Person {
-   
-   // Bean properties
-   
@BeanProperty(swap=CalendarSwap.ISO8601DTZ.class) 
public Calendar birthDate;
-   ...
-   
-   // Normal constructor
-   public Person(int id, String name, String 
uri, String addressBookUri, String birthDate) 
-   throws Exception {
-   ...
-   this.birthDate = new 
GregorianCalendar();
-   this.birthDate.setTime(
-   
DateFormat.getDateInstance(DateFormat.MEDIUM).parse(birthDate));
-   }
-   }
-   
-   
-   And we alter our code to pass in the birthdate.
-   
-   
-   // Create our bean.
-   Person p = new Person(1, "John Smith", 
"http://sample/addressBook/person/1;, 
-   "http://sample/addressBook;, "Aug 12, 1946");
-   
-   
-   Now when we rerun the sample code, we'll get the 
following:
-   
-   
-   rdf:RDF
-   
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#;
-   xmlns:j="http://www.apache.org/juneau/;
-   xmlns:jp="http://www.apache.org/juneaubp/;
-   
xmlns:per="http://www.apache.org/person/;
-  rdf:Description 
rdf:about="http://sample/addressBook/person/1;
- per:addressBookUri

[juneau] branch master updated: Javadoc updates.

2018-03-05 Thread jamesbognar

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 d88e711  Javadoc updates.
d88e711 is described below

commit d88e711599335b062ef38c39e3575ef06ff72251
Author: JamesBognar 
AuthorDate: Mon Mar 5 10:57:33 2018 -0500

Javadoc updates.
---
 juneau-doc/src/main/javadoc/overview.html | 316 +++---
 1 file changed, 156 insertions(+), 160 deletions(-)

diff --git a/juneau-doc/src/main/javadoc/overview.html 
b/juneau-doc/src/main/javadoc/overview.html
index 27e24f1..e89e16a 100644
--- a/juneau-doc/src/main/javadoc/overview.html
+++ b/juneau-doc/src/main/javadoc/overview.html
@@ -106,7 +106,7 @@
POJO Builders
URIs
BeanFilters
-   Interface filters
+   Interface Filters
Stop Classes
Bypass Serialization using Readers 
and InputStreams

@@ -119,16 +119,16 @@
Comparison with Jackson
POJO Categories
Best Practices
-   Additional Information
-   
-   JSON
-   XML
-   HTML
-   UON
-   URL-Encoding
-   
+   JSON Details
+   XML Details
+   HTML Details
+   UON Details
+   URL-Encoding Details

juneau-marshall-rdf
+   
+   RDF Details
+   
juneau-dto

HTML5
@@ -3656,145 +3656,135 @@

 

-   
-   2.14 - Additional 
Information
+   
+   2.14 - JSON Details

-   
-   Extensive javadocs exist for individual language 
support.
-   Refer to these docs for language-specific information.
-   
+   Additional Information - 
org.apache.juneau.json
+   
+   JSON support 
overview 
+   
+   Example
+   
+   JsonSerializer
 class 
+   
+   @Bean and 
@BeanProperty annotations
+   Collections
+   JSON-Schema
 support
+Non-tree models 
and recursion detection
+   Configurable
 properties
+   Other 
notes
+   
+   JsonParser 
class 
+   
+   Parsing into 
generic POJO models
+   Configurable
 properties
+   Other 
notes
+   
+   
+   
 
-   
-   
-   2.13.1 - JSON
-   
-   Additional Information - 
org.apache.juneau.json
-   
-   JSON support 
overview 
-   
-   Example
-   
-   JsonSerializer
 class 
+   
+   
+   2.15 - XML Details
+   
+   Additional Information - 
org.apache.juneau.xml
+   
+   XML support 
overview 
+   
+   XML support 
overview - example
+   
+   XmlSerializer 
class 
+   
+   XML support 
methodology
+   @Xml 
annotations

-   @Bean and 
@BeanProperty annotations
-   Collections
-   JSON-Schema
 support
-Non-tree models 
and recursion detection
-   Configurable
 properties
-   Other 
notes
+   @Bean.typeName()
+   @Xml.childName()
+   @Xml.format()

-   JsonParser 
class 
+   Namespaces

-   Parsing into 
generic POJO models
-   Configurable
 properties
-   Other 
notes
+   Auto-detection
 of namespaces

[juneau] branch master updated: Javadoc updates.

2018-02-27 Thread jamesbognar

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 252f29a  Javadoc updates.
252f29a is described below

commit 252f29acfa1426cc52680eab241f2c8b1c5cda1b
Author: JamesBognar 
AuthorDate: Tue Feb 27 09:12:26 2018 -0500

Javadoc updates.
---
 .../main/java/org/apache/juneau/config/Config.java | 221 +--
 .../org/apache/juneau/config/ConfigBuilder.java|   8 +-
 .../apache/juneau/config/store/ConfigEntry.java|  35 +-
 .../org/apache/juneau/config/ConfigMapTest.java|   4 +-
 .../java/org/apache/juneau/config/ConfigTest.java  |  11 +-
 .../org/apache/juneau/internal/StringUtils.java|  18 +-
 juneau-doc/src/main/javadoc/overview.html  | 672 ++---
 7 files changed, 666 insertions(+), 303 deletions(-)

diff --git 
a/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/Config.java 
b/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/Config.java
index 3630319..0fbdfd4 100644
--- 
a/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/Config.java
+++ 
b/juneau-core/juneau-config/src/main/java/org/apache/juneau/config/Config.java
@@ -221,24 +221,24 @@ public final class Config extends Context implements 
ConfigEventListener, Writab
public static final String CONFIG_binaryFormat = PREFIX + 
"binaryFormat.s";
 
/**
-* Configuration property:  Beans on separate lines.
+* Configuration property:  Multi-line values should always be on 
separate lines.
 * 
 * Property:
 * 
-*  Name:  "Config.beanOnSeparateLines.b"
+*  Name:  
"Config.multiLineValuesOnSeparateLines.b"
 *  Data type:  Boolean
 *  Default:  false
 *  Methods: 
 *  
-*  {@link 
ConfigBuilder#beansOnSeparateLines()}
+*  {@link 
ConfigBuilder#multiLineValuesOnSeparateLines()}
 *  
 * 
 * 
 * Description:
 * 
-* When enabled, serialized POJOs will be placed on a separate line 
from the key.
+* When enabled, multi-line values will always be placed on a separate 
line from the key.
 */
-   public static final String CONFIG_beansOnSeparateLines = PREFIX + 
"beansOnSeparateLines.b";
+   public static final String CONFIG_multiLineValuesOnSeparateLines = 
PREFIX + "multiLineValuesOnSeparateLines.b";

/**
 * Configuration property:  Read-only.
@@ -272,7 +272,7 @@ public final class Config extends Context implements 
ConfigEventListener, Writab
private final VarResolverSession varSession;
private final int binaryLineLength;
private final String binaryFormat;
-   private final boolean beansOnSeparateLines, readOnly;
+   private final boolean multiLineValuesOnSeparateLines, readOnly;
private final ConfigMap configMap;
private final BeanSession beanSession;
private final List listeners = 
Collections.synchronizedList(new LinkedList());
@@ -321,7 +321,7 @@ public final class Config extends Context implements 
ConfigEventListener, Writab
.createSession();
binaryLineLength = getIntegerProperty(CONFIG_binaryLineLength, 
-1);
binaryFormat = getStringProperty(CONFIG_binaryFormat, 
"BASE64").toUpperCase();
-   beansOnSeparateLines = 
getBooleanProperty(CONFIG_beansOnSeparateLines, false);
+   multiLineValuesOnSeparateLines = 
getBooleanProperty(CONFIG_multiLineValuesOnSeparateLines, false);
readOnly = getBooleanProperty(CONFIG_readOnly, false);
}

@@ -337,7 +337,7 @@ public final class Config extends Context implements 
ConfigEventListener, Writab
this.varSession = varSession;
binaryLineLength = copyFrom.binaryLineLength;
binaryFormat = copyFrom.binaryFormat;
-   beansOnSeparateLines = copyFrom.beansOnSeparateLines;
+   multiLineValuesOnSeparateLines = 
copyFrom.multiLineValuesOnSeparateLines;
readOnly = copyFrom.readOnly;
beanSession = copyFrom.beanSession;
}
@@ -433,7 +433,7 @@ public final class Config extends Context implements 
ConfigEventListener, Writab
 * 
 * Equivalent to calling put(key, value, isEncoded(key)).
 * 
-* @param key The key.  See {@link #getString(String)} for a 
description of the key.
+* @param key The key.
 * @param value The new value POJO.
 * @return The previous value, or null if the section or key 
did not previously exist.
 * @throws SerializeException
@@ -448,7 +448,7 @@ public final class Config extends

[juneau] branch master updated: Javadoc updates.

2018-01-31 Thread jamesbognar

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 b3f40bb  Javadoc updates.
b3f40bb is described below

commit b3f40bbf02e82205a871b0ebe4c9d9e2018dfb49
Author: JamesBognar 
AuthorDate: Wed Jan 31 08:59:28 2018 -0800

Javadoc updates.
---
 juneau-doc/src/main/javadoc/overview.html  | 219 +++--
 .../juneau/microservice/resources/ConfigEdit.html  |   2 +-
 .../apache/juneau/rest/test/NlsResource.properties |  22 +-
 .../org/apache/juneau/rest/ReaderResource.java |   3 +-
 .../org/apache/juneau/rest/RequestHeaders.java |  15 +
 .../org/apache/juneau/rest/RequestPathMatch.java   |  82 +++-
 .../java/org/apache/juneau/rest/RestContext.java   |  62 ++-
 .../org/apache/juneau/rest/RestParamDefaults.java  |   4 +-
 .../java/org/apache/juneau/rest/RestRequest.java   | 542 +
 .../java/org/apache/juneau/rest/RestServlet.java   |  66 +--
 .../org/apache/juneau/rest/RestServletDefault.java |   4 +-
 .../juneau/rest/annotation/RestResource.java   |   6 +-
 .../org/apache/juneau/rest/vars/RequestVar.java|  16 +-
 13 files changed, 831 insertions(+), 212 deletions(-)

diff --git a/juneau-doc/src/main/javadoc/overview.html 
b/juneau-doc/src/main/javadoc/overview.html
index 95b3393..355cb3f 100644
--- a/juneau-doc/src/main/javadoc/overview.html
+++ b/juneau-doc/src/main/javadoc/overview.html
@@ -4965,14 +4965,134 @@

3.1.3.1 - 
RestServlet

-   TODO
+   
+   The {@link 
org.apache.juneau.rest.RestServlet} class is the entry point for your REST 
resources.
+   It extends directly from 
HttpServlet and is deployed like any other servlet.
+   
+   
+   When the servlet init() method 
is called, it triggers the code to find and process the @RestResource
+   annotations on that class and all child 
classes.
+   These get constructed into a {@link 
org.apache.juneau.rest.RestContext} object that holds all the configuration
+   information about your resource in a 
read-only object.
+   
+   
+   Most developers are not going to be 
using the RestServlet class itself, and instead will
+   extend from one of the preconfigured 
default servlets such as {@link org.apache.juneau.rest.RestServletDefault}.
+   The RestServlet class by 
itself is not configured with any serializers and parsers, and therefore
+   not very useful on it's own.
+   However, the class does provide a 
couple of convenience methods to be aware of:
+   
+   
+   {@link 
org.apache.juneau.rest.RestServlet}
+   
+   {@link 
org.apache.juneau.rest.RestServlet#log(Level,String,Object...) 
log(Level,String,Object...)}
+   {@link 
org.apache.juneau.rest.RestServlet#log(Level,Throwable,String,Object...) 
log(Level,Throwable,String,Object...)}
+   {@link 
org.apache.juneau.rest.RestServlet#getContext() getContext()}
+   
+   
+   
+   Since this is a servlet, you also have 
the ability to intercept calls to the init and service methods
+   in your subclass.

 


3.1.3.2 - 
RestServletDefault

-   TODO
+   
+   The {@link 
org.apache.juneau.rest.RestServletDefault} class is a subclass of {@link 
org.apache.juneau.rest.RestServlet}
+   preconfigured with the following:
+   
+   
+   A default set of serializers and 
parsers (pretty much all of them except for the RDF ones).
+   Some basic HTML boilerplate for the 
HTML representation of your POJOs.
+

[juneau] branch master updated: Javadoc updates.

2018-01-29 Thread jamesbognar

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 3c48e1c  Javadoc updates.
3c48e1c is described below

commit 3c48e1cce71cfffec19c453422be0363c87a6b67
Author: JamesBognar 
AuthorDate: Mon Jan 29 08:38:06 2018 -0500

Javadoc updates.
---
 .../src/main/java/org/apache/juneau/annotation/Builder.java|  1 -
 juneau-doc/src/main/javadoc/overview.html  | 10 --
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/annotation/Builder.java
 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/annotation/Builder.java
index a5c1fea..a3529bb 100644
--- 
a/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/annotation/Builder.java
+++ 
b/juneau-core/juneau-marshall/src/main/java/org/apache/juneau/annotation/Builder.java
@@ -23,7 +23,6 @@ import java.lang.annotation.*;
  * 
  * Example:
  * 
- * 
  * // POJO class.
  * @Builder(MyBeanBuilder.class)
  * public class MyBean {
diff --git a/juneau-doc/src/main/javadoc/overview.html 
b/juneau-doc/src/main/javadoc/overview.html
index 404ba88..b2edee3 100644
--- a/juneau-doc/src/main/javadoc/overview.html
+++ b/juneau-doc/src/main/javadoc/overview.html
@@ -2411,8 +2411,9 @@
}


-   Builders MUST be beans with one or more 
writable properties.
-   The bean properties themselves do 
not need to be readable (e.g. setters without getters).
+   The POJO class can be any type 
including beans.
+   Builders MUST be beans with one or 
more writable properties.
+   The bean properties themselves do 
not need to be readable (i.e. getters are optional).


Builders require two parts:
@@ -2454,6 +2455,11 @@
public MyPojo(MyBuilder b) {...}


+   See Also:
+   
+   {@link 
org.apache.juneau.annotation.Builder}
+   {@link 
org.apache.juneau.transform.Builder}
+   




-- 
To stop receiving notification emails like this one, please contact
jamesbog...@apache.org.

[juneau] branch master updated: Javadoc updates.

2018-01-24 Thread jamesbognar

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 b9523bb  Javadoc updates.
b9523bb is described below

commit b9523bbd6c23b6d1ab23784eb18c0bfbb93bd10b
Author: JamesBognar 
AuthorDate: Wed Jan 24 15:12:13 2018 -0500

Javadoc updates.
---
 juneau-doc/src/main/javadoc/overview.html | 457 +-
 1 file changed, 258 insertions(+), 199 deletions(-)

diff --git a/juneau-doc/src/main/javadoc/overview.html 
b/juneau-doc/src/main/javadoc/overview.html
index 7e03450..b2b577b 100644
--- a/juneau-doc/src/main/javadoc/overview.html
+++ b/juneau-doc/src/main/javadoc/overview.html
@@ -142,14 +142,74 @@

juneau-rest-server

-   Remoteable Proxies
-   Using with Spring or other Injection 
frameworks
-   Using HTTP/2 features
+   Hello World Example
+   Class Hierarchy
+   Instantiation
+   
+   Children
+   Router Pages
+   Resource Resolvers
+   Lifecycle Hooks
+   Annotation 
Inheritance
+   
+   @RestMethod Annotation
+   
+   Java Method 
Parameters
+   Method Return Types
+   @RestMethod.path()
+   @RestMethod.matchers()
+   
+   @Body
+   
+   Handling Form Posts
+   Handling Multi-Part 
Form Posts
+   
+   @FormData
+   @Query
+   @Header
+   Serializers
+   Parsers
+   Properties
+   Transforms
+   Guards
+   Converters
+   Messages
+   Encoders
+   SVL Variables
+   Configuration Files
+   Static files
+   Client Versioning
+   OPTIONS pages
+   
+   Info Providers
+   
+@HtmlDoc
+   
+   Widgets
+   UI Customization
+   Stylesheets
+   
+   Default Headers
+   Logging and Error 
Handling
+   HTTP Status Codes
+   Overloading HTTP 
Methods
+   Built-in Parameters
+   Custom Serializers 
and Parsers
+   Using with OSGi
+   Remoteable Proxies
+   
+   Remoteable Proxies - 
Client Side
+   Remoteable Proxies - 
Server Side
+   Remoteable 
Proxies - @Remoteable Annotation
+   
+   Using with Spring or other Injection 
frameworks
+   Using HTTP/2 features
+   Other Notes

-   juneau-rest-server-jaxrs
-   juneau-rest-client
+   3.2 - juneau-rest-server-jaxrs
+   3.3 - 
juneau-rest-client

-   Interface proxies against 3rd-party 
REST interfaces
+   3.3.1 - Interface proxies against 
3rd-party REST interfaces


juneau-microservice
@@ -4539,12 +4599,13 @@



-   
+   
3.1.1 - Hello World 
Example


-   A REST resource is an implementation of {@link 
org.apache.juneau.rest.RestServlet}, which itself is simply an 
-   extension of {@link 
javax.servlet.http.HttpServlet}.  
+   A REST resource is simply a Java class 
annotated with {@link org.apache.juneau.annotation.RestResource}.
+   The most common case is a class that 
extends {@link org.apache.juneau.rest.RestServlet}, which itself is simply an 
+   extension of {@link 
javax.servlet.http.HttpServlet} which allows it to be deployed as a servlet.  


In

[juneau] branch master updated: Javadoc updates.

[juneau] branch master updated: Javadoc updates.

[juneau] branch master updated: Javadoc updates.

[juneau] branch master updated: Javadoc updates.

[juneau] branch master updated: Javadoc updates.

[juneau] branch master updated: Javadoc updates.

[juneau] branch master updated: Javadoc updates.

[juneau] branch master updated: Javadoc updates.

8 matches

Site Navigation

Mail list logo

Footer information