Date: 2005-01-11T06:44:05
   Editor: RolandWeber
   Wiki: Jakarta-HttpClient Wiki
   Page: HttpClientApiRedesign
   URL: http://wiki.apache.org/jakarta-httpclient/HttpClientApiRedesign

   first take on asynchronous request handling

Change Log:

------------------------------------------------------------------------------
@@ -146,6 +146,40 @@
    a. {{{ NTLMScheme }}} class implementing {{{ AuthScheme }}}
    a. {{{ AuthChallengeParser }}} class
 
+== http-async ==
+
+possible package name: '''org.apache.http.async'''
+
+The purpose of this component is to provide an asynchronous alternative to the 
synchronous {{{ HttpMethodExecutor }}} in http-common.
+
+depends on 
+
+ * Java 1.4
+ * commons-logging (really needed? if feasible I'd rather do without this 
dependency)
+ * http-common
+
+The rationale behind trying to avoid dependency on a logging framework is to 
keep the component reusable by projects that have already standardized on a 
certain logging framework.
+
+provides
+
+ * asynchronous execution interface for HTTP requests. The {{{ HttpConnection 
}}} for communication is passed as an argument when the interface is used. 
Responses and errors are reported as callbacks.
+
+   a. {{{ HttpAsyncLink }}} interface for sending requests asynchronously
+   a. {{{ HttpAsyncCallback }}} interface
+
+ * default implementation of the asynchronous execution interface. The default 
is to spawn a new background thread that sends the request over the connection 
and waits for a response. The callback interface is used by that thread.
+
+   a. {{{ StdAsyncLink }}} class implementing {{{ HttpAsyncLink }}}
+
+ * result lookup interface for HTTP responses.
+
+   a. {{{ HttpAsyncResult }}} interface for checking whether the response is 
available, and getting it
+   a. {{{ HttpAsyncNotify }}} interface extending {{{ HttpAsyncResult }}} with 
a wait/notify mechanism
+
+ * default implementation of a callback handler and result provider. The 
default implementation uses the same error retry handling as {{{ 
DefaultHttpRequestRetryHandler }}}.
+
+   a. {{{ StdAsyncCallbackHandler }}} class implementing {{{ HttpAsyncCallback 
}}}, {{{ HttpAsyncResult }}}, {{{ HttpAsyncNotify }}}
+
 == http-client ==
 
 possible package name: '''org.apache.http.httpclient'''

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to