Felix GV 2013-05-09, 23:39
Doug Cutting 2013-05-10, 17:55
Jeremy Kahn 2013-05-10, 18:47
Thanks for the feedback guys :) !
I've created AVRO-1329 <https://issues.apache.org/jira/browse/AVRO-1329>.
I'll play around with IDLs, as Doug suggested, and see if that can suit our
documentation and maintenance needs better for the time being.
Thanks again :) !
On Fri, May 10, 2013 at 2:47 PM, Jeremy Kahn <[EMAIL PROTECTED]> wrote:
> +1 to this suggestion. Docs on individual symbols in IDL enums would be
> Felix, will you file that ticket please? I can promise to upvote.
> On Fri, May 10, 2013 at 10:55 AM, Doug Cutting <[EMAIL PROTECTED]> wrote:
>> If you use Avro IDL then you can more easily maintain long, multi-line
>> comments for your enum.
>> IDL files (.avdl) can be compiled to Schemas (.avsc) by Maven, which
>> are then compiled to Java.
>> Documentation per enum symbol is not currently supported, but would
>> not be difficult to add. Please file an issue in Jira if you'd like
>> to see this. For compatibility, in Json, this would probably appear
>> as a parallel array of documentation strings, e.g., something like:
>> ("name": "Foo", "type":"enum", "doc":"an enum", "symbols":["X","Y"],
>> "symbols-doc":["X is X", "Y is Y"]}
>> On Thu, May 9, 2013 at 4:39 PM, Felix GV <[EMAIL PROTECTED]> wrote:
>> > Hello,
>> > I'm currently writing an avro schema which includes an enum field that I
>> > already have as a java enum in my application.
>> > At first, I named the avro field with the same fully qualified name
>> > name dot enum name) as my existing java enum. I then ran the avro
>> > and found that it overwrote my existing java enum with an avro-generated
>> > enum.
>> > I find this slightly annoying because my java enum had comments
>> > the purpose of each enum value, and the avro-generated enum doesn't have
>> > this.
>> > I see two or three potential solutions:
>> > Accepting to replace my current enum with the avro-generated one in my
>> > base, which I feel I cannot document properly (since I have access to
>> > one doc attribute for the whole enum, instead of per symbol). On a side
>> > note, I haven't found any way to have a multi-line doc attribute in an
>> > schema, so that makes things slightly more annoying still. I wouldn't
>> > settling on using the avro-generated enums without documentation per
>> > if at least I could have one big doc/comment that documents all symbols
>> > once, but since it seems the doc attribute must be a one-liner, this is
>> > starting to be a little too messy for my taste...
>> > Maintaining two separate enums: my manually written (and documented)
>> enum as
>> > well as the avro-generated enum. For now, I think this is what I'm
>> going to
>> > do, because those enums have little chances of changing anyway, but
>> from a
>> > maintenance standpoint, it seems pretty horrendous...
>> > I guess there's a third way, which would involve creating a script that
>> > backs up my enums, compiles all my schemas, and then restores my backed
>> > enums, but this also seems ultra messy :( ... I haven't tested if it'd
>> > (since the manually written enum is missing the $SCHEMA field), but I
>> > it would...
>> > Am I being OCD about this? or is this a concern that others have bumped
>> > into? How do you guys deal with this? Did I miss anything in the way
>> > works?
>> > P.S.: I've seen that reflect mappings may be able to work with arbitrary
>> > java enums, but since they seemed discouraged for performance reasons, I
>> > haven't digged much in this direction. I'd like to keep using .avsc
>> files if
>> > possible, but if there's a better way, I can certainly try it.
>> > P.P.S.: We're currently using avro 1.6.1, but if the latest version
>> > a nice way of handling my use case, then I guess I could get us to
Scott Carey 2013-05-13, 21:38
Felix GV 2013-05-16, 23:51