[
https://issues.apache.org/jira/browse/AVRO-1472?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13933655#comment-13933655
]
ASF subversion and git services commented on AVRO-1472:
-------------------------------------------------------
Commit 1577264 from [~cutting] in branch 'avro/trunk'
[ https://svn.apache.org/r1577264 ]
AVRO-1472. Java: Clarify parse method in getting started guide. Contributed by
Michael Knapp.
> Usage of Parser is Wrong in Getting Started Guide
> -------------------------------------------------
>
> Key: AVRO-1472
> URL: https://issues.apache.org/jira/browse/AVRO-1472
> Project: Avro
> Issue Type: Improvement
> Affects Versions: 1.7.4, 1.7.5, 1.7.6
> Reporter: Michael Knapp
> Priority: Minor
> Fix For: 1.7.7
>
>
> In the Getting Started Guide for java, in the "Serializing and deserializing
> without code generation" section, for versions 1.7.3 and later, I still see
> this:
> Schema schema = new Parser().parse(new File("user.avsc"));
> This is COMPLETELY confusing to people, I am assuming now that you have
> imported org.apache.avro.Schema.Parser, but that is not clear to the users.
> There is also a class in avro called org.apache.avro.io.parsing.Parser, most
> users would look at your "Parser" in the example and think you are talking
> about "org.apache.avro.io.parsing.Parser", when you are actually talking
> about "org.apache.avro.Schema.Parser"
> I just wasted the last hour of my life trying to figure this out. Please fix
> your documentation. Either tell people exactly what parser you are
> importing, or explicitly state it like this:
> Schema schema = new Schema.Parser().parse(in);
--
This message was sent by Atlassian JIRA
(v6.2#6252)
