You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@avro.apache.org by "Doug Cutting (JIRA)" <ji...@apache.org> on 2012/07/12 20:39:34 UTC
[jira] [Created] (AVRO-1125) Java: reflect package documentation
discourages use
Doug Cutting created AVRO-1125:
----------------------------------
Summary: Java: reflect package documentation discourages use
Key: AVRO-1125
URL: https://issues.apache.org/jira/browse/AVRO-1125
Project: Avro
Issue Type: Improvement
Components: doc, java
Reporter: Doug Cutting
Assignee: Doug Cutting
Fix For: 1.7.1
The package-level documentation for org.apache.avro.reflect says:
bq. This API is not recommended except as a stepping stone for systems that currently uses Java interfaces to define RPC protocols.
That seems overly cautious. Folks are productively using Avro's reflect API in lots of other ways.
--
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
[jira] [Resolved] (AVRO-1125) Java: reflect package documentation
discourages use
Posted by "Doug Cutting (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/AVRO-1125?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Doug Cutting resolved AVRO-1125.
--------------------------------
Resolution: Fixed
I committed this.
> Java: reflect package documentation discourages use
> ---------------------------------------------------
>
> Key: AVRO-1125
> URL: https://issues.apache.org/jira/browse/AVRO-1125
> Project: Avro
> Issue Type: Improvement
> Components: doc, java
> Reporter: Doug Cutting
> Assignee: Doug Cutting
> Fix For: 1.7.1
>
> Attachments: AVRO-1125.patch
>
>
> The package-level documentation for org.apache.avro.reflect says:
> bq. This API is not recommended except as a stepping stone for systems that currently uses Java interfaces to define RPC protocols.
> That seems overly cautious. Folks are productively using Avro's reflect API in lots of other ways.
--
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
[jira] [Updated] (AVRO-1125) Java: reflect package documentation
discourages use
Posted by "Doug Cutting (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/AVRO-1125?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Doug Cutting updated AVRO-1125:
-------------------------------
Attachment: AVRO-1125.patch
Here's a patch that removes this warning. A few other clarifications are made to the documentation.
> Java: reflect package documentation discourages use
> ---------------------------------------------------
>
> Key: AVRO-1125
> URL: https://issues.apache.org/jira/browse/AVRO-1125
> Project: Avro
> Issue Type: Improvement
> Components: doc, java
> Reporter: Doug Cutting
> Assignee: Doug Cutting
> Fix For: 1.7.1
>
> Attachments: AVRO-1125.patch
>
>
> The package-level documentation for org.apache.avro.reflect says:
> bq. This API is not recommended except as a stepping stone for systems that currently uses Java interfaces to define RPC protocols.
> That seems overly cautious. Folks are productively using Avro's reflect API in lots of other ways.
--
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