search

achrefB3 / google-api-java-client

Automatically exported from code.google.com/p/google-api-java-client
0 stars 0 forks source link

HttpRequest.headers deprecated in JAR file - but not in API docs #265

Closed GoogleCodeExporter closed 9 years ago

GoogleCodeExporter commented 9 years ago 
Version of google-api-java-client (e.g. 1.4.1-beta)?

1.4.1-beta

Java environment (e.g. Java 6, Android 2.3, App Engine 1.4.3)?

JDK 1.5.0_12 and JDK 1.6.0_26

Describe the problem.

Running with -Xlint:deprecation issues this warning:

org/springhaven/testing/GdataTest1.java:76: warning: [deprecation] headers in 
com.google.api.client.http.HttpRequest has been deprec
ated

How would you expect it to be fixed?

Either un-deprectate the headers field in HttpRequest, or properly document the 
fact that this field is deprecated and what correct non-deprecated 
functionality we should use in place of HttpRequest.headers

Original issue reported on code.google.com by darkfoxp...@gmail.com on 12 Aug 2011 at 9:21

GoogleCodeExporter commented 9 years ago 
It is deprecated in version 1.5.0-beta, not 1.4.0-beta.  Please take a look at 
the new API docs for more details:

http://javadoc.google-http-java-client.googlecode.com/hg/1.5.0-beta/com/google/a
pi/client/http/HttpRequest.html#headers

Original comment by yan...@google.com on 12 Aug 2011 at 9:53

GoogleCodeExporter commented 9 years ago 
Okay.  I hadn't realized that I'd downloaded the 1.5.0-beta API.

In this case, shouldn't there be a link *SOMEWHERE* on 
http://code.google.com/p/google-api-java-client/ about the 1.5.0-beta APIs?

There's not even a mention that it's been released - and if it HASN'T been 
released, why is it on the downloads page?

Original comment by darkfoxp...@gmail.com on 12 Aug 2011 at 10:39

GoogleCodeExporter commented 9 years ago 
I want to add:  Thank you for pointing me to the documentation URL and for 
informing me of the version difference.

My previous comment was admittedly 'snippy' and I apologise for that.

However, snippy or not, my point is valid.  Given that the 1.5.0-beta API is 
the first link that shows up in the Downloads page, there should be *some* 
mention of it, along with appropriate documentation links, etc., on the front 
page.

Original comment by darkfoxp...@gmail.com on 12 Aug 2011 at 10:43