class Knj::Objects attr_reader :args, :events, :data def initialize(args) require "#{$knjpath}arrayext" require "#{$knjpath}event_handler" require "#{$knjpath}hash_methods" @callbacks = {} @args = Knj::ArrayExt.hash_sym(args) @args[:col_id] = :id if !@args[:col_id] @args[:class_pre] = "class_" if !@args[:class_pre] @args[:module] = Kernel if !@args[:module] @args[:cache] = :weak if !@args.key?(:cache) @objects = {} @data = {} @mutex_require = Mutex.new require "weakref" if @args[:cache] == :weak and !Kernel.const_defined?(:WeakRef) @events = Knj::Event_handler.new @events.add_event( :name => :no_html, :connections_max => 1 ) @events.add_event( :name => :no_date, :connections_max => 1 ) @events.add_event( :name => :missing_class, :connections_max => 1 ) raise "No DB given." if !@args[:db] and !@args[:custom] raise "No class path given." if !@args[:class_path] and (@args[:require] or !@args.key?(:require)) if args[:require_all] require "#{$knjpath}php" loads = [] Dir.foreach(@args[:class_path]) do |file| next if file == "." or file == ".." or !file.match(/\.rb$/) file_parsed = file file_parsed.gsub!(@args[:class_pre], "") if @args.key?(:class_pre) file_parsed.gsub!(/\.rb$/, "") file_parsed = Knj::Php.ucwords(file_parsed) loads << file_parsed self.requireclass(file_parsed, {:load => false}) end loads.each do |load_class| self.load_class(load_class) end end end def init_class(classname) return false if @objects.key?(classname) @objects[classname] = {} end #Returns a cloned version of the @objects variable. Cloned because iteration on it may crash some of the other methods in Ruby 1.9+ def objects objs_cloned = {} @objects.keys.each do |key| objs_cloned[key] = @objects[key].clone end return objs_cloned end def db return @args[:db] end def count_objects count = 0 @objects.keys.each do |key| count += @objects[key].length end return count end def connect(args, &block) raise "No object given." if !args["object"] raise "No signals given." if !args.key?("signal") and !args.key?("signals") args["block"] = block if block_given? @callbacks[args["object"]] = {} if !@callbacks[args["object"]] conn_id = @callbacks[args["object"]].length.to_s @callbacks[args["object"]][conn_id] = args end def call(args, &block) classstr = args["object"].class.to_s if @callbacks.key?(classstr) @callbacks[classstr].clone.each do |callback_key, callback| docall = false if callback.key?("signal") and args.key?("signal") and callback["signal"] == args["signal"] docall = true elsif callback["signals"] and args["signal"] and callback["signals"].index(args["signal"]) != nil docall = true end next if !docall if callback["block"] callargs = [] arity = callback["block"].arity if arity <= 0 #do nothing elsif arity == 1 callargs << args["object"] else raise "Unknown number of arguments: #{arity}" end callback["block"].call(*callargs) elsif callback["callback"] Knj::Php.call_user_func(callback["callback"], args) else raise "No valid callback given." end end end end def requireclass(classname, args = {}) classname = classname.to_sym return false if @objects.key?(classname) @mutex_require.synchronize do if (@args[:require] or !@args.key?(:require)) and (!args.key?(:require) or args[:require]) filename = "#{@args[:class_path]}/#{@args[:class_pre]}#{classname.to_s.downcase}.rb" filename_req = "#{@args[:class_path]}/#{@args[:class_pre]}#{classname.to_s.downcase}" raise "Class file could not be found: #{filename}." if !File.exists?(filename) require filename_req end if args[:class] classob = args[:class] else begin classob = @args[:module].const_get(classname) rescue NameError => e if @events.connected?(:missing_class) @events.call(:missing_class, { :class => classname }) classob = @args[:module].const_get(classname) else raise e end end end if (classob.respond_to?(:load_columns) or classob.respond_to?(:datarow_init)) and (!args.key?(:load) or args[:load]) self.load_class(classname, args) end @objects[classname] = {} end end #Loads a Datarow-class by calling various static methods. def load_class(classname, args = {}) if args[:class] classob = args[:class] else classob = @args[:module].const_get(classname) end pass_arg = Knj::Hash_methods.new(:ob => self, :db => @args[:db]) classob.load_columns(pass_arg) if classob.respond_to?(:load_columns) classob.datarow_init(pass_arg) if classob.respond_to?(:datarow_init) end #Gets an object from the ID or the full data-hash in the database. def get(classname, data) classname = classname.to_sym if data.is_a?(Integer) or data.is_a?(String) or data.is_a?(Fixnum) id = data.to_i elsif data.is_a?(Hash) and data.key?(@args[:col_id].to_sym) id = data[@args[:col_id].to_sym].to_i elsif data.is_a?(Hash) and data.key?(@args[:col_id].to_s) id = data[@args[:col_id].to_s].to_i elsif raise Knj::Errors::InvalidData, "Unknown data: '#{data.class.to_s}'." end if @objects.key?(classname) and @objects[classname].key?(id) case @args[:cache] when :weak begin obj = @objects[classname][id].__getobj__ if obj.is_a?(Knj::Datarow) and obj.respond_to?(:table) and obj.respond_to?(:id) and obj.table.to_sym == classname and obj.id.to_i == id return obj else #This actually happens sometimes... WTF!? - knj raise WeakRef::RefError end rescue WeakRef::RefError @objects[classname].delete(id) rescue NoMethodError => e #NoMethodError because the object might have been deleted from the cache, and __getobj__ then throws it. raise e if e.message != "undefined method `__getobj__' for nil:NilClass" end else return @objects[classname][id] end end self.requireclass(classname) if !@objects.key?(classname) if @args[:datarow] or @args[:custom] obj = @args[:module].const_get(classname).new(Knj::Hash_methods.new(:ob => self, :data => data)) else args = [data] args = args | @args[:extra_args] if @args[:extra_args] obj = @args[:module].const_get(classname).new(*args) end case @args[:cache] when :weak @objects[classname][id] = WeakRef.new(obj) when :none return obj else @objects[classname][id] = obj end return obj end def object_finalizer(id) classname = @objects_idclass[id] if classname @objects[classname].delete(id) @objects_idclass.delete(id) end end def get_by(classname, args = {}) classname = classname.to_sym self.requireclass(classname) classob = @args[:module].const_get(classname) raise "list-function has not been implemented for #{classname}" if !classob.respond_to?("list") args["limit"] = 1 self.list(classname, args) do |obj| return obj end return false end def get_try(obj, col_name, obj_name = nil) if !obj_name if match = col_name.to_s.match(/^(.+)_id$/) obj_name = Knj::Php.ucwords(match[1]).to_sym else raise "Could not figure out objectname for: #{col_name}." end end id_data = obj[col_name].to_i return false if id_data.to_i <= 0 begin return self.get(obj_name, id_data) rescue Knj::Errors::NotFound return false end end #Returns an array-list of objects. If given a block the block will be called for each element and memory will be spared if running weak-link-mode. def list(classname, args = {}, &block) args = {} if args == nil classname = classname.to_sym self.requireclass(classname) classob = @args[:module].const_get(classname) raise "list-function has not been implemented for '#{classname}'." if !classob.respond_to?("list") if @args[:datarow] or @args[:custom] ret = classob.list(Knj::Hash_methods.new(:args => args, :ob => self, :db => @args[:db]), &block) else realargs = [args] realargs = realargs | @args[:extra_args] if @args[:extra_args] ret = classob.list(*realargs, &block) end #If 'ret' is an array and a block is given then the list-method didnt return blocks. We emulate it instead with the following code. if block and ret.is_a?(Array) ret.each do |obj| block.call(obj) end return nil elsif block and ret != nil raise "Return should return nil because of block but didnt. It wasnt an array either..." elsif block return nil else return ret end end #Returns select-options-HTML for inserting into a HTML-select-element. def list_opts(classname, args = {}) Knj::ArrayExt.hash_sym(args) classname = classname.to_sym if args[:list_args].is_a?(Hash) list_args = args[:list_args] else list_args = {} end html = "" if args[:addnew] or args[:add] html << "#{_("Add new")}" end self.list(classname, args[:list_args]) do |object| html << "" rescue Exception => e html << ">[#{object.class.name}: #{e.message}]" end end return html end #Returns a hash which can be used to generate HTML-select-elements. def list_optshash(classname, args = {}) Knj::ArrayExt.hash_sym(args) classname = classname.to_sym if args[:list_args].is_a?(Hash) list_args = args[:list_args] else list_args = {} end if RUBY_VERSION[0..2] == 1.8 and Knj::Php.class_exists("Dictionary") print "Spawning dictionary.\n" if args[:debug] list = Dictionary.new else print "Spawning normal hash.\n" if args[:debug] list = {} end if args[:addnew] or args[:add] list["0"] = _("Add new") elsif args[:choose] list["0"] = _("Choose") + ":" elsif args[:all] list["0"] = _("All") elsif args[:none] list["0"] = _("None") end print "Doing loop\n" if args[:debug] self.list(classname, args[:list_args]) do |object| print "Object: #{object.id}\n" if args[:debug] if object.respond_to?(:name) list[object.id] = object.name elsif object.respond_to?(:title) list[object.id] = object.title else raise "Object of class '#{object.class.name}' doesnt support 'name' or 'title." end end print "Returning...\n" if args[:debug] return list end #Returns a list of a specific object by running specific SQL against the database. def list_bysql(classname, sql, d = nil, &block) classname = classname.to_sym ret = [] if !block @args[:db].q(sql) do |d_obs| if block block.call(self.get(classname, d_obs)) else ret << self.get(classname, d_obs) end end return ret if !block end # Add a new object to the database and to the cache. def add(classname, data = {}) classname = classname.to_sym self.requireclass(classname) if @args[:datarow] classobj = @args[:module].const_get(classname) if classobj.respond_to?(:add) classobj.add(Knj::Hash_methods.new( :ob => self, :db => self.db, :data => data )) end required_data = classobj.required_data required_data.each do |req_data| if !data.key?(req_data[:col]) raise "No '#{req_data[:class]}' given by the data '#{req_data[:col]}'." end begin obj = self.get(req_data[:class], data[req_data[:col]]) rescue Knj::Errors::NotFound raise "The '#{req_data[:class]}' by ID '#{data[req_data[:col]]}' could not be found with the data '#{req_data[:col]}'." end end ins_id = @args[:db].insert(classobj.table, data, {:return_id => true}) retob = self.get(classname, ins_id) elsif @args[:custom] classobj = @args[:module].const_get(classname) retob = classobj.add(Knj::Hash_methods.new( :ob => self, :data => data )) else args = [data] args = args | @args[:extra_args] if @args[:extra_args] retob = @args[:module].const_get(classname).add(*args) end self.call("object" => retob, "signal" => "add") if retob.respond_to?(:add_after) retob.send(:add_after, {}) end return retob end #Adds several objects to the database at once. This is faster than adding every single object by itself, since this will do multi-inserts if supported by the database. def adds(classname, datas) if !@args[:datarow] datas.each do |data| @args[:module].const_get(classname).add(*args) self.call("object" => retob, "signal" => "add") end else if @args[:module].const_get(classname).respond_to?(:add) datas.each do |data| @args[:module].const_get(classname).add(Knj::Hash_methods.new( :ob => self, :db => self.db, :data => data )) end end db.insert_multi(classname, datas) end end #Calls a static method on a class. Passes the d-variable which contains the Objects-object, database-reference and more... def static(class_name, method_name, *args, &block) raise "Only available with datarow enabled." if !@args[:datarow] and !@args[:custom] class_name = class_name method_name = method_name self.requireclass(class_name) class_obj = @args[:module].const_get(class_name) #Sometimes this raises the exception but actually responds to the class? Therefore commented out. - knj #raise "The class '#{class_obj.name}' has no such method: '#{method_name}' (#{class_obj.methods.sort.join(", ")})." if !class_obj.respond_to?(method_name) pass_args = [] if @args[:datarow] pass_args << Knj::Hash_methods.new(:ob => self, :db => self.db) else pass_args << Knj::Hash_methods.new(:ob => self) end args.each do |arg| pass_args << arg end class_obj.send(method_name, *pass_args, &block) end #Unset object. Do this if you are sure, that there are no more references left. This will be done automatically when deleting it. def unset(object) if object.is_a?(Array) object.each do |obj| unset(obj) end return nil end classname = object.class.name if @args[:module] classname = classname.gsub(@args[:module].name + "::", "") end classname = classname.to_sym #if !@objects.key?(classname) #raise "Could not find object class in cache: #{classname}." #elsif !@objects[classname].key?(object.id.to_i) #errstr = "" #errstr << "Could not unset object from cache.\n" #errstr << "Class: #{object.class.name}.\n" #errstr << "ID: #{object.id}.\n" #errstr << "Could not find object ID in cache." #raise errstr #else @objects[classname].delete(object.id.to_i) #end end def unset_class(classname) if classname.is_a?(Array) classname.each do |classn| self.unset_class(classn) end return false end classname = classname.to_sym return false if !@objects.key?(classname) @objects[classname] = {} end #Delete an object. Both from the database and from the cache. def delete(object) self.call("object" => object, "signal" => "delete_before") self.unset(object) obj_id = object.id object.delete if object.respond_to?(:delete) if @args[:datarow] object.class.depending_data.each do |dep_data| objs = self.list(dep_data[:classname], {dep_data[:colname].to_s => object.id, "limit" => 1}) if !objs.empty? raise "Cannot delete <#{object.class.name}:#{object.id}> because <#{objs[0].class.name}:#{objs[0].id}> depends on it." end end if object.class.translations _kas.trans_del(object) end @args[:db].delete(object.table, {:id => obj_id}) end self.call("object" => object, "signal" => "delete") object.destroy end #Deletes several objects as one. If running datarow-mode it checks all objects before it starts to actually delete them. Its faster than deleting every single object by itself... def deletes(objs) if !@args[:datarow] objs.each do |obj| self.delete(obj) end else arr_ids = [] ids = [] objs.each do |obj| ids << obj.id if ids.length >= 1000 arr_ids << ids ids = [] end obj.delete if obj.respond_to?(:delete) end arr_ids << ids if ids.length > 0 arr_ids.each do |ids| @args[:db].delete(objs[0].table, {:id => ids}) end end end # Try to clean up objects by unsetting everything, start the garbagecollector, get all the remaining objects via ObjectSpace and set them again. Some (if not all) should be cleaned up and our cache should still be safe... dirty but works. def clean(classn) return false if @args[:cache] == :weak or @args[:cache] == :none if classn.is_a?(Array) classn.each do |realclassn| self.clean(realclassn) end else return false if !@objects.key?(classn) @objects[classn] = {} GC.start end end #Erases the whole cache and regenerates is from ObjectSpace if not running weak-link-caching. If running weaklink-caching then only removes the dead links. def clean_all return self.clean_all_weak if @args[:cache] == :weak return false if @args[:cache] == :none classnames = [] @objects.keys.each do |classn| classnames << classn end classnames.each do |classn| @objects[classn] = {} end GC.start self.clean_recover end #Runs through all objects-weaklink-references and removes the weaklinks if the object has been recycled. def clean_all_weak @objects.keys.each do |classn| @objects[classn].keys.each do |object_id| object = @objects[classn][object_id] begin if !object or !object.weakref_alive? @objects[classn].delete(object_id) end rescue WeakRef::RefError #This happens if the object has been collected. @objects[classn].delete(object_id) end end end end #Regenerates cache from ObjectSpace. Its pretty dangerous but can be used in envs where WeakRef is not supported (did someone say Rhodes?). def clean_recover return false if @args[:cache] == :weak or @args[:cache] == :none return false if RUBY_ENGINE == "jruby" and !JRuby.objectspace @objects.keys.each do |classn| data = @objects[classn] classobj = @args[:module].const_get(classn) ObjectSpace.each_object(classobj) do |obj| begin data[obj.id.to_i] = obj rescue => e if e.message == "No data on object." #Object has been unset - skip it. next end raise e end end end end end require "#{$knjpath}objects/objects_sqlhelper"