api_request 1.0.9

api request for handle call api. every request is an action has execute method.

example/lib/main.dart

import 'package:api_request/api_request.dart';
import 'package:example/ApiError.dart';
import 'package:flutter/material.dart';

class Post {
  final int id;
  final int userId;
  final String title;
  final String body;
  const Post({
    required this.id,
    required this.userId,
    required this.title,
    required this.body,
  });

  @override
  String toString() {
    return 'Post{' +
        ' id: $id,' +
        ' userId: $userId,' +
        ' title: $title,' +
        ' body: $body,' +
        '}';
  }

  factory Post.fromMap(Map<String, dynamic> map) {
    return Post(
      id: map['id'],
      userId: map['userId'],
      title: map['title'],
      body: map['body'],
    );
  }
}

class PostsResponse {
  List<Post>? posts;
  PostsResponse({this.posts});

  PostsResponse.fromList(List<dynamic>? data) {
    if (data is List) {
      this.posts = <Post>[];
      data.forEach((item) => this.posts?.add(Post.fromMap(item)));
    }
  }
}

class PostsRequestAction extends ApiRequestAction<PostsResponse> {
  @override
  bool get authRequired => false;

  @override
  String get path => 'posts';

  @override
  RequestMethod get method => RequestMethod.GET;

  @override
  ResponseBuilder<PostsResponse> get responseBuilder =>
      (list) => PostsResponse.fromList(list);
}

class PostRequestAction extends ApiRequestAction<Post> {
  PostRequestAction();

  @override
  bool get disableGlobalOnError => true;

  @override
  bool get authRequired => false;

  @override
  String get path => 'posts/{id}';

  @override
  RequestMethod get method => RequestMethod.GET;

  @override
  ResponseBuilder<Post> get responseBuilder => (map) => Post.fromMap(map);

  @override
  Function get onInit => () => print('Action Init');
}

String yourMethodToGetToken() {
  return '1|hfkf9rfynfuynyf89erfynrfyepiruyfp';
}

Future<String> yourAysncMethodToGetToken() async {
  return '1|hfkf9rfynfuynyf89erfynrfyepiruyfp';
}

void main() {
  //config api requests;
  ApiRequestOptions.instance?.config(
    enableLog: true,

    /// set base url for all request
    baseUrl: 'https://jsonplaceholder.typicode.com/',

    errorBuilder: (json) => ApiError.fromJson(json),

    /// set token type to 'Bearer '
    tokenType: ApiRequestOptions.bearer,
    onError: (e) => print('Global Error'),

    /// set token as string api request action will with is if auth is required
    //token: '1|hfkf9rfynfuynyf89erfynrfyepiruyfp',

    /// we will call this method to get token in run time -- method must be return string
    //getToken: () => yourMethodToGetToken(),

    /// we will call this method to get token in run time -- method must be return Future<string>
    getAsyncToken: () => yourAysncMethodToGetToken(),

    /// send default query params for all requests
    //defaultQueryParameters: {'locale': 'ar'},
  );
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Api Request Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(title: 'Api Request Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  List<Post>? posts = <Post>[];
  final PostsRequestAction action = PostsRequestAction();
  bool loading = true;

  @override
  initState() {
    super.initState();
    /*SimpleApiRequest.withBuilder((data) => PostsResponse.fromList(data))
        .get('/posts')
        .then((response) => response?.fold((l) => null, (r) {
              posts = r.posts;
            }));*/

    //older way

    // action?.onError = (e) {
    //   loading = false;
    //   setState(() {});
    //   print(e.toString());
    // };
    // action?.onSuccess = (s) {
    //   loading = false;
    //   posts = s?.posts;
    //   setState(() {});
    // };
    // action?.onQueue();

    // new way
    //use run action to return with Either value or error

    action
        .whereQuery('test', 'test')
        .withHeader('test-me', 'try-me')
        .listen(
          onStart: () => print('hi onStart'),
          onSuccess: (r) => print('hi onSuccess'),
          onError: (e) => print('hi onError ${e.apiErrorResponse?.message}'),
          onDone: () => print('hi onDone'),
        )
        .execute()
        .then((value) {
      loading = false;
      value?.fold((l) => print(l?.message), (r) {
        posts = r?.posts;
        setState(() {});
      });
    });
  }

  _getPostData(int? id) {
    PostRequestAction()
        .where('id', id)
        .whereMapQuery({'id': 'test'})
        .listen(
          onStart: () => print('hi onStart'),
          onSuccess: (r) => print('response Post Id: ${r?.id}'),
          onError: (e) => print('hi onError ${e.message}'),
          onDone: () => print('hi onDone'),
        )
        .execute();

    //older way

    // action.onError = (e) {
    //   print(e.toString());
    // };
    // action.onSuccess = (s) {
    //   print('response Post Id: ${s?.id}');
    // };
    // action.onQueue();

    // new way
    //use run action to return with Either value or error
    // action.execute();
  }

  getReport() {
    print("${ApiRequestPerformance.instance?.actionsReport}");
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: loading
            ? CircularProgressIndicator()
            : ListView.builder(
                itemCount: posts?.length,
                itemBuilder: (_, index) => ListTile(
                      title: Text("${posts?[index].title}"),
                      onTap: () {
                        _getPostData(posts?[index].id);
                      },
                    )),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: getReport,
        child: Icon(Icons.report),
      ),
    );
  }
}

// add on success on error , subscripe
// execute is back and rename new method