定义良好的web service接口

 asp.net写的web service例子
http://www.huangbowen.net/post/web-service-eaxmple.html

最近搞了两天的web service测试，对于这些web service接口感觉实在是XX，加上经常在网上看见兄弟们讨论web service相关的一些问题，觉得十分有必要对什么是比较好的web service接口有个统一的认识。今天这篇B文就来说说我眼中定义良好的web service接口是个什么鸟样子。
谨慎的抛出异常。可以把web service中的异常（SOAP FAULT）对比Java的runtime exception。任何异常都应该对应系统意外，而不是业务例外。对于这点其实要具体情况具体分析。简单的可以归纳为三种情况。第一种情况是接口返回值是简单类型，比如boolean型，就true和false两种情况，不抛出异常怎么办？选择有两种，一是抛出异常（废话！台下别扔鸡蛋，西红柿我喜欢吃），二是改变接口，返回int用1和0对应true和false，用-1对应系统异常。第二种情况是接口返回值是复杂对象（RPC），这种情况下其实没办法改变什么，忍一忍，抛出个简单的异常得了。注意这时候可别把异常对象再套个七八层，你不累用你接口的人也累。第三种情况是返回值是xml文档对象，这种情况可以把xml文档定义的灵活一些，让它能够兼容正常和异常的情况。
btw：写完回头一看，KAO，居然有十条，这绝不是我的本意，兄弟们自己看着取舍。