класс 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.