WSO2 WSF/Ruby Stepping towards 1.0

Yesterday We were doing an RC on WSO2 WSF/Ruby. It will enable growing ruby and rails developers to feel the taste of WS-* stack without having any trouble.

WSF/Ruby is based on the WSO2 WSF/C which itself based on set of apache web service projects like Axis2/C, Rampart/C, Sandesha/C, Savan/C. So the WSF/Ruby will be great platform to experience the power of these project.

Consuming a web services with WSF/Ruby is really simple. It need very few line of code to do a simple web service,

---

require "wsf"   req_payload_string = "<greet> Hello </greet>" 

client = WSO2::WSF::WSClient.new({"to" => "http://greeting_host/myservice"}) 

res_message = client.request(req_payload_string) 

p res_message.payload_to_s << "\n"

---

The service provider code would be simple as this, You may put this on some function in the controller class inside Rails. (Yea I mean Ruby on Rails)

---

def greet(message)      if message.payload_to_s == "Hello"   

      "<greetResponse>Welcome!</greetResponse>"   

   else 

      "<greetResponse>Still Welcome!</greetResponse>" 

   end 

end

service = WSService.new({"operations" => {"greet" => "greet"}}) #the greet service operation to greet function map 

res = service.reply(request, response) 

render :text => res

---

Ok, That may seems ordinary. How about improving the service by authenticating the user with username tokens,Consumers may give their identity by adding some options at the constructor of WSO2::WSF::WSClient,

---

   policy_content = {"use_username_token" => true}   

 policy = WSPolicy.new({"security" => policy_content})   

 security_options = {"user" => "dimuthu",   

     "password" => "not my real one",   

     "password_type" => "Digest"} 

security_token = WSSecurityToken.new(security_options) 

options = {"to" => "http://greeting_host/myservice", 

      "policy" => policy, 

      "security_token" => security_token} 

client = WSClient.new(options)

---

And the service provider will also change their code just to authenticate the user,

---

  def passwordCallBack(username)    # hopefully you will be taking the password out from database   

  if(username == "dimuthu")   

    return "not my real one" 

  else 

    return "I m a guest" 

  end 

end  

policy_content = {"use_username_token" => true} 

policy = WSO2::WSF::WSPolicy.new({"security" => policy_content}) 

sec_token = WSO2::WSF::WSSecurityToken.new({"password_callback" => "passwordCallBack", 

                                            "password_type" => "Digest"}) 

wss = WSO2::WSF::WSService.new({"operations" => operations, 

                                "policy" => policy, 

                                "securityToken" => sec_token})

---

Similarly not only the username token, but also complete specifications of WS-Security, WS-Addressing, WS-Policy and WS-Reliable messaging can be used from a simple script with WSF/Ruby. This API is proven to be simple and popular with its predecessor WSO2 WSF/PHP. Hope we can do the same in Ruby as well.:)