[Cocoa] NSValueTransformer

Value Transformer

코코아 바인딩에서 어떤 키패스의 값을 그대로 사용하는 것이 아니라 다른 단위로 변환하는 등의 변화를 주고 사용해야 한다면 중간에 어떤 매개체가 값을 바꿔서 전달해주는 역할을 하도록 해야 한다. 예를 들어 섭씨 온도를 표시하는 텍스트 필드와 화씨 온도로 조절하는 슬라이드가 있고 이 들을 코코아 바인딩으로 구현하고자 한다면, (물론 모델 객체의 두개의 프로퍼티를 각각 만들고 여기에 바인딩해도 되지만) NSValueTransformer를 사용하여 값 변환 장치를 만들어 사용할 수 있다.

사용하는 일이 흔하지는 않지만, 파운데이션 프레임워크는 이런 값 변환기를 몇 개 가지고 있으며 개발자는 NSValueTransformer를 서브클래싱하여 이런 변환기를 만들 수 있다.

코코아 바인딩에서 모델의 어떤 값이 UI요소에 표현될 때, 변환기를 거치게 되면 변환된 값이 표시된다. 즉 UI요소에 setObjectValue: 메시지가 전달되기 직전에 변환기의 transformedValue: 를 거친다.

이와 반대로 사용자가 인터페이스를 조작하여 값을 변경한 경우에는 다시 reverseTransformedValue: 를 거쳐 역변환된 값이 모델에 전달된다.

변환기를 만들기 위해서는 +transformedValueClass, +allowReverseTransformtion, -transformedValue: 세 개의 메소드를 구현하면 된다. 그리고 역변환을 지원하려면 reverseTransformedValue: 메소드도 구현해야 한다.

화씨 온도를 섭씨 온도로 변환하는 변환기를 만드는 과정을 간단히 살펴보겠다.

반환값의 클래스 정의하기

+(Class)transformedValueClass
{
    return [NSNumber class];
}

역변환 여부 결정

+(BOOL)allowsReverseTransformation
{
    return YES;
}

값 변환하는 부분

-(id)transformedValue:(id)value
{
    float fahrenheitInputValue, celsiusOutputValue;
    if (value == nil) return nil;

    if([value respondsToSelector:@selector(floatValue)]) {
        fahrenheitInputValue = [valeu floatValue];
    } else {
        [NSException raise:NSInternalInconsistencyException
            format:@"Value (%@) does not respond to -floatValue.",[value class]];
    }

    celsiusOutputValue = (5.0/9.0) * (fahrenheitInputValue - 32.0);
    return [NSNumber numberWithFloat:celsiusOutputValue];
}

역변환하기

역변환도 동일한 로직으로 작성한다.

-(id)reverseTransformedValue:(id)value
{
    float celsiusInputValue, fahrenheitOutputValue;
    if (value == nil) return nil;

    if([value respondsToSelector:@selector(floatValue)]) {
        celsiusInputValue = [valeu floatValue];
    } else {
        [NSException raise: NSInternalInconsistencyException
            format: @"Value (%@) does not respond to -floatValue.",[value class]];
    }

    celsiusOutputValue = (5.0/9.0) * (fahrenheitOutputValue - 32.0);
    return [NSNumber numberWithFloat:celsiusOutputValue];
}

기본 변환기들

다음 변환기들은 파운데이션이 제공하는 기본 변환기들이다.

  • NSNegateBooleanTransformerName – 특정값을 부정하는 boolean 값을 담은 NSNumber 객체를 내어준다.
  • NSIsNilTransformerName – 입력값이 nil 이면 YES를 담은 NSNumber를 준다.
  • NSIsNotNilTransformerName – 입력값이 nil이 아니면 YES를 담은 NSNumber를 준다.
  • NSUnarchiveFromDataTransformerName – NSData를 언아카이빙하여 그 객체를 반환한다. NSUserDefaultsController와 함께 주로 사용한다.
  • NSKeyedUnarchiveFromDataTransformerNameKeyed archiving을 사용해 직렬화된 객체를 언아카이브할 때 사용한다.