sschmid / floc-reflection

Reflection for Objective-C.

Floc Reflection

Description

Floc Reflection is a set of class methods to easily inspect objects in Objective-C.

How to use Floc Reflection

Inspect an object

Car *car = [[Car alloc] init];

BOOL isClass = [FLReflection isClass:car];
BOOL isProtocol = [FLReflection isProtocol:car];
BOOL isBlock = [FLReflection isBlock:car];
BOOL isInstance = [FLReflection isInstance:car];

NSLog(@"isClass = %d", isClass);        // NO
NSLog(@"isProtocol = %d", isProtocol);  // NO
NSLog(@"isBlock = %d", isBlock);        // NO
NSLog(@"isInstance = %d", isInstance);  // YES

Get all property names of a class

NSArray *propertyNames = [FLReflection getAllPropertyNamesOfClass:[Car class]];
NSLog(@"propertyNames = %@", propertyNames);  // [@"wheel", @"engine"]

Get the property type of a class

// returns class 'Wheel'
id wheelType = [FLReflection getTypeForProperty:@"wheel"
                                        ofClass:[Car class]];

// returns protocol <Engine>
id engineType = [FLReflection getTypeForProperty:@"engine"
                                         ofClass:[Car class]];

Install Floc Reflection

You find the source files you need in Floc-Reflection/Classes.

CocoaPods

Install CocoaPods and add the Floc Reflection reference to your Podfile

platform :ios, '5.0'
  pod 'Floc-Reflection'
end

Install Floc Reflection

$ cd path/to/project
$ pod install

Open the created Xcode Workspace file.

floc-reflection's Issues

Don't use exceptions

Please do not use exceptions for something that's not absolutely fatal as this is against general ObjC principles, instead return nil or return the error through and options NSError parameter.

It is common for people to have "Break on All Exceptions" activated in Xcode as an early eject for critical problems that will happen later that are difficult to debug. In this case it's something that can and should be handled gracefully by testing the return value.