Mailing-List: contact dev-help@hc.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "HttpComponents Project" <dev@hc.apache.org>
Date: Thu, 17 Jan 2013 07:38:13 +0000 (UTC)
From: "John McCarthy (JIRA)" <jira@apache.org>
To: dev@hc.apache.org
Message-ID: <JIRA.12627998.1358408220239.150929.1358408293012@arcas>
In-Reply-To: <JIRA.12627998.1358408220239@arcas>
References: <JIRA.12627998.1358408220239@arcas>
Subject: [jira] [Updated] (HTTPCORE-330) Clarify InputStreamEntity length
 constructor argument
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable


     [ https://issues.apache.org/jira/browse/HTTPCORE-330?page=3Dcom.atlass=
ian.jira.plugin.system.issuetabpanels:all-tabpanel ]

John McCarthy updated HTTPCORE-330:
-----------------------------------

    Description: When creating an InputStreamEntity, content length may not=
 be known.  (Also, it may be desired to create an entity that will be read =
until fully consumed without specifying a content length.)  From what I see=
 in the writeTo() method source, you may specify a number less than zero fo=
r the length parameter in the constructor if the length is not known.  Plea=
se clarify this in the javadoc.  Also, because is length is optional, perha=
ps corresponding constructors should be added that don't require this param=
eter.  (was: When creating an {{InputStreamEntity}}, content length may not=
 be known.  (Also, it may be desired to create an entity that will be read =
until fully consumed without specifying a content length.)  From what I see=
 in the {{writeTo()}} method source, you may specify a number less than zer=
o for the {{length}} parameter in the constructor if the length is not know=
n.  Please clarify this in the javadoc.  Also, because is length is optiona=
l, perhaps corresponding constructors should be added that don't require th=
is parameter.)
        Summary: Clarify InputStreamEntity length constructor argument  (wa=
s: Clarify {{InputStreamEntity}} {{length}} constructor argument)
   =20
> Clarify InputStreamEntity length constructor argument
> -----------------------------------------------------
>
>                 Key: HTTPCORE-330
>                 URL: https://issues.apache.org/jira/browse/HTTPCORE-330
>             Project: HttpComponents HttpCore
>          Issue Type: Improvement
>          Components: Documentation, HttpCore
>    Affects Versions: 4.2.3
>            Reporter: John McCarthy
>            Priority: Minor
>              Labels: documentation
>
> When creating an InputStreamEntity, content length may not be known.  (Al=
so, it may be desired to create an entity that will be read until fully con=
sumed without specifying a content length.)  From what I see in the writeTo=
() method source, you may specify a number less than zero for the length pa=
rameter in the constructor if the length is not known.  Please clarify this=
 in the javadoc.  Also, because is length is optional, perhaps correspondin=
g constructors should be added that don't require this parameter.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrato=
rs
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