scalm-RocketAMF 1.0.0

data/README.rdoc

@@ -0,0 +1,47 @@
+== DESCRIPTION:
+
+RocketAMF is a full featured AMF0/3 serializer and deserializer with support for
+bi-directional Flash to Ruby class mapping, custom serialization and mapping,
+remoting gateway helpers that follow AMF0/3 messaging specs, and a suite of specs
+to ensure adherence to the specification documents put out by Adobe. If the C
+components compile, then RocketAMF automatically takes advantage of them to
+provide a substantial performance benefit. In addition, RocketAMF is fully
+compatible with Ruby 1.9.
+
+== INSTALL:
+
+  gem install RocketAMF
+
+== SIMPLE EXAMPLE:
+
+  require 'rocketamf'
+
+  hash = {:apple => "Apfel", :red => "Rot", :eyes => "Augen"}
+  File.open("amf.dat", 'w') do |f|
+    f.write RocketAMF.serialize(hash, 3) # Use AMF3 encoding to serialize
+  end
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2011 Stephen Augenstein and Jacob Henry
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,59 @@
+require 'rubygems'
+require 'rake'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+require 'rspec/core/rake_task'
+require 'rake/extensiontask'
+
+desc 'Default: run the specs.'
+task :default => :spec
+
+# I don't want to depend on bundler, so we do it the bundler way without it
+gemspec_path = 'RocketAMF.gemspec'
+spec = begin
+  eval(File.read(File.join(File.dirname(__FILE__), gemspec_path)), TOPLEVEL_BINDING, gemspec_path)
+rescue LoadError => e
+  original_line = e.backtrace.find { |line| line.include?(gemspec_path) }
+  msg  = "There was a LoadError while evaluating #{gemspec_path}:\n  #{e.message}"
+  msg << " from\n  #{original_line}" if original_line
+  msg << "\n"
+  puts msg
+  exit
+end
+
+RSpec::Core::RakeTask.new do |t|
+end
+
+desc 'Generate documentation'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = spec.name
+  rdoc.options += spec.rdoc_options
+  rdoc.rdoc_files.include(*spec.extra_rdoc_files)
+  rdoc.rdoc_files.include("lib") # Don't include ext folder because no one cares
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.need_zip = false
+  pkg.need_tar = false
+end
+
+Rake::ExtensionTask.new('rocketamf_ext', spec) do |ext|
+  if RUBY_PLATFORM =~ /mswin|mingw/ then
+    # No cross-compile on win, so compile extension to lib/1.[89]
+    RUBY_VERSION =~ /(\d+\.\d+)/
+    ext.lib_dir = "lib/#{$1}"
+  else
+    ext.cross_compile = true
+    ext.cross_platform = 'x86-mingw32'
+    ext.cross_compiling do |gem_spec|
+      gem_spec.post_install_message = "You installed the binary version of this gem!"
+    end
+  end
+  #ext.config_options << '--enable-sort-props'
+end
+
+desc "Build gem packages"
+task :gems do
+  sh "rake cross native gem RUBY_CC_VERSION=1.8.7:1.9.2"
+end

data/RocketAMF.gemspec

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name    = 'scalm-RocketAMF'
+  s.version = '1.0.0'
+  s.platform = Gem::Platform::RUBY
+  s.authors  = ['Jacob Henry', 'Stephen Augenstein', "Joc O'Connor"]
+  s.email    = ['perl.programmer@gmail.com']
+  s.homepage = 'http://github.com/scalm/rocketamf'
+  s.summary = 'Fast AMF serializer/deserializer with remoting request/response wrappers to simplify integration'
+
+  s.files         = Dir[*['README.rdoc', 'benchmark.rb', 'RocketAMF.gemspec', 'Rakefile', 'lib/**/*.rb', 'spec/**/*.{rb,bin,opts}', 'ext/**/*.{c,h,rb}']]
+  s.test_files    = Dir[*['spec/**/*_spec.rb']]
+  s.extensions    = Dir[*["ext/**/extconf.rb"]]
+  s.require_paths = ["lib"]
+
+  s.has_rdoc         = true
+  s.extra_rdoc_files = ['README.rdoc']
+  s.rdoc_options     = ['--line-numbers', '--main', 'README.rdoc']
+end

data/benchmark.rb

@@ -0,0 +1,74 @@
+$:.unshift(File.dirname(__FILE__) + '/ext')
+$:.unshift(File.dirname(__FILE__) + '/lib')
+require 'rubygems'
+require 'rocketamf'
+require 'rocketamf/pure/deserializer' # Only ext gets included by default if available
+require 'rocketamf/pure/serializer'
+
+OBJECT_COUNT = 100000
+TESTS = 5
+
+class TestClass
+  attr_accessor :prop_a, :prop_b, :prop_c, :prop_d, :prop_e
+
+  def populate some_arg=nil # Make sure class mapper doesn't think populate is a property
+    @@count ||= 1
+    @prop_a = "asdfasdf #{@@count}"
+    @prop_b = "simple string"
+    @prop_c = 3120094.03
+    @prop_d = Time.now
+    @prop_e = 3120094
+    @@count += 1
+    self
+  end
+end
+
+objs = []
+OBJECT_COUNT.times do
+  objs << TestClass.new.populate
+end
+
+["native", "pure"].each do |type|
+  # Set up class mapper
+  cm = if type == "pure"
+    RocketAMF::ClassMapping
+  else
+    RocketAMF::Ext::FastClassMapping
+  end
+  cm.define do |m|
+    m.map :as => 'TestClass', :ruby => 'TestClass'
+  end
+
+  [0, 3].each do |version|
+    # 2**24 is larger than anyone is ever going to run this for
+    min_serialize = 2**24
+    min_deserialize = 2**24
+
+    puts "Testing #{type} AMF#{version}:"
+    TESTS.times do
+      ser = if type == "pure"
+        RocketAMF::Pure::Serializer.new(cm.new)
+      else
+        RocketAMF::Ext::Serializer.new(cm.new)
+      end
+      start_time = Time.now
+      out = ser.serialize(version, objs)
+      end_time = Time.now
+      puts "\tserialize run: #{end_time-start_time}s"
+      min_serialize = [end_time-start_time, min_serialize].min
+
+      des = if type == "pure"
+        RocketAMF::Pure::Deserializer.new(cm.new)
+      else
+        RocketAMF::Ext::Deserializer.new(cm.new)
+      end
+      start_time = Time.now
+      temp = des.deserialize(version, out)
+      end_time = Time.now
+      puts "\tdeserialize run: #{end_time-start_time}s"
+      min_deserialize = [end_time-start_time, min_deserialize].min
+    end
+    puts "\tminimum serialize time: #{min_serialize}s"
+    puts "\tminimum deserialize time: #{min_deserialize}s"
+  end
+end

data/ext/rocketamf_ext/class_mapping.c

@@ -0,0 +1,484 @@
+#include <ruby.h>
+#ifdef HAVE_RB_STR_ENCODE
+#include <ruby/st.h>
+#else
+#include <st.h>
+#endif
+#include "utility.h"
+
+extern VALUE mRocketAMF;
+extern VALUE mRocketAMFExt;
+VALUE cFastMappingSet;
+VALUE cTypedHash;
+ID id_use_ac;
+ID id_use_ac_ivar;
+ID id_mappings;
+ID id_mappings_ivar;
+ID id_hashset;
+
+typedef struct {
+    VALUE mapset;
+    st_table* setter_cache;
+    st_table* prop_cache;
+} CLASS_MAPPING;
+
+typedef struct {
+    st_table* as_mappings;
+    st_table* rb_mappings;
+} MAPSET;
+
+/*
+ * Mark the as_mappings and rb_mappings hashes
+ */
+static void mapset_mark(MAPSET *set) {
+    if(!set) return;
+    rb_mark_tbl(set->as_mappings);
+    rb_mark_tbl(set->rb_mappings);
+}
+
+/*
+ * Free the mapping tables and struct
+ */
+int mapset_free_strtable_key(st_data_t key, st_data_t value, st_data_t ignored) {
+    xfree((void *)key);
+    return ST_DELETE;
+}
+static void mapset_free(MAPSET *set) {
+    st_foreach(set->as_mappings, mapset_free_strtable_key, 0);
+    st_free_table(set->as_mappings);
+    set->as_mappings = NULL;
+    st_foreach(set->rb_mappings, mapset_free_strtable_key, 0);
+    st_free_table(set->rb_mappings);
+    set->rb_mappings = NULL;
+    xfree(set);
+}
+
+/*
+ * Allocate mapset and populate mappings with built-in mappings
+ */
+static VALUE mapset_alloc(VALUE klass) {
+    MAPSET *set = ALLOC(MAPSET);
+    memset(set, 0, sizeof(MAPSET));
+    VALUE self = Data_Wrap_Struct(klass, mapset_mark, mapset_free, set);
+
+    // Initialize internal data
+    set->as_mappings = st_init_strtable();
+    set->rb_mappings = st_init_strtable();
+
+    return self;
+}
+
+/*
+ * call-seq:
+ *   RocketAMF::Ext::MappingSet.new
+ *
+ * Creates a mapping set object and populates the default mappings
+ */
+static VALUE mapset_init(VALUE self) {
+    rb_funcall(self, rb_intern("map_defaults"), 0);
+    return self;
+}
+
+/*
+ * call-seq:
+ *   m.map_defaults
+ *
+ * Adds required mapping configs, calling map for the required base mappings
+ */
+static VALUE mapset_map_defaults(VALUE self) {
+    const int NUM_MAPPINGS = 9;
+    const char* ruby_classes[] = {
+        "RocketAMF::Values::AbstractMessage",
+        "RocketAMF::Values::RemotingMessage",
+        "RocketAMF::Values::AsyncMessage",
+        "RocketAMF::Values::AsyncMessageExt",
+        "RocketAMF::Values::CommandMessage",
+        "RocketAMF::Values::CommandMessageExt",
+        "RocketAMF::Values::AcknowledgeMessage",
+        "RocketAMF::Values::AcknowledgeMessageExt",
+        "RocketAMF::Values::ErrorMessage"
+    };
+    const char* as_classes[] = {
+        "flex.messaging.messages.AbstractMessage",
+        "flex.messaging.messages.RemotingMessage",
+        "flex.messaging.messages.AsyncMessage",
+        "DSA",
+        "flex.messaging.messages.CommandMessage",
+        "DSC",
+        "flex.messaging.messages.AcknowledgeMessage",
+        "DSK",
+        "flex.messaging.messages.ErrorMessage"
+    };
+
+    int i;
+    ID map_id = rb_intern("map");
+    VALUE params = rb_hash_new();
+    VALUE as_sym = ID2SYM(rb_intern("as"));
+    VALUE ruby_sym = ID2SYM(rb_intern("ruby"));
+    for(i = 0; i < NUM_MAPPINGS; i++) {
+        rb_hash_aset(params, as_sym, rb_str_new2(as_classes[i]));
+        rb_hash_aset(params, ruby_sym, rb_str_new2(ruby_classes[i]));
+        rb_funcall(self, map_id, 1, params);
+    }
+
+    return self;
+}
+
+/*
+ * call-seq:
+ *   m.map :as => 'com.example.Date', :ruby => "Example::Date'
+ *
+ * Map a given AS class to a ruby class. Use fully qualified names for both.
+ */
+static VALUE mapset_map(VALUE self, VALUE mapping) {
+    MAPSET *set;
+    Data_Get_Struct(self, MAPSET, set);
+
+    VALUE as_class = rb_hash_aref(mapping, ID2SYM(rb_intern("as")));
+    VALUE rb_class = rb_hash_aref(mapping, ID2SYM(rb_intern("ruby")));
+    st_insert(set->as_mappings, (st_data_t)strdup(RSTRING_PTR(as_class)), rb_class);
+    st_insert(set->rb_mappings, (st_data_t)strdup(RSTRING_PTR(rb_class)), as_class);
+
+    return Qnil;
+}
+
+/*
+ * Internal method for looking up a given ruby class's AS class name or Qnil if
+ * not found
+ */
+static VALUE mapset_as_lookup(VALUE self, const char* class_name) {
+    MAPSET *set;
+    Data_Get_Struct(self, MAPSET, set);
+
+    VALUE as_name;
+    if(st_lookup(set->rb_mappings, (st_data_t)class_name, &as_name)) {
+        return as_name;
+    } else {
+        return Qnil;
+    }
+}
+
+/*
+ * Internal method for looking up a given AS class names ruby class name mapping
+ * or Qnil if not found
+ */
+static VALUE mapset_rb_lookup(VALUE self, const char* class_name) {
+    MAPSET *set;
+    Data_Get_Struct(self, MAPSET, set);
+
+    VALUE rb_name;
+    if(st_lookup(set->as_mappings, (st_data_t)class_name, &rb_name)) {
+        return rb_name;
+    } else {
+        return Qnil;
+    }
+}
+
+/*
+ * Mark the mapset object and property lookup cache
+ */
+static void mapping_mark(CLASS_MAPPING *map) {
+    if(!map) return;
+    rb_gc_mark(map->mapset);
+    rb_mark_tbl(map->prop_cache);
+}
+
+/*
+ * Free prop cache table and struct
+ */
+static void mapping_free(CLASS_MAPPING *map) {
+    st_free_table(map->setter_cache);
+    st_free_table(map->prop_cache);
+    xfree(map);
+}
+
+/*
+ * Allocate class mapping struct
+ */
+static VALUE mapping_alloc(VALUE klass) {
+    CLASS_MAPPING *map = ALLOC(CLASS_MAPPING);
+    memset(map, 0, sizeof(CLASS_MAPPING));
+    VALUE self = Data_Wrap_Struct(klass, mapping_mark, mapping_free, map);
+    map->setter_cache = st_init_numtable();
+    map->prop_cache = st_init_numtable();
+    return self;
+}
+
+/*
+ * Class-level getter for use_array_collection
+ */
+static VALUE mapping_s_array_collection_get(VALUE klass) {
+    VALUE use_ac = rb_ivar_get(klass, id_use_ac_ivar);
+    if(use_ac == Qnil) {
+        use_ac = Qfalse;
+        rb_ivar_set(klass, id_use_ac_ivar, use_ac);
+    }
+    return use_ac;
+}
+
+/*
+ * Class-level setter for use_array_collection
+ */
+static VALUE mapping_s_array_collection_set(VALUE klass, VALUE use_ac) {
+    return rb_ivar_set(klass, id_use_ac_ivar, use_ac);
+}
+
+/*
+ * Return MappingSet for class mapper, creating if uninitialized
+ */
+static VALUE mapping_s_mappings(VALUE klass) {
+    VALUE mappings = rb_ivar_get(klass, id_mappings_ivar);
+    if(mappings == Qnil) {
+        mappings = rb_class_new_instance(0, NULL, cFastMappingSet);
+        rb_ivar_set(klass, id_mappings_ivar, mappings);
+    }
+    return mappings;
+}
+
+/*
+ * call-seq:
+ *   mapper.define {|m| block } => nil
+ *
+ * Define class mappings in the block. Block is passed a MappingSet object as
+ * the first parameter. See RocketAMF::ClassMapping for details.
+ */
+static VALUE mapping_s_define(VALUE klass) {
+    if (rb_block_given_p()) {
+        VALUE mappings = rb_funcall(klass, id_mappings, 0);
+        rb_yield(mappings);
+    }
+    return Qnil;
+}
+
+/*
+ * Reset class mappings
+ */
+static VALUE mapping_s_reset(VALUE klass) {
+    rb_ivar_set(klass, id_use_ac_ivar, Qfalse);
+    rb_ivar_set(klass, id_mappings_ivar, Qnil);
+    return Qnil;
+}
+
+/*
+ * Initialize class mapping object, setting use_class_mapping to false
+ */
+static VALUE mapping_init(VALUE self) {
+    CLASS_MAPPING *map;
+    Data_Get_Struct(self, CLASS_MAPPING, map);
+    map->mapset = rb_funcall(CLASS_OF(self), id_mappings, 0);
+    VALUE use_ac = rb_funcall(CLASS_OF(self), id_use_ac, 0);
+    rb_ivar_set(self, id_use_ac_ivar, use_ac);
+    return self;
+}
+
+/*
+ * call-seq:
+ *   mapper.get_as_class_name => str
+ *
+ * Returns the AS class name for the given ruby object. Will also take a string
+ * containing the ruby class name.
+ */
+static VALUE mapping_as_class_name(VALUE self, VALUE obj) {
+    CLASS_MAPPING *map;
+    Data_Get_Struct(self, CLASS_MAPPING, map);
+
+    int type = TYPE(obj);
+    const char* class_name;
+    if(type == T_STRING) {
+        // Use strings as the class name
+        class_name = RSTRING_PTR(obj);
+    } else {
+        // Look up the class name and use that
+        VALUE klass = CLASS_OF(obj);
+        class_name = rb_class2name(klass);
+        if(klass == cTypedHash) {
+            VALUE orig_name = rb_funcall(obj, rb_intern("type"), 0);
+            class_name = RSTRING_PTR(orig_name);
+        } else if(type == T_HASH) {
+            // Don't bother looking up hash mapping, but need to check class name first in case it's a typed hash
+            return Qnil;
+        }
+    }
+
+    return mapset_as_lookup(map->mapset, class_name);
+}
+
+/*
+ * call_seq:
+ *   mapper.get_ruby_obj => obj
+ *
+ * Instantiates a ruby object using the mapping configuration based on the
+ * source AS class name. If there is no mapping defined, it returns a
+ * <tt>RocketAMF::Values::TypedHash</tt> with the serialized class name.
+ */
+static VALUE mapping_get_ruby_obj(VALUE self, VALUE name) {
+    CLASS_MAPPING *map;
+    Data_Get_Struct(self, CLASS_MAPPING, map);
+
+    VALUE argv[1];
+    VALUE ruby_class_name = mapset_rb_lookup(map->mapset, RSTRING_PTR(name));
+    if(ruby_class_name == Qnil) {
+        argv[0] = name;
+        return rb_class_new_instance(1, argv, cTypedHash);
+    } else {
+        VALUE base_const = rb_mKernel;
+        char* endptr;
+        char* ptr = RSTRING_PTR(ruby_class_name);
+        while((endptr = strstr(ptr,"::"))) {
+            endptr[0] = '\0'; // NULL terminate to make string ops work
+            base_const = rb_const_get(base_const, rb_intern(ptr));
+            endptr[0] = ':'; // Restore correct char
+            ptr = endptr + 2;
+        }
+        return rb_class_new_instance(0, NULL, rb_const_get(base_const, rb_intern(ptr)));
+    }
+}
+
+/*
+ * st_table iterator for populating a given object from a property hash
+ */
+static int mapping_populate_iter(VALUE key, VALUE val, const VALUE args[2]) {
+    CLASS_MAPPING *map;
+    Data_Get_Struct(args[0], CLASS_MAPPING, map);
+    VALUE obj = args[1];
+
+    if(TYPE(obj) == T_HASH) {
+        rb_hash_aset(obj, key, val);
+        return ST_CONTINUE;
+    }
+
+    if(TYPE(key) != T_SYMBOL) rb_raise(rb_eArgError, "Invalid type for property key: %d", TYPE(key));
+
+    // Calculate symbol for setter function
+    ID key_id = SYM2ID(key);
+    ID setter_id;
+    if(!st_lookup(map->setter_cache, key_id, &setter_id)) {
+        // Calculate symbol
+        const char* key_str = rb_id2name(key_id);
+        long len = strlen(key_str);
+        char* setter = ALLOC_N(char, len+2);
+        memcpy(setter, key_str, len);
+        setter[len] = '=';
+        setter[len+1] = '\0';
+        setter_id = rb_intern(setter);
+        xfree(setter);
+
+        // Store it
+        st_add_direct(map->setter_cache, key_id, setter_id);
+    }
+
+    if(rb_respond_to(obj, setter_id)) {
+        rb_funcall(obj, setter_id, 1, val);
+    } else if(rb_respond_to(obj, id_hashset)) {
+        rb_funcall(obj, id_hashset, 2, key, val);
+    }
+
+    return ST_CONTINUE;
+}
+
+/*
+ * call-seq:
+ *   mapper.populate_ruby_obj(obj, props, dynamic_props=nil) => obj
+ *
+ * Populates the ruby object using the given properties. Property hashes MUST
+ * have symbol keys, or it will raise an exception.
+ */
+static VALUE mapping_populate(int argc, VALUE *argv, VALUE self) {
+    // Check args
+    VALUE obj, props, dynamic_props;
+    rb_scan_args(argc, argv, "21", &obj, &props, &dynamic_props);
+
+    VALUE args[2] = {self, obj};
+    st_foreach(RHASH_TBL(props), mapping_populate_iter, (st_data_t)args);
+    if(dynamic_props != Qnil) {
+        st_foreach(RHASH_TBL(dynamic_props), mapping_populate_iter, (st_data_t)args);
+    }
+
+    return obj;
+}
+
+/*
+ * call-seq:
+ *   mapper.props_for_serialization(obj) => hash
+ *
+ * Extracts all exportable properties from the given ruby object and returns
+ * them in a hash. For performance purposes, property detection is only performed
+ * once for a given class instance, and then cached for all instances of that
+ * class. IF YOU'RE ADDING AND REMOVING PROPERTIES FROM CLASS INSTANCES YOU
+ * CANNOT USE THE FAST CLASS MAPPER.
+ */
+static VALUE mapping_props(VALUE self, VALUE obj) {
+    CLASS_MAPPING *map;
+    Data_Get_Struct(self, CLASS_MAPPING, map);
+
+    if(TYPE(obj) == T_HASH) {
+        return obj;
+    }
+
+    // Get "properties"
+    VALUE props_ary;
+    VALUE klass = CLASS_OF(obj);
+    long i, len;
+    if(!st_lookup(map->prop_cache, klass, &props_ary)) {
+        props_ary = rb_ary_new();
+
+        // Build props array
+        VALUE all_methods = rb_class_public_instance_methods(0, NULL, klass);
+        VALUE object_methods = rb_class_public_instance_methods(0, NULL, rb_cObject);
+        VALUE possible_methods = rb_funcall(all_methods, rb_intern("-"), 1, object_methods);
+        len = RARRAY_LEN(possible_methods);
+        for(i = 0; i < len; i++) {
+            VALUE meth = rb_obj_method(obj, RARRAY_PTR(possible_methods)[i]);
+            VALUE arity = rb_funcall(meth, rb_intern("arity"), 0);
+            if(FIX2INT(arity) == 0) {
+                rb_ary_push(props_ary, RARRAY_PTR(possible_methods)[i]);
+            }
+        }
+
+        // Store it
+        st_add_direct(map->prop_cache, klass, props_ary);
+    }
+
+    // Build properties hash using list of properties
+    VALUE props = rb_hash_new();
+    len = RARRAY_LEN(props_ary);
+    for(i = 0; i < len; i++) {
+        VALUE key = RARRAY_PTR(props_ary)[i];
+        ID getter = (TYPE(key) == T_STRING) ? rb_intern(RSTRING_PTR(key)) : SYM2ID(key);
+        rb_hash_aset(props, key, rb_funcall(obj, getter, 0));
+    }
+
+    return props;
+}
+
+void Init_rocket_amf_fast_class_mapping() {
+    // Define map set
+    cFastMappingSet = rb_define_class_under(mRocketAMFExt, "FastMappingSet", rb_cObject);
+    rb_define_alloc_func(cFastMappingSet, mapset_alloc);
+    rb_define_method(cFastMappingSet, "initialize", mapset_init, 0);
+    rb_define_method(cFastMappingSet, "map_defaults", mapset_map_defaults, 0);
+    rb_define_method(cFastMappingSet, "map", mapset_map, 1);
+
+    // Define FastClassMapping
+    VALUE cFastClassMapping = rb_define_class_under(mRocketAMFExt, "FastClassMapping", rb_cObject);
+    rb_define_alloc_func(cFastClassMapping, mapping_alloc);
+    rb_define_singleton_method(cFastClassMapping, "use_array_collection", mapping_s_array_collection_get, 0);
+    rb_define_singleton_method(cFastClassMapping, "use_array_collection=", mapping_s_array_collection_set, 1);
+    rb_define_singleton_method(cFastClassMapping, "mappings", mapping_s_mappings, 0);
+    rb_define_singleton_method(cFastClassMapping, "reset", mapping_s_reset, 0);
+    rb_define_singleton_method(cFastClassMapping, "define", mapping_s_define, 0);
+    rb_define_attr(cFastClassMapping, "use_array_collection", 1, 0);
+    rb_define_method(cFastClassMapping, "initialize", mapping_init, 0);
+    rb_define_method(cFastClassMapping, "get_as_class_name", mapping_as_class_name, 1);
+    rb_define_method(cFastClassMapping, "get_ruby_obj", mapping_get_ruby_obj, 1);
+    rb_define_method(cFastClassMapping, "populate_ruby_obj", mapping_populate, -1);
+    rb_define_method(cFastClassMapping, "props_for_serialization", mapping_props, 1);
+
+    // Cache values
+    cTypedHash = rb_const_get(rb_const_get(mRocketAMF, rb_intern("Values")), rb_intern("TypedHash"));
+    id_use_ac = rb_intern("use_array_collection");
+    id_use_ac_ivar = rb_intern("@use_array_collection");
+    id_mappings = rb_intern("mappings");
+    id_mappings_ivar = rb_intern("@mappings");
+    id_hashset = rb_intern("[]=");
+}