web service error best practices

2005-08-11 Thread Bryan Stevenson
I know...another best practices thread ;-)

I'm wondering how others out there are handling argument types for web services?

Typically if an argument is meant to be numeric you would code it as such.  Now 
if someone calling the webservice were to pass in a string instead of a number 
and error would be thrown.

I'm guessing depending on the langauge consuming the web service the error they 
get will differ??

Will that error likley tell them they passed an invalid typed argument? or 
would it be tough to determine what went wrong?

Would it be better/worse to simply make that argument accept a string and then 
in the method make sure it's a number and if not return a meaningful error 
message (so no real error occurs)?  or is it better to leave it up to the web 
service consumers to try/catch errors in their own dang app and read the web 
service specs to know what kind of arguments are to be passed? ;-)

thoughts??

TIA

Cheers

Bryan Stevenson B.Comm.
VP  Director of E-Commerce Development
Electric Edge Systems Group Inc.
phone: 250.480.0642
fax: 250.480.1264
cell: 250.920.8830
e-mail: [EMAIL PROTECTED]
web: www.electricedgesystems.com

~|
Discover CFTicket - The leading ColdFusion Help Desk and Trouble 
Ticket application

http://www.houseoffusion.com/banners/view.cfm?bannerid=48

Message: http://www.houseoffusion.com/lists.cfm/link=i:4:214602
Archives: http://www.houseoffusion.com/cf_lists/threads.cfm/4
Subscription: http://www.houseoffusion.com/lists.cfm/link=s:4
Unsubscribe: http://www.houseoffusion.com/cf_lists/unsubscribe.cfm?user=89.70.4
Donations  Support: http://www.houseoffusion.com/tiny.cfm/54


Re: web service error best practices

2005-08-11 Thread Barney Boisvert
Let them deal with it.  I suspect that CF will automatically convert
string arguments to numeric, just like it does internally, but I don't
know for sure.  Either way, it's up to the WS client to make sure
they're calling the service in the right way.  The error message
should come from the type-checker on their end, not from your server,
at least if they're using a strongly typed language.  If not, then
they'll get a type error from CF, and it should be equally
communicative of what went wrong.

cheers,
barneyb

On 8/11/05, Bryan Stevenson [EMAIL PROTECTED] wrote:
 I know...another best practices thread ;-)
 
 I'm wondering how others out there are handling argument types for web 
 services?
 
 Typically if an argument is meant to be numeric you would code it as such.  
 Now if someone calling the webservice were to pass in a string instead of a 
 number and error would be thrown.
 
 I'm guessing depending on the langauge consuming the web service the error 
 they get will differ??
 
 Will that error likley tell them they passed an invalid typed argument? or 
 would it be tough to determine what went wrong?
 
 Would it be better/worse to simply make that argument accept a string and 
 then in the method make sure it's a number and if not return a meaningful 
 error message (so no real error occurs)?  or is it better to leave it up to 
 the web service consumers to try/catch errors in their own dang app and read 
 the web service specs to know what kind of arguments are to be passed? ;-)
 
 thoughts??
 
 TIA
 
 Cheers
 
-- 
Barney Boisvert
[EMAIL PROTECTED]
360.319.6145
http://www.barneyb.com/

Got Gmail? I have 50 invites.

~|
Logware (www.logware.us): a new and convenient web-based time tracking 
application. Start tracking and documenting hours spent on a project or with a 
client with Logware today. Try it for free with a 15 day trial account.
http://www.houseoffusion.com/banners/view.cfm?bannerid=67

Message: http://www.houseoffusion.com/lists.cfm/link=i:4:214607
Archives: http://www.houseoffusion.com/cf_lists/threads.cfm/4
Subscription: http://www.houseoffusion.com/lists.cfm/link=s:4
Unsubscribe: http://www.houseoffusion.com/cf_lists/unsubscribe.cfm?user=89.70.4
Donations  Support: http://www.houseoffusion.com/tiny.cfm/54


Re: web service error best practices

2005-08-11 Thread Bryan Stevenson
 Let them deal with it.  I suspect that CF will automatically convert
 string arguments to numeric, just like it does internally, but I don't
 know for sure.  Either way, it's up to the WS client to make sure
 they're calling the service in the right way.  The error message
 should come from the type-checker on their end, not from your server,
 at least if they're using a strongly typed language.  If not, then
 they'll get a type error from CF, and it should be equally
 communicative of what went wrong.

 cheers,
 barneyb

Thank Barney...I was leaning the same waymake the service function as 
advertisedif they don't pay attention then kablooey ;-)

Cheers

Bryan Stevenson B.Comm.
VP  Director of E-Commerce Development
Electric Edge Systems Group Inc.
phone: 250.480.0642
fax: 250.480.1264
cell: 250.920.8830
e-mail: [EMAIL PROTECTED]
web: www.electricedgesystems.com 


~|
Find out how CFTicket can increase your company's customer support 
efficiency by 100%
http://www.houseoffusion.com/banners/view.cfm?bannerid=49

Message: http://www.houseoffusion.com/lists.cfm/link=i:4:214610
Archives: http://www.houseoffusion.com/cf_lists/threads.cfm/4
Subscription: http://www.houseoffusion.com/lists.cfm/link=s:4
Unsubscribe: http://www.houseoffusion.com/cf_lists/unsubscribe.cfm?user=89.70.4
Donations  Support: http://www.houseoffusion.com/tiny.cfm/54