Differences

This shows you the differences between two versions of the page.

--- scripting:restcallback [2022/08/25 14:48] – jerryhopper
+++ scripting:restcallback [2022/08/25 15:05] (current) – [Common usage] jerryhopper
@@ Line 14: / Line 14: @@
 ===== Common usage =====
-The baseworld component is returned on the GetWorld() global command.
+The restAPI allows interaction with external webresources in JSON format. the RestCallback class contains functions in which you process the restAPI request results.
+Typical usage : statistics/leaderboards/persistent world.
-Typical usage : [[scripting:baseworld#findentitybyname|find an Entity]].
   class TestCallback : RestCallback
@@ Line 35: / Line 38: @@
 ===== Functions =====
-==== GET(); ====
+==== OnError(); ====
+  OnError( int errorCode );
+Called in case request failed (ERestResult) - Note! May be called multiple times in case of (RetryCount > 1)
+Return type: [[scripting:datatypes#void]]
+==== OnTimeout(); ====
+  OnTimeout(  );
+Called in case request timed out or handled improperly (no error, no success, no data)
+Return type: [[scripting:datatypes#void]]
+==== OnSuccess(); ====
+  OnSuccess( string data, int dataSize );
+Called when data arrived and/ or response processed successfully
+Return type: [[scripting:datatypes#void]]
+==== OnFileCreated(); ====
+  OnFileCreated( string fileName, int dataSize );
+Called when data arrived and/ or file created successfully
+Return type: [[scripting:datatypes#void]]
+===== FULL EXAMPLE =====
+<code>
+class TestCallback : RestCallback
+{
+	void OnError( int errorCode )
+	{
+		// override this with your implementation
+		Print(" !!! OnError() ");
+	};
+	void OnTimeout()
+	{
+		// override this with your implementation
+		Print(" !!! OnTimeout() ");
+	};
+	void OnSuccess( string data, int dataSize )
+	{
+		// override this with your implementation
+		Print(" !!! OnSuccess() size=" + dataSize );
+		if( dataSize > 0 )
+			Print(data); // !!! NOTE: Print() will not output string longer than 1024b, check your dataSize !!!
+	};
-  GET(RestCallback cb, string request);
-Return type: [[scripting:datatypes#int]]
+	void OnFileCreated( string fileName, int dataSize )
+	{
+		// override this with your implementation
+		Print(" !!! OnFileCreated() file=" + fileName + " size=" + dataSize );
+	};
+}
+</code>