wrest 1.0.0.beta2-universal-java-1.6

data/lib/wrest/components/container/alias_accessors.rb

@@ -0,0 +1,66 @@
+# Copyright 2009 Sidu Ponnappa
+
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and limitations under the License.
+
+module Wrest
+  module Components::Container
+    module AliasAccessors
+      def self.included(klass) #:nodoc:
+        klass.extend AliasAccessors::ClassMethods
+      end
+
+      def self.build_aliased_attribute_getter(attribute_name, alias_name) #:nodoc:
+        "def #{alias_name};#{attribute_name};end;"
+      end
+
+      def self.build_aliased_attribute_setter(attribute_name, alias_name) #:nodoc:
+        "def #{alias_name}=(value);self.#{attribute_name}=value;end;"
+      end
+
+      def self.build_aliased_attribute_queryer(attribute_name, alias_name) #:nodoc:
+        "def #{alias_name}?;self.#{attribute_name}?;end;"
+      end
+      
+      module ClassMethods
+        # Creates an alias set of getter, setter and query methods for 
+        # attributes that aren't quite the way you'd like them to be; this
+        # is especially useful when you have no control over the source web
+        # sevice/resource.
+        #
+        # For example, lets say that a particular resource exposes a
+        # User's age as 'a' and sex as 's'. Typically, you'd have to access it as
+        # user.a and user.s whereas you's like to access it as user.age and user.sex.
+        # This is where alias_accessors comes into the picture. Your User class would
+        # look somethig like this:
+        #
+        #  class User
+        #    include Wrest::Components::Container
+        #
+        #    alias_accessors  :a => :age,
+        #                     :s => :sex
+        #  end
+        # This would create the methods user.age, user.age= and user.age? which delegates
+        # to user.a, user.a= and user.a? respectively.
+        #
+        # See examples/wow_realm_status.rb for a working example.
+        # 
+        # WARNING: If you try to create an alias with the same name as the attribute,
+        # and then use it, you _will_ cause an infinite loop.
+        def alias_accessors(alias_map)
+          alias_map.each do |attribute_name, alias_name|
+            self.class_eval(
+            AliasAccessors.build_aliased_attribute_getter(attribute_name, alias_name) +
+            AliasAccessors.build_aliased_attribute_setter(attribute_name, alias_name) +
+            AliasAccessors.build_aliased_attribute_queryer(attribute_name, alias_name)
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/wrest/components/container/alias_accessors.rbc

@@ -0,0 +1,905 @@
+!RBIX
+0
+x
+M
+1
+n
+n
+x
+10
+__script__
+i
+28
+99
+7
+0
+65
+49
+1
+2
+13
+99
+12
+7
+2
+12
+7
+3
+12
+65
+12
+49
+4
+4
+15
+49
+2
+0
+15
+2
+11
+I
+6
+I
+0
+I
+0
+I
+0
+n
+p
+5
+x
+5
+Wrest
+x
+11
+open_module
+x
+15
+__module_init__
+M
+1
+n
+n
+x
+5
+Wrest
+i
+30
+5
+66
+99
+7
+0
+45
+1
+2
+49
+3
+2
+13
+99
+12
+7
+4
+12
+7
+5
+12
+65
+12
+49
+6
+4
+15
+49
+4
+0
+11
+I
+6
+I
+0
+I
+0
+I
+0
+n
+p
+7
+x
+9
+Container
+x
+10
+Components
+n
+x
+17
+open_module_under
+x
+15
+__module_init__
+M
+1
+n
+n
+x
+9
+Container
+i
+28
+5
+66
+99
+7
+0
+65
+49
+1
+2
+13
+99
+12
+7
+2
+12
+7
+3
+12
+65
+12
+49
+4
+4
+15
+49
+2
+0
+11
+I
+6
+I
+0
+I
+0
+I
+0
+n
+p
+5
+x
+14
+AliasAccessors
+x
+11
+open_module
+x
+15
+__module_init__
+M
+1
+n
+n
+x
+14
+AliasAccessors
+i
+72
+5
+66
+99
+7
+0
+7
+1
+65
+5
+49
+2
+4
+15
+99
+7
+3
+7
+4
+65
+5
+49
+2
+4
+15
+99
+7
+5
+7
+6
+65
+5
+49
+2
+4
+15
+99
+7
+7
+7
+8
+65
+5
+49
+2
+4
+15
+99
+7
+9
+65
+49
+10
+2
+13
+99
+12
+7
+11
+12
+7
+12
+12
+65
+12
+49
+2
+4
+15
+49
+11
+0
+11
+I
+6
+I
+0
+I
+0
+I
+0
+n
+p
+13
+x
+8
+included
+M
+1
+n
+n
+x
+8
+included
+i
+11
+20
+0
+45
+0
+1
+43
+2
+49
+3
+1
+11
+I
+3
+I
+1
+I
+1
+I
+1
+n
+p
+4
+x
+14
+AliasAccessors
+n
+x
+12
+ClassMethods
+x
+6
+extend
+p
+5
+I
+0
+I
+d
+I
+0
+I
+e
+I
+b
+x
+72
+/Users/sidu/Work/wrest/lib/wrest/components/container/alias_accessors.rb
+p
+1
+x
+5
+klass
+x
+13
+attach_method
+x
+30
+build_aliased_attribute_getter
+M
+1
+n
+n
+x
+30
+build_aliased_attribute_getter
+i
+21
+7
+0
+20
+1
+47
+49
+1
+0
+7
+2
+20
+0
+47
+49
+1
+0
+7
+3
+63
+5
+11
+I
+7
+I
+2
+I
+2
+I
+2
+n
+p
+4
+s
+4
+def 
+x
+4
+to_s
+s
+1
+;
+s
+5
+;end;
+p
+5
+I
+0
+I
+11
+I
+0
+I
+12
+I
+15
+x
+72
+/Users/sidu/Work/wrest/lib/wrest/components/container/alias_accessors.rb
+p
+2
+x
+14
+attribute_name
+x
+10
+alias_name
+x
+30
+build_aliased_attribute_setter
+M
+1
+n
+n
+x
+30
+build_aliased_attribute_setter
+i
+21
+7
+0
+20
+1
+47
+49
+1
+0
+7
+2
+20
+0
+47
+49
+1
+0
+7
+3
+63
+5
+11
+I
+7
+I
+2
+I
+2
+I
+2
+n
+p
+4
+s
+4
+def 
+x
+4
+to_s
+s
+14
+=(value);self.
+s
+11
+=value;end;
+p
+5
+I
+0
+I
+15
+I
+0
+I
+16
+I
+15
+x
+72
+/Users/sidu/Work/wrest/lib/wrest/components/container/alias_accessors.rb
+p
+2
+x
+14
+attribute_name
+x
+10
+alias_name
+x
+31
+build_aliased_attribute_queryer
+M
+1
+n
+n
+x
+31
+build_aliased_attribute_queryer
+i
+21
+7
+0
+20
+1
+47
+49
+1
+0
+7
+2
+20
+0
+47
+49
+1
+0
+7
+3
+63
+5
+11
+I
+7
+I
+2
+I
+2
+I
+2
+n
+p
+4
+s
+4
+def 
+x
+4
+to_s
+s
+7
+?;self.
+s
+6
+?;end;
+p
+5
+I
+0
+I
+19
+I
+0
+I
+1a
+I
+15
+x
+72
+/Users/sidu/Work/wrest/lib/wrest/components/container/alias_accessors.rb
+p
+2
+x
+14
+attribute_name
+x
+10
+alias_name
+x
+12
+ClassMethods
+x
+11
+open_module
+x
+15
+__module_init__
+M
+1
+n
+n
+x
+12
+ClassMethods
+i
+16
+5
+66
+99
+7
+0
+7
+1
+65
+67
+49
+2
+0
+49
+3
+4
+11
+I
+5
+I
+0
+I
+0
+I
+0
+n
+p
+4
+x
+15
+alias_accessors
+M
+1
+n
+n
+x
+15
+alias_accessors
+i
+8
+20
+0
+56
+0
+50
+1
+0
+11
+I
+3
+I
+1
+I
+1
+I
+1
+n
+p
+2
+M
+1
+p
+2
+x
+9
+for_block
+t
+n
+x
+15
+alias_accessors
+i
+49
+58
+37
+19
+0
+15
+37
+19
+1
+15
+15
+5
+45
+0
+1
+20
+0
+20
+1
+49
+2
+2
+45
+0
+3
+20
+0
+20
+1
+49
+4
+2
+81
+5
+45
+0
+6
+20
+0
+20
+1
+49
+7
+2
+81
+5
+49
+8
+1
+11
+I
+8
+I
+2
+I
+2
+I
+2
+n
+p
+9
+x
+14
+AliasAccessors
+n
+x
+30
+build_aliased_attribute_getter
+n
+x
+30
+build_aliased_attribute_setter
+x
+1
++
+n
+x
+31
+build_aliased_attribute_queryer
+x
+10
+class_eval
+p
+13
+I
+0
+I
+37
+I
+a
+I
+38
+I
+b
+I
+39
+I
+15
+I
+3a
+I
+21
+I
+3b
+I
+2d
+I
+38
+I
+31
+x
+72
+/Users/sidu/Work/wrest/lib/wrest/components/container/alias_accessors.rb
+p
+2
+x
+14
+attribute_name
+x
+10
+alias_name
+x
+4
+each
+p
+5
+I
+0
+I
+36
+I
+0
+I
+37
+I
+8
+x
+72
+/Users/sidu/Work/wrest/lib/wrest/components/container/alias_accessors.rb
+p
+1
+x
+9
+alias_map
+x
+17
+method_visibility
+x
+15
+add_defn_method
+p
+3
+I
+2
+I
+36
+I
+10
+x
+72
+/Users/sidu/Work/wrest/lib/wrest/components/container/alias_accessors.rb
+p
+0
+p
+11
+I
+2
+I
+d
+I
+d
+I
+11
+I
+18
+I
+15
+I
+23
+I
+19
+I
+2e
+I
+1d
+I
+48
+x
+72
+/Users/sidu/Work/wrest/lib/wrest/components/container/alias_accessors.rb
+p
+0
+x
+13
+attach_method
+p
+3
+I
+2
+I
+c
+I
+1c
+x
+72
+/Users/sidu/Work/wrest/lib/wrest/components/container/alias_accessors.rb
+p
+0
+x
+13
+attach_method
+p
+3
+I
+2
+I
+b
+I
+1e
+x
+72
+/Users/sidu/Work/wrest/lib/wrest/components/container/alias_accessors.rb
+p
+0
+x
+13
+attach_method
+p
+3
+I
+0
+I
+a
+I
+1c
+x
+72
+/Users/sidu/Work/wrest/lib/wrest/components/container/alias_accessors.rb
+p
+0