hc-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Daniel Kulp (JIRA)" <j...@apache.org>
Subject [jira] [Created] (HTTPCORE-305) Javadoc could be clearer about the scopes for the encoder/decoder....
Date Tue, 31 Jul 2012 19:27:35 GMT
Daniel Kulp created HTTPCORE-305:

             Summary: Javadoc could be clearer about the scopes for the encoder/decoder....
                 Key: HTTPCORE-305
                 URL: https://issues.apache.org/jira/browse/HTTPCORE-305
             Project: HttpComponents HttpCore
          Issue Type: Improvement
          Components: Documentation
            Reporter: Daniel Kulp

While working with hc for use with CXF, I tried using the encoder/decoder on a different thread,
but ONLY on that different thread since they aren't marked threadsafe.  However, I ran into
some problems.   The javadoc for produceContent and for the encoder/decoder interfaces likely
should contain something like:

"The encoder should only be used within the context of the call to produceContent.   The IOControl
object can be retained and used on other threads to allow resuming events when appropriate."

to make it clear that the encoder/decoder should not be retained at all, but the IONControl
object could be.

This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira


To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org

View raw message