You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@juneau.apache.org by ja...@apache.org on 2018/12/19 23:20:14 UTC
[juneau-website] branch asf-site updated: 8.0.0 website preview
This is an automated email from the ASF dual-hosted git repository.
jamesbognar pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/juneau-website.git
The following commit(s) were added to refs/heads/asf-site by this push:
new edca08d 8.0.0 website preview
edca08d is described below
commit edca08d1363cc0abd9bd38f4045ffd4d60c8320e
Author: JamesBognar <ja...@apache.org>
AuthorDate: Wed Dec 19 18:20:03 2018 -0500
8.0.0 website preview
---
content/8.0.0/community.html | 2 +-
content/8.0.0/config.html | 5 ++---
content/8.0.0/examples.html | 4 ++--
content/8.0.0/index.html | 1 +
content/8.0.0/marshall.html | 2 +-
content/8.0.0/rest-client.html | 6 +++---
content/8.0.0/rest-server.html | 27 ++++++---------------------
content/8.0.0/svl.html | 2 +-
8 files changed, 17 insertions(+), 32 deletions(-)
diff --git a/content/8.0.0/community.html b/content/8.0.0/community.html
index 0822856..5c1fd30 100644
--- a/content/8.0.0/community.html
+++ b/content/8.0.0/community.html
@@ -45,7 +45,7 @@
<p>
To become a contributor, we recommend joining and contributing code changes through the mailing list.
Once you're contributing and your work is good, one of our team may invite you to be a committer. After that, the team will call for a vote.
- When that happens, if you accept, the following process kicks into place...
+ When that happens, if you accept, the following process kicks into place:
</p>
<ul class='spaced-list'>
<li>Download and print the Apache Contributor License Agreement from the <a class='doclink' href='http://www.apache.org/dev/new-committers-guide.html' target='_top'>New committers guide</a>.
diff --git a/content/8.0.0/config.html b/content/8.0.0/config.html
index fdfe39b..6c35f5c 100644
--- a/content/8.0.0/config.html
+++ b/content/8.0.0/config.html
@@ -46,7 +46,7 @@
</p>
<p>
- The <code>juneau-config</code> module defines an API allows you to interact with INI files using POJOs.
+ The <code>juneau-config</code> module defines an API allows you to interact with INI-style configuration files using POJOs.
It builds upon the marshalling and SVL APIs to provide sophisticated dynamic configuration files.
<p>
<p class='bcode w800'>
@@ -95,8 +95,7 @@
<ck>aBean2</ck> = <cv>{foo:'$ARG{0}',baz:$C{MySection/anInt}}</cv>
</p>
<p>
- You're probably wondering "why INI files?"
- The beauty of these INI files is that they're easy to read and modify, yet sophisticated enough to allow you to
+ The beauty of these files is that they're easy to read and modify, yet sophisticated enough to allow you to
store arbitrary-complex data structures and retrieve them as simple values or complex POJOs:
</p>
<p class='bcode w800'>
diff --git a/content/8.0.0/examples.html b/content/8.0.0/examples.html
index 52973a4..d5eec56 100644
--- a/content/8.0.0/examples.html
+++ b/content/8.0.0/examples.html
@@ -63,7 +63,7 @@
</p>
<p class='bcode w800'>
- http://localhost:10000
+ http://localhost:10000
</p>
<img class='bordered w800' src='images/juneau-examples-rest.RootResources.1.png'>
@@ -109,7 +109,7 @@
</p>
<p>
- The <code>juneau-examples-rest-springboot</code> class contains the same examples as <code>juneau-examples-rest</code>
+ The <code>juneau-examples-rest-springboot</code> library contains the same examples as <code>juneau-examples-rest</code>
but also includes the following:
</p>
<ul class='spaced-list'>
diff --git a/content/8.0.0/index.html b/content/8.0.0/index.html
index 31f18cf..87c9fba 100644
--- a/content/8.0.0/index.html
+++ b/content/8.0.0/index.html
@@ -82,6 +82,7 @@
font-size: 1.0em;
text-transform: uppercase;
font-weight: lighter;
+ min-width: 115px;
}
nav ul { list-style-type: none; padding: 0; }
nav ul li { padding: 5px 0px; }
diff --git a/content/8.0.0/marshall.html b/content/8.0.0/marshall.html
index c81f86a..9f4a3a5 100644
--- a/content/8.0.0/marshall.html
+++ b/content/8.0.0/marshall.html
@@ -366,7 +366,7 @@
<hr>
<p>
- Lots of shortcuts are provided throughout the API to simplify tasks, and the APIs are often useful for debugging and logging purposes as well...
+ Lots of shortcuts are provided throughout the API to simplify tasks, and the APIs are often useful for debugging and logging purposes as well:
</p>
<p class='bcode w800'>
<jc>// Create JSON strings from scratch using fluent-style code.</jc>
diff --git a/content/8.0.0/rest-client.html b/content/8.0.0/rest-client.html
index 987ea56..4d73fb7 100644
--- a/content/8.0.0/rest-client.html
+++ b/content/8.0.0/rest-client.html
@@ -100,7 +100,7 @@
This is an extremely powerful feature that allows you to quickly define easy-to-use interfaces against virtually any REST interface.
</p>
<p>
- Similar in concept to remoteable services defined above, but in this case we simply define our interface with
+ Similar in concept to restRPC services defined above, but in this case we simply define our interface with
special annotations that tell us how to convert input and output to HTTP headers, query parameters, form post parameters, or request/response bodies.
</p>
<h5 class='figure'>Example:</h5>
@@ -189,7 +189,7 @@
title=<js>"Petstore application"</js>,
...
)
- <jk>public class</jk> PetStoreResource <jk>extends</jk> BasicRestServletJena <jk>implements</jk> PetStore {
+ <jk>public class</jk> PetStoreResource <jk>extends</jk> BasicRestServlet <jk>implements</jk> PetStore {
...
@@ -225,7 +225,7 @@
<jk>for</jk> (Pet x : ps.getPets()) {
ps.deletePet(<js>"my-special-key"</js>, x.getId());
- System.<jsf>err</jsf>.println(<js>"Deleted pet: id="</js> + x.getId());
+ System.<jsf>out</jsf>.println(<js>"Deleted pet: id="</js> + x.getId());
}
}
</p>
diff --git a/content/8.0.0/rest-server.html b/content/8.0.0/rest-server.html
index cf37b90..848c9c2 100644
--- a/content/8.0.0/rest-server.html
+++ b/content/8.0.0/rest-server.html
@@ -81,12 +81,12 @@
}
<ja>@RestMethod</ja>(name=<jsf>GET</jsf>, path=<js>"/{propertyName}"</js>)
- <jk>public</jk> String getSystemProperty(<ja>@Path</ja> String propertyName) <jk>throws</jk> Throwable {
+ <jk>public</jk> String getSystemProperty(<ja>@Path</ja>(<js>"propertyName"</js>) String propertyName) <jk>throws</jk> Throwable {
<jk>return</jk> System.<jsm>getProperty</jsm>(propertyName);
}
<ja>@RestMethod</ja>(name=<jsf>PUT</jsf>, path=<js>"/{propertyName}"</js>, guards=AdminGuard.<jk>class</jk>)
- <jk>public</jk> String setSystemProperty(<ja>@Path</ja> String propertyName, <ja>@Body</ja> String value) {
+ <jk>public</jk> String setSystemProperty(<ja>@Path</ja>(<js>"propertyName"</js>) String propertyName, <ja>@Body</ja> String value) {
System.<jsm>setProperty</jsm>(propertyName, value);
<jk>return</jk> <js>"OK"</js>;
}
@@ -98,7 +98,7 @@
}
<ja>@RestMethod</ja>(name=<jsf>DELETE</jsf>, path=<js>"/{propertyName}"</js>, guards=AdminGuard.<jk>class</jk>)
- <jk>public</jk> String deleteSystemProperty(<ja>@Path</ja> String propertyName) {
+ <jk>public</jk> String deleteSystemProperty(<ja>@Path</ja>(<js>"propertyName"</js>) String propertyName) {
System.<jsm>clearProperty</jsm>(propertyName);
<jk>return</jk> <js>"OK"</js>;
}
@@ -330,6 +330,9 @@
<p>
Swagger UI is auto-generated and self-hosted through OPTIONS requests:
</p>
+ <p class='bcode w900'>
+ http://localhost:10000/petstore?method=OPTIONS
+ </p>
<img class='bordered w900' src='images/juneau-examples-rest.PetStoreResource.9a.png'>
<br>
<img class='bordered w900' src='images/juneau-examples-rest.PetStoreResource.9h.png'>
@@ -438,25 +441,7 @@
<p>
The <code>juneau-rest-server-jaxrs</code> module defines predefined <code>MessageBodyReader</code> and
<code>MessageBodyWriter</code> implementations for using Juneau serializers and parsers in JAX-RS environments.
- It consists of the following classes:
</p>
- <ul class='spaced-list'>
- <li>
- <code>org.apache.juneau.rest.jaxrs.BaseProvider</code> - The base provider class that implements the JAX-RS
- <code>MessageBodyReader</code> and <code>MessageBodyWriter</code> interfaces.
- <li>
- <code>org.apache.juneau.rest.jaxrs.JuneauProvider</code> - Annotation that is applied to subclasses of <code>BaseProvider</code>
- to specify the serializers/parsers associated with a provider, and optionally filters and properties to
- apply to those serializers and parsers.
- <li>
- <code>org.apache.juneau.rest.jaxrs.DefaultProvider</code> - A default provider that provides the same level
- of media type support as the <code>BasicRestServlet</code> class.
- </ul>
- <p>
- The JAX/RS support does provide you will the full marshalling capabilities of Juneau.
- However, it should be noted that you lose some sophisticated functionality by not using the REST servlet
- API (such as the Developer Interfaces, guards, path matchers, localization, auto-generated Swagger docs, etc...).
- </p>
<h5 class='section'>More Information:</h5>
<ul class='doctree'>
diff --git a/content/8.0.0/svl.html b/content/8.0.0/svl.html
index 19b1005..b68b125 100644
--- a/content/8.0.0/svl.html
+++ b/content/8.0.0/svl.html
@@ -59,7 +59,7 @@
String myProperty = VarResolver.<jsf>DEFAULT</jsf>.resolve(<js>"The Java home directory is $S{java.home}"</js>);
</p>
<p>
- The following shows how variables can be arbitrarily nested...
+ The following shows how variables can be arbitrarily nested:
</p>
<p class='bcode w800'>
<jc>// Look up a property in the following order: