Back to Repositories

Validating Array Resource Binding Integration in ButterKnife

This test suite validates the BindArray functionality in Butterknife, focusing on array resource binding capabilities. It verifies the correct binding and unbinding of different array types including string, integer, and character sequence arrays in an Android context.

Test Coverage Overview

The test suite provides comprehensive coverage of array binding functionality in Butterknife.

Key areas tested include:

String array binding and persistence
Integer array resource binding
CharSequence array handling
Proper unbinding behavior for all array types

Integration points focus on Android resource system interaction and view binding lifecycle.

Implementation Analysis

The testing approach utilizes JUnit with Android Instrumentation framework to validate array resource binding. Each test case follows a consistent pattern of creating targets, binding resources, verifying values, and checking unbinding behavior.

Framework-specific features leverage:

ButterKnife.bind() for resource injection
InstrumentationRegistry for context access
Truth assertion library for precise comparisons

Technical Details

Testing tools and configuration:

JUnit test framework
Android Instrumentation TestRunner
Google Truth assertion library
Custom ViewTree implementation
ButterKnife annotation processing
Android resource system integration

Best Practices Demonstrated

The test suite exemplifies high-quality integration testing practices.

Notable implementations include:

Isolated test cases for each array type
Proper resource cleanup through unbinding
Consistent test structure and naming
Effective use of static inner classes for test targets
Comprehensive validation of binding states

jakewharton/butterknife

butterknife-integration-test/src/androidTest/java/com/example/butterknife/functional/BindArrayTest.java

            
package com.example.butterknife.functional;

import android.content.Context;
import android.view.View;
import androidx.test.InstrumentationRegistry;
import butterknife.BindArray;
import butterknife.ButterKnife;
import butterknife.Unbinder;
import com.example.butterknife.test.R;
import org.junit.Test;

import static com.google.common.truth.Truth.assertThat;

public final class BindArrayTest {
  private final Context context = InstrumentationRegistry.getContext();
  private final View tree = ViewTree.create(1);

  static class StringArrayTarget {
    @BindArray(R.array.string_one_two_three) String[] actual;
  }

  @Test public void asStringArray() {
    StringArrayTarget target = new StringArrayTarget();
    String[] expected = context.getResources().getStringArray(R.array.string_one_two_three);

    Unbinder unbinder = ButterKnife.bind(target, tree);
    assertThat(target.actual).isEqualTo(expected);

    unbinder.unbind();
    assertThat(target.actual).isEqualTo(expected);
  }

  static class IntArrayTarget {
    @BindArray(R.array.int_one_two_three) int[] actual;
  }

  @Test public void asIntArray() {
    IntArrayTarget target = new IntArrayTarget();
    int[] expected = context.getResources().getIntArray(R.array.int_one_two_three);

    Unbinder unbinder = ButterKnife.bind(target, tree);
    assertThat(target.actual).isEqualTo(expected);

    unbinder.unbind();
    assertThat(target.actual).isEqualTo(expected);
  }

  static class CharSequenceArrayTarget {
    @BindArray(R.array.int_one_two_three) CharSequence[] actual;
  }

  @Test public void asCharSequenceArray() {
    CharSequenceArrayTarget target = new CharSequenceArrayTarget();
    CharSequence[] expected = context.getResources().getTextArray(R.array.int_one_two_three);

    Unbinder unbinder = ButterKnife.bind(target, tree);
    assertThat(target.actual).isEqualTo(expected);

    unbinder.unbind();
    assertThat(target.actual).isEqualTo(expected);
  }
}