dot_net_services 0.3.0 → 0.4.0

data/lib/service_bus/message_buffer.rb

@@ -0,0 +1,313 @@
+# Copyright (c) 2009, Persistent Systems Limited
+#
+# Redistribution and use, with or without modification, are permitted
+#  provided that the following  conditions are met:
+#   - Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   - Neither the name of Persistent Systems Limited nor the names of its contributors
+#     may be used to endorse or promote products derived from this software
+#     without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE, DATA, OR PROFITS
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+require "#{__FILE__}/../http_proxy"
+require "#{__FILE__}/../requests"
+require "#{__FILE__}/../message_buffer_policy"
+require "#{__FILE__}/../locked_message_info"
+require "#{__FILE__}/../../acs/shared_secret_token_provider"
+require "#{__FILE__}/../../common/dot_net_services_environment"
+
+# This class contains implementation to 
+# * Create a message buffer
+# * Retrieve message buffer policy for a given message buffer name
+# * Delete a message buffer
+# * Send message to a message buffer
+# * Make a peek lock on a message buffer
+# * Delete a locked message in the given message buffer
+# * Release lock on a locked message buffer
+# * Retrieve a message from the given message buffer
+# 
+# The class includes  DotNetServices::HTTPRequests module that holds implementations to make HTTP requests
+class MessageBuffer
+  include HTTPProxy
+  include DotNetServices::HTTPRequests
+  
+  HTTP_STATUS_CODE_OK = '200'
+  HTTP_STATUS_CODE_CREATED  = '201'
+  HTTP_STATUS_CODE_ACCEPTED  = '202'
+  HTTP_STATUS_CODE_NORESPONSE  = '204'
+  HTTP_STATUS_CODE_BADREQUEST  = '400'
+  HTTP_STATUS_CODE_INTERNAL_SERVER_ERROR  = '500'
+  HTTP_HEADER_EXPECT = '100-continue'
+  
+  ACCEPTED_RESPONSE_CODES = [HTTP_STATUS_CODE_ACCEPTED, HTTP_STATUS_CODE_CREATED, HTTP_STATUS_CODE_OK]
+  
+  DEFAULT_LOCK_DURATION = "120"
+  DEFAULT_RECEIVE_TIMEOUT = "60"
+  DEFAULT_SEND_TIMEOUT = "60"
+  
+  # Initializes the Mesasge Buffer object with following settings
+  # * issuer_name 
+  # * issuer_key (issuer_secret or Management key)
+  # * solution_name
+  # * service_name
+  # * proxy - OPTIONAL hash with keys
+  #   * 'http_web_proxy_server'
+  #   * 'http_web_proxy_port'
+  #   * 'http_web_proxy_username'
+  #   * 'http_web_proxy_password'
+  def initialize(issuer_name, issuer_key, solution_name, service_name, proxy = {})
+    @issuer_name = issuer_name
+    @issuer_key = issuer_key
+    @solution_name = solution_name
+    @service_name = service_name
+    @proxy = proxy
+    set_http_web_proxy(proxy)
+    @acm_host_name = DotNetServicesEnvironment.acm_host_name
+    @service_bus_host_name = DotNetServicesEnvironment.service_bus_host_name
+  end
+
+  # Creates a message buffer. Accepts following params
+  # * msg_buffer_name
+  # * msg_buffer_policy_obj (+MessageBufferPolicy+)
+  def create_message_buffer(msg_buffer_name, msg_buffer_policy_obj)
+    raise 'Message Buffer Policy cannot be nil' unless msg_buffer_policy_obj
+    msg_buffer_policy = msg_buffer_policy_obj.message_buffer_policy
+    request_uri, msg_buffer_uri = msg_buffer_uris(msg_buffer_name)
+    raise 'Message buffer URI not found' unless msg_buffer_uri
+    token = acquire_authorization_token(request_uri, msg_buffer_uri)
+    begin
+      options = {}
+      header = {
+        'Content-type' => MessageBufferConstants.content_type_property_for_atom_xml,
+        'Authorization' => authorization(token),
+        'Expect' => HTTP_HEADER_EXPECT
+      }
+      
+      options.store(:header, header)
+      response = put(msg_buffer_uri, msg_buffer_policy, options)
+      if ACCEPTED_RESPONSE_CODES.include?(response.code)
+        return response.body
+      else
+        raise("Unexpected response code #{response.code}")
+      end
+    rescue
+      raise "Unexpected exception occured in create_message_buffer"
+    end
+  end
+  
+  # Fetches policy of the given message buffer. Expects - 
+  # * Message Buffer Name
+  def policy(msg_buffer_name)
+    request_uri, msg_buffer_uri = msg_buffer_uris(msg_buffer_name)
+    token = acquire_authorization_token(request_uri, msg_buffer_uri)
+    options = {}
+    header = {
+      'Content-type' => MessageBufferConstants.content_type_property_for_atom_xml,
+      'Expect' => HTTP_HEADER_EXPECT,
+      'Authorization' => authorization(token) 
+    }
+    
+    options.store(:header, header)
+    response = get(msg_buffer_uri, options)
+    if response.code == HTTP_STATUS_CODE_OK
+      body = response.body
+      if body.match(/<entry xmlns=/)
+        return body
+      else
+        raise 'Unexpected response body while trying to get the message buffer policy'
+      end
+    end
+  end
+  
+  # Deletes message buffer. Expects -
+  # * Message Buffer Name
+  def delete_message_buffer(msg_buffer_name)
+    request_uri, msg_buffer_uri = msg_buffer_uris(msg_buffer_name)
+    token = acquire_authorization_token(request_uri, msg_buffer_uri)
+    options = {}
+    header = {
+      'Content-type' => MessageBufferConstants.content_type_property_for_atom_xml,
+      'Expect' => HTTP_HEADER_EXPECT,
+      'Authorization' => authorization(token) 
+    }
+    options.store(:header, header)
+    response = delete(msg_buffer_uri, options)
+    if response.code == HTTP_STATUS_CODE_OK
+      return response.body
+    else
+      raise "Unexpected response code #{response.code}"
+    end
+  end
+    
+  # Sends given message to given message buffer. Expects - 
+  # * Message Buffer Name
+  # * Message body
+  # * timeout(Default = DEFAULT_SEND_TIMEOUT)
+  def send_message(msg_buffer_name, msg_str, timeout = DEFAULT_SEND_TIMEOUT)
+    send_path = MessageBufferConstants.path_for_send_message
+    timeout_parameter = MessageBufferConstants.timeout_parameter
+    msg_buffer_uri = message_uri(msg_buffer_name, send_path)
+    message = formatted_message(msg_str)
+    token = acquire_authorization_token(request_uri, msg_buffer_uri)
+    send_uri = msg_buffer_uri + "?" + timeout_parameter + "=" + timeout
+    options = {}
+    header = {
+      'Content-type' => MessageBufferConstants.content_type_property_for_text,
+      'Expect' => HTTP_HEADER_EXPECT,
+      'Authorization' => authorization(token) 
+    }
+    options.store(:header, header)
+    response = post(send_uri, message, options)
+    ACCEPTED_RESPONSE_CODES.include?(response.code) || raise("Unexpected response code #{response.code}")
+  end
+  
+  # Makes a peek lock on given message buffer. Expects - 
+  # * Message Buffer Name
+  # * Timeout(Default = DEFAULT_SEND_TIMEOUT)
+  # * Lock Duration(Default = DEFAULT_LOCK_DURATION)
+  def peek_lock(msg_buffer_name, timeout = DEFAULT_RECEIVE_TIMEOUT, lock_duration = DEFAULT_LOCK_DURATION)
+    retrieve_path = MessageBufferConstants.path_for_retrieve_message
+    timeout_parameter = MessageBufferConstants.timeout_parameter
+    lock_duration_parameter = MessageBufferConstants.lock_duration_parameter
+    msg_buffer_uri = message_uri(msg_buffer_name, retrieve_path)
+    token = acquire_authorization_token(request_uri, msg_buffer_uri)
+    retrieve_url = msg_buffer_uri + "?" + timeout_parameter + "=" + timeout + "&" + lock_duration_parameter + "=" + lock_duration
+    options = {}
+    header = { 
+        'Content-type' => MessageBufferConstants.content_type_property_for_text,
+        'Expect' => HTTP_HEADER_EXPECT,
+        'Authorization' => authorization(token) ,
+        'Accept' => "*/*" 
+    }
+    options.store(:header,header)
+    response = post(retrieve_url, "", options)
+     if ACCEPTED_RESPONSE_CODES.include?(response.code)
+      return LockedMessageInfo.new(
+        response['X-MS-LOCK-ID'],
+        response['X-MS-LOCK-LOCATION'],
+        response['X-MS-MESSAGE-LOCATION']         
+      )
+    else
+      raise "Unexpected response code #{response.code}"
+    end
+  end  
+
+  # Deletes a locked message. Expects following arguments obtained as part of the response of peek_lock- 
+  # * Message Buffer Uri
+  # * Lock Id
+  def delete_locked_message(message_uri, lock_id)
+    lock_id_parameter = MessageBufferConstants.lock_id_parameter
+    token = acquire_authorization_token(request_uri, message_uri)
+    delete_uri = message_uri + "?" + lock_id_parameter + "=" + lock_id
+    options = {}
+    header = { 
+      'Content-type' => MessageBufferConstants.content_type_property_for_atom_xml,
+      'Expect' => HTTP_HEADER_EXPECT,
+      'Authorization' => "#{MessageBufferConstants.shared_secret_header} #{CGI::unescape(token)}",
+      'Accept' => "*/*"
+     }
+    options.store(:header,header)
+    response = delete(delete_uri, options)
+    if response.code == HTTP_STATUS_CODE_OK
+      return response.body
+    else
+      raise "Unexpected response code #{response.code}"
+    end
+  end  
+
+  # Releases lock. Expects following arguments obtained as part of the response of peek_lock- 
+  # * Lock Uri
+  def release_lock(lock_uri)
+    token = acquire_authorization_token(request_uri, lock_uri)
+    options = {}
+    header = { 
+      'Content-type' => MessageBufferConstants.content_type_property_for_text,
+      'Expect' => HTTP_HEADER_EXPECT,
+      'Authorization' => authorization(token) ,
+      'Accept' => "*/*"
+     }
+    options.store(:header,header)
+    response = delete(lock_uri,options)
+    if response.code == HTTP_STATUS_CODE_OK
+      return response.body
+    else
+      raise "Unexpected response code #{response.code}"
+    end
+  end  
+
+  # Retrieve the message in the message buffer. Expects -
+  # * Message Buffer Name
+  # * Timeout(Default = DEFAULT_SEND_TIMEOUT)
+  def retrieve_message(msg_buffer_name, timeout = DEFAULT_RECEIVE_TIMEOUT)
+    retrieve_path = MessageBufferConstants.path_for_retrieve_message
+    timeout_parameter = MessageBufferConstants.timeout_parameter
+    msg_buffer_uri = message_uri(msg_buffer_name, retrieve_path)
+    token = acquire_authorization_token(request_uri, msg_buffer_uri)
+    retrieve_url = msg_buffer_uri.to_s + "?" + timeout_parameter.to_s + "=" + timeout.to_s
+    options = {}
+    header = { 
+      'Content-type' => MessageBufferConstants.content_type_property_for_text,
+      'Authorization' => "#{MessageBufferConstants.shared_secret_header} #{CGI.unescape(token)}"
+     }
+    options.store(:header,header)
+    response = delete(retrieve_url,options)
+    if response.code == HTTP_STATUS_CODE_OK
+      return response.body
+    else
+      raise "Unexpected response code #{response.code}"
+    end
+  end  
+
+  private
+  
+  def acquire_authorization_token(request_uri, msg_buffer_uri)
+    begin
+      shared_secret_token_provider = SharedSecretTokenProvider.new(@issuer_name, @issuer_key, @proxy)
+      token_info = shared_secret_token_provider.token(request_uri, msg_buffer_uri) #msg_buffer_uri = applies_to
+      token_info.token
+    rescue
+        raise 'Unable to acquire ACS (Shared Secret) Token'
+    end
+  end
+
+  def authorization(token)
+    "#{MessageBufferConstants.shared_secret_header} #{CGI::unescape(token)}"
+  end
+  
+  def msg_buffer_uris(msg_buffer_name)
+    return request_uri, message_buffer_create_uri(msg_buffer_name)
+  end
+  
+  def request_uri 
+    "https://#{@solution_name}-sb.#{@acm_host_name}/#{@service_name}/" #The slash at the end is ESSENTIAL
+  end
+
+  def message_buffer_create_uri(message_buffer_name)
+    "http://#{@solution_name}.#{@service_bus_host_name}/#{message_buffer_name}/" #The slash at the end is ESSENTIAL
+  end
+
+  # This method returns the message in xml format
+  def formatted_message(message)
+    msg = "<s:Envelope xmlns:s='http://www.w3.org/2003/05/soap-envelope' xmlns:a='http://www.w3.org/2005/08/addressing'>"
+    msg += "<s:Header><a:Action s:mustUnderstand='1'/></s:Header>"
+    msg += "<s:Body><string xmlns='#{MessageBufferConstants.message_namespace}'>#{message}</string></s:Body>"
+    msg += "</s:Envelope>"
+    msg
+  end
+  
+  def message_uri(message_buffer_name, send_path)
+    "http://#{@solution_name}.#{@service_bus_host_name}/#{message_buffer_name}/#{send_path}"
+  end
+
+end

data/lib/service_bus/message_buffer_constants.rb

@@ -0,0 +1,48 @@
+# Copyright (c) 2009, Persistent Systems Limited
+#
+# Redistribution and use, with or without modification, are permitted
+#  provided that the following  conditions are met:
+#   - Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   - Neither the name of Persistent Systems Limited nor the names of its contributors
+#     may be used to endorse or promote products derived from this software
+#     without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE, DATA, OR PROFITS
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+class MessageBufferConstants # :nodoc: 
+  @shared_secret_header = 'WRAPv0.8'
+  @content_type_property_for_atom_xml = 'application/atom+xml;type=entry;charset=utf-8'
+  @content_type_property_for_text = 'text/xml;charset=utf-8'
+  @path_for_send_message = 'messages'
+  @path_for_retrieve_message = 'messages/head'
+  @message_namespace = 'http://schemas.microsoft.com/2003/10/Serialization/'
+  @message_buffer_policy_namespace = 'http://schemas.microsoft.com/netservices/2009/05/servicebus/connect'
+  @lock_duration_parameter = 'lockduration'
+  @timeout_parameter = 'timeout'
+  @lock_id_parameter = 'lockid'
+
+	class << self
+    attr_accessor :shared_secret_header, 
+      :content_type_property_for_atom_xml,
+      :content_type_property_for_text,
+      :path_for_send_message,
+      :path_for_retrieve_message,
+      :message_namespace,
+      :message_buffer_policy_namespace,
+      :lock_duration_parameter,
+      :timeout_parameter,
+      :lock_id_parameter
+  end
+end
+

data/lib/service_bus/message_buffer_policy.rb

@@ -0,0 +1,55 @@
+# Copyright (c) 2009, Persistent Systems Limited
+#
+# Redistribution and use, with or without modification, are permitted
+#  provided that the following  conditions are met:
+#   - Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   - Neither the name of Persistent Systems Limited nor the names of its contributors
+#     may be used to endorse or promote products derived from this software
+#     without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE, DATA, OR PROFITS
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+require "#{__FILE__}/../message_buffer_constants"
+
+class MessageBufferPolicy
+  
+  # Initializes message buffer policy. Does not expect any parameters by default.
+  # * Authorization - DEFAULT = "Required"
+  # * Transport Protection - DEFAULT = "None"
+  # * Expires After - DEFAULT = "PT5M"
+  # * Max Message Count - DEFAULT = 10
+  def initialize(authorization = "Required", transport_protection = "None", expires_after = "PT5M", max_message_count = 10)
+    @authorization = authorization
+    @transport_protection = transport_protection
+    @expires_after = expires_after
+    @max_message_count = max_message_count
+    @message_buffer_policy_name  = message_buffer_policy
+  end  
+
+  # Returns the message buffer policy in atom format
+  def message_buffer_policy
+    xml_str = "<entry xmlns='http://www.w3.org/2005/Atom'><content type='text/xml'><MessageBufferPolicy xmlns:i='http://www.w3.org/2001/XMLSchema-instance' "
+		xml_str += "xmlns='#{MessageBufferConstants.message_buffer_policy_namespace}'>"
+		xml_str += "<Authorization>#{@authorization}</Authorization>"
+		xml_str += "<TransportProtection>#{@transport_protection}</TransportProtection>"
+		xml_str += "<ExpiresAfter>#{@expires_after}</ExpiresAfter>"
+		xml_str += "<MaxMessageCount>#{@max_message_count}</MaxMessageCount>"
+		xml_str += "</MessageBufferPolicy></content></entry>"
+		xml_str
+  end
+  
+  #TODO, there could be a static method that accepts the policy in xml and returns the msg_buffer_policy object. Another kind of constructor
+
+end
+

data/lib/service_bus/requests.rb

@@ -0,0 +1,95 @@
+# Copyright (c) 2009, Persistent Systems Limited
+#
+# Redistribution and use, with or without modification, are permitted
+#  provided that the following  conditions are met:
+#   - Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   - Neither the name of Persistent Systems Limited nor the names of its contributors
+#     may be used to endorse or promote products derived from this software
+#     without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE, DATA, OR PROFITS
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+require 'net/https'
+require "#{__FILE__}/../message_buffer_constants"
+
+module DotNetServices # :nodoc:
+  module HTTPRequests # :nodoc:
+  
+    module ToHash # :nodoc:
+      def to_hash
+        data_hash = {}
+        self.split('&').each do |param_pair|
+          param, val = param_pair.split('=')
+          data_hash.store(param, val)
+        end
+        data_hash
+      end
+    end
+    
+    def proxy
+      #TODO Uncomment the following line of code and comment the next line of code BEFORE RELEASE
+      # @http_web_proxy || Net::HTTP
+      @http_web_proxy || Net::HTTP::Proxy('itgproxy.redmond.corp.microsoft.com', '80')
+    end
+    
+    def get(url, options = {})
+      header = options[:header] if options[:header]
+      url = URI.parse(url)
+      req = Net::HTTP::Get.new(url.path, header)
+      req.basic_auth options[:http_username], options[:http_password] if options[:http_username] && options[:http_password]
+      res = proxy.start(url.host, url.port) do |http| 
+        yield(req, http) if block_given?
+        http.request(req)
+      end
+      res
+    end
+    
+    def delete(url, options = {})
+      header = options[:header] if options[:header]
+      url = URI.parse(url)
+      url_path = (url.query && url.query != '') ? (url.path + '?' + url.query) : url.path
+      req = Net::HTTP::Delete.new(url_path, header)
+      req.basic_auth options[:http_username], options[:http_password] if options[:http_username] && options[:http_password]
+      res = proxy.start(url.host, url.port) do |http| 
+        yield(req, http) if block_given?
+        http.request(req)
+      end
+      res
+    end
+    
+    def post(url, data, options = {})
+     header = options[:header] if options[:header]
+     url = URI.parse(url)
+     url_path = (url.query && url.query != '') ? (url.path + '?' + url.query) : url.path
+     http = proxy.new(url.host, url.port)
+     http.use_ssl = true if options[:use_ssl]
+     http = http.start
+     yield(req, http) if block_given?
+     res = http.post(url_path, data, header) 
+     res
+   end
+
+    def put(url , data, options = {})
+     header = options[:header] if options[:header]
+     url = URI.parse(url)
+     url_path = (url.query && url.query != '') ? (url.path + '?' + url.query) : url.path
+     http = proxy.new(url.host, url.port)
+     yield(req, http) if block_given?
+     http = http.start
+     res = http.put(url_path, data, header) 
+     res
+    end
+    
+  end
+end

data/test/config/test_config.yml

@@ -0,0 +1,40 @@
+# Copyright (c) 2009, Persistent Systems Limited
+#
+# Redistribution and use, with or without modification, are permitted
+#  provided that the following  conditions are met:
+#   - Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   - Neither the name of Persistent Systems Limited nor the names of its contributors
+#     may be used to endorse or promote products derived from this software
+#     without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE, DATA, OR PROFITS
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+simple_api_auth:
+  wrap_name: infocorp
+  wrap_password: eFBmEieKwRht6W6bSTuKLG8pTTVudbHmkjzJ++DukFc=
+  applies_to: http://localhost/SalesDashboard/
+  solution_name: rubyservice
+  trusted_key: YtO+yRw7gIXvU2ObK0P4W6hsCQPmQPlo/geg8zJDrb0=
+  
+#Setting the proxy is optional. You may also set http_web_proxy_username and http_web_proxy_password if you need to.
+proxy:
+  http_web_proxy_server: itgproxy.redmond.corp.microsoft.com
+  http_web_proxy_port: 80
+  
+type_token:
+  issuer_name: owner
+  issuer_key: Jtt77GMAGljdnTXqvHlwijwGobEJXfT4+xlXAnLQoB4=
+  rest_applies_to: http://rubyservice.servicebus.windows.net/whatver/
+  rest_request_uri: https://rubyservice-sb.accesscontrol.windows.net/WRAPv0.8/
+  

data/test/dot_net_services_environment_test.rb

@@ -0,0 +1,54 @@
+# Copyright (c) 2009, Persistent Systems Limited
+#
+# Redistribution and use, with or without modification, are permitted
+#  provided that the following  conditions are met:
+#   - Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   - Neither the name of Persistent Systems Limited nor the names of its contributors
+#     may be used to endorse or promote products derived from this software
+#     without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE, DATA, OR PROFITS
+# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+# EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+require '../lib/common/dot_net_services_environment'
+require 'test/unit'
+
+class DotNetServicesEnvironmentTest < Test::Unit::TestCase
+  def setup
+    @dnse = DotNetServicesEnvironment
+    @host_names = @dnse::HOST_NAMES
+  end
+
+  def test_acm_host_name
+    assert_equal @host_names["default"]["acm"], @dnse.acm_host_name
+    assert_equal @host_names["int"]["acm"], @dnse.acm_host_name("int")
+    assert_equal @host_names["ppe"]["acm"], @dnse.acm_host_name("ppe")
+    assert_equal @host_names["prod"]["acm"], @dnse.acm_host_name("prod")
+  end
+
+  def test_sts_host_name
+    assert_equal @host_names["default"]["sts"], @dnse.sts_host_name
+    assert_equal @host_names["int"]["sts"], @dnse.sts_host_name("int")
+    assert_equal @host_names["ppe"]["sts"], @dnse.sts_host_name("ppe")
+    assert_equal @host_names["prod"]["sts"], @dnse.sts_host_name("prod")
+  end
+
+  def test_service_bus_host_name
+    assert_equal @host_names["default"]["service_bus"], @dnse.service_bus_host_name
+    assert_equal @host_names["int"]["service_bus"], @dnse.service_bus_host_name("int")
+    assert_equal @host_names["ppe"]["service_bus"], @dnse.service_bus_host_name("ppe")
+    assert_equal @host_names["prod"]["service_bus"], @dnse.service_bus_host_name("prod")
+  end
+
+end
+