MapModel #

Dart flutter Pub Package

Language: en cn

MapModel as its name suggests. Implement various Model objects using Map, such as Entity, VO, and DTO.

Its core idea is to use Map as storage and getter/setter as facade to control visibility. In order to reduce the cost of object conversion, and even share the same instance, only with different visibility. This is like using different types of pointers to interpret the same memory space, rather than maintaining data synchronization across multiple memory blocks.

Setup #

dependencies:
  map_model: any

dev_dependencies:
  build_runner: any
  map_model_builder: any

Example #

import 'package:map_model/map_model.dart';
part 'your_model.g.dart';

@Model([
  Property<String?>('nullableString', value: '"123"'),
  Property<int>('fixInt'),
  Property('withValueConvert', value: '12', convert: 'convert'),
  Property<List<String?>?>('listWithType'),
  Property<List?>('listNoType'),
  Property<Map<String?, dynamic>?>('mapWithType'),
  Property<Map?>('mapNoType'),
])
class SuperModel extends _SuperModelImpl {/// use extends
  SuperModel([super.data]);
}

convert(data) => data.toString();

@Model([
  Property<String?>('subProperty', value: '"value form sub default"'),
])
class SubModel extends SuperModel with _SubModelMixin {/// use mixin
  SubModel([super.data]);
}

• use extends superClass: _${yourClass}Impl
• use mixin: _${yourClass}Mixin

Generate #

flutter pub run build_runner build

or

dart run build_runner build

Use MapModel #

import 'your_model.dart';

main() {
  /// simple case
  var customModel = SuperModel();
  print(customModel.nullableString);
  /// console see 123

  /// init data
  Map<String, dynamic> data = {'nullableString': 'notDefaultValue', 'unknownProperty': 'do not export'};
  var customModelWithInit = SuperModel(data);
  print(customModelWithInit.nullableString);
  /// console see notDefaultValue

  var subModel = SubModel(data);
  print(subModel.export());
  /// do not export 'unknownProperty'
  /// console see {nullableString: notDefaultValue, fixInt: null, withValueConvert: 12, listWithType: null, listNoType: null, mapWithType: null, mapNoType: null, subProperty: value form sub default}

  var other = SuperModel();
  subModel.bindTo(other);/// Different types have obtained the ability to synchronize data
  /// change one of binds, other also changed
  subModel.nullableString = 'from bind changed';

  print(other.nullableString);
  /// console see 'from bind changed'
}

• export() Only defined fields can be obtained.
• bindTo() Used for conversion between models, sharing a single piece of data.