Ruby-Mongrel2

Constants

CONFIG_DEFAULTS: Configuration defaults
CONFIG_SQL: The Pathname of the SQL file used to create the config database
DEFAULTS
MIMETYPES_SQL: The Pathname of the SQL file used to add default mimetypes mappings to the config database

Public Class Methods

anchor

configure( config=nil )

Configurability API – called when the configuration is loaded with the 'mongrel2' section of the config file if there is one. This method can also be used without Configurability by passing an object that can be merged with Mongrel2::Config::CONFIG_DEFAULTS.

# File lib/mongrel2/config.rb, line 117
def self::configure( config=nil )
        return unless config

        config = CONFIG_DEFAULTS.merge( config )

        if dbspec = config[ :configdb ]
                # Assume it's a path to a sqlite database if it doesn't have a schema
                dbspec = "%s://%s" % [ self.sqlite_adapter, dbspec ] unless
                        dbspec.include?( ':' )
                self.db = Sequel.connect( dbspec )
        end
end

anchor

database_initialized?()

Returns true if the config database has been installed. This currently only checks to see if the 'server' table exists for the sake of speed.

# File lib/mongrel2/config.rb, line 193
def self::database_initialized?
        return self.without_sql_logging do
                self.db.table_exists?( :server )
        end
end

anchor

db=( newdb )

Reset the database connection that all model objects will use to newdb, which should be a Sequel::Database.

# File lib/mongrel2/config.rb, line 133
def self::db=( newdb )
        @db = newdb
        if @dataset
                Loggability.for_logger( self ).with_level( :fatal ) do
                        set_dataset( newdb.dataset.clone(@dataset.opts) )
                end
        end

        if self == Mongrel2::Config
                newdb.logger = Loggability[ Mongrel2 ].proxy_for( newdb )
                newdb.sql_log_level = :debug

                self.descendents.each do |subclass|
                        self.log.debug "Resetting database connection for %p to: %p (%#16x)" %
                                [ subclass, newdb, newdb.object_id * 2 ]
                        subclass.db = newdb
                end
        end
end

anchor

dbname()

Return the name of the current config database, or nil if the current database is an in-memory one.

# File lib/mongrel2/config.rb, line 225
def self::dbname
        if self.db.opts[:database]
                return self.db.opts[:database]
        elsif self.db.uri
                return URI( self.db.uri )
        else
                return nil
        end
end

anchor

in_memory_db()

Return a Sequel::Database for an in-memory database via the available SQLite library

# File lib/mongrel2/config.rb, line 108
def self::in_memory_db
        return Sequel.connect( adapter: self.sqlite_adapter )
end

anchor

init_database()

Initialize the currently-configured database (if it hasn't been already)

# File lib/mongrel2/config.rb, line 201
def self::init_database
        return if self.database_initialized?
        return self.init_database!
end

anchor

init_database!()

Initialize the currently-configured database, dropping any existing tables.

# File lib/mongrel2/config.rb, line 208
def self::init_database!
        sql = self.load_config_schema
        mimetypes_sql = self.load_mimetypes_sql

        self.log.warn "Installing config schema."

        self.db.execute_ddl( sql )
        self.db.run( mimetypes_sql )

        # Force the associations to reset
        self.db = db
        self.log_action( "Initialized the config database." )
end

anchor

load_config_schema()

Return the contents of the configuration schema SQL file.

# File lib/mongrel2/config.rb, line 180
def self::load_config_schema
        return CONFIG_SQL.read
end

anchor

load_mimetypes_sql()

Return the contents of the mimetypes SQL file.

# File lib/mongrel2/config.rb, line 186
def self::load_mimetypes_sql
        return MIMETYPES_SQL.read
end

anchor

log_action( what, why=nil, where=nil, how=nil )

Log an entry to the commit log with the given what, why, where, and how values and return it after it's saved.

# File lib/mongrel2/config.rb, line 238
def self::log_action( what, why=nil, where=nil, how=nil )
        Mongrel2::Config::Log.log_action( what, why, where, how )
end

anchor

mimetypes()

Return a Hash of current mimetypes from the config database keyed by extension.

# File lib/mongrel2/config.rb, line 170
def self::mimetypes
        unless @mimetypes
                @mimetypes = Mongrel2::Config::Mimetype.to_hash( :extension, :mimetype )
                @mimetypes.freeze
        end
        return @mimetypes
end

anchor

servers()

Return the Array of currently-configured servers in the config database as Mongrel2::Config::Server objects.

# File lib/mongrel2/config.rb, line 156
def self::servers
        return Mongrel2::Config::Server.all
end

anchor

settings()

Return a Hash of current settings from the config database. The keys are converted to Symbols.

# File lib/mongrel2/config.rb, line 163
def self::settings
        setting_hash = Mongrel2::Config::Setting.to_hash( :key, :value )
        return Mongrel2::Table.new( setting_hash )
end

anchor

sqlite_adapter()

Return the name of the Sequel SQLite adapter to use. If the amalgalite library is available, this will return 'amalgalite', else it returns 'sqlite'.

# File lib/mongrel2/config.rb, line 98
def self::sqlite_adapter
        if defined?( ::Amalgalite )
                return 'amalgalite'
        else
                return 'sqlite'
        end
end

Protected Class Methods

anchor

without_sql_logging( logged_db=nil ) { || ... }

Execute a block after removing all loggers from the current database handle, then restore them before returning.

# File lib/mongrel2/config.rb, line 250
def self::without_sql_logging( logged_db=nil )
        logged_db ||= self.db

        loggers_to_restore = logged_db.loggers.dup
        logged_db.loggers.clear
        yield
ensure
        logged_db.loggers.replace( loggers_to_restore )
end

References¶ ↑