класс CGI::Session::PStore

Родитель:: Объект

Класс хранения сессий на основе PStore.

Он основан на классе PStore верхнего уровня, предоставляемом файлом библиотеки pstore.rb. Данные сессии Session сериализуются и хранятся в файле. Предоставляются средства блокировки файла и транзакций.

Публичные методы класса

new(session, option={}) Показать исходный код

# File lib/cgi/session/pstore.rb, line 46
def initialize(session, option={})
  dir = option['tmpdir'] || Dir::tmpdir
  prefix = option['prefix'] || ''
  id = session.session_id
  require 'digest/md5'
  md5 = Digest::MD5.hexdigest(id)[0,16]
  path = dir+"/"+prefix+md5
  path.untaint
  if File::exist?(path)
    @hash = nil
  else
    unless session.new_session
      raise CGI::Session::NoSession, "uninitialized session"
    end
    @hash = {}
  end
  @p = ::PStore.new(path)
  @p.transaction do |p|
    File.chmod(0600, p.path)
  end
end

Создать новый экземпляр CGI::Session::PStore.

Этот конструктор используется внутри CGI::Session. Пользователю, как правило, не нужно вызывать его напрямую.

session — сессия, для которой создается этот экземпляр. Идентификатор сессии должен содержать только буквенно-цифровые символы; автоматически сгенерированные идентификаторы сессий соответствуют этому требованию.

option — хеш опций для инициализатора. Признаются следующие опции:

tmpdir: директория для хранения файла PStore. По умолчанию Dir.tmpdir (обычно “/tmp” в системах Unix).
prefix: префикс, добавляемый к идентификатору сессии при генерации имени файла для файла PStore этой сессии. По умолчанию пустая строка.

Файл PStore этой сессии будет создан, если он не существует, или открыт, если существует.

Публичные методы экземпляра

close() Показать исходный код

# File lib/cgi/session/pstore.rb, line 88
def close
  update
end

Обновить и закрыть файл PStore сессии.

delete() Показать исходный код

# File lib/cgi/session/pstore.rb, line 93
def delete
  path = @p.path
  File::unlink path
end

Закрыть и удалить файл PStore сессии.

restore() Показать исходный код

# File lib/cgi/session/pstore.rb, line 71
def restore
  unless @hash
    @p.transaction do
      @hash = @p['hash'] || {}
    end
  end
  @hash
end

Восстановить состояние сессии из файла PStore сессии.

Возвращает состояние сессии в виде хеша.

update() Показать исходный код

# File lib/cgi/session/pstore.rb, line 81
def update
  @p.transaction do
    @p['hash'] = @hash
  end
end

Сохранить состояние сессии в файле PStore сессии.

Ruby Core © 1993–2017 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.