L'API //Write and Read// est écrite en Java et nous l'utilisons pour notre module de versionning.

====== Obtenir les classes ======

Si vous possédez une copie de EzGED, les jar contenant les classes nécessaires se trouvent dans :
  
  C:\nchp\usr\local\nchp\ezged\www3\resources\applet
  
Les fichiers jar dont vous aurez besoin sont :
  * ezApplet.jar
  * warApplet.jar


Vous pouvez aussi télécharger le jar suivant qui contient toutes les librairies nécessaires :

http://updates.nchp.net/WarAppletAll.jar


====== Utilisation ======

===== Upload simple =====

Un exemple illustrant comment utiliser l'API pour uploader un fichier sur EzGED.

<code>
import war.*;

public class TestUpload {
	public static void main(String[] args) {
		String filepath = "C:\\prog\\test\\pdf\\image_vec.pdf";
		String url = "http://localhost/ezged3/data/pupload.php";
		String sessionid = "96745501";
	   
		WarApplet applet = new WarApplet();
		String result = applet.upload(filepath, url, sessionid);
	}
}
</code>

On compile en ajoutant dans notre classpath le jar qui contient toutes les dépendances :
<code>
>javac -cp .;WarAppletAll.jar TestUpload.java
</code>

Puis on exécute :

<code>
>java -cp .;WarAppletAll.jar TestUpload
</code>

Ce qui nous donne la sortie suivante avec notre exemple:

<code>
Applet : upload C:\prog\test\pdf\image_vec.pdf to http://localhost/ezged3/data/pupload.php
Applet : _upload
C:\Users\Florian\.ezged\image_vec.pdf
CHUNKS:4
chunk 0
{"success":true,"chunkpart":true,"message":"Part file successfully uploaded.","partPath":"C:\\nchp\\var\\spool\\ezged\\instance\/enqueued\/\\image_vec.1423583573.pdf"}
chunk 1
{"success":true,"chunkpart":true,"message":"Part file successfully uploaded.","partPath":"C:\\nchp\\var\\spool\\ezged\\instance\/enqueued\/\\image_vec.1423583574.pdf"}
chunk 2
{"success":true,"chunkpart":true,"message":"Part file successfully uploaded.","partPath":"C:\\nchp\\var\\spool\\ezged\\instance\/enqueued\/\\image_vec.1423583574.pdf"}
chunk 3
{"success":true,"chunkpart":false,"message":"File successfully uploaded.","filePath":"C:\\nchp\\var\\spool\\ezged\\instance\/enqueued\/\\image_vec.1423583574.pdf"}

{"success":true,"chunkpart":false,"message":"File successfully uploaded.","filePath":"C:\\nchp\\var\\spool\\ezged\\instance\/enqueued\/\\image_vec.1423583574.pdf"}
</code>

===== Upload vers un COLD =====

Cet exemple montre comment uploader un ou plusieurs fichiers vers le répertoire d'attente.
Ce répertoire doit obligatoirement se situer sous l'arborescence **ocr\wait** (e.g : C:\nchp\var\spool\ezged\instance\ocr\wait)

Le code n'est pas si différent, nous appelons simplement la méthode 

<code>public String _upload(String filepath, String url, String sessionid, String waitdir)</code>

Plutôt que 
<code>public String upload(final String filepath, final String url, final String sessionid)</code>

Ce qui nous donne
<code>
import war.*;

public class TestUpload {
	public static void main(String[] args) {
		String filepath = "C:\\prog\\test\\pdf\\image_vec.pdf";
		String url = "http://localhost/ezged3/data/pupload.php";
		String sessionid = "96745501";
	   
		WarApplet applet = new WarApplet();
		String result = applet._upload(filepath, url, sessionid, "images");

                //Ici le code pour parser le resultat
	}
}
</code>

Nous ne décrivons pas ici comment parser le résultat qui est au format JSON. 
Vous pouvez utiliser la librairie de votre choix.

Voici un exemple de retour au format JSON du script pupload.php :

<file json retour.json>
{
	"success":true,
	"chunkpart":false,
	"message":"File successfully uploaded.",
	"filePath":"C:\\nchp\\var\\spool\\ezged\\instance\/ocr\/wait\/tutoriel_service_cold\/fichier2.pdf"
}
</file>

Les fichiers dont la taille excède 1.5Mo seront découpés. Vous aurez donc plusieurs retours pour le même fichier. Tant qu'il ne s'agira pas du fichier complet chunkpart aura la valeur true.

Il faudra donc vous assurer d'avoir le retour suivant pour success et chunkpart :
<code>
"success":true,
"chunkpart":false,
</code>