Class: Mongrel2::Config
- Inherits:
-
Object
- Object
- Mongrel2::Config
- Extended by:
- Configurability, Loggability
- Includes:
- Constants
- Defined in:
- lib/mongrel2/config.rb
Overview
The base Mongrel2 database-backed configuration class. It’s a subclass of Sequel::Model, so you’ll first need to be familiar with Sequel (sequel.rubyforge.org/) and especially its Sequel::Model ORM.
You will also probably want to refer to the Sequel::Plugins documentation for the validation_helpers and subclasses plugins.
References
Defined Under Namespace
Modules: DSL Classes: Directory, Filter, Handler, Host, Log, Mimetype, Proxy, Route, Server, Setting, Statistic, XRequest
Constant Summary collapse
- CONFIG_DEFAULTS =
Configuration defaults
{ :configdb => Mongrel2::DEFAULT_CONFIG_URI, }
- DEFAULTS =
CONFIG_DEFAULTS
- CONFIG_SQL =
The Pathname of the SQL file used to create the config database
DATA_DIR + 'config.sql'
- MIMETYPES_SQL =
The Pathname of the SQL file used to add default mimetypes mappings to the config database
DATA_DIR + 'mimetypes.sql'
Constants included from Constants
Mongrel2::Constants::DATA_DIR, Mongrel2::Constants::DEFAULT_CONFIG_SCRIPT, Mongrel2::Constants::DEFAULT_CONFIG_URI, Mongrel2::Constants::DEFAULT_CONTROL_SOCKET, Mongrel2::Constants::MAX_BROADCAST_IDENTS
Class Method Summary collapse
-
.configure(config = nil) ⇒ Object
Configurability API – called when the configuration is loaded with the ‘mongrel2’ section of the config file if there is one.
-
.database_initialized? ⇒ Boolean
Returns
true
if the config database has been installed. -
.db=(newdb) ⇒ Object
Reset the database connection that all model objects will use to
newdb
, which should be a Sequel::Database. -
.dbname ⇒ Object
Return the name of the current config database, or nil if the current database is an in-memory one.
-
.in_memory_db ⇒ Object
Return a Sequel::Database for an in-memory database via the available SQLite library.
-
.init_database ⇒ Object
Initialize the currently-configured database (if it hasn’t been already).
-
.init_database! ⇒ Object
Initialize the currently-configured database, dropping any existing tables.
-
.load_config_schema ⇒ Object
Return the contents of the configuration schema SQL file.
-
.load_mimetypes_sql ⇒ Object
Return the contents of the mimetypes SQL file.
-
.log_action(what, why = nil, where = nil, how = nil) ⇒ Object
Log an entry to the commit log with the given
what
,why
,where
, andhow
values and return it after it’s saved. -
.mimetypes ⇒ Object
Return a Hash of current mimetypes from the config database keyed by extension.
-
.servers ⇒ Object
Return the Array of currently-configured servers in the config database as Mongrel2::Config::Server objects.
-
.settings ⇒ Object
Return a Hash of current settings from the config database.
-
.sqlite_adapter ⇒ Object
Return the name of the Sequel SQLite adapter to use.
Class Method Details
.configure(config = nil) ⇒ Object
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.
119 120 121 122 123 124 125 126 127 128 129 130 |
# File 'lib/mongrel2/config.rb', line 119 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 |
.database_initialized? ⇒ Boolean
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.
195 196 197 198 199 |
# File 'lib/mongrel2/config.rb', line 195 def self::database_initialized? return self.without_sql_logging do self.db.table_exists?( :server ) end end |
.db=(newdb) ⇒ Object
Reset the database connection that all model objects will use to newdb
, which should be a Sequel::Database.
135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 |
# File 'lib/mongrel2/config.rb', line 135 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 |
.dbname ⇒ Object
Return the name of the current config database, or nil if the current database is an in-memory one.
227 228 229 230 231 232 233 234 235 |
# File 'lib/mongrel2/config.rb', line 227 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 |
.in_memory_db ⇒ Object
Return a Sequel::Database for an in-memory database via the available SQLite library
110 111 112 |
# File 'lib/mongrel2/config.rb', line 110 def self::in_memory_db return Sequel.connect( adapter: self.sqlite_adapter ) end |
.init_database ⇒ Object
Initialize the currently-configured database (if it hasn’t been already)
203 204 205 206 |
# File 'lib/mongrel2/config.rb', line 203 def self::init_database return if self.database_initialized? return self.init_database! end |
.init_database! ⇒ Object
Initialize the currently-configured database, dropping any existing tables.
210 211 212 213 214 215 216 217 218 219 220 221 222 |
# File 'lib/mongrel2/config.rb', line 210 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 |
.load_config_schema ⇒ Object
Return the contents of the configuration schema SQL file.
182 183 184 |
# File 'lib/mongrel2/config.rb', line 182 def self::load_config_schema return CONFIG_SQL.read end |
.load_mimetypes_sql ⇒ Object
Return the contents of the mimetypes SQL file.
188 189 190 |
# File 'lib/mongrel2/config.rb', line 188 def self::load_mimetypes_sql return MIMETYPES_SQL.read end |
.log_action(what, why = nil, where = nil, how = nil) ⇒ Object
Log an entry to the commit log with the given what
, why
, where
, and how
values and return it after it’s saved.
240 241 242 |
# File 'lib/mongrel2/config.rb', line 240 def self::log_action( what, why=nil, where=nil, how=nil ) Mongrel2::Config::Log.log_action( what, why, where, how ) end |
.mimetypes ⇒ Object
Return a Hash of current mimetypes from the config database keyed by extension.
172 173 174 175 176 177 178 |
# File 'lib/mongrel2/config.rb', line 172 def self::mimetypes unless @mimetypes @mimetypes = Mongrel2::Config::Mimetype.to_hash( :extension, :mimetype ) @mimetypes.freeze end return @mimetypes end |
.servers ⇒ Object
Return the Array of currently-configured servers in the config database as Mongrel2::Config::Server objects.
158 159 160 |
# File 'lib/mongrel2/config.rb', line 158 def self::servers return Mongrel2::Config::Server.all end |
.settings ⇒ Object
Return a Hash of current settings from the config database. The keys are converted to Symbols.
165 166 167 168 |
# File 'lib/mongrel2/config.rb', line 165 def self::settings setting_hash = Mongrel2::Config::Setting.to_hash( :key, :value ) return Mongrel2::Table.new( setting_hash ) end |
.sqlite_adapter ⇒ Object
Return the name of the Sequel SQLite adapter to use. If the amalgalite library is available, this will return ‘amalgalite’, else it returns ‘sqlite’.
100 101 102 103 104 105 106 |
# File 'lib/mongrel2/config.rb', line 100 def self::sqlite_adapter if defined?( ::Amalgalite ) return 'amalgalite' else return 'sqlite' end end |