[FLUTTER] Shared Preferences trong Flutter

Để lưu trữ các dữ liệu ở local trong ứng dụng Flutter, ngoài cách lưu bằng sqlite, chúng ta còn thể lưu dữ liệu vào Shared Preferences

1. Sơ lược về Shared Preferences trong Flutter

• Dùng để lưu những tập dữ liệu nhỏ dưới dạng key-value
• Các loại dữ liệu có thể lưu như là int, double, bool, String and List<String>
• Các dữ liệu được lưu lại trong một file .xml và được lưu vào trong bộ nhớ đệm của máy
• Các dữ liệu chúng ta có thể dùng để lưu như là các thông số về Settings, token,, …

2. Cách sử dụng

• Thêm thư viện vào trong file pubspect.yaml:

shared_preferences: ^2.0.13

Vì các hàm xử lý lưu dữ liệu trong shared_preferences đều là các hàm Future, nên chúng ta cần dùng await để gọi:

• Hàm lưu dữ liệu

// Obtain shared preferences.
final prefs = await SharedPreferences.getInstance();

// Save an integer value to 'counter' key. 
await prefs.setInt('counter', 10);
// Save an boolean value to 'repeat' key. 
await prefs.setBool('repeat', true);
// Save an double value to 'decimal' key. 
await prefs.setDouble('decimal', 1.5);
// Save an String value to 'action' key. 
await prefs.setString('action', 'Start');
// Save an list of strings to 'items' key. 
await prefs.setStringList('items', <String>['Earth', 'Moon', 'Sun']);

• Hàm đọc dữ liệu

// Try reading data from the 'counter' key. If it doesn't exist, returns null.
final int? counter = prefs.getInt('counter');
// Try reading data from the 'repeat' key. If it doesn't exist, returns null.
final bool? repeat = prefs.getBool('repeat');
// Try reading data from the 'decimal' key. If it doesn't exist, returns null.
final double? decimal = prefs.getDouble('decimal');
// Try reading data from the 'action' key. If it doesn't exist, returns null.
final String? action = prefs.getString('action');
// Try reading data from the 'items' key. If it doesn't exist, returns null.
final List<String>? items = prefs.getStringList('items');

• Nếu chúng ta muốn xóa bỏ dữ liệu đã được lưu

// Remove data for the 'counter' key. 
final success = await prefs.remove('counter');

Tài liệu tham khảo: shared_preferences | Flutter Package (pub.dev)

Author: LamNT59

[FLUTTER] Sự khác biệt giữa Future và Stream trong Flutter

Lập trình không đồng bộ trong Flutter được đặc trưng bởi hai lớp Future và Stream

1. Future

Khi một hàm bất đồng bộ được thực hiện xong nó sẽ trả về một Future.

• Một hàm Future có thể trả về một giá trị.
• Một hàm Future cũng có thể trả về một lỗi nếu có bất kì ngoại lệ nào xảy ra.

Future<void> fetchUserOrder() {
  // Imagine that this function is fetching user info from another service or database.
  return Future.delayed(const Duration(seconds: 2), () => print('Large Latte'));
}

void main() {
  fetchUserOrder();
  print('Fetching user order...');
}

2. Stream

Định nghĩa: Stream là một chuỗi các sự kiện không đồng bộ. Nó giống như một Lặp lại không đồng bộ – trong đó, thay vì nhận được sự kiện tiếp theo khi bạn yêu cầu, luồng cho bạn biết rằng có một sự kiện khi nó sẵn sàng.

Future<int> sumStream(Stream<int> stream) async {
  var sum = 0;
  await for (final value in stream) {
    sum += value;
  }
  return sum;
}

Stream<int> countStream(int to) async* {
  for (int i = 1; i <= to; i++) {
    yield i;
  }
}

void main() async {
  var stream = countStream(10);
  var sum = await sumStream(stream);
  print(sum); // 55
}

3. Khác biệt giữa Future và Stream

Như chúng ta có thể thấy ở trên thì điểm khác biệt rõ rệt nhất của Future và Stream là:

• Trong quá trình xử lý Future sẽ chờ đợi đến khi hoàn thành và chỉ trả lại kết quả tại thời điểm đó.
• Stream thì sẽ trả về dữ liệu liên tục nếu nó vẫn tiếp tục được chuyển về, tạo thành một luồng.

Từ những sự khác biệt này chúng ta có thể suy luận ra các trường hợp nào nên sử dụng Future, trường hợp nào nên sử dụng Stream.

Future:

• Chụp một bức ảnh từ camera, hoặc lấy từ trong bộ nhớ.
• Lẩy các thông tin về file.
• Tạo các https request.
• …

Stream:

• Lắng nghe sự thay đổi của vị trí.
• Chơi nhạc.
• Đồng hồ bấm giờ.
• Làm việc với web-socket.
• …

Hãy chọn cho mình những cách phù hợp nhất với các vấn đề chúng ta cần giải quyết.

Tài liệu tham khảo:

• Asynchronous programming: Streams | Dart
• Asynchronous programming: futures, async, await | Dart

Author: LamNT59

[FLUTTER] Tìm hiểu về cách sử dụng SQLite trong Flutter

Để lưu những dữ liệu theo dạng bảng dễ dàng cho việc truy vấn và thay đổi, chúng ta cần sử dụng SQLite

I. Khái quát về Sqlite trong Flutter

Trong Flutter chúng ta sử dụng thư viện sqflite, thư viện này sẽ hỗ trợ chúng ta:

• Sử dụng trên đa nền tảng Android, iOS, MacOS.
• Hỗ trợ transactions và batches.
• Tự động quản lý phiên bản (version) trong khi mở.
• Hỗ trợ các câu lệnh truy vấn CRUD (Create – Read – Update – Delete) đầy đủ.
• Thực hiện các xử lý trên background của iOS và Android.

II. Cách sử dụng Sqlite trong Flutter

1. Thêm thư viện

1.1. Thêm thư viện sqflite và path (dùng để xác định vị trí lưu database trong bộ nhớ) vào phần dependencies trong file pubspec.yaml

2. Cài đặt thư viện

2.1. Đầu tiên chúng ta cần tạo một class model Student, đây sẽ là dữ liệu chúng ta dùng trong quá trình lưu trữ.

class Student {
  int id;
  String name;
  int grade;

  Student({required this.id, required this.name, required this.grade});
}

Nếu bạn chưa biết rõ về Sql cũng như các câu lệnh của chúng, hãy tìm hiểu về chúng trước khi tiếp tục: SQL Introduction (w3schools.com)

2.2. Tiếp theo chúng ta khởi tạo database

class StudentDatabase {
  static Database? _database;

  static Future<Database> getInstance() async {
    _database ??= await openDatabase(

        /// use join to create path for db, then the path will be path/student.db
        join(await getDatabasesPath(), "student.db"),

        /// This function will be called in the first time database is created
        onCreate: (db, version) {
      return db.execute(
          "CREATE TABLE student(id INTEGER PRIMARY KEY, name TEXT, grade INTEGER)");
    },

        /// This version will use when you want to upgrade or downgrade the database
        version: 1,
        singleInstance: true);
    return _database!;
  }
}

• Hàm onCreate() được gọi tại lần đầu mà database được khởi tạo
• Version chính là phiên bản của database, nếu bạn muốn thay đổi cấu trúc của database thì chúng ta phải thay đổi version.

Tiếp theo ta thêm các hàm phục vụ cho việc chuyển đổi dữ liệu khi muốn thêm vào database cũng như lấy dữ liệu ra từ database

class Student{
...

Map<String, dynamic> toMap() => {'id': id, 'name': name, 'grade': grade};

factory Student.fromMap(Map<String, dynamic> map) {
  return Student(id: map['id'], name: map['name'], grade: map['grade']);
}
...
}

Ở đây mình có viết thành một project CRUD, với các phân tần giữa data và UI rõ ràng, để có thể hiểu hơn về project này hãy đọc đến cuối bài viết.

2.3. Thêm một trường dữ liệu vào bảng

Future<DataResult> insertStudent(Student student, String tableName) async {
    try{
      Database db = await StudentDatabase.getInstance();
      int lastInsertedRow = await db.insert(tableName, student.toMap(),
          conflictAlgorithm: ConflictAlgorithm.replace);
      return DataResult.success(lastInsertedRow);
    }catch(ex){
      return DataResult.failure(DatabaseFailure(ex.toString()));
    }
  }

• Hàm insert() có hai tham số truyền vào là tên của bảng và dữ liệu chúng ta muốn thêm vào bảng, dữ liệu này đã được chuyển thành một map để có thể thực hiện thêm vào database.
• Tham số conflictAlgorithm: được sử dụng để xác định các xử lý khi có sự trùng lặp dữ liệu xảy ra, ở đây tham số này có giá trị là ConflictAlgorithm.replace có nghĩa là nếu trùng primary key thì giá trị cũ sẽ được thay thế bằng giá trị mới.
• Nếu hàm insert thực hiện thành công sẽ trả về id của hàng vừa được thêm.
• Nếu không thành công sẽ trả về giá trị 0.

2.4. Lấy thông tin của tất cả các trường

Trong Android Studio có một công cụ hỗ trợ chúng ta xem được các cơ sở dữ liệu đang có trong app, đó chính là App Inspection

Tại đây chúng ta có thể thấy được bảng “student” đã được thêm 33 trường dữ liệu, vậy bây giờ chúng ta muốn lấy tất cả những dữ liệu này ra thì phải làm thế nào?

Future<DataResult> getAllStudent() async{
    try{
      Database db = await StudentDatabase.getInstance();
      final List<Map<String,dynamic>> maps = await db.query("student");
      List<Student> students = maps.map((e) => Student.fromMap(e)).toList();
      return DataResult.success(students);
    }catch(ex){
      return DataResult.failure(DatabaseFailure(ex.toString()));
    }
  }

Chúng ta chỉ cần sử dụng hàm query, truyền vào tham số là bảng mà chúng ta cần lấy dữ liệu.

• Dữ liệu trả về sẽ ở dạng List<Map<String,dynamic>>, vì vậy chúng ta cần chuyển đổi chúng sang dạng của lớp Student sử dụng hàm fromMap() đã được thêm trong class Student

2.5. Thay đổi thông tin của một trường.

Future<DataResult> updateStudent(Student student) async{
    try{
      Database db = await StudentDatabase.getInstance();
      int numberOfChanges = await db.update("student", student.toMap(),where: "id = ?",whereArgs: [student.id]);
      return DataResult.success(numberOfChanges);
    }catch(ex){
      return DataResult.failure(DatabaseFailure(ex.toString()));
    }
  }

Để thực hiện được việc thay đổi dữ liệu của một trường chúng ta cần sử dụng hàm update()

• Các tham số truyền vào gồm có tên bảng, dữ liệu thay đổi (được chuyển sang map), điều kiện thay đổi và tham số cho điều kiện đó.
• Có thể thấy phần thay đổi dữ liệu này khá giống với phần thêm dữ liệu, chỉ khác chúng ta có thêm hai tham số khá quan trọng là “where” và “whereArgs”.
• Giá trị trả về của hàm update() là số lượng thay đổi đã diễn ra.

2.6. Xóa thông tin của một trường

Future<DataResult> deleteStudent(int id) async{
    try{
      Database db = await StudentDatabase.getInstance();
      int numberOfRowEffected = await db.delete("student",where: "id = ?",whereArgs: [id]);
      return DataResult.success(numberOfRowEffected);
    }catch(ex){
      return DataResult.failure(DatabaseFailure(ex.toString()));
    }
  }

Để thực hiện việc xóa dữ liệu chúng ta sẽ cần dùng đến hàm delete()

• Gần giống với hàm update chúng ta cũng cần có hai tham số “where” và “whereArgs”
• Giá trị trả về sẽ là hàng bị thay đổi giá trị.

III. Tổng kết

Phần Sql này khá là khó và khô khan đối với những người mới học, mới tiếp cận, vì vậy mọi người cần luyện tập thêm để trở nên master phần này nhé.

Link github của project mình tự làm cho mọi người tham khảo: lamdev99/sqflite_crud (github.com)

Tài liệu tham khảo:

• sqflite | Flutter Package (pub.dev)
• Persist data with SQLite | Flutter

Author: LamNT59

[FLUTTER] Cách viết Unit Test trong Flutter (Phần 2)

Lời ngỏ

Mỗi ngôn ngữ, hay framework đều có các cách để triển khai Unit Test khác nhau. Tuy nhiên trong bài viết này mình sẽ chú trọng vào Unit Test trong Flutter.

B. Cách triển khai Unit Test trong Flutter

1. Cài đặt thư viện

Để có thể viết Unit Test trong Flutter, chúng ta cần thêm thư viện test, nhớ thêm vào phần dev_dependencies nhé.

2. Cấu hình và giải thích

• Đầu tiên chúng ta tạo một hàm xử lý để giả định cho một chức năng trong app

class Calculation{
  int add(int a, int b){
    return a+b;
  }
  int subtract(int a, int b){
    return a-b;
  }
}

• Trong class Calculation, chúng ta có hàm xử lý là hàm “add”,”subtract”, đây chính là hàm chúng ta cần viết unit test. Bước tiếp theo là tạo một class để viết unit test.

• Ở trong phần package tree của project chúng ta sẽ thấy một package tên là “test”.

Đây sẽ là nơi chúng ta viết các unit test cho ứng dụng.

Có thể thấy ở bên trong folder này đã có một class được viết sẵn có tên là “widget_test.dart”, đây sẽ là class dùng trong việc test các widget của ứng dụng.

• Chúng ta tạo thêm một file đặt tên là “calculation_test” (Hãy đặt tên của file theo những chức năng, lớp mà chúng ta muốn test để dễ trong việc phân biệt và tìm kiếm.

• Chúng ta tạo một class “main”, bên trong sẽ viết các hàm unit test

import 'package:flutter_test/flutter_test.dart';
import 'package:unit_test_sample/calculation.dart';

void main(){
  /// Init class which needs tested
  Calculation calculation = Calculation();
  /// Test function add
  test("Sum of two integer ", () {
    int result = calculation.add(5, 4);
    expect(result, 9);
  });
}

• Ở đây ta sử dụng hàm “test” để viết các unit test cho từng chức năng.

Hàm “test” này có 2 tham số cần truyền vào đó là:

• Mô tả của test, nơi chúng ta có thể mô tả xem hàm test này đang test chức năng nào, hoặc có thể bổ sung thêm một vài mô ta cho input chúng ta truyền vào (ví dụ như input đó bị lỗi, sai, hay đúng).
• Tham số còn lại chính là một hàm, ở đây chúng ta sẽ viết các bước để có thể gọi được đến hàm cần test (ở đây là hàm “add”), cuối cùng chúng ta sử dụng hàm “expect” để kiểm tra kết quả của hàm test với kết quả mà chúng ta mong đợi. Tham số đầu tiên sẽ là kết quả của hàm được test, tham số còn lại là kết quả mà chúng ta mong muốn.

Như vậy phần chuẩn bị hàm test đã xong, giờ việc chúng ta cần làm là chạy thôi:

• Ấn chuột phải rồi chọn “run test in calculation” hoặc ấn tổ hợp phím Ctrl + Shift + F10:
• Sau một lúc chạy thì ở phía dưới sẽ hiển thị một màn hình kết quả test:

Nếu có tick xanh ở trước mô tả “Sum of two integer”, có nghĩa là test của chúng ta đã chạy đúng như mong đợi.

Thử thay đổi kết quả mong đợi để xem chuyện gì xảy ra:

test("Sum of two integer ", () {
    int result = calculation.add(5, 4);
    expect(result, 8);
  });

Ngay lập tức test của chúng ta đã chạy sai, trong phần log lỗi cũng đã chỉ ra cho chúng ta biết chúng ta sai ở đâu.

• Expected (kết quả mong đợi) là 8 trong khi Actual (kết quả được tính toán) là 9, từ đó chúng ta sẽ rất dễ dàng trong việc fix lỗi.

Khi có nhiều hàm test cùng liên quan đến một vấn đề, chúng ta có thể cho chúng vào trong một “group” để dễ quản lý hơn.

void main() {
  /// Init class which needs tested
  Calculation calculation = Calculation();
  group(
    "Calculate with integer",
    () {
      /// Test function add
      test("Sum of two integer ", () {
        int result = calculation.add(5, 4);
        expect(result, 9);
      });

      /// Test function subtract
      test("Subtraction of two integer ", () {
        int result = calculation.subtract(5, 4);
        expect(result, 1);
      });
    },
  );
}

Và khi chạy lên chúng ta sẽ được kết quả như sau:

3. Tài liệu tham khảo

• An introduction to unit testing | Flutter

Chúc các bạn luôn nhìn thấy một màu xanh lá khi chạy Unit Test

Tác giả: LamNT59

[FLUTTER] Cách viết Unit Test trong Flutter (Phần 1)

Lời ngỏ

Unit Test là một phần rất quan trọng trong quá trình phát triển phần mềm, tuy nhiên nó thường xuyên bị lãng quên với một lập trình viên mới vào nghề hoặc chưa có nhiều kinh nghiệm. Mong rằng bài viết sẽ giúp bạn có cái nhìn trực quan hơn về Unit Test tron phát triển phầm mềm, đặc biệt là trong Flutter.

A. Đôi điều về Unit Test

1. Unit Test là gì?

Unit Test là một loại kiểm thử phần mềm trong đó các đơn vị hay thành phần riêng lẻ của phần mềm được kiểm thử. Kiểm thử đơn vị được thực hiện trong quá trình phát triển ứng dụng. Mục tiêu của Kiểm thử đơn vị là cô lập một phần code và xác minh tính chính xác của đơn vị đó.

Nếu khái niệm trên vẫn còn khá khó hiểu thì hãy thử tách nghĩa từng từ ra một nhé:

• Unit là một thành phần Phần mềm nhỏ nhất mà ta có thể kiểm tra được như các hàm (Function), thủ tục (Procedure), lớp (Class), hoặc các phương thức (Method).
• Test thì là kiểm thử, kiểm tra tính chính xác của một cái gì đó.

Đến đây thì chắc các bạn cũng đã có cho mình một chút khái niệm về Unit Test rồi đúng không nhỉ.

Thường các lập trình viên khi nghe về một khái niệm mà trong đó có từ “Test” thì điều mọi người sẽ nghĩ đến ngay đó là “Test là công việc của Tester đâu phải việc của mình nên mình không cần quan tâm :v”.

Nhưng KHÔNG, các bạn đã nhầm to. Unit Test sẽ phải được viết bởi các lập trình viên, bởi chính những người viết ra những dòng code đó.

2. Vòng đời của Unit Test

Vòng đời của Unit Test gồm 3 giai đoạn:

• Fail (trạng thái lỗi).
• Ignore (tạm ngừng thực hiện).
• Pass (trạng thái làm việc).

Ba giai đoạn này sẽ thay phiên nhau làm việc khi một Unit Test được chạy tự động.

3. Unit Test quan trọng không và khi nào thì cần viết Unit Test?

Unit Test là một phần không thể thiếu trong quá trình phát triển phần mềm. Unit Test đem lại cho chúng ta rất nhiều lợi ích:

• Tạo ra một môi trường để kiểm tra bất kỳ đoạn code nào, duy trì sự ổn định của phần mềm. Unit Test giúp chúng ra kiểm tra những kết quả trả về mong muốn cũng như những ngoại lệ mong muốn.
• Phát hiện các lỗi, các xử lý không hiệu quả trong code, các vấn đề về thiết kế.
• Việc viết Unit Test có thể coi như việc tạo một người dùng đầu tiên cho ứng dụng, từ đó chúng ta có thể biết được những vấn đề mà trong quá trình sử dụng ứng dụng người dùng có thể gặp phải.
• Giúp cho quá trình phát triển phần mềm trở nên nhanh hơn, số lượng test case khi được test cũng sẽ pass nhiều hơn. Điều này giúp cho các bộ phận khác như QA, Tester làm việc sẽ nhàn hơn. Và trên hết đối với những coder chúng ta, việc ít phải đối mặt với Tester cũng làm cho buổi làm việc “bớt sóng gió” hơn đúng không nào?

Note

Viết Unit Test càng sớm càng tốt trong giai đoạn viết code và xuyên suốt chu kỳ Phát triển phần mềm.

4. Như nào là một Unit Test có giá trị?

Muốn viết một Unit Test hiệu quả, đem lại nhiều lợi ích nhất cho bản thân cũng như dự án thì cần chú ý những điểm sau:

• Unit Test chạy nhanh, sử dụng dữ liệu dễ hiểu, dễ đọc.

• Hãy làm cho mỗi test độc lập với những phần khác. Mỗi test chỉ nên liên quan đến một hàm, thủ tục, … Điều này sẽ giúp chúng ta dễ dàng hơn trong quá trình quản lý unit test, cũng như đáp ứng được các thay đổi trong code.
• Giả lập tất cả các dịch vụ và trạng thái bên ngoài. Ví dụ: Nếu bạn có làm việc với Database, thì KHÔNG nên sử dụng database thật của ứng dụng để viết Unit Test, bởi vì giá trị trong đó sẽ có thể thay đổi và ảnh hưởng đến các kết quả mong đợi của bạn. Thay vào đó hay tự vào cho mình một fake database, với dự liệu có sẵn và chỉ sử dụng các hàm, thủ tục để làm việc với nó.
• Nên đặt tên các đơn vị kiểm thử rõ ràng và nhất quán với nhau để đảm bảo rằng test case dễ đọc. Để bất kỳ ai cũng có thể khởi chạy test case mà không gặp phải trở ngại.
• Triển khai Unit Test bao quát hết tất cả các ngoại lệ, các test case.

B. Cách triển khai Unit Test trong Flutter (Còn tiếp)

Nguồn tham khảo:

• Unit Test là gì? Khái niệm và vai trò | TopDev

Tác giả: LamNT59