`$response.addContent`¶

Description¶

Crée ou ajoute du contenu au buffer de réponse. La méthode supporte les données texte (via une valeur string) et les données binaires (via un objet file) mais pas un mix des deux. Il n'est en effet pas permis d'écrire des données textuelles puis d'y ajouter des données binaires. Il n'est pas non plus permis d'ajouter des données binaires si la réponse en contient déjà. En fait seules les données texte peuvent être complétées.

Les éléments d'en-tête de la réponse (status, headers (dont le content-type), etc.) doivent être définis avant l'ajout de données dans le buffer de réponse car il n'est plus possible de modifier ces éléments une fois que l'on envoie des données dans le buffer, à moins d'invalider le buffer au moyen de la méthode $response.reset.

Syntaxe¶

$response.addContent( content )

Paramètres¶

content string / file / map

Donnée à inscrire dans ou à ajouter au buffer.

Dans le cas où la donnée est un map, la méthode génère et envoie une représentation json du map à la response. Elle se charge également de spécifier le content-type à application/json Il n'est donc pas nécessaire de le spécifier dans le code du script.

Retour¶

Retourne toujours null.

Exemples¶

L'exemple ci-dessous retourne une représentation json d'un map.

$response.addContent({
  foo: 1,
  bar: "xyz"
});

L'exemple ci-dessous construit une réponse qui retourne un code HTTP 500 avec le texte de la dernière erreur retournée par le moteur.

$response.setStatus(500);
$response.setContentType("text/plain; charset=utf-8");
$response.addContent($script.getLastError());

$response.addContent¶