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 2017/08/07 20:20:31 UTC
incubator-juneau-website git commit: Update to reflect recent changes
to Microservice API.
Repository: incubator-juneau-website
Updated Branches:
refs/heads/asf-site 12d94039b -> 58c75a058
Update to reflect recent changes to Microservice API.
Project: http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/commit/58c75a05
Tree: http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/tree/58c75a05
Diff: http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/diff/58c75a05
Branch: refs/heads/asf-site
Commit: 58c75a0587b395ac16a70dc9f6c803718f73cc1c
Parents: 12d9403
Author: JamesBognar <ja...@apache.org>
Authored: Mon Aug 7 16:20:28 2017 -0400
Committer: JamesBognar <ja...@apache.org>
Committed: Mon Aug 7 16:20:28 2017 -0400
----------------------------------------------------------------------
content/about.html | 79 ++++++++++---------------------------------------
1 file changed, 15 insertions(+), 64 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-juneau-website/blob/58c75a05/content/about.html
----------------------------------------------------------------------
diff --git a/content/about.html b/content/about.html
index b754b5b..724bb16 100644
--- a/content/about.html
+++ b/content/about.html
@@ -12,12 +12,13 @@
A single cohesive framework consisting of the following parts:
</p>
<ul class='spaced-list'>
- <li>A toolkit for marshalling POJOs to a variety of content types using a common framework.
- <li>A REST server API for creating Swagger-based self-documenting REST interfaces using POJOs.
- <li>A REST client API for interacting with REST interfaces using POJOs.
- <li>A REST client interface proxy API that allows you to quickly create Java interfaces against virtually any 3rd-party REST interface.
+ <li>A universal toolkit for marshalling POJOs to a wide variety of content types using a common framework.
+ <li>A universal REST server API for creating Swagger-based self-documenting REST interfaces using POJOs, simply deployed as
+ one or more top-level servlets in any Servlet 3.1.0+ container.
+ <li>A universal REST client API for interacting with Juneau or 3rd-party REST interfaces using POJOs and proxy interfaces.
<li>A sophisticated configuration file API.
- <li>A REST microservice API that combines all the features above for creating lightweight standalone REST interfaces that start up in milliseconds.
+ <li>A REST microservice API that combines all the features above with a simple configurable Jetty server for
+ creating lightweight standalone REST interfaces that start up in milliseconds.
</ul>
<p>
Questions via email to <a class='doclink' href='mailto:dev@juneau.apache.org?Subject=Apache%20Juneau%20question'>dev@juneau.apache.org</a> are always welcome.
@@ -67,9 +68,9 @@
<ul class='spaced-list'>
<li>The serializers and parsers require nothing more than Java 6+.
<li>The RDF serializers and parsers require Apache Jena 2.5.1+.
- <li>The REST server API requires any Servlet 2.4+ container.
+ <li>The REST server API requires any Servlet 3.1.0+ container.
<li>The REST client API requires Apache HttpClient 4.5+.
- <li>The REST microservice API requires Eclipse Jetty 8.1+.
+ <li>The REST microservice API uses Eclipse Jetty 9.4.3.
</ul>
<h5 class='toc'>Components</h5>
@@ -1368,10 +1369,11 @@
<h5 class='toc'>Juneau Microservice</h5>
<p>
The microservice API combines all the features above with a built-in Jetty server to produce a lightweight
- REST service packaged as two simple files:
+ REST service packaged as three simple files:
</p>
<ul>
<li>An executable jar file that starts up a REST interface in milliseconds.
+ <li>A configurable <code>jetty.xml</code> file.
<li>An external INI file that can be used to configure your REST resources on the fly.
</ul>
<p>
@@ -1381,7 +1383,9 @@
REST microservices can also be started programmatically in existing code:
</p>
<p class='bcode'>
- RestMicroservice myRestService = <jk>new</jk> RestMicroservice().setConfig(<js>"microservice.cfg"</js>, <jk>false</jk>);
+ RestMicroservice myRestService = <jk>new</jk> RestMicroservice()
+ .setConfig(<js>"microservice.cfg"</js>, <jk>false</jk>)
+ .setJettyXml(<js>"my-jetty.xml"</js>);
myRestService.start();
URI uri = myRestService.getURI();
</p>
@@ -1399,47 +1403,9 @@
#================================================================================</cc>
<cs>[REST]</cs>
- <cc># The HTTP port number to use.
- # Can be a comma-delimited list of ports to try.
- # 0 means try a random port.
- # Default is Rest-Port setting in manifest file, or 8000.
- # In this case, try port 10000, then try 3 random ports.</cc>
- <ck>port</ck> = <cv>[10000, 0, 0, 0]</cv>
-
- <cc># A JSON map of servlet paths to servlet classes.
- # Example:
- # resourceMap = {'/*':'com.foo.MyServlet'}
- # Either resourceMap or resources must be specified.</cc>
- <ck>resourceMap</ck> =
+ <cc># The location of the jetty.xml file to use for configuring Jetty.</cc>
+ <ck>jettyXml</ck> = <cv>jetty.xml</cv>
- <cc># A comma-delimited list of names of classes that extend from Servlet.
- # Resource paths are pulled from @RestResource.path() annotation, or
- # "/*" if annotation not specified.
- # Example:
- # resources = com.foo.MyServlet
- # Default is Rest-Resources in manifest file.
- # Either resourceMap or resources must be specified.</cc>
- <ck>resources</ck> =
-
- <cc># The context root of the Jetty server.
- # Default is Rest-ContextPath in manifest file, or "/".</cc>
- <ck>contextPath</ck> =
-
- <cc># Authentication: NONE, BASIC.</cc>
- <ck>authType</ck> = <cv>NONE</cv>
-
- <cc># The BASIC auth username.
- # Default is Rest-LoginUser in manifest file.</cc>
- <ck>loginUser</ck> =
-
- <cc># The BASIC auth password.
- # Default is Rest-LoginPassword in manifest file.</cc>
- <ck>loginPassword</ck> =
-
- <cc># The BASIC auth realm.
- # Default is Rest-AuthRealm in manifest file.</cc>
- <ck>authRealm</ck> =
-
<cc># Stylesheet to use for HTML views.
# The default options are:
# - styles/juneau.css
@@ -1455,21 +1421,6 @@
# RESTART_SERVICE - Shutdown and exit with code '3'.</cc>
<ck>saveConfigAction</ck> = <cv>RESTART_SERVER</cv>
- <cc># Enable SSL support.</cc>
- <ck>useSsl</ck> = <cv>true</cv>
-
- <cc>#================================================================================
- # Bean properties on the org.eclipse.jetty.util.ssl.SslSocketFactory class
- #--------------------------------------------------------------------------------
- # Ignored if REST/useSsl is false.
- #================================================================================</cc>
- <cs>[REST-SslContextFactory]</cs>
- <ck>keyStorePath</ck> = <cv>client_keystore.jks</cv>
- <ck>keyStorePassword*</ck> = <cv>{HRAaRQoT}</cv>
- <ck>excludeCipherSuites</ck> = <cv>TLS_DHE.*, TLS_EDH.*</cv>
- <ck>excludeProtocols</ck> = <cv>SSLv3</cv>
- <ck>allowRenegotiate</ck> = <cv>false</cv>
-
<cc>#================================================================================
# Logger settings
# See FileHandler Java class for details.