Flutter Equatable의 이해

원래는 Bloc에 대해서 자세하게 작성하고 싶었지만, Bloc에 대한 내용을 잘 정리하기엔 아직 초보 플러터 개발자의 입장에서 조금 더 내용의 구체화가 필요하다고 생각이 들었다.

그래서 Bloc 공식문서 예제에 자주 등장하는 Equtable 이라는 라이브러리가 나오는데 이 라이브러리에 대해서 어떤 역할을 하고 왜 사용하는게 좋은지

이 부분도 알고 넘어가면 좋을 것 같아서 자세하게 공부해봤다.

1. Equatable이란?

Equatable은 Dart와 Flutter에서 객체 간의 값 비교를 쉽게 구현할 수 있도록 도와주는 패키지이다.

그냥 값들을 비교하면 되는거 아니야? 라고 생각할 수 있지만 전혀 아니다.

Dart에서는 기본적으로 두 객체를 비교할 때 참조 동등성(reference equality)를 사용한다.

한마디로 두 객체가 동일한 메모리 주소를 가리킬 때만 같다고 판단한다.

그래서 객체 안의 값이 같다고 하더라도 실제로 두 객체가 다른 메모리 주소를 가리키고 있기 때문에 다르다고 판단한다.

하지만 Equatable을 사용하면 값 동등성(value equality)을 쉽게 구현할 수 있다.

즉 객체의 속성 값이 같다면 두 객체를 같다고 판단할 수 있게 된다.

 

1.1 왜 Equatable이 필요할까?

일반적인 Dart 클래스에서는 동일한 값을 가진 두 객체를 비교할 때 문제가 발생한다.

아래의 예제를 보면

class Person {
  final String name;
  final int age;

  Person(this.name, this.age);
}

void main() {
  final person1 = Person('hsungjin', 27);
  final person2 = Person('hsungjin', 27);

  print(person1.name == person2.name); // true  
  print(person1.age == person2.age); // true
  print(person1 == person2); // false
}

위 코드에서 person1과 person2는 같은 값을 가지고 있지만, == 연산자는 false를 반환한다.

아니 왜 person1 과 person2 가 다른거지?

이는 위에서 설명했듯이 Dart에서는 값이 같더라도 실제로 두 객체가 서로 다른 메모리 주소를 참조하고 있기 때문이다.

만약 Equtable을 사용하지 않고 비교를 하려면 조금 복잡해질 수 있다.

두 값에 대한 hashCode를 비교하는 방법이 있으로 구현해야 한다.

 

class Person {
  final String name;
  final int age;

  const Person(this.name, this.age);

  @override
  bool operator ==(Object other) =>
    identical(this, other) ||
    other is Person &&
    runtimeType == other.runtimeType &&
    name == other.name &&
    age == other.age;

  @override
  int get hashCode => name.hashCode ^ age.hashCode;
}

void main() {
  final person1 = Person('hsungjin', 27);
  final person2 = Person('hsungjin', 27);

  print(person1 == person2); // true
}

하지만 Equatable을 사용하면 이러한 문제를 해결할 수 있다.

 

2. Equatable 사용하기

 

2.1 기본 사용법

Equatable을 사용하려면 먼저 pubspec.yaml에 의존성을 추가해야 한다

dependencies:
  equatable: ^2.0.7

그런 다음 클래스에 Equatable을 적용할 수 있다.

 

import 'package:equatable/equatable.dart';

class Person extends Equatable {
  final String name;
  final int age;

  const Person(this.name, this.age);

  @override
  List<Object> get props => [name, age];
}

void main() {
  final person1 = Person('hsungjin', 27);
  final person2 = Person('hsungjin', 27);

  print(person1 == person2); // true
}

Equatable을 사용하면 위와 같이 간단하게 객체 비교를 할 수 있게 해준다.

여기서 주의 해야할 점은 Equatable은 변경 불가능한 객체에서만 작동하도록 설계 되어있으므로 모든 변수가 final로 선언되어야 한다.

 

2.2 props 메서드 이해하기

props getter는 Equatable의 핵심이다.

이 메서드는 객체의 동등성 비교에 사용될 속성들의 리스트를 반환한다.

props에 포함된 속성들만 비교에 사용되므로, 필요한 속성만 포함시키는 것이 중요하다.

class Person extends Equatable {
  final String name;
  final int age;
  final List<String> hobbies;
  final DateTime birthDate;

  const Person({
    required this.name,
    required this.age,
    required this.hobbies,
    required this.birthDate,
  });

  @override
  List<Object> get props => [name, age, hobbies, birthDate];

  // JSON 형식의 작업을 해야 할 경우
  factory Person.fromJson(Map<String, dynamic> json) {
    return Person(
      name: json['name'],
      age: json['age'],
      hobbies: json['hobbies'],
      birthDate: json['birthDate'],
    );
  }
}

 

3. Equatable의 추가적인 기능들

 

3.1 hashCode 자동 생성

Equatable은 props에 정의된 속성들을 기반으로 자동으로 hashCode를 생성한다.

이는 객체를 Set이나 Map의 키로 사용할 때 유용하다

void main() {
  final person1 = Person('hsungjin', 27);
  final person2 = Person('hsungjin', 27);

  print(person1.hashCode == person2.hashCode); // true

  final set = {person1, person2};
  print(set.length); // 1 (중복이 제거됨)

  final map = {person1: 'hsungjin', person2: 'hsungjin'};
  print(map.length); // 1 (중복이 제거됨)
}

 

3.2 toString()

Equatable은 디버깅을 위한 유용한 toString() 메서드를 제공한다.

이를 통해 객체의 상태를 쉽게 확인할 수 있다

class Person extends Equatable {
  final String name;
  final int age;

  const Person(this.name, this.age);

  @override
  List<Object> get props => [name, age];

  @override
  String toString() => 'Person(name: $name, age: $age)';
}

void main() {
  final person = Person('hsungjin', 27);
  print(person); // Person(name: hsunjin, age: 27)
}

 

3.3 불변성(Immutability) 보장

Equatable을 사용할 때는 클래스를 불변(immutable)으로 만드는 것이 권장된다.

불변성을 통해 객체의 상태가 변경되지 않음을 보장할 수 있다.

class ImmutablePerson extends Equatable {
  final String name;
  final int age;

  // const 생성자 사용
  const ImmutablePerson(this.name, this.age);

  @override
  List<Object> get props => [name, age];
}

 

4. 사용 예제

 

4.1 Bloc 패턴에서의 활용

Bloc 패턴이나 다른 상태 관리 솔루션에서 Equatable은 매우 유용하다.

상태 객체의 동등성을 쉽게 비교할 수 있어 상태 변화 감지에 효과적이다.

abstract class AuthState extends Equatable {
  const AuthState();
}

class AuthInitial extends AuthState {
  @override
  List<Object> get props => [];
}

class AuthLoading extends AuthState {
  @override
  List<Object> get props => [];
}

class AuthAuthenticated extends AuthState {
  final String username;

  const AuthAuthenticated(this.username);

  @override
  List<Object> get props => [username];
}

 

4.2 테스트에서의 활용

Equatable은 테스트 작성을 더 쉽게 만들어 준다.

객체의 동등성을 쉽게 비교할 수 있어 테스트 코드가 간결해진다.

void main() {
  test('두 Person 객체가 같은 값을 가질 때 동등해야 함', () {
    final person1 = Person('hsungjin', 27);
    final person2 = Person('hsungjin', 27);

    expect(person1, equals(person2));
  });

  test('두 Person 객체가 다른 값을 가질 때 동등하지 않아야 함', () {
    final person1 = Person('hsungjin', 27);
    final person2 = Person('hsungjin', 28);

    expect(person1, isNot(equals(person2)));
  });
}

 

5. 고려사항

Equatable은 매우 효율적이지만, 몇 가지 고려해야 할 사항이 있다.

 

필요한 속성만 참조하기

props에는 동등성 비교에 실제로 필요한 속성만 포함해야 한다.

불필요한 속성을 포함하면 성능에 영향을 줄 수 있다

class User extends Equatable {
  final String id;
  final String name;
  final DateTime lastUpdated; // 비교에서 제외할 수 있음

  const User(this.id, this.name, this.lastUpdated);

  @override
  List<Object> get props => [id, name]; // lastUpdated는 제외
}

 

구체적인 비교

Equatable은 표면적인 비교만 수행하므로, 중첩된 객체의 경우 추가적인 처리가 필요할 수 있다. 중첩된 리스트나 맵을 비교할 때는 그에 맞는 처리를 해줘야 한다.

class DeepPerson extends Equatable {
  final String name;
  final List<String> hobbies;

  const DeepPerson(this.name, this.hobbies);

  @override
  List<Object> get props => [name, List<String>.from(hobbies)];
}

 

불필요한 사용 피하기

모든 클래스에 Equatable을 적용하는 것은 좋지 않습니다.

다음과 같은 경우에만 Equatable 사용을 고려하면 좋다.

• 객체의 값 비교가 자주 필요한 경우
• Bloc의 상태(State) 클래스
• 테스트에서 객체 비교가 필요한 경우
• Collection(Set, Map 등)의 키로 사용되는 객체

 

성능 영향

Equatable은 편리하지만 약간의 성능 오버헤드가 있다고 한다.

class ExpensivePerson extends Equatable {
  final String name;
  final List<String> hobbies;

  const ExpensivePerson(this.name, this.hobbies);

  @override
  List<Object> get props => [name, hobbies]; // 매번 새로운 리스트 생성
}

// 개선된 사용 방법
class BetterPerson extends Equatable {
  final String name;
  final List<String> hobbies;

  const BetterPerson(this.name, this.hobbies);

  // 캐시된 props 사용
  static final List<Object> _props = [];

  @override
  List<Object> get props {
    _props
      ..clear()
      ..add(name)
      ..add(hobbies);
    return _props;
  }
}

 

7.3 null 안전성 고려

Equatable을 사용할 때 null 안전성도 고려해야 합니다:

class NullSafePerson extends Equatable {
  const NullSafePerson({this.name, [this.age]});

  final String? name;
  final int? age;

  @override
  List<Object?> get props => [name, age]; // Object? 사용
}

 

6. Equatable vs 수동 구현

때로는 Equatable 대신 직접 == 연산자와 hashCode를 구현하는 것이 더 적절할 수 있다.

class ManualPerson {
  final String name;
  final int age;

  const ManualPerson(this.name, this.age);

  @override
  bool operator ==(Object other) {
    if (identical(this, other)) return true;
    return other is ManualPerson && 
           other.name == name && 
           other.age == age;
  }

  @override
  int get hashCode => name.hashCode ^ age.hashCode;
}

다음과 같은 경우에는 사용을 고려해 봐도 좋다고 한다

• 매우 간단한 클래스의 경우
• 특별한 비교 로직이 필요한 경우
• 성능이 매우 중요한 경우

 

결론

Equatable은 Flutter 애플리케이션에서 객체 비교를 단순화하고 예측 가능하게 만드는 라이브러리이다.

특히 상태 관리나 테스트 작성 시 매우 유용하며, 적절히 사용하면 코드의 품질과 유지보수성을 크게 향상시킬 수 있다.

하지만 모든 클래스에 무분별하게 적용하기보다는 실제로 값 비교가 필요한 경우에만 선택적으로 사용하는 것이 좋다.

또한 불변성과 성능을 고려하여 적절히 설계하는 것이 중요하다.

참조

• Equatable 공식 문서
• Flutter Bloc 라이브러리
• Dart 공식 문서 - Object equality