google / built_value.dart

Immutable value types, enum classes, and serialization.
https://pub.dev/packages/built_value
BSD 3-Clause "New" or "Revised" License
867 stars 184 forks source link

Auto add builder factories for nested built_collection classes #1254

Open JosephNK opened 1 year ago

JosephNK commented 1 year ago

When using BuiltMap nesting, is it not automatically created?

abstract class Calendar implements Built<Calendar, CalendarBuilder> { 
  ...
  @BuiltValueField(wireName: 'calendar')
    BuiltMap<String, BuiltMap<String, BuiltList<DayDTO>>>? get calendar;
  ...
}

automatically generated below

..addBuilderFactory(
          const FullType(BuiltMap, const [
            const FullType(String),
            const FullType(BuiltMap, const [
              const FullType(String),
              const FullType(
                  BuiltList, const [const FullType(DayDTO)])
            ])
          ]),
          () => new MapBuilder<String,
              BuiltMap<String, BuiltList<DayDTO>>>())

however, the below needs to be added manually.

..addBuilderFactory(
          const FullType(BuiltMap, const [
            const FullType(String),
            const FullType(
                BuiltList, const [const FullType(DayDTO)])
          ]),
          () => new MapBuilder<String, BuiltList<DayDTO>>())
..addBuilderFactory(
        const FullType(
            BuiltList, const [const FullType(DayDTO)]),
        () => new ListBuilder<DayDTO>())

It won't work unless you add it manually in the code above. So you have to add it manually, but it works.

Is there a way to automatically generate it?

JosephNK commented 1 year ago

I added the following code for auto-generation.

Is it correct to use it like this?

abstract class Calendar implements Built<Calendar, CalendarBuilder> { 
  ...
  @BuiltValueField(wireName: 'calendar')
    BuiltMap<String, BuiltMap<String, BuiltList<DayDTO>>>? get calendar;
  ...
  BuiltMap<String, BuiltList<DayDTO>>? get autogen01; <-- added
  BuiltList<DayDTO>? get autogen02;  <-- added
}
davidmorgan commented 1 year ago

Yes, it's necessary to add builder factories manually in some cases.

It's true that you could add fields as in your second post so the builder factories get generated for you, but then you will end up with a very weird class :) ... maybe you could put all such fields in a single class that you don't use, as a more convenient way to add builder factories.

Sorry that this part of built_value is so awkward, there is a long standing feature request to improve it but I haven't had a chance to tackle it!

pierremrtn commented 2 months ago

I was considering using built_value for a project, but this is a big deal to me. The amount of boilerplate can be huge and hard to write.

tp commented 2 weeks ago

I was considering using built_value for a project, but this is a big deal to me. The amount of boilerplate can be huge and hard to write.

@pierremrtn I understand that concern. For a current project (which internally uses built_value with the Dio OpenAPI generator) the value gained form this package much outweighs the extra effort / headache caused by this.

For the case where we now want to deal with e.g. BuiltMap<String, BuiltList<Foo>> I added a helper method:

extension on SerializersBuilder {
  /* Adds support for values of type `BuiltMap<Key, BuiltList<Value>>` */
  void addMapOfList<Key, Value>() {
    addBuilderFactory(
      FullType(BuiltMap, [
        FullType(Key),
        FullType(
          BuiltList,
          [FullType(Value)],
        )
      ]),
      () => new MapBuilder<Key, BuiltList<Value>>(),
    );

    addBuilderFactory(
      FullType(BuiltList, [FullType(Value)]),
      () => new ListBuilder<Value>(),
    );
  }
}

With that we only have to call addMapOfList<String, X>() for each case on the SerializersBuilder on init. So after the initial setup this is now easy to use, should this ever come up again.

Maybe this helps anyone else to work around this problem quickly until it's supported via code generation.