Utilisation de méthodes futures

• Des appels externes à des services Web externes. Si vous effectuez des appels externes à partir d’un déclencheur ou après l’exécution d’une opération DML, vous devez utiliser une méthode future ou pour file d'attente. Un appel externe dans un déclencheur garderait la connexion à la base de données ouverte pendant la durée de vie de l’appel externe, ce qui est interdit dans un environnement mutualisé.
• Les opérations que vous souhaitez exécuter dans leur propre thread, lorsque les conditions sont favorables, par exemple un calcul ou un traitement d’enregistrements qui mobilise des ressources importantes.
• L’isolation des opérations DML sur différents types de sObject afin d’éviter l’erreur d’opérations DML mixtes. Il s’agit d’un cas extrême, mais vous pouvez parfois rencontrer cette erreur. Pour plus informations, reportez-vous à sObjects That Cannot Be Used Together in DML Operations (en anglais).

public class SomeClass {
  @future
  public static void someFutureMethod(List<Id> recordIds) {
    List<Account> accounts = [Select Id, Name from Account Where Id IN :recordIds];
    // process account records to do awesome stuff
  }
}

Exemple de code d’appel externe

Pour exécuter un appel externe de service Web à un service externe ou une API, vous créez une classe Apex avec une méthode future marquée avec (callout=true). La classe ci-dessous contient les méthodes d’exécution de l’appel de façon synchrone et asynchrone lorsque les appels externes ne sont pas autorisés. Nous insérons un enregistrement dans un objet de journal personnalisé pour suivre le statut de l’appel externe, simplement parce que la consignation est toujours intéressante ! 

La classe SmsMessage et le sObject SMS_Log__c dans l’exemple sont des hypothèses et affichés uniquement pour illustrer le modèle d’appel.

public class SMSUtils {
    // Call async from triggers, etc, where callouts are not permitted.
    @future(callout=true)
    public static void sendSMSAsync(String fromNbr, String toNbr, String m) {
        String results = sendSMS(fromNbr, toNbr, m);
        System.debug(results);
    }
    // Call from controllers, etc, for immediate processing
    public static String sendSMS(String fromNbr, String toNbr, String m) {
        // Calling 'send' will result in a callout
        String results = SmsMessage.send(fromNbr, toNbr, m);
        insert new SMS_Log__c(to__c=toNbr, from__c=fromNbr, msg__c=results);
        return results;
    }
}

@isTest
public class SMSCalloutMock implements HttpCalloutMock {
    public HttpResponse respond(HttpRequest req) {
        // Create a fake response
        HttpResponse res = new HttpResponse();
        res.setHeader('Content-Type', 'application/json');
        res.setBody('{"status":"success"}');
        res.setStatusCode(200);
        return res;
    }
}

@IsTest
private class Test_SMSUtils {
  @IsTest
  private static void testSendSms() {
    Test.setMock(HttpCalloutMock.class, new SMSCalloutMock());
    Test.startTest();
      SMSUtils.sendSMSAsync('111', '222', 'Greetings!');
    Test.stopTest();
    // runs callout and check results
    List<SMS_Log__c> logs = [select msg__c from SMS_Log__c];
    System.assertEquals(1, logs.size());
    System.assertEquals('success', logs[0].msg__c);
  }
}

• Assurez-vous que les méthodes futures sont exécutées aussi rapidement que possibles.
• Si vous utilisez des appels externes de service Web, essayez de regrouper tous les appels externes de la même méthode future au lieu d’utiliser une méthode future séparée pour chaque appel externe.
• Effectuez des tests complets à l’échelle. Effectuez un test pour déterminer si un déclencheur mettant en file d’attente des appels @future peut gérer une collection de déclencheur de 200 enregistrements. Vous pouvez ainsi déterminer si la conception des volumes actuels et futurs entraîne des délais.
• Utilisez un code Apex par lot plutôt que des méthodes futures pour traiter simultanément un grand nombre d’enregistrements. Cette solution est plus efficace que la création d’une requête future pour chaque enregistrement.

• Les méthodes munies de l’annotation @future doivent être statiques et ne peuvent renvoyer qu’un type void.
• Les paramètres spécifiés doivent être des types de données primitifs, des groupes de types de données primitifs ou des collections de types de données primitifs. Les méthodes futures ne peuvent pas accepter des objets en tant qu’arguments.
• L’ordre d’exécution des méthodes futures ne correspond pas nécessairement à l’ordre dans lequel elles sont appelées. En outre, deux méthodes futures peuvent être exécutées simultanément, ce qui peut entraîner un verrouillage d’enregistrement si les deux méthodes mettent à jour le même enregistrement.
• Les méthodes futures ne peuvent pas être utilisées dans des contrôleurs Visualforce dans getMethodName(), setMethodName(), ni dans le constructeur.
• Vous ne pouvez pas appeler une méthode future à partir d’une méthode future. Vous ne pouvez pas non plus invoquer un déclencheur qui appelle une méthode future tout en exécutant une méthode future. Pour empêcher les appels de méthode future récursifs, suivez le lien « Preventing Recursive Future Method Calls in Salesforce » dans la section Ressources.
• Les méthodes getContent() et getContentAsPDF() ne peuvent pas être utilisées dans des méthodes avec une annotation @future.
• Vous êtes limité(e) à 50 appels futurs par invocation Apex avec une limite supplémentaire en nombre d’appels par période de 24 heures. Pour plus d’informations sur ces limitations, suivez le lien ci-dessous.