Cette tâche permet de convertir un objet SIMessage en un tableau d'octets.
Pourquoi et quand exécuter cette tâche
Si vous souhaitez sauvegarder un objet SIMessage dans votre système de fichiers
local ou dans une base de données, vous devez tout d'abord convertir l'objet en un tableau
d'octets et en une chaîne de formats. Vous pouvez recréer le message à partir d'un tableau
d'octets et d'une chaîne de formats. Pour ce faire, procédez comme suit :
Procédure
- Dans votre application, enregistrez la chaîne de formats associée à l'instance SIMessage. Par exemple :
String savedFormat=message.getFormat();
- Appelez getDataGraphAsBytes. Exemple :
Bytes newDataGraph = message.getNewDataGraph(newFormat);
Cette méthode renvoie une copie
de la charge utile sous forme d'un flux de données.
Vous pouvez stocker les octets et la chaîne de formats
associée.
- Facultatif : Pour reconstruire le message, appelez la
méthode createDataGraph fournie par l'API
SIDataGraphFactory. Cette méthode requiert un tableau d'octets et une chaîne de formats. Par exemple :
DataGraph newDataGraph = SIDataGraphFactory.getInstance().createDataGraph(byteArray, newFormat);
Cette méthode crée un graphique des données en analysant les octets
en fonction du format transmis à la méthode.
Que faire ensuite
Vous pouvez utiliser le graphique des données nouvellement créé en tant que charge utile d'une instance SIMessage
en utilisant la méthode setDataGraph() de SIMessage.
Exemple :
newMessage.setDataGraph(newDataGraph, savedFormat);