hc-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Michael Osipov (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (HTTPCLIENT-1601) Tutorial claims that PUT is not idempotent
Date Sat, 24 Jan 2015 16:57:34 GMT

    [ https://issues.apache.org/jira/browse/HTTPCLIENT-1601?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14290706#comment-14290706
] 

Michael Osipov commented on HTTPCLIENT-1601:
--------------------------------------------

Jon, I did not say the the behavior is implemented incorrectly, I am indicating that the documentation
is flawed. I do not expect the client to retry {{PUT}} by default. That would require a resettable
input stream and a custom retry handler.

Your propopal boils it down pretty much. I simply do not like documentation which leads the
reader into false assumptions especially when the statements aren't true.

> Tutorial claims that PUT is not idempotent
> ------------------------------------------
>
>                 Key: HTTPCLIENT-1601
>                 URL: https://issues.apache.org/jira/browse/HTTPCLIENT-1601
>             Project: HttpComponents HttpClient
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 4.3.6
>            Reporter: Michael Osipov
>
> Open up [chapter 1.4.2|http://hc.apache.org/httpcomponents-client-ga/tutorial/html/fundamentals.html#d5e280],
it says that {{PUT}} is not idempotent. This clearly violates [RFC 7231, section 4.2.2|http://tools.ietf.org/html/rfc7231#section-4.2.2].
It should be checked whether this is just a documentation flaw or even maybe an implemenation
flaw.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

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


Mime
View raw message