Added method for drilling on many objects simultaneously

SVN: 27278

openbis-ipad/BisKit/Classes/CISDOBIpadService.h

@@ -55,7 +55,10 @@ enum CISOBIpadServiceErrorCode {
 //! Get all root-level entities from the openBIS ipad service, possibly along with some children as well. The success message will be invoked with a collection of CISDOBIpadRawEntity objects.
 - (CISDOBAsyncCall *)listRootLevelEntities;
 
-//! Get drill information from the openBIS ipad service -- this will include information about the children of the entity and possibly their children as well. The success message will be invoked with a collection of CISDOBIpadRawEntity objects.
+//! Get drill information from the openBIS ipad service -- this will include information about the children of the entity and possibly their children as well. The two collections must have the same cardinality. The success message will be invoked with a collection of CISDOBIpadRawEntity objects.
+- (CISDOBAsyncCall *)drillOnEntities:(NSArray *)permIds refcons:(NSArray *)refcons;
+
+//! A convenience version of drillOnEntities:refcons: for one entity.
 - (CISDOBAsyncCall *)drillOnEntityWithPermId:(NSString *)permId refcon:(id)refcon;
 
 @end

openbis-ipad/BisKit/Classes/CISDOBIpadService.m

@@ -175,14 +175,19 @@ NSString *const CISDOBIpadServiceErrorDomain = @"CISDOBIpadServiceErrorDomain";
     return iPadCall;
 }
 
-- (CISDOBAsyncCall *)drillOnEntityWithPermId:(NSString *)permId refcon:(id)refcon
+- (CISDOBAsyncCall *)drillOnEntities:(NSArray *)permIds refcons:(NSArray *)refcons
 {
-    // A simple version of the method that just request data for one entity.
-    NSDictionary *entity =
-        [NSDictionary dictionaryWithObjectsAndKeys:
-            permId, @"PERM_ID",
-            refcon, @"REFCON", nil];
-    NSArray *entities = [NSArray arrayWithObject: entity];
+    NSUInteger count = [permIds count];
+    NSAssert([refcons count] == count, @"Drilling requires permIds and refcons. There must be an equal number of these.");
+    NSMutableArray *entities = [[NSMutableArray alloc] initWithCapacity: [permIds count]];
+    for (NSUInteger i = 0; i < count; ++i) {
+        NSDictionary *entity =
+            [NSDictionary dictionaryWithObjectsAndKeys:
+                [permIds objectAtIndex: i], @"PERM_ID",
+                [refcons objectAtIndex: i], @"REFCON", nil];
+        [entities addObject: entity];
+    }
+
     NSDictionary *parameters =
         [NSDictionary dictionaryWithObjectsAndKeys:
             @"DRILL", @"requestKey",
@@ -203,6 +208,13 @@ NSString *const CISDOBIpadServiceErrorDomain = @"CISDOBIpadServiceErrorDomain";
     return iPadCall;
 }
 
+- (CISDOBAsyncCall *)drillOnEntityWithPermId:(NSString *)permId refcon:(id)refcon
+{
+    NSArray *permIds = [NSArray arrayWithObject: permId];
+    NSArray *refcons = [NSArray arrayWithObject: refcon];
+    return [self drillOnEntities: permIds refcons: refcons];
+}
+
 @end
 
 @implementation CISDOBIpadServiceCall