Μετατροπή curl σε Objective-C

Το NSURLSession είναι το API του Foundation framework της Apple για δικτύωση HTTP σε Objective-C (και Swift). Διαχειρίζεται εργασίες δεδομένων, λήψεις, μεταφορτώσεις και μεταφορές στο παρασκήνιο. Διαθέσιμο σε iOS 7+, macOS 10.9+. Δεν απαιτείται εξωτερική εξάρτηση — είναι ο τυπικός τρόπος για αιτήματα HTTP στις πλατφόρμες της Apple. Το curl2code δημιουργεί κώδικα NSURLSession για Objective-C.

Το NSURLSession είναι η ενσωματωμένη λύση — επαρκής για τις περισσότερες ανάγκες και με μηδενικές εξαρτήσεις. Το AFNetworking ήταν ιστορικά δημοφιλές αλλά τώρα βρίσκεται σε κατάσταση συντήρησης. Ο διάδοχός του είναι το Alamofire (Swift). Για νέα έργα Objective-C, συνιστάται το NSURLSession. Για Swift, δείτε τον μετατροπέα curl σε Swift.

Ορίστε την κεφαλίδα στο NSMutableURLRequest: [request setValue:@"Bearer token" forHTTPHeaderField:@"Authorization"]. Για Basic auth, κωδικοποιήστε τα διαπιστευτήρια με NSData και base64EncodedStringWithOptions:. Το curl2code μετατρέπει τα flags -u και Bearer στη σωστή σύνταξη της Objective-C.

Κατασκευάστε το multipart σώμα με NSMutableData: προσθέστε boundary strings, δεδομένα πεδίων και δεδομένα αρχείων με τα κατάλληλα διαχωριστικά CRLF. Ορίστε το Content-Type με το boundary. Αυτό γίνεται χειροκίνητα αλλά δίνει πλήρη έλεγχο. Το AFNetworking το απλοποιεί αυτό με το AFHTTPRequestSerializer.

Οι completion handlers του NSURLSession παρέχουν μια παράμετρο NSError — ελέγξτε την για σφάλματα δικτύου/μεταφοράς. Μετατρέψτε την απόκριση σε NSHTTPURLResponse και ελέγξτε το statusCode. Χρησιμοποιήστε τις μεθόδους delegate του NSURLSession για πιο λεπτομερή χειρισμό σφαλμάτων, συμπεριλαμβανομένων των authentication challenges και των ανακατευθύνσεων.

Το NSURLSession χρησιμοποιεί callbacks βασισμένα σε blocks: [session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) { ... }]. Πάντα να καλείτε το [task resume] για να ξεκινήσει. Για διαδοχικά αιτήματα, φωλιάστε τα blocks ή χρησιμοποιήστε dispatch groups με το dispatch_group_notify.

Ορίστε τα στο NSURLSessionConfiguration: config.timeoutIntervalForRequest = 30 και config.timeoutIntervalForResource = 300. Ή ανά αίτημα: request.timeoutInterval = 30. Τα σφάλματα timeout εμφανίζονται ως NSURLErrorTimedOut στην παράμετρο error. Αυτά αντιστοιχούν στην επιλογή --max-time του curl.

Ορίστε το connectionProxyDictionary στο NSURLSessionConfiguration με κλειδιά όπως το (NSString *)kCFNetworkProxiesHTTPProxy και την πόρτα. Το NSURLSession σέβεται τις ρυθμίσεις proxy του συστήματος από προεπιλογή σε macOS και iOS. Για αρχεία PAC, ρυθμίστε τα μέσω των προτιμήσεων συστήματος.

Μετατρέψτε μια curl POST εντολή όπως curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL σε Objective-C χρησιμοποιώντας το curl2code. Ο παραγόμενος κώδικας χρησιμοποιεί [request setHTTPBody:[NSJSONSerialization dataWithJSONObject:dict options:0 error:nil]]. Το curl2code εντοπίζει αυτόματα τα -d/--data flags με JSON περιεχόμενο και ορίζει την κατάλληλη Content-Type κεφαλίδα στον κώδικα NSURLSession.

Περάστε το curl -H "Authorization: Bearer YOUR_TOKEN" URL στο curl2code και αυτό θα δημιουργήσει κώδικα NSURLSession με την κεφαλίδα εξουσιοδότησης: [request setValue:@"Bearer TOKEN" forHTTPHeaderField:@"Authorization"]. Το curl2code εντοπίζει τα Bearer tokens τόσο από τα -H "Authorization: Bearer ..." όσο και από τα --oauth2-bearer flags. Για Basic auth, χρησιμοποιήστε το -u user:pass.

Το curl2code μετατρέπει το curl -H "Content-Type: application/json" URL σε κώδικα NSURLSession με τη σωστή κεφαλίδα: [request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"]. Για δεδομένα -d, το curl χρησιμοποιεί από προεπιλογή το application/x-www-form-urlencoded· για μεταφορτώσεις φορμών -F, χρησιμοποιεί το multipart/form-data. Το curl2code αντιστοιχίζει το καθένα στο σωστό NSURLSession API.