Template Toolkit: Модули: Template::Config

Template Toolkit

(русская редакция)

[ Пособия ] [ Руководство ] [ Модули ] [ Библиотеки ] [ Утилиты ] [ Вопросы ] [ Релиз ] [ Perl-ресурсы ] Форум ]
 
Поиск
Template Toolkit | Модули | Template::Config

Template::Config

[ ◄ Template::Base ] [ Template::Constants ► ]
Производящий модуль для инициализации других модулей TT2.

Оглавление

ОБЗОР

Индекс ] [ Модули ] [ Наверх ]

    use Template::Config;

ОПИСАНИЕ

Индекс ] [ Модули ] [ Наверх ]

Этот модуль реализует ряд методов для загрузки и инициализации других модулей, которые составляют Template Toolkit. Он предоставляет последовательный способ создания компонентов инструментария и позволяет использовать собственные модули разработчика вместо стандартных.

Переменные пакета такие как $STASH, $SERVICE, $CONTEXT и т.д. содержат имена модулей/пакетов для каждого компонента (Template::Stash, Template::Service и Template::Context, соответственно) и используются различными производящими методами (stash(), service() и context()) для загрузки подходящего модуля. Изменение этих переменных приведет к последующим вызовам подходящего производящего метода, загружающего и инициализирующего объект нового класса.

ПУБЛИЧНЫЕ МЕТОДЫ

Индекс ] [ Модули ] [ Наверх ]

load($module)

Загружает модуль посредством require(). Все вхождения '::' в имени модуля преобразуются в '/' и добавляется '.pm'. Возвращает 1 в случае успеха или undef при ошибке. Используйте $class->error(), чтобы получить строку с сообщением об ошибке.

preload()

Этот метод выполняет предварительную загрузку всех других модулей Template::*, которые возможно будут использоваться. Он вызывается модулем Template при выполнении под mod_perl ($ENV{MOD_PERL} установлена).

parser(\%config)

Создает экземпляр нового объекта парсера класса, имя которого указано переменной пакета $PARSER (по умолчанию: Template::Parser). Возвращает ссылку на вновь созданный экземпляр парсера или undef в случае ошибки.

provider(\%config)

Создает экземпляр нового объекта поставщика шаблонов (по умолчанию: Template::Provider). Как и выше, возвращает ссылку на вновь созданный экземпляр объекта или undef в случае ошибки.

plugins(\%config)

Создает экземпляр нового объекта поставщика плагинов (по умолчанию: Template::Plugins). Как и выше, возвращает ссылку на вновь созданный экземпляр объекта или undef в случае ошибки.

filters(\%config)

Создает экземпляр нового объекта поставщика фильтров (по умолчанию: Template::Filters). Как и выше, возвращает ссылку на вновь созданный экземпляр объекта или undef в случае ошибки.

stash(\%vars)

Создает экземпляр нового объекта хранилища (Template::Stash или Template::Stash::XS в зависимости от установки по умолчанию, выбранной при установке), используя содержимое хеша, передаваемого в качестве необязательного аргумента как начальные определения переменных. Как и выше, возвращает ссылку на вновь созданный экземпляр объекта или undef в случае ошибки.

context(\%config)

Создает экземпляр нового объекта контекста шаблона (по умолчанию: Template::Context). Как и выше, возвращает ссылку на вновь созданный экземпляр объекта или undef в случае ошибки.

service(\%config)

Создает экземпляр нового объекта сервиса шаблона (по умолчанию: Template::Service). Как и выше, возвращает ссылку на вновь созданный экземпляр объекта или undef в случае ошибки.

instdir($dir)

Возвращает корневой каталог установки Template Toolkit, в котором установлены дополнительные компоненты. Любой относительный путь, передаваемый в качестве аргумента будет добавлен к возвращаемому каталогу.

    # например, возвращается '/usr/local/tt2'
    my $ttroot = Template::Config->instdir()
	|| die "$Template::Config::ERROR\n";
    # например, возвращается '/usr/local/tt2/templates'
    my $template = Template::Config->instdir('templates')
	|| die "$Template::Config::ERROR\n";

Возвращает undef и соответственно устанавливает $Template::Config::ERROR, если дополнительные компоненты Template Toolkit не установлены.

АВТОР

Индекс ] [ Модули ] [ Наверх ]

Энди Уардли (Andy Wardley <abw@andywardley.com>)

http://www.andywardley.com/

ВЕРСИЯ

Индекс ] [ Модули ] [ Наверх ]

2.68, поставляется в составе Template Toolkit версии 2.14, дата релиза - 4 октября 2004.

АВТОРСКИЕ ПРАВА

Индекс ] [ Модули ] [ Наверх ]

  Copyright (C) 1996-2004 Andy Wardley.  All Rights Reserved.
  Copyright (C) 1998-2002 Canon Research Centre Europe Ltd.

Этот модуль является свободно-распространяемым программным обеспечением; вы можете распространять и/или модифицировать его на тех же условиях, что и Perl.

СМОТРИ ТАКЖЕ

Индекс ] [ Модули ] [ Наверх ]