Author: buildbot
Date: Wed Oct 31 11:09:12 2012
New Revision: 836710
Log:
Staging update by buildbot for mina
Modified:
websites/staging/mina/trunk/content/ (props changed)
websites/staging/mina/trunk/content/asyncweb/class_diagram.html
websites/staging/mina/trunk/content/asyncweb/client_ideas.html
websites/staging/mina/trunk/content/asyncweb/client_use_cases.html
websites/staging/mina/trunk/content/asyncweb/index.html
websites/staging/mina/trunk/content/asyncweb/references.html
Propchange: websites/staging/mina/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Oct 31 11:09:12 2012
@@ -1 +1 @@
-1404059
+1404091
Modified: websites/staging/mina/trunk/content/asyncweb/class_diagram.html
==============================================================================
--- websites/staging/mina/trunk/content/asyncweb/class_diagram.html (original)
+++ websites/staging/mina/trunk/content/asyncweb/class_diagram.html Wed Oct 31
11:09:12 2012
@@ -1 +1,96 @@
-asyncweb/page.html
\ No newline at end of file
+<!DOCTYPE html>
+<!--
+ 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.
+-->
+<html>
+<head>
+ <title>Class Diagram — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet"
type="text/css">
+ <link href="./../css/asyncweb.css" rel="stylesheet"
type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ Sshd
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+<h1 id="class-diagram">Class Diagram</h1>
+<h2 id="http-messages">HTTP Messages</h2>
+<p>The following class diagram represents the HttpMessage interfaces with all
the related interfaces and classes.</p>
+<p><img alt="HTTP Message"
src="../staticresources/images/asyncweb/httpmessages.png" /></p>
+<h2 id="http-server">HTTP Server</h2>
+<p>The set of classand interfaces used to create an HTTP server</p>
+<p><img alt="HTTP Server"
src="../staticresources/images/asyncweb/httpserver.png" /></p>
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a
href="http://www.apache.org";>The Apache Software Foundation</a> - <a
href="./../privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd,
Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project
logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Modified: websites/staging/mina/trunk/content/asyncweb/client_ideas.html
==============================================================================
--- websites/staging/mina/trunk/content/asyncweb/client_ideas.html (original)
+++ websites/staging/mina/trunk/content/asyncweb/client_ideas.html Wed Oct 31
11:09:12 2012
@@ -1 +1,122 @@
-asyncweb/page.html
\ No newline at end of file
+<!DOCTYPE html>
+<!--
+ 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.
+-->
+<html>
+<head>
+ <title>Client Ideas — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet"
type="text/css">
+ <link href="./../css/asyncweb.css" rel="stylesheet"
type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ Sshd
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+<h1 id="client-ideas">Client Ideas</h1>
+<ul>
+<li>Add support for connection retries (make the number of retry attempts
configurable)</li>
+<li>HttpFuture.cancel(true) could close the underlying socket connection. This
would ensure the request actually gets cancelled and is similar to the behavior
of IoFuture.cancel(true) in JSR 203.</li>
+<li>Add support to HttpFuture to be able to determine if the future timed out,
errored out, or completed successfully without having to invoke
HttpFuture.get()</li>
+<li>Create an abstract implementation of HttpListener that has callback
methods such as "onSuccess, onCancel, onError, onTimeout".</li>
+<li>Add support for HTTP auth</li>
+<li>Add support for using an ExecutorService for callback execution</li>
+<li>Monitoring support based on key events: might be useful for
instrumentation and/or monitoring<ul>
+<li>Such events could include<ul>
+<li>Connect started</li>
+<li>Connect (indicate in the event whether the connection is secure or
not)</li>
+<li>Connect failed</li>
+<li>Connect retry</li>
+<li>Connect reused</li>
+<li>Connection closed by server</li>
+<li>Disconnect</li>
+<li>Request started</li>
+<li>Request sent (this would be triggered when the request is actually sent
down to the transport so we can monitor latency from queueing requests)</li>
+<li>Request success - received success response from server</li>
+<li>Request failure - received error response from server</li>
+<li>Request timeout</li>
+<li>Redirect</li>
+<li>Request challenged â Do we need to differentiate between a challenge
from the proxy and challenge from the remote web server?</li>
+<li>Response received</li>
+<li>Bad cookie</li>
+</ul>
+</li>
+<li>The order these events are dispatched should be clearly defined</li>
+</ul>
+</li>
+<li>Proxy configuration: support for exclusion lists</li>
+</ul>
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a
href="http://www.apache.org";>The Apache Software Foundation</a> - <a
href="./../privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd,
Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project
logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Modified: websites/staging/mina/trunk/content/asyncweb/client_use_cases.html
==============================================================================
--- websites/staging/mina/trunk/content/asyncweb/client_use_cases.html
(original)
+++ websites/staging/mina/trunk/content/asyncweb/client_use_cases.html Wed Oct
31 11:09:12 2012
@@ -1 +1,171 @@
-asyncweb/page.html
\ No newline at end of file
+<!DOCTYPE html>
+<!--
+ 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.
+-->
+<html>
+<head>
+ <title>Client Use Cases — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet"
type="text/css">
+ <link href="./../css/asyncweb.css" rel="stylesheet"
type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ Sshd
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+<h1 id="use-cases">Use Cases</h1>
+<ul>
+<li>Joe Coder needs to asynchronously download content from 3 different URLs.
He should be able to do so easily using a fork/join pattern such as:</li>
+</ul>
+<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV
class="preformattedContent panelContent">
+<PRE>// Initiate requests without exposing the complexity of creating an
HttpRequest object
+HttpFuture future1 = client.get(url1);
+HttpFuture future2 = client.get(url2);
+HttpFuture future3 = client.get(url3);
+// Requests execute asynchronously
+// Wait for completions
+content1 = future1.get();
+content2 = future2.get();
+content3 = future3.get();
+</PRE>
+</DIV></DIV></p>
+<ul>
+<li>Sally Programmer needs to POST data to a URL. Rather than blocking and
waiting for the response, Sally wants to handle the response in an event-driven
manner. Currently to do this with AHC, a callback must be passed when the
request is initiated. We should consider moving to an observable future pattern
similar :</li>
+</ul>
+<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV
class="preformattedContent panelContent">
+<PRE>// initiate request
+HttpFuture future = client.post(uri, post_data);
+// Sally adds a completion handler
+future.addListener(new HttpListener() {
+ public void onCompletion(HttpFuture future) {
+ // Do something when request completes
+ }
+}
+// Another framework could add a completion handler
+someAhcAwareFramework.addCompletionListener(future);
+</PRE>
+</DIV></DIV></p>
+<ul>
+<li>
+<p>Juliana Hacker has an 8GB video clip that she wishes to upload doing an
HTTP PUT. It would be impractical to load the entire video clip into memory and
this is AsyncWeb so she wants to keep all the I/O as asynchronous as possible.
We should make it possible to utilize MINA's support for
FileChannel.transferTo. We should also make it possible to use compression
encoding to upload the file.</p>
+</li>
+<li>
+<p>Josh Java now wants to download the 8GB video clip. It would not be
feasible to download such a large video clip into a single HttpResponse. We
need to provide someway of dealing with chunks of data asynchronously. We
should also make it possible to use compression to download the file.</p>
+</li>
+<li>
+<p>Joe Coder wants build a client that utilizes the COMET technique. The
client needs to be able to receive data at any time as well as be able to send
data at any time.</p>
+</li>
+<li>
+<p>Danny Doolittle needs to mimic a browser as part of his regression testing
framework for his websites. He hopes that AHC could help along the lines of:
+Here the instance of client holds any cookies that have been set by the first
AHC.get(). These cookies may be security mechanisms that protect access to the
images linked in the HTML document. So, the idea is that the client is a web
session. If I get a new client from the factory, I get a clean "browser" that
has no temporary cookies. Permanent cookies are "stored" in the factory. If I
want a clean start, I create a factory.</p>
+</li>
+</ul>
+<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV
class="preformattedContent panelContent">
+<PRE>client.get(url1).addListener(new HttpListener() {
+ public void onCompletion(HttpFuture future) {
+ Set<URL> images = Util.scrapeImages(future);
+ for (URL image : images) {
+ client.get(image);
+ }
+ }
+});
+</PRE>
+</DIV></DIV></p>
+<ul>
+<li>Susan Sunshine needs to benchmark the performace of the website. Using
Danny Doolittle's code, she adds: </li>
+</ul>
+<p><DIV class="preformatted panel" style="border-width: 1px;"><DIV
class="preformattedContent panelContent">
+<PRE>
+client.get(url1).addListener(new HttpListener() {
+ public void onCompletion(HttpFuture future) {
+ Set<URL> images = Util.scrapeImages(future);
+ for (URL image : images) {
+ client.get(image).addListener(new EventListener() {
+ public void fire(HttpEvent event) {
+ // record some image loading timing info depending on type of event
+ }
+ });
+ }
+ }
+}).addListener(new EventListener() {
+ public void fire(HttpEvent event) {
+ // record some timing info depending on type of event
+ }
+});
+</PRE>
+</DIV></DIV></p>
+<p>Here the idea is that one can add different kinds of listeners in a chained
manner.</p>
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a
href="http://www.apache.org";>The Apache Software Foundation</a> - <a
href="./../privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd,
Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project
logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Modified: websites/staging/mina/trunk/content/asyncweb/index.html
==============================================================================
--- websites/staging/mina/trunk/content/asyncweb/index.html (original)
+++ websites/staging/mina/trunk/content/asyncweb/index.html Wed Oct 31 11:09:12
2012
@@ -1 +1,93 @@
-asyncweb/page.html
\ No newline at end of file
+<!DOCTYPE html>
+<!--
+ 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.
+-->
+<html>
+<head>
+ <title>AsyncWeb — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet"
type="text/css">
+ <link href="./../css/asyncweb.css" rel="stylesheet"
type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ Sshd
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+<h1 id="apache-asyncweb">Apache AsyncWeb</h1>
+<p>Apache AsyncWeb (built on top of the Apache MINA network framework) employs
non-blocking selector driven IO at the transport level, and is asynchronous
thoughout - from the initial parsing of requests, right through to and
including the services implemented by users.<br>
+Apache AsyncWeb breaks away from the blocking request / response architecture
found in todays popular HTTP engines. This allows it to be highly scalable and
capable of supporting very high throughput - even in high processing latency
scenarios.<br>
+A simple API allows new asynchronous services to be created easily - and
out-of-the-box Spring integration allows them to be configured simply and with
great flexibility. In addition to "endpoint" HTTP services, AsyncWeb also
allows configurable "chains" of behaviour - enabling "filter" like behaviour to
be applied to all requests. Pluggable "resolvers" map incoming requests to
their target HTTP service - and are given access to the entire incoming request
- allowing the routing possibilities to be very flexible.</p>
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a
href="http://www.apache.org";>The Apache Software Foundation</a> - <a
href="./../privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd,
Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project
logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
Modified: websites/staging/mina/trunk/content/asyncweb/references.html
==============================================================================
--- websites/staging/mina/trunk/content/asyncweb/references.html (original)
+++ websites/staging/mina/trunk/content/asyncweb/references.html Wed Oct 31
11:09:12 2012
@@ -1 +1,93 @@
-asyncweb/page.html
\ No newline at end of file
+<!DOCTYPE html>
+<!--
+ 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.
+-->
+<html>
+<head>
+ <title>References — Apache MINA</title>
+
+ <link href="./../css/common.css" rel="stylesheet"
type="text/css">
+ <link href="./../css/asyncweb.css" rel="stylesheet"
type="text/css">
+
+</head>
+ <body>
+ <div id="container">
+ <div id="header">
+ <div id="subProjectsNavBar">
+ <a href="./../">
+
+ Apache MINA Project
+
+ </a>
+ |
+ <a href="./../mina/index.html">
+
+ MINA
+
+ </a>
+ |
+ <a href="./../asyncweb/index.html">
+
+ AsyncWeb
+
+ </a>
+ |
+ <a href="./../ftpserver/index.html">
+
+ FtpServer
+
+ </a>
+ |
+ <a href="./../sshd/index.html">
+
+ Sshd
+
+ </a>
+ |
+ <a href="./../vysper/index.html">
+
+ Vysper
+
+ </a>
+ </div><!-- subProjectsNavBar -->
+ </div><!-- header -->
+ <div id="content">
+ <div id="leftColumn">
+
+
+
+
+
+ </div><!-- leftColumn -->
+ <div id="rightColumn">
+
+
+<h1 id="references">References</h1>
+<ul>
+<li>Interesting Comet article <a
href="http://cometdaily.com/2008/04/01/new-technology-new-problems-delayed-pushes-operations/";>http://cometdaily.com/2008/04/01/new-technology-new-problems-delayed-pushes-operations/</a></li>
+</ul>
+
+ </div><!-- rightColumn -->
+ <div id="endContent"></div>
+ </div><!-- content -->
+ <div id="footer">© 2003-2012, <a
href="http://www.apache.org";>The Apache Software Foundation</a> - <a
href="./../privacy-policy.html">Privacy Policy</a><br />
+ Apache MINA, MINA, Apache Vysper, Vysper, Apache SSHd, SSHd,
Apache FtpServer, FtpServer, Apache AsyncWeb, AsyncWeb,
+ Apache, the Apache feather logo, and the Apache Mina project
logos are trademarks of The Apache Software Foundation.
+ </div>
+ </div><!-- container -->
+ </body>
+</html>
+
