7 |
8 | @interface OCMockRecorder : NSProxy
9 | {
10 | id signatureResolver;
11 | NSInvocation *recordedInvocation;
12 | NSMutableArray *invocationHandlers;
13 | }
14 |
15 | - (id)initWithSignatureResolver:(id)anObject;
16 |
17 | - (BOOL)matchesInvocation:(NSInvocation *)anInvocation;
18 | - (void)releaseInvocation;
19 |
20 | - (id)andReturn:(id)anObject;
21 | - (id)andReturnValue:(NSValue *)aValue;
22 | - (id)andThrow:(NSException *)anException;
23 | - (id)andPost:(NSNotification *)aNotification;
24 | - (id)andCall:(SEL)selector onObject:(id)anObject;
25 | #if NS_BLOCKS_AVAILABLE
26 | - (id)andDo:(void (^)(NSInvocation *))block;
27 | #endif
28 | - (id)andForwardToRealObject;
29 |
30 | - (NSArray *)invocationHandlers;
31 |
32 | @end
33 |
--------------------------------------------------------------------------------
/ModelViewPresenterDemo/OCMocksLibs/libOCMock.a:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/dgadd/iOSModelViewPresenter/d07d26b8f18073f0f917afef32f3b68fee194862/ModelViewPresenterDemo/OCMocksLibs/libOCMock.a
--------------------------------------------------------------------------------
/README.markdown:
--------------------------------------------------------------------------------
1 | Model-View-Presenter Example in iOS
2 |
3 |
4 | NOTE This sample code demonstrates only ONE method in the presenter class, a method to push an array of book titles to the view. In a typical, busy view controller with multiple events being handled, the underlying presenter class might have many methods to serve each of these activities.
5 |
6 |
7 |
8 | Over time, I will try and add additional presenter methods to this example.
9 |
10 |
11 |
12 |
13 | Explanation of Model-View-Presenter (used with protocols in iOS)
14 |
15 | MVP is a solution to the age-old problem of business logic and external coordination concerns slipping into the presentation layer. The view controllers in iOS are largely concerned with serving the view, either by listening for events and handling them (typically through delegate methods or IBAction methods), or by assigning information to properties. But it is difficult to prevent the rest of the application's concerns slipping into this layer by default.
16 |
17 |
18 |
19 | The best way to prevent this is by writing unit tests against the view controller. However, the view controller has many concerns and couplings that would make truly isolated unit-tests difficult.
20 |
21 |
22 |
23 | The Model-View-Presenter pattern addresses this by creating a new, simple class called a presenter, with no direct dependencies on any concerns above it (presentation) or below it (business logic, IO, data). The Presenter achieves this by only operating against protocols (interfaces in java/C#) which have been injected into the constructor (alloc/init) of the class. Unit tests use a combination of mock objects (that observe and verify behavior), stubs (simple auto-generated implementations of the protocol) or fully-created fake classes to verify the behavior of the presenter, without ever directly connecting to the view controller or underlying data sources.
24 |
25 |
26 |
27 | In this example code, the implementation of Model-View-Presenter uses:
28 |
29 | - groups that store Presenters, Views, Models (and also: Repositories and ViewControllers)
30 | - the Presenter init takes as parameters protocols (in Java and C#, this would be interfaces)
31 | - the first parameter is a protocol for a repository (to query and return the Model)
32 | - the second parameter is a protocol for the View (to receive content that is pushed to it, and to notify of events that it has received)
33 | - the Model group is empty; the model in this implementation is merely an NSString* (a book title)
34 |
35 |
36 |
37 |
38 | The first unit test in this sample code uses mock objects to design and verify the behavior of the presenter methods. These methods coordinate the actions of the protocols that have been dependency-injected into the presenter's init. Specifically, the test verifies its expectation that the presenter's displayBooksFromBookstore method will:
39 |
40 | - find all books from the book store repository
41 | - "push" those books to the view
42 |
43 |
44 |
45 |
46 | The second unit test uses a fake class to verify that data passed through the presenter matches as expected.
47 |
48 |
49 |
50 | Finally: What should the view controller look like when Model-View-Presenter is used?
51 |
52 |
53 |
54 | It should have 4 main effects:
55 |
56 | - An init or early event in the view controller should instantiate the presenter, passing in "self" as the conforming view protocol
57 | - your view controller will still have lots of methods--filled with the event handling and delegate fulfilment methods that are typically required for an objective-C application. But the CONTENT of those methods will have changed.
58 | - these methods should now contain only presentation logic. For example, the table row event will still have to retrieve the cell by its identifier and assign values to the cell's contents--those are a presentation-level concern
59 | - but any non-presentation logic (coordination logic, business logic, model manipulation) will now be passed to presenter methods instead.
60 |
61 |
62 |
63 |
64 | And those presenter methods will now be isolated/decoupled and therefore can (and should) each be verified and validated by mock and unit tests.
65 |
--------------------------------------------------------------------------------