-
Notifications
You must be signed in to change notification settings - Fork 3
/
listing6.html
executable file
·695 lines (633 loc) · 29.2 KB
/
listing6.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html>
<head>
<!-- BEGIN META TAG INFO -->
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<link rel="home" href="http://developer.apple.com/">
<link rel="find" href="http://developer.apple.com/search/">
<link rel="stylesheet" type="text/css" href="../../documentation/css/adcstyle.css" title="fonts">
<script language="JavaScript" src="../../documentation/js/adc.js" type="text/javascript"></script>
<!-- END META TAG INFO -->
<!-- BEGIN TITLE -->
<title>People - /AppControllerSyncing.m</title>
<!-- END TITLE -->
<script language="JavaScript">
function JumpToNewPage() {
window.location=document.scpopupmenu.gotop.value;
return true;
}
</script>
</head>
<!-- BEGIN BODY OPEN -->
<body>
<!--END BODY OPEN -->
<!-- START CENTER OPEN -->
<center>
<!-- END CENTER OPEN -->
<!-- BEGIN LOGO AND SEARCH -->
<!--#include virtual="/includes/adcnavbar"-->
<!-- END LOGO AND SEARCH -->
<!-- START BREADCRUMB -->
<div id="breadcrumb">
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr>
<td scope="row"><img width="340" height="10" src="images/1dot.gif" alt=""></td>
<td><img width="340" height="10" src="images/1dot.gif" alt=""></td>
</tr>
<tr valign="middle">
<td align="left" colspan="2">
<a href="http://developer.apple.com/">ADC Home</a> > <a href="../../referencelibrary/index.html">Reference Library</a> > <a href="../../samplecode/index.html">Sample Code</a> > <a href="../../samplecode/Cocoa/index.html">Cocoa</a> > <a href="../../samplecode/Cocoa/idxDataManagement-date.html">Data Management</a> > <A HREF="javascript:location.replace('index.html');">People</A> >
</td>
</tr>
<tr>
<td colspan="2" scope="row"><img width="680" height="35" src="images/1dot.gif" alt=""></td>
</tr>
</table>
</div>
<!-- END BREADCRUMB -->
<!-- START MAIN CONTENT -->
<!-- START TITLE GRAPHIC AND INTRO-->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr align="left" valign="top">
<td><h1><div id="pagehead">People</div></h1></td>
</tr>
</table>
<!-- END TITLE GRAPHIC AND INTRO -->
<!-- START WIDE COLUMN -->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr align="left" valign="top">
<td id="scdetails">
<h2>/AppControllerSyncing.m</h2>
<form name="scpopupmenu" onSubmit="return false;" method=post>
<p><strong>View Source Code:</strong>
<select name="gotop" onChange="JumpToNewPage();" style="width:340px"><option selected value="ingnore">Select File</option>
<option value="listing1.html">/AppController.h</option>
<option value="listing2.html">/AppController.m</option>
<option value="listing3.html">/AppControllerExtensions.h</option>
<option value="listing4.html">/AppControllerExtensions.m</option>
<option value="listing5.html">/AppControllerSyncing.h</option>
<option value="listing6.html">/AppControllerSyncing.m</option>
<option value="listing7.html">/Change.h</option>
<option value="listing8.html">/Change.m</option>
<option value="listing9.html">/Constants.h</option>
<option value="listing10.html">/LastNameFilter.h</option>
<option value="listing11.html">/LastNameFilter.m</option>
<option value="listing12.html">/main.m</option>
<option value="listing13.html">/NSArrayExtras.h</option>
<option value="listing14.html">/NSArrayExtras.m</option>
<option value="listing15.html">/NSEventExtras.h</option>
<option value="listing16.html">/NSEventExtras.m</option>
<option value="listing17.html">/TableView.h</option>
<option value="listing18.html">/TableView.m</option></select>
</p>
</form>
<p><strong><a href="People.zip">Download Sample</a></strong> (“People.zip”, 710.5K)<BR>
<strong><a href="People.dmg">Download Sample</a></strong> (“People.dmg”, 1.02M)</p>
<!--
<p><strong><a href="#">Download Sample</a></strong> (“filename.sit”, 500K)</p>
-->
</td>
</tr>
<tr>
<td scope="row"><img width="680" height="10" src="images/1dot.gif" alt=""><br>
<img height="1" width="680" src="images/1dot_919699.gif" alt=""><br>
<img width="680" height="20" src="images/1dot.gif" alt=""></td>
</tr>
<tr>
<td scope="row">
<!--googleon: index -->
<pre class="sourcecodebox">/*
File: AppControllerSyncing.m
Abstract: Part of the People project demonstrating use of the
SyncServices framework
Version: 0.1
Disclaimer: IMPORTANT: This Apple software is supplied to you by Apple
Computer, Inc. ("Apple") in consideration of your agreement to the
following terms, and your use, installation, modification or
redistribution of this Apple software constitutes acceptance of these
terms. If you do not agree with these terms, please do not use,
install, modify or redistribute this Apple software.
In consideration of your agreement to abide by the following terms, and
subject to these terms, Apple grants you a personal, non-exclusive
license, under Apple's copyrights in this original Apple software (the
"Apple Software"), to use, reproduce, modify and redistribute the Apple
Software, with or without modifications, in source and/or binary forms;
provided that if you redistribute the Apple Software in its entirety and
without modifications, you must retain this notice and the following
text and disclaimers in all such redistributions of the Apple Software.
Neither the name, trademarks, service marks or logos of Apple Computer,
Inc. may be used to endorse or promote products derived from the Apple
Software without specific prior written permission from Apple. Except
as expressly stated in this notice, no other rights or licenses, express
or implied, are granted by Apple herein, including but not limited to
any patent rights that may be infringed by your derivative works or by
other works in which the Apple Software may be incorporated.
The Apple Software is provided by Apple on an "AS IS" basis. APPLE
MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION
THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND
OPERATION ALONE OR IN COMBINATION WITH YOUR PRODUCTS.
IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL
OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION,
MODIFICATION AND/OR DISTRIBUTION OF THE APPLE SOFTWARE, HOWEVER CAUSED
AND WHETHER UNDER THEORY OF CONTRACT, TORT (INCLUDING NEGLIGENCE),
STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
Copyright © 2005 Apple Computer, Inc., All Rights Reserved
*/
#import <SyncServices/SyncServices.h>
#import "AppControllerExtensions.h"
#import "AppControllerSyncing.h"
#import "Change.h"
#import "Constants.h"
#import "LastNameFilter.h"
#import "NSArrayExtras.h"
@implementation AppController (Syncing)
//
// ===========================================
// Syncing
//
//
// This function encapsulates the control flow for a sync
// session. It is the callback that has been registered
// in the ISyncSession call to
// beginSessionInBackgroundWithClient:entityNames:target:selector:.
// As documented, it takes an ISyncClient and an ISyncSession
// as its two arguments. If the session is nil, then an
// ISyncSession could not be created, and the function should
// take no action. Also note that this function includes an
// exception handler. This serves as a "top-level" handler
// to catch any exceptions that are raised by the sync process.
//
- (void)performSync:(ISyncClient *)syncClient :(ISyncSession *)syncSession
{
@try {
// Sync session could be nil. If it is, you need to clean up and
// try to create a session again.
if (syncSession) {
[self negotiateSession:syncSession];
[self pushDataForSession:syncSession];
[self pullDataForSession:syncSession];
}
}
@catch (NSException *exception) {
NSLog(@"caught exception: %@: %@", [exception name], [exception reason]);
}
@finally {
[self syncCleanup];
}
}
//
// This method is the sync alert handler registered by the ISyncClient call to
// setSyncAlertHandler:self selector:. It calls sync:, and is therefore
// equivalent in its behavior to the user pressing the "Sync" button in the
// user interface.
//
- (void)client:(ISyncClient *)syncClient willSyncEntityNames:(NSArray *)entityNames
{
[self sync:self];
}
//
// This method registers our schema and client with the sync engine.
// In the case where the client is not already registered, a client
// description for the client is also supplied, which tells the sync
// engine about our client, the schema elements it syncs with, and
// (optionally) about any sync tool we supply.
//
- (ISyncClient *)performRegistrations
{
ISyncManager *syncManager = [ISyncManager sharedManager];
ISyncClient *syncClient;
// Since we are using one of the Sync Services public schemas in this
// application, it is not necessary to register it.
// The contacts schema is guaranteed to be registered automatically.
// If you are not using one of the public schemas, now is the time
// to register it.
//
// [syncManager registerSchemaWithBundlePath:CanonicalContactsSchemaPath];
// See if our sync client has already registered...
if (!(syncClient = [syncManager clientWithIdentifier:ClientIdentifier])) {
// ...and if it hasn't, register it.
syncClient = [syncManager registerClientWithIdentifier:ClientIdentifier descriptionFilePath:
[[NSBundle mainBundle] pathForResource:@"ClientDescription" ofType:@"plist"]];
}
return syncClient;
}
//
// This method helps to negotiate a sync mode for the session. It takes it cues
// from the user interface in this example, but in the case of a "real" app,
// setting the sync mode would probably take some input from application state.
// For instance, if an application has lost part of its data set, it will likely
// wish to perform a refresh sync.
// It is also important to note that this is a "negotiation" process. You ask
// for the mode you want here, but the kind of session you get is really up
// to the sync engine. Later, in the push and pull phases, we will find out
// what the sync engine has decided.
//
- (void)negotiateSession:(ISyncSession *)syncSession
{
switch (m_syncMode) {
case FastSync:
// nothing to do here.
break;
case SlowSync:
[syncSession clientWantsToPushAllRecordsForEntityNames:m_entityNames];
break;
case RefreshSync:
[syncSession clientDidResetEntityNames:m_entityNames];
break;
case PullTheTruth:
// not handled here. must be handled before syncSession starts.
break;
}
}
//
// The push sync phase.
//
- (void)pushDataForSession:(ISyncSession *)syncSession
{
if ([syncSession shouldPushAllRecordsForEntityName:EntityContact]) {
// Slow sync. Push all records we have. Any record not pushed
// in this step that the sync engine has in its store will
// be construed as a delete. Ask for a refresh sync when
// negotiating a sync mode if you do not wish to have records
// you do not push to be considered deletes.
NSEnumerator *enumerator = [m_appRecordsForSession objectEnumerator];
NSDictionary *appRecord;
while ((appRecord = [enumerator nextObject])) {
NSDictionary *syncRecord = [self convertAppRecordToSyncRecord:appRecord];
NSString *identifier = [appRecord objectForKey:IdentifierKey];
[syncSession pushChangesFromRecord:syncRecord withIdentifier:identifier];
}
}
else if ([syncSession shouldPushChangesForEntityName:EntityContact]) {
// Fast sync. Fast syncing requires that you to present the only
// changes since your last sync. Your code must be able to track
// such changes over time if you wish to fast sync. Note how
// this is accomplished in the AppController class using the
// Change object. Conveniently, such Changes objects are also used
// by this application to implement undo/redo.
NSEnumerator *enumerator = [m_changesSinceLastSync objectEnumerator];
Change *change;
while ((change = [enumerator nextObject])) {
switch ([change type]) {
case AddRecord:
case ModifyRecord: {
NSDictionary *appRecord = [change record];
NSString *identifier = [appRecord objectForKey:IdentifierKey];
// Note the conversion from an application record to a sync record.
// Adds and modifies are treated the same: We just push
// the whole record. This seems OK since our records
// are small. If our records were larger, it might make sense
// to push modifications using the pushChange: method on ISyncSession.
NSDictionary *syncRecord = [self convertAppRecordToSyncRecord:appRecord];
[syncSession pushChangesFromRecord:syncRecord withIdentifier:identifier];
break;
}
case DeleteRecord:
// No record conversion needed in the case of a delete. However, fast
// sync requires that we save the identifiers for deleted records so
// we can tell the sync engine about it here.
[syncSession deleteRecordWithIdentifier:[[change oldRecord] objectForKey:IdentifierKey]];
break;
}
}
}
}
//
// The pull sync phase.
//
- (void)pullDataForSession:(ISyncSession *)syncSession
{
// Figure out what to pull. If you are pulling more than one entity type,
// ask for them individually. You cannot make any assumptions about one
// entity type based on the result of shouldPullChangesForEntityName: for
// another entity type.
BOOL shouldPull = [syncSession shouldPullChangesForEntityName:EntityContact];
if (!shouldPull) {
[self syncCleanup];
}
// Determine if we need to replace all data from server. This will return
// YES if pulling the truth. However, it is important to note that you
// should not throw away your data upon receiving a YES response from this
// call. You should wait until a later time, at the very least, you should
// wait until after you call and receive a YES response from
// prepareToPullChangesForEntityNames:beforeDate:. The prepareXXX function
// can return NO or may not return in the time you are willing to wait.
// If you delete your data here and then do not pull, you will wind up
// with no data in your code.
// Again, if you are pulling more than one entity type, ask for them
// individually. you cannot make any assumptions about one entity
// type based on the result of shouldReplaceAllRecordsOnClientForEntityName:
// for another entity type.
if ([syncSession shouldReplaceAllRecordsOnClientForEntityName:EntityContact]) {
m_syncReplaceAllRecords = YES;
}
// Ask the sync engine if it is ready to pull changes. This code is willing
// to wait an indefinite amount of time for this method to return. You may
// wish to have a shorter time out and call this code in a loop.
// Particularly if you are calling this code from the main thread, you may
// wish to provide feedback to the user while waiting for a YES response.
if (![syncSession prepareToPullChangesForEntityNames:m_entityNames beforeDate:[NSDate distantFuture]]) {
[self syncFailed:syncSession error:nil];
return;
}
// Now that prepareToPullChangesForEntityNames:beforeDate: has been called, it is
// OK to delete data here when pulling the truth. Optionally, you could wait until
// all the new records are pulled before deleting your local store, but you should
// wait at least this long.
if (m_syncReplaceAllRecords)
[m_appRecordsForSession removeAllObjects];
// Now do the actual pulling.
NSEnumerator *changeEnumerator = [syncSession changeEnumeratorForEntityNames:m_entityNames];
ISyncChange *change;
while ((change = [changeEnumerator nextObject])) {
NSString *identifier = [change recordIdentifier];
[m_pulledIdentifiers addObject:identifier];
switch ([change type]) {
case ISyncChangeTypeAdd: {
NSDictionary *syncRecord = [change record];
// Note the conversion of sync record to application record.
NSDictionary *appRecord = [self convertSyncRecordToAppRecord:syncRecord withIdentifier:identifier];
[m_appRecordsForSession addObject:appRecord];
break;
}
case ISyncChangeTypeModify: {
NSDictionary *syncRecord = [change record];
// Note the conversion of sync record to application record.
NSDictionary *appRecord = [self convertSyncRecordToAppRecord:syncRecord withIdentifier:identifier];
int index = [m_appRecordsForSession indexOfSyncRecordWithIdentifier:identifier];
if ([m_appRecordsForSession count] > index) {
[m_appRecordsForSession replaceObjectAtIndex:index withObject:appRecord];
}
break;
}
case ISyncChangeTypeDelete: {
unsigned index = [m_appRecordsForSession indexOfSyncRecordWithIdentifier:identifier];
if ([m_appRecordsForSession count] > index)
// No record conversion needed in the case of a delete.
[m_appRecordsForSession removeObjectAtIndex:index];
break;
}
}
}
// Note how records were not accepted at the time they were pulled. Separating the
// pull operation from the accept operation gives you the opportunity to run
// this code inside a critical section. Why might you want to do that?
// If you are running the sync operation in a background thread, where the main
// thread might still be accepting changes from the user, you can lock out the UI
// here while you check the records you have pulled against the records that have
// been modified since you started syncing. If you have such records, do not
// accept them. By not accepting them, the sync engine will give them to you
// again the next time you sync, and the sync framework conflict resolver will
// run to automatically handle conflicts.
// This is also the place where we tell the sync engine about any record formatting
// we have done.
// This acts as the first phase of the two-phase commit.
NSString *identifier;
NSEnumerator *enumerator = [m_pulledIdentifiers objectEnumerator];
while ((identifier = [enumerator nextObject])) {
[syncSession clientAcceptedChangesForRecordWithIdentifier:identifier
formattedRecord:[m_formattedRecords objectForKey:identifier]
newRecordIdentifier:nil];
}
// Second phase of two-phase commit.
[syncSession clientCommittedAcceptedChanges];
[syncSession finishSyncing];
// Update our local record store with the records modified by the sync operation.
[m_appRecords removeAllObjects];
[m_appRecords addObjectsFromArray:m_appRecordsForSession];
}
//
// Catch all failure handler. This would likely communicate the failure to the
// user in some kind, gentle (and hopefully informative) way.
//
- (void)syncFailed:(ISyncSession *)syncSession error:(NSError *)error
{
[syncSession cancelSyncing];
NSLog(@"sync failed: %@", [error localizedFailureReason]);
[self syncCleanup];
}
//
// All sync sessions, whether they succeed or fail, come through this code.
// This handles updating the UI, and releases some objects used in the sync
// session.
//
- (void)syncCleanup
{
[m_syncProgress stopAnimation:self];
[m_syncProgress setHidden:YES];
[m_syncButton setEnabled:YES];
[m_syncModeButton setEnabled:YES];
[m_appRecordsForSession release];
[m_changesSinceLastSync release];
[m_pulledIdentifiers release];
[m_formattedRecords release];
[self sortNamesAndDisplay];
[self update];
[self writeDataFile];
}
//
// ===========================================
// Record conversion
//
//
// This method converts an application record, like the ones used to
// represent data internally in application-specific code, into the
// form the sync engine uses. The mapping is trivially simple in
// this example, but real code will likely need to do more serious
// work here.
//
- (NSDictionary *)convertAppRecordToSyncRecord:(NSDictionary *)record
{
NSString *firstName = [record objectForKey:FirstNameKey];
NSString *middleName = [record objectForKey:MiddleNameKey];
NSString *lastName = [record objectForKey:LastNameKey];
NSString *company = [record objectForKey:CompanyNameKey];
NSMutableDictionary *syncRecord = [NSMutableDictionary dictionaryWithObjectsAndKeys:
EntityContact, ISyncRecordEntityNameKey,
nil];
if (firstName && ([firstName isEqualToString:@""] == NO)) {
[syncRecord setObject:firstName forKey:FirstNameKey];
}
if (middleName && ([middleName isEqualToString:@""] == NO)) {
[syncRecord setObject:middleName forKey:MiddleNameKey];
}
if (lastName && ([lastName isEqualToString:@""] == NO)) {
[syncRecord setObject:lastName forKey:LastNameKey];
}
if (company && ([company isEqualToString:@""] == NO)) {
[syncRecord setObject:company forKey:CompanyNameKey];
}
return syncRecord;
}
//
// This method converts a sync record, like the ones pulled from
// the sync engine, into the form used by the application. The mapping
// is trivially simple in this example, but real code will likely need
// to do more serious work here.
//
- (NSDictionary *)convertSyncRecordToAppRecord:(NSDictionary *)record withIdentifier:(NSString *)identifier
{
NSString *firstName = [record objectForKey:FirstNameKey];
NSString *middleName = [record objectForKey:MiddleNameKey];
NSString *lastName = [record objectForKey:LastNameKey];
NSString *company = [record objectForKey:CompanyNameKey];
if (m_syncsUsingRecordFormatting) {
firstName = [firstName length] > FormatLimit ? [firstName substringToIndex:FormatLimit] : firstName;
middleName = [middleName length] > FormatLimit ? [middleName substringToIndex:FormatLimit] : middleName;
lastName = [lastName length] > FormatLimit ? [lastName substringToIndex:FormatLimit] : lastName;
company = [company length] > FormatLimit ? [company substringToIndex:FormatLimit] : company;
}
NSDictionary *result = [NSDictionary dictionaryWithObjectsAndKeys:
identifier, IdentifierKey,
firstName ? firstName : @"", FirstNameKey,
middleName ? middleName : @"", MiddleNameKey,
lastName ? lastName : @"", LastNameKey,
company ? company : @"", CompanyNameKey,
nil];
if (m_syncsUsingRecordFormatting) {
[m_formattedRecords setObject:[self convertAppRecordToSyncRecord:result] forKey:identifier];
}
return result;
}
//
// ===========================================
// IBActions
//
//
// Handles the changes to sync options as shown in the "Options" menu in
// the application.
//
- (IBAction)syncOptionsChanged:(id)sender
{
int value = [sender tag];
switch (value) {
case UsesRecordFiltering:
m_syncsUsingRecordFiltering = !m_syncsUsingRecordFiltering;
break;
case UsesRecordFormatting:
m_syncsUsingRecordFormatting = !m_syncsUsingRecordFormatting;
break;
case UsesSyncAlertHandler:
m_syncsUsingSyncAlertHandler = !m_syncsUsingSyncAlertHandler;
BOOL flag = m_syncsUsingSyncAlertHandler;
// These few lines of code register a sync alert handler method.
// When our application is running, it will be asked through the
// handler we supply if it wishes to join a sync session that is
// beginning.
ISyncClient *syncClient = [self performRegistrations];
[syncClient setShouldSynchronize:flag withClientsOfType:ISyncClientTypeApplication];
[syncClient setShouldSynchronize:flag withClientsOfType:ISyncClientTypeDevice];
[syncClient setShouldSynchronize:flag withClientsOfType:ISyncClientTypeServer];
[syncClient setShouldSynchronize:flag withClientsOfType:ISyncClientTypePeer];
[syncClient setSyncAlertHandler:self selector:@selector(client:willSyncEntityNames:)];
break;
case SyncsOnAppDeactivate:
m_syncsOnAppDeactivate = !m_syncsOnAppDeactivate;
NSNotificationCenter *defaultCenter = [NSNotificationCenter defaultCenter];
if (m_syncsOnAppDeactivate) {
[defaultCenter addObserver:self
selector:@selector(sync:)
name:NSApplicationWillResignActiveNotification
object:nil];
}
else {
[defaultCenter removeObserver:self
name:NSApplicationWillResignActiveNotification
object:nil];
}
break;
}
}
//
// This method starts a sync session. It updates the UI, creates some
// session-specific objects used to track the activity of the session,
// and starts the session running.
//
- (IBAction)sync:(id)sender
{
@try {
[m_syncButton setEnabled:NO];
[m_syncModeButton setEnabled:NO];
[m_syncProgress setHidden:NO];
[m_syncProgress startAnimation:self];
[[m_window undoManager] removeAllActions];
m_appRecordsForSession = [m_appRecords mutableCopy];
m_changesSinceLastSync = [m_changes copy];
[m_changes removeAllObjects];
m_pulledIdentifiers = [[NSMutableArray alloc] init];
m_formattedRecords = [[NSMutableDictionary alloc] init];
m_syncReplaceAllRecords = NO;
m_syncMode = [m_syncModeButton indexOfSelectedItem];
ISyncClient *syncClient = [self performRegistrations];
if (!syncClient) {
NSLog(@"cannot create sync syncClient.");
return;
}
// If you are going to be doing record filtering, set the filters
// on the client before starting the session.
if (m_syncsUsingRecordFiltering) {
id filter = [LastNameFilter filter];
[syncClient setFilters:[NSArray arrayWithObject:filter]];
}
else {
[syncClient setFilters:[NSArray array]];
}
// If you are pulling the truth, tell the client this fact
// before starting the session.
if (m_syncMode == PullTheTruth) {
[syncClient setShouldReplaceClientRecords:YES forEntityNames:m_entityNames];
}
// Ask for a session to be started in the background. This is a good choice
// if starting the session from the main thread, since other clients in
// other processes may be joining, and you will not want to block your UI
// while that handshaking is taking place.
[ISyncSession beginSessionInBackgroundWithClient:syncClient entityNames:m_entityNames
target:self selector:@selector(performSync::)];
}
@catch (NSException *exception) {
NSLog(@"caught exception: %@: %@", [exception name], [exception reason]);
[self syncCleanup];
}
}
@end
</pre>
<!--googleoff: index -->
</td>
</tr>
</table>
<!-- END WIDE COLUMN -->
<!-- END MAIN CONTENT -->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr>
<td><div style="width: 100%; height: 1px; background-color: #919699; margin-top: 5px; margin-bottom: 15px"></div></td>
</tr>
<tr>
<td align="center"><br/>
<table border="0" cellpadding="0" cellspacing="0" class="graybox">
<tr>
<th>Did this document help you?</th>
</tr>
<tr>
<td>
<div style="margin-bottom: 8px"><a href="http://developer.apple.com/feedback/?v=1&url=/samplecode/People/listing6.html%3Fid%3DDTS10003615-1.0&media=dvd" target=_new>Yes</a>: Tell us what works for you.</div>
<div style="margin-bottom: 8px"><a href="http://developer.apple.com/feedback/?v=2&url=/samplecode/People/listing6.html%3Fid%3DDTS10003615-1.0&media=dvd" target=_new>It’s good, but:</a> Report typos, inaccuracies, and so forth.</div>
<div><a href="http://developer.apple.com/feedback/?v=3&url=/samplecode/People/listing6.html%3Fid%3DDTS10003615-1.0&media=dvd" target=_new>It wasn’t helpful</a>: Tell us what would have helped.</div>
</td>
</tr>
</table>
</td>
</tr>
</table>
<!-- START BOTTOM APPLE NAVIGATION -->
<!--#include virtual="/includes/footer"-->
<!-- END BOTTOM APPLE NAVIGATION -->
<!-- START CENTER CLOSE -->
</center>
<!-- END CENTER CLOSE -->
</body>
</html>