Annotation Future

Utilisez l'annotation future pour identifier les méthodes qui sont exécutées de façon asynchrone. Lorsque vous spécifiez future, la méthode est exécutée lorsque Salesforce a des ressources disponibles.

Par exemple, vous pouvez utiliser l'annotation future lors d'un appel de service Web asynchrone vers un service externe. Sans l'annotation, l'appel de service Web est effectué à partir du même fil qui exécute le code Apex, et aucun traitement supplémentaire n'est effectué jusqu'à la fin de l'appel (traitement synchrone).

Les méthodes avec l'annotation future doivent être des méthodes statiques et peuvent renvoyer uniquement un type void.

Pour effectuer une méthode dans une classe exécutée de façon asynchrone, définissez la méthode avec l'annotation future. Par exemple :

global class MyFutureClass {



  @future 

  static void myMethod(String a, Integer i) {

    System.debug('Method called with: ' + a + ' and ' + i);

    //do callout, other long running code

  }

}

L'extrait suivant montre comment spécifier qu'une méthode exécute un appel :

  @future (callout=true)

  public static void doCalloutFromFuture() {

   //Add code to perform callout

}

Vous pouvez spécifier (callout=false) pour empêcher une méthode d'effectuer des appels.

Pour tester des méthodes définies avec l'annotation future, appelez la classe contenant la méthode dans un bloc de code startTest, stopTest. Tous les appels asynchrones effectués après la méthode startTest sont collectés par le système. Lors de l'exécution de stopTest, tous les processus asynchrones sont exécutés de façon synchrone.

Les méthodes avec l'annotation future présentent les limitations suivantes :

• 10 appels de méthode au maximum peuvent être effectués par invocation Apex
  Remarque

  Les appels asynchrones, tels que @future ou executeBatch, appelés dans un bloc startTest, stopTest, ne sont pas pris en compte dans les limitations du nombre de tâches en file d'attente.
• Salesforce impose également une limite sur le nombre d'invocations de méthode future : 200 appels de méthode par licence utilisateur Salesforce complète, licence utilisateur Salesforce Platform ou licence utilisateur Force.com App Subscription, par 24 heures. Cette limitation s'applique à l'échelle de l'organisation. Les licences utilisateur Chatter Only, Utilisateurs clients de Chatter, Customer Portal User et Partner portal ne sont pas incluses dans le calcul de cette limitation. Par exemple, supposons que votre organisation possède trois licences Salesforce complètes, deux licences Salesforce Platform et 100 licences Customer Portal User. Votre organisation entière est limitée à 1000 appels de méthode par 24 heures, calculés par la formule 200 * (3+2), pas 200 * (3+2+100).
• Les paramètres spécifiés doivent être des types de données primitifs, des tableaux de types de données primitifs ou des collections de types de données primitifs.
• Les méthodes avec l'annotation future ne peuvent pas prendre des sObjects ou des objets en tant qu'arguments.
• Les méthodes avec l'annotation future ne peuvent pas être utilisées dans des contrôleurs Visualforce, ni dans des méthodes getMethodName ou setMethodName, ni dans le constructeur.

Notez que toute méthode qui utilise l'annotation future requiert une attention particulière, car elle n'est pas nécessairement exécutée dans l'ordre dans lequel elle est appelée.

Vous ne pouvez pas appeler une méthode annotée avec future à partir d'une méthode qui contient également l'annotation future. Vous ne pouvez pas non plus appeler un déclencheur à partir d'une méthode annotée qui appelle une autre méthode annotée.

Les méthodes getContent et getContentAsPDFPageReference ne peuvent pas être utilisées dans des méthodes avec l'annotation future.

Pour plus d'informations sur les appels, reportez-vous à Invocation d'appels en utilisant le langage Apex.