Core layer of flutter projects.

Use HiveCachingManager for save data to the cache.

##Example:

 // HiveCachingManager implements HiveService.
  // HiveService implements LocaleCachingService
  // Which mean you can use hive spesific functions or locale caching functions

  ///[_cachingService] can use  only [LocaleCachingService] methods.
  final LocaleCachingService _cachingService = HiveCachingManager.instance;

  ///[_hiveService] can use [LocaleCachingService] methods and [HiveService] spesific methods.
  final HiveService _hiveService = HiveCachingManager.instance;

Future<void> examples() async {
    var isSaved = await _cachingService.setValue<String>('Test', 'My data');
    print(isSaved.toString());

    var myDataCache =
        await _cachingService.getValue<String>('Test', defaultValue: '');
    var myDataHive =
        await _hiveService.getValue<String>('Test', defaultValue: '');

    print(myDataCache?.toString() ?? 'error cache');
    print(myDataHive?.toString() ?? 'error hive');

    var isOpen = _hiveService.isBoxOpen('Test');
    if (isOpen) {
      await _hiveService.close<String>('Test');
    }

    var isDeleted = await _cachingService.deleteValue('Test');
    print('Is Deleted: $isDeleted');
  }

• RemoteDataService created for API requests.

  • HttpRemoteDataManager created.
  • ApiResponse & ApiResponseModel created. Users can parse their json using ApiResponse.
  • EntityModel created for parse json to model simply.
  • Also JsonConverter created for parse json.
  • HttpStatusCodeController created. It returns Result with message.
  • Exceptions created like ConnectionException, ServerException or SocketException
  • ApiConstants created. It includes url's and messages.

• DurationTypes enum created. It includes some Durations.

• Sizes enum created. It returns some double values.

Example Usage:

• Define HttpRemoteManager

final _remoteService = HttpRemoteDataManager.getInstance(
    baseUrl: 'https://jsonplaceholder.typicode.com/',
    timeout: DurationTypes.thirtytwoSeconds,
    header: {'Content-type': 'application/json'},
  )
    ..addBearerTokenToHeader('ADD_YOUR_TOKEN')
    ..setTimeout(DurationTypes.sixteenSeconds)
    ..setHeader({'CUSTOM_HEADER': 'SET_EASILY'});

• Get Data

Future<void> getData(int id) async {
    //TReturn means: this method will return for example Todo class.
    //TModel means: Parse response data like TModel type for example Todo class.
    var result = await _remoteService.getData<Todo, Todo>(
      endpoint: 'todos/$id',
      parseModel: Todo(),
    );

    //End this methods request with http and convert response json like Todo class.
    // If all operations succes it returns [SuccessDataResult] and data type Todo.

    if (result.success) {
      print(result.data?.title);
      print(result.toJson());
    } else {
      print(result.message);
    }
  }

Future<void> getAllTodosByApiResponse(int id) async {
    //That operation gets Todo list inside of [ApiResponseModel]
    var result = await _remoteService.getDataByApiResponse<List<Todo>, Todo>(
      endpoint: 'todos/$id',
      parseModel: Todo(),
      apiResponse: MyApiResponseModel(),
    );

    if (result.statusCode == 0 && result.success == true) {
      result.data?.map((item) => print(item.title));
      print(result.toJson());
    } else {
      print(result.message);
    }
  }

• Post Data

Future<void> postData(Todo todo) async {
    //That operation send data using [POST] method and returns [Todo] class
    var result = await _remoteService.postByData<Todo, Todo>(
      endpoint: '/posts',
      body: todo,
      parseModel: Todo(),
      isJsonEncode: true,
    );

    if (result.success) {
      print(result.toJson());
    } else {
      print(result.message);
    }
  }

  Future<void> postDataByApiResponse(Todo todo) async {
    //That operation send data using [POST] method and returns [ApiResponse] extended class
    var result = await _remoteService.postByResponseData<Todo, Todo>(
      endpoint: '/posts',
      body: todo,
      parseModel: Todo(),
      isJsonEncode: true,
      apiResponse: MyApiResponseModel(),
    );

    if ((result.success ?? false) && (result.statusCode ?? -1) == 0) {
      print(result.toJson());
    } else {
      print(result.message);
    }
  }
}

• Create Entity class and implement with EntityModel

// implement EntityModel to your class if you want to parse automatically.
class Todo implements EntityModel<Todo> {
  int? userId;
  int? id;
  bool completed;
  String? title;
  String? body;

  Todo({
    this.userId,
    this.id,
    this.completed = false,
    this.title,
    this.body,
  });

  factory Todo.fromJson(Map<String, dynamic> json) {
    return Todo(
      userId: json['userId'],
      id: json['id'],
      title: json['title'],
      body: json['body'],
      completed: json['completed'],
    );
  }

  @override
  Todo fromJson(Map<String, dynamic> json) => Todo.fromJson(json);

  @override
  Map<String, dynamic>? toJson() {
    return {
      'userId': userId,
      'id': id,
      'title': title,
      'body': body,
    };
  }
}

• Customize ApiResponseModel if you need.

// You can create your ApiResponseModel and use it.
class MyApiResponseModel<TData, TParse> implements ApiResponse<TData, TParse> {
  @override
  TData? data;

  @override
  String? message;

  @override
  TParse? parseModel;

  @override
  int? statusCode;

  @override
  bool? success;

  String? statusMessage;
  String? json;

  MyApiResponseModel({
    this.data,
    this.message,
    this.parseModel,
    this.statusCode,
    this.success,
    this.json,
    this.statusMessage,
  });

  @override
  ApiResponse fromJson(Map<String, dynamic> json, {TParse? parseModel}) {
    //TODO: parse your json data
    return ApiResponseModel();
  }

  @override
  Map<String, dynamic> toJson() {
    // TODO: implement toJson
    return {};
  }
}

You can display your messages using DisplaySnackBar class or DisplayAlertDialog class.

Theese classes have two methods. One of them success message and other one is error message.

You can use results for return data with message and succes information.

• Example Usage:

DataResult<int> addOneIfNotNull(int? value) { return value != null ? SuccessDataResult(data: value + 1) : ErrorDataResult(message: 'value is null'); }