Introduction

　　Web Services Made Easy (WSME) simplifies the writing of REST web services by providing simple yet powerful typing,

　　removing the need to directly manipulate the request and the response objects.

Protocols

　　WSEM support lots of protocols.

　　'restjson':　　 Implements a REST+Json protocol.

　　'restxml':　　 Implements a REST+Xml protocol.

　　'soap':　　　　Implements the SOAP protocol.

Conception

WSRoot:　　　Root controller for webservices

@expose: 　　The return type of web service interface

@validate:　　Validate the incoming paramters type

@signature: 　Set the return type and the incoming paramters type

Example

　　WSME provide details implements for Web Service.

　　WSME need a Web Framework to provide service.

　　In the OpenStack, Horizon use Django web framework.

　　The following example use bottle web framework.

 

from wsme import WSRoot, expose, validate, signaturefrom wsme.types import Fileimport bottlefrom six import uclass Person(object):    id = int    firstname = unicode    lastname = unicode    hobbies = [unicode]    def __repr__(self):        return "Person(%s, %s %s, %s)" % (            self.id,            self.firstname, self.lastname,            self.hobbies        )class DemoRoot(WSRoot):    @expose(int)    @validate(int, int)    def multiply(self, a, b):        return a * b    @expose(File)    @validate(File)    def echofile(self, afile):        return afile    @expose(unicode)    def helloworld(self):        return u"Здраво, свете (<- Hello World in Serbian !)"    @expose(Person)    def getperson(self):        p = Person()        p.id = 12        p.firstname = u'Ross'        p.lastname = u'Geler'        p.hobbies = []        print p        return p    @expose([Person])    def listpersons(self):        p = Person()        p.id = 12        p.firstname = u('Ross')        p.lastname = u('Geler')        r = [p]        p = Person()        p.id = 13        p.firstname = u('Rachel')        p.lastname = u('Green')        r.append(p)        print r        return r    @expose(Person)    @validate(Person)    def setperson(self, person):        return person    @expose([Person])    @validate([Person])    def setpersons(self, persons):        print persons        return persons    @signature(int, int, int)    def increment(self, value, delta=1):        return value + delta    @signature(Person, body=Person)    def updateauthor(self, person):        return person # Set Web Root Pathroot = DemoRoot(webpath='/ws') # Add Soap protocolroot.addprotocol('soap',        tns='http://example.com/demo',        typenamespace='http://example.com/demo/types',        baseURL='http://127.0.0.1:8080/ws/',)# Add Rest Json protocalroot.addprotocol('restjson')# Create a wsgi Applicationbottle.mount('/ws/', root.wsgiapp())# Run Applicaton in bottlebottle.run()