ServerMethods' exception handling - Revision history

Wikicatglobe at 04:44, 18 October 2013

2013-10-18T04:44:05Z

← Older revision		Revision as of 04:44, 18 October 2013
Line 1:		Line 1:
	<accesscontrol>~~Administrators,,Cem,,Maysunshine~~</accesscontrol>		<accesscontrol>Main:MyGroup</accesscontrol>
	== Introduction ==		== Introduction ==

Cg_pham at 09:31, 4 October 2011

2011-10-04T09:31:14Z

← Older revision		Revision as of 09:31, 4 October 2011
Line 1:		Line 1:
			<accesscontrol>Administrators,,Cem,,Maysunshine</accesscontrol>
	== Introduction ==		== Introduction ==

Catglobe at 08:54, 24 December 2008

2008-12-24T08:54:00Z

← Older revision		Revision as of 08:54, 24 December 2008
Line 149:		Line 149:
	// Do your normal callback handling here		// Do your normal callback handling here
	}		}
	</source>		</source>

	Notice that when exceptions are thrown the callback function is only called if you have disabled the error handler as described in the previous section.		Notice that when exceptions are thrown the callback function is only called if you have disabled the error handler as described in the previous section.

			[[Category:Technical guidelines]]

Catglobe at 08:52, 24 December 2008

2008-12-24T08:52:59Z

← Older revision		Revision as of 08:52, 24 December 2008
Line 139:		Line 139:
	Instead of returning the exception as a string, the exception object ServerMethodException is now passed to the callback function if an exception was caught on the server side. In order to identify that an exception occurred a new property has been added to the ServerMethodException class called isException, so your callback function should look something like this:		Instead of returning the exception as a string, the exception object ServerMethodException is now passed to the callback function if an exception was caught on the server side. In order to identify that an exception occurred a new property has been added to the ServerMethodException class called isException, so your callback function should look something like this:

	<source lang="javascript"		<source lang="javascript">
	function onMyServerMethodCallback(returnValue)		function onMyServerMethodCallback(returnValue)
	{		{
Line 148:		Line 148:

	// Do your normal callback handling here		// Do your normal callback handling here
	}		}
			</source>

	Notice that when exceptions are thrown the callback function is only called if you have disabled the error handler as described in the previous section.		Notice that when exceptions are thrown the callback function is only called if you have disabled the error handler as described in the previous section.

Catglobe at 08:52, 24 December 2008

2008-12-24T08:52:12Z

← Older revision		Revision as of 08:52, 24 December 2008
Line 139:		Line 139:
	Instead of returning the exception as a string, the exception object ServerMethodException is now passed to the callback function if an exception was caught on the server side. In order to identify that an exception occurred a new property has been added to the ServerMethodException class called isException, so your callback function should look something like this:		Instead of returning the exception as a string, the exception object ServerMethodException is now passed to the callback function if an exception was caught on the server side. In order to identify that an exception occurred a new property has been added to the ServerMethodException class called isException, so your callback function should look something like this:

	~~Tekstboks:~~ function onMyServerMethodCallback(returnValue) { if(returnValue.isException) { // Do your error handling here ~~} // Do your normal callback handling here~~ }		<source lang="javascript"
			function onMyServerMethodCallback(returnValue)
			{
			if(returnValue.isException)
			{
			// Do your error handling here
			}

	Notice that when exceptions are thrown the callback function is only called if you have disabled the error handler as described in the previous section.~~</source>~~		// Do your normal callback handling here
			}

			Notice that when exceptions are thrown the callback function is only called if you have disabled the error handler as described in the previous section.

Catglobe at 08:46, 24 December 2008

2008-12-24T08:46:07Z

← Older revision		Revision as of 08:46, 24 December 2008
Line 34:		Line 34:
	if(parameters.length != callerArguments.length)		if(parameters.length != callerArguments.length)
	{		{
	alert("Server method "+serverMethod.getName()+ " received an invalid number of arguments");		alert("Server method "+serverMethod.getName()+" received an invalid number of arguments");
	return;		return;
	}		}
Line 45:		Line 45:
	{		{
	// Some kind of error showing there is a type mismatch		// Some kind of error showing there is a type mismatch
	messages += " - Parameter '"+~~param eters~~[i].getName()+"' expected type '"+ parameters[i].getTypeName()+"' not type '"+ (typeof callerArguments[i])+"'";		messages += " - Parameter '"+parameters[i].getName()+
			"' expected type '"+parameters[i].getTypeName()+
			"' not type '"+ (typeof callerArguments[i])+"'";
	}		}
	}		}
Line 51:		Line 53:
	if(0 < messages.length)		if(0 < messages.length)
	{		{
	messages = "Type mismatch(es) in server method "+ serverMethod.getName()+":\n"+messages;		messages = "Type mismatch(es) in server method "+serverMethod.getName()+":\n"+messages;
	alert(messages);		alert(messages);
	return;		return;
Line 81:		Line 83:
	<body onload="onPageLoad();">		<body onload="onPageLoad();">
	<form action="ServerMethodsTesting.aspx" runat="server">		<form action="ServerMethodsTesting.aspx" runat="server">
	<!-- html goes here -->		<!-- html goes here -->
	</form>		</form>
	</body>		</body>

Catglobe at 08:44, 24 December 2008

2008-12-24T08:44:15Z

@@ Line 95: / Line 95: @@
 The default implementation for ServerMethods.onCallServerError method is shown below:
-Tekstboks: // On error event handler ServerMethods.onCallServerError = function(exception, serverMethod, callerArguments) { alert(exception.getMessage()); }
+<source lang="javascript">
 It is possible to disable the call to this method as shown in the following example; again overriding this method can only be done after the whole page has been loaded:
-Tekstboks: <%@ Page language="c#" Inherits="CatGlobe.Web.Common.ServerMethods.ServerMethodsTesting" Codebehind="ServerMethodsTesting.aspx.cs"&nbsp;%> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" > <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>ServerMethods example</title> <script type="text/javascript"> function onPageLoad() { ServerMethods.onCallServerError = null; } </script> </head> <body onload="onPageLoad();"> <form action="servermethodstesting.aspx" runat="server"> <!-- html goes here --> </form> </body> </html>
+<source lang="javascript">
-When the ServerMethods.onCallServerError is disabled as shown in the example above, then any exception thrown on the server will be send to the client side’s callback function instead. The next section described how it is possible to determine whether the value returned to the callback function is a ServerMethodException or actually the result that was expected.
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" >
 == ServerMethodException.isException  ==

Catglobe at 08:40, 24 December 2008

2008-12-24T08:40:08Z

@@ Line 29: / Line 29: @@
+{
 	// Get parameters for the server method
-	var parameters = serverMethod.getParameters(); // Validate number of parameters if(parameters.length&nbsp;!= callerArguments.length) { alert("Server method "+serverMethod.getName()+ " received an invalid number of arguments"); return; } // Validate types var messages = ""; for(var i = 0; i &lt; parameters.length; i++) { if(!ServerMethods.__validateType(parameters[i].getType(), callerArguments[i])) { // Some kind of error showing there is a type mismatch messages += " - Parameter '"+param eters[i].getName()+"' expected type '"+ parameters[i].getTypeName()+"' not type '"+ (typeof callerArguments[i])+"'"; } } if(0 &lt; messages.length) { messages = "Type mismatch(es) in server method "+ serverMethod.getName()+":\n"+messages; alert(messages); return; } } &lt;/source&gt;
+	var parameters = serverMethod.getParameters();
 The whole page must be loaded before you can change the event handler, so the ServerMethods.onValidationError method could be changed for example when the body fires the onload event. A small example of this is given below:
-Tekstboks: &lt;%@ Page language="c#" Inherits="CatGlobe.Web.Common.ServerMethods.ServerMethodsTesting" Codebehind="ServerMethodsTesting.aspx.cs"&nbsp;%&gt; &lt;!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" &gt; &lt;html xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;head&gt; &lt;title&gt;ServerMethods example&lt;/title&gt; &lt;script type="text/javascript"&gt; function onPageLoad() { // On validation error event handler ServerMethods.onValidationError = function(serverMethod, callerArguments) { alert("Validation error"); } } &lt;/script&gt; &lt;/head&gt; &lt;body onload="onPageLoad();"&gt; &lt;form action="ServerMethodsTesting.aspx" runat="ser ver"&gt; &lt;!-- html goes here --&gt; &lt;/form&gt; &lt;/body&gt; &lt;/html&gt;
+<source lang="javascript">
 == ServerMethods.onCallServerError  ==
@@ Line 47: / Line 99: @@
 It is possible to disable the call to this method as shown in the following example; again overriding this method can only be done after the whole page has been loaded:
-Tekstboks: &lt;%@ Page language="c#" Inherits="CatGlobe.Web.Common.ServerMethods.ServerMethodsTesting" Codebehind="ServerMethodsTesting.aspx.cs"&nbsp;%&gt; &lt;!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" &gt; &lt;html xmlns="http://www.w3.org/1999/xhtml"&gt; &lt;head&gt; &lt;title&gt;ServerMethods example&lt;/title&gt; &lt;script type="text/javascript"&gt; function onPageLoad() { ServerMethods.onCallServerError = null; } &lt;/script&gt; &lt;/head&gt; &lt;body onload="onPageLoad();"&gt; &lt;form action="servermethodstesting.aspx" runat="server"&gt; &lt;!-- html goes here --&gt; &lt;/form&gt; &lt;/body&gt; &lt;/html&gt;
+Tekstboks: <%@ Page language="c#" Inherits="CatGlobe.Web.Common.ServerMethods.ServerMethodsTesting" Codebehind="ServerMethodsTesting.aspx.cs"&nbsp;%> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" > <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>ServerMethods example</title> <script type="text/javascript"> function onPageLoad() { ServerMethods.onCallServerError = null; } </script> </head> <body onload="onPageLoad();"> <form action="servermethodstesting.aspx" runat="server"> <!-- html goes here --> </form> </body> </html>
 When the ServerMethods.onCallServerError is disabled as shown in the example above, then any exception thrown on the server will be send to the client side’s callback function instead. The next section described how it is possible to determine whether the value returned to the callback function is a ServerMethodException or actually the result that was expected.
@@ Line 57: / Line 109: @@
 Tekstboks: function onMyServerMethodCallback(returnValue) { if(returnValue.isException) { // Do your error handling here } // Do your normal callback handling here }
-Notice that when exceptions are thrown the callback function is only called if you have disabled the error handler as described in the previous section.
+Notice that when exceptions are thrown the callback function is only called if you have disabled the error handler as described in the previous section.</source>

Catglobe at 08:36, 24 December 2008

2008-12-24T08:36:28Z

← Older revision		Revision as of 08:36, 24 December 2008
Line 25:		Line 25:

	<source lang="javascript">		<source lang="javascript">
	~~Tekstboks:~~ // On validation error event handler ServerMethods.onValidationError = function(serverMethod, callerArguments) { // Get parameters for the server method var parameters = serverMethod.getParameters(); // Validate number of parameters if(parameters.length != callerArguments.length) { alert("Server method "+serverMethod.getName()+ " received an invalid number of arguments"); return; } // Validate types var messages = ""; for(var i = 0; i < parameters.length; i++) { if(!ServerMethods.__validateType(parameters[i].getType(), callerArguments[i])) { // Some kind of error showing there is a type mismatch messages += " - Parameter '"+param eters[i].getName()+"' expected type '"+ parameters[i].getTypeName()+"' not type '"+ (typeof callerArguments[i])+"'"; } } if(0 < messages.length) { messages = "Type mismatch(es) in server method "+ serverMethod.getName()+":\n"+messages; alert(messages); return; } }		// On validation error event handler
	</source>		ServerMethods.onValidationError = function(serverMethod, callerArguments)
			{
			// Get parameters for the server method
			var parameters = serverMethod.getParameters(); // Validate number of parameters if(parameters.length != callerArguments.length) { alert("Server method "+serverMethod.getName()+ " received an invalid number of arguments"); return; } // Validate types var messages = ""; for(var i = 0; i < parameters.length; i++) { if(!ServerMethods.__validateType(parameters[i].getType(), callerArguments[i])) { // Some kind of error showing there is a type mismatch messages += " - Parameter '"+param eters[i].getName()+"' expected type '"+ parameters[i].getTypeName()+"' not type '"+ (typeof callerArguments[i])+"'"; } } if(0 < messages.length) { messages = "Type mismatch(es) in server method "+ serverMethod.getName()+":\n"+messages; alert(messages); return; } } </source>

	The whole page must be loaded before you can change the event handler, so the ServerMethods.onValidationError method could be changed for example when the body fires the onload event. A small example of this is given below:		The whole page must be loaded before you can change the event handler, so the ServerMethods.onValidationError method could be changed for example when the body fires the onload event. A small example of this is given below:

Catglobe at 08:35, 24 December 2008

2008-12-24T08:35:27Z

← Older revision		Revision as of 08:35, 24 December 2008
Line 1:		Line 1:
	== Introduction ==		== Introduction ==

	ServerMethods' exception handling for asynchronous server methods has been improved. The improvement will be available from version 5.0 and forward. Should anyone need it for version 4.9, then a merge back to version 4.9 will also be done, but this is only done on request.		ServerMethods' exception handling for asynchronous server methods has been improved. The improvement will be available from version 5.0 and forward. Should anyone need it for version 4.9, then a merge back to version 4.9 will also be done, but this is only done on request.

	In the previous version of ServerMethods there was no easy way of handling exceptions that occurred for asynchronous server methods. If an exception occurred then the message from that exception would be returned to the callback function as a string. So, if your server method already returned a string it would be difficult to see, when the string was an exception and when it was actually the result you wanted.		In the previous version of ServerMethods there was no easy way of handling exceptions that occurred for asynchronous server methods. If an exception occurred then the message from that exception would be returned to the callback function as a string. So, if your server method already returned a string it would be difficult to see, when the string was an exception and when it was actually the result you wanted.

	== The Improvements ==		== The Improvements ==

	In order to better handle exceptions for asynchronous server methods we have implemented two new event handlers on the ServerMethods class:		In order to better handle exceptions for asynchronous server methods we have implemented two new event handlers on the ServerMethods class:

	* ServerMethods.onValidationError		*ServerMethods.onValidationError
	* ServerMethods.onCallServerError		*ServerMethods.onCallServerError

	And a new property on the ServerMethodException class:		And a new property on the ServerMethodException class:

	* isException		*isException

	How to use these new event handlers and properties will be explained in the following sections.		How to use these new event handlers and properties will be explained in the following sections.

	== ServerMethods.onValidationError ==		== ServerMethods.onValidationError ==

	When a server method is called from the client side, then validation of the arguments passed to the server method is done before actually sending the request to the server side.		When a server method is called from the client side, then validation of the arguments passed to the server method is done before actually sending the request to the server side.

	If validation of the arguments passed to the server method cannot be validated then ServerMethods.onValidationError is called. A default implementation of this method already exists, and we will show it here as an example of how to implement an event handler for validation errors.		If validation of the arguments passed to the server method cannot be validated then ServerMethods.onValidationError is called. A default implementation of this method already exists, and we will show it here as an example of how to implement an event handler for validation errors.

	Tekstboks: // On validation error event handler ServerMethods.onValidationError = function(serverMethod, callerArguments) { // Get parameters for the server method var parameters = serverMethod.getParameters(); // Validate number of parameters if(parameters.length != callerArguments.length) { alert("Server method "+serverMethod.getName()+ " received an invalid number of arguments"); return; } // Validate types var messages = ""; for(var i = 0; i < parameters.length; i++) { if(!ServerMethods.__validateType(parameters[i].getType(), callerArguments[i])) { // Some kind of error showing there is a type mismatch messages += " - Parameter '"+param eters[i].getName()+"' expected type '"+ parameters[i].getTypeName()+"' not type '"+ (typeof callerArguments[i])+"'"; } } if(0 < messages.length) { messages = "Type mismatch(es) in server method "+ serverMethod.getName()+":\n"+messages; alert(messages); return; } }		<source lang="javascript">
			Tekstboks: // On validation error event handler ServerMethods.onValidationError = function(serverMethod, callerArguments) { // Get parameters for the server method var parameters = serverMethod.getParameters(); // Validate number of parameters if(parameters.length != callerArguments.length) { alert("Server method "+serverMethod.getName()+ " received an invalid number of arguments"); return; } // Validate types var messages = ""; for(var i = 0; i < parameters.length; i++) { if(!ServerMethods.__validateType(parameters[i].getType(), callerArguments[i])) { // Some kind of error showing there is a type mismatch messages += " - Parameter '"+param eters[i].getName()+"' expected type '"+ parameters[i].getTypeName()+"' not type '"+ (typeof callerArguments[i])+"'"; } } if(0 < messages.length) { messages = "Type mismatch(es) in server method "+ serverMethod.getName()+":\n"+messages; alert(messages); return; } }
			</source>

	The whole page must be loaded before you can change the event handler, so the ServerMethods.onValidationError method could be changed for example when the body fires the onload event. A small example of this is given below:		The whole page must be loaded before you can change the event handler, so the ServerMethods.onValidationError method could be changed for example when the body fires the onload event. A small example of this is given below:

	Tekstboks: <%@ Page language="c#" Inherits="CatGlobe.Web.Common.ServerMethods.ServerMethodsTesting" Codebehind="ServerMethodsTesting.aspx.cs" %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" > <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>ServerMethods example</title> <script type="text/javascript"> function onPageLoad() { // On validation error event handler ServerMethods.onValidationError = function(serverMethod, callerArguments) { alert("Validation error"); } } </script> </head> <body onload="onPageLoad();"> <form action="ServerMethodsTesting.aspx" runat="ser ver"> <!-- html goes here --> </form> </body> </html>		Tekstboks: <%@ Page language="c#" Inherits="CatGlobe.Web.Common.ServerMethods.ServerMethodsTesting" Codebehind="ServerMethodsTesting.aspx.cs" %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" > <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>ServerMethods example</title> <script type="text/javascript"> function onPageLoad() { // On validation error event handler ServerMethods.onValidationError = function(serverMethod, callerArguments) { alert("Validation error"); } } </script> </head> <body onload="onPageLoad();"> <form action="ServerMethodsTesting.aspx" runat="ser ver"> <!-- html goes here --> </form> </body> </html>

	== ServerMethods.onCallServerError ==		== ServerMethods.onCallServerError ==

	When a server method is called synchronous we can use a try-catch block around the call to catch exceptions that might have been thrown on the server, but doing so for an asynchronous server method is not possible because JavaScript is not waiting actively for the server side to respond back to the client side.		When a server method is called synchronous we can use a try-catch block around the call to catch exceptions that might have been thrown on the server, but doing so for an asynchronous server method is not possible because JavaScript is not waiting actively for the server side to respond back to the client side.

	Therefore we have changed the way that asynchronous server methods inform the client side about exceptions occurred on the server side. When an exception is thrown on the server it is captured by ServerMethods API and ServerMethods.onCallServerError is called.		Therefore we have changed the way that asynchronous server methods inform the client side about exceptions occurred on the server side. When an exception is thrown on the server it is captured by ServerMethods API and ServerMethods.onCallServerError is called.

	The default implementation for ServerMethods.onCallServerError method is shown below:		The default implementation for ServerMethods.onCallServerError method is shown below:

	Tekstboks: // On error event handler ServerMethods.onCallServerError = function(exception, serverMethod, callerArguments) { alert(exception.getMessage()); }		Tekstboks: // On error event handler ServerMethods.onCallServerError = function(exception, serverMethod, callerArguments) { alert(exception.getMessage()); }

	It is possible to disable the call to this method as shown in the following example; again overriding this method can only be done after the whole page has been loaded:		It is possible to disable the call to this method as shown in the following example; again overriding this method can only be done after the whole page has been loaded:

	Tekstboks: <%@ Page language="c#" Inherits="CatGlobe.Web.Common.ServerMethods.ServerMethodsTesting" Codebehind="ServerMethodsTesting.aspx.cs" %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" > <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>ServerMethods example</title> <script type="text/javascript"> function onPageLoad() { ServerMethods.onCallServerError = null; } </script> </head> <body onload="onPageLoad();"> <form action="servermethodstesting.aspx" runat="server"> <!-- html goes here --> </form> </body> </html>		Tekstboks: <%@ Page language="c#" Inherits="CatGlobe.Web.Common.ServerMethods.ServerMethodsTesting" Codebehind="ServerMethodsTesting.aspx.cs" %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" > <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>ServerMethods example</title> <script type="text/javascript"> function onPageLoad() { ServerMethods.onCallServerError = null; } </script> </head> <body onload="onPageLoad();"> <form action="servermethodstesting.aspx" runat="server"> <!-- html goes here --> </form> </body> </html>

	When the ServerMethods.onCallServerError is disabled as shown in the example above, then any exception thrown on the server will be send to the client side’s callback function instead. The next section described how it is possible to determine whether the value returned to the callback function is a ServerMethodException or actually the result that was expected.		When the ServerMethods.onCallServerError is disabled as shown in the example above, then any exception thrown on the server will be send to the client side’s callback function instead. The next section described how it is possible to determine whether the value returned to the callback function is a ServerMethodException or actually the result that was expected.

	== ServerMethodException.isException ==		== ServerMethodException.isException ==

	Instead of returning the exception as a string, the exception object ServerMethodException is now passed to the callback function if an exception was caught on the server side. In order to identify that an exception occurred a new property has been added to the ServerMethodException class called isException, so your callback function should look something like this:		Instead of returning the exception as a string, the exception object ServerMethodException is now passed to the callback function if an exception was caught on the server side. In order to identify that an exception occurred a new property has been added to the ServerMethodException class called isException, so your callback function should look something like this:

	Tekstboks: function onMyServerMethodCallback(returnValue) { if(returnValue.isException) { // Do your error handling here } // Do your normal callback handling here }		Tekstboks: function onMyServerMethodCallback(returnValue) { if(returnValue.isException) { // Do your error handling here } // Do your normal callback handling here }

	Notice that when exceptions are thrown the callback function is only called if you have disabled the error handler as described in the previous section.		Notice that when exceptions are thrown the callback function is only called if you have disabled the error handler as described in the previous section.