Учебник - часть 1
Содержание
Вступление
В главе Первые шаги, был описан процесс установки BlueBream и создания проекта из шаблона bluebream. В этом учебнике, вы научитесь создавать простое приложение коллектор заявок. Данная серия уроков поможет ближе ознакомится с принципами BlueBream.
Вот несколько функций будущего приложения:
- В один накопитель можно добавить сколько угодно заявок.
- Каждая новая заявка должен иметь описание и один начальный комментарий.
- К заявке можно добавлять комментарии.
Это первая часть обучения. После завершения этой главы, вы должны уметь:
- Понимать структуру директорий проекта.
- Использовать и настраивать Buildout.
- Создавать контент-объекты (content objects) и интерфейсы.
Использовать инструмент для генерации форм (zope.formlib).
Примеры, которые предлагаются для изучения в документации можно загрузить отсюда. Исходники доступны на разных этапах, соответственно разделам.
- Этап 1 : разделы от 5.2 до 5.7
- Этап 2 : раздел 5.8
- Этап 3 : раздел 5.9
- Этап 4 : раздел 6.2
- Этап 5 : раздел 6.3
Этап 6 : разделы 6.4 & 6.5
Создание нового проекта
Использование шаблона проекта bluebream
В этом разделе мы будем создавать структуру папок для нашего приложения. Я предполагаю, что вы уже установили bluebream, используя команду easy_install bluebream, как упоминалось в главе Первые шаги. Давайте назовем приложение ticketcollector, и создадим Python пакет с именем tc.main. Итак, мы создали проект с именем ticketcollector, пакетом пространства имен tc и под-пакетом main. Давайте создадим структуру папок для нашего приложения:
1 $ paster create -t bluebream
2
3 Selected and implied templates:
4 bluebream#bluebream A BlueBream project, base template
5
6 Enter project name: ticketcollector
7 Variables:
8 egg: ticketcollector
9 package: ticketcollector
10 project: ticketcollector
11 Enter python_package (Main Python package (with namespace, if any)) ['ticketcollector']: tc.main
12 Enter interpreter (Name of custom Python interpreter) ['breampy']:
13 Enter version (Version (like 0.1)) ['0.1']:
14 Enter description (One-line description of the package) ['']: Ticket Collector
15 Enter long_description (Multi-line description (in reST)) ['']: An issue tracking application
16 Enter keywords (Space-separated keywords/tags) ['']:
17 Enter author (Author name) ['']: Baiju M
18 Enter author_email (Author email) ['']: baiju@example.com
19 Enter url (URL of homepage) ['']:
20 Enter license_name (License name) ['']: ZPL
21 Enter zip_safe (True/False: if the package can be distributed as a .zip file) [False]:
22 Creating template bluebream
23 Creating directory ./ticketcollector
24
25 Your project has been created! Now, you want to:
26 1) put the generated files under version control
27 2) run: python boostrap.py
28 3) run: ./bin/buildout
Как видно из примера выше, мы предоставили почти всю информацию о проекте. Значения, которые были указаны, можно поменять позже. Это сделать очень просто; все, что трудно изменить позже - это имена пакетов, потому что на них позже может быть много ссылок в коде.
Организация нового пакета
Если вы перейдете в папку ticketcollector, вы увидите несколько папок и файлов:
jack@computer:/projects/ticketcollector$ ls -CF bootstrap.py debug.ini etc/ src/ versions.cfg buildout.cfg deploy.ini setup.py var/
Когда структура проекта готова, вы можете добавить его в систему контроля версий. Вам не следует добавлять папку src/ticketcollector.egg-info, так как она автоматически создается с помощью setuptools. Вот пример с использованием bzr:
jack@computer:/projects/ticketcollector$ rm -fr src/ticketcollector.egg-info/ jack@computer:/projects/ticketcollector$ bzr init Created a standalone tree (format: 2a) jack@computer:/projects/ticketcollector$ bzr add * adding bootstrap.py adding buildout.cfg adding debug.ini ... jack@computer:/projects/ticketcollector$ bzr ci -m "Initial import" Committing to: /projects/ticketcollector/ added bootstrap.py added buildout.cfg ... Committed revision 1.
Добавление проекта в систему контроля версий необязательный, но рекомендуемый шаг. У вас теперь есть правильный исходный код, который, после построения, приобретет вид рабочего приложения. Проект теперь полностью независим, от дистрибутива bluebream, который только помогает добраться до этой точки развития. Теперь проект содержит все необходимое для установки зависимостей из Интернета и настройки приложения.
Генерация (bootstrapping) проекта
Следующий шаг - установка Buildout. Цель Buildout - автоматизировать сборку Python приложений из исходников. Единственное требование для Buildout - это Python. BlueBream предоставляет скрипт генерации для установки !Buildout и настройки проекта для его запуска. Этот скрипт называется bootstrap.py и делает следующие вещи:
Загружает и устанавливает дистрибутив distribute с PyPI, который содержит внутри пакет setuptools.
Загружает и устанавливает дистрибутив zc.buildout c PyPI.
- Создает папки проекта :- bin/, eggs/, parts/, develop-eggs/.
Создает скрипт внутри папки bin с именем buildout.
Когда вы запускаете bootstrap.py, вы видите, что он создает несколько папок и скрипт bin/buildout, как было упомянуто раньше:
jack@computer:/projects/ticketcollector$ python bootstrap.py Creating directory '/projects/ticketcollector/bin'. Creating directory '/projects/ticketcollector/parts'. Creating directory '/projects/ticketcollector/develop-eggs'. Creating directory '/projects/ticketcollector/eggs'. Generated script '/projects/ticketcollector/bin/buildout'.
Папка bin - место, куда Buildout устанавливает все выполнимые скрипты.
Папка eggs - место, куда Buildout устанавливает яйца.
Папка parts, куда Buildout сохраняет весь свой вывод. Buildout ожидает, что в этой папке ничего не будет изменятся со стороны разработчика.
Папка develop-eggs - место, куда Buildout сохраняет ссылки на все локально разработанные яйца.
Настройка Buildout
После генерации проекта вы можете собрать приложение. Все шаги, которые на этот момент уже сделаны, делаются всего один раз для нового проекта, но запуск сборщика необходим при каждом изменение его конфигурации. Теперь вы готовы запустить bin/buildout для того, чтобы собрать приложение, но перед этим следует взглянуть на содержимое файла buildout.cfg:
Конфигурация сборщика разделена на несколько секций, называемых частями. Главная часть - [buildout], является первой частью в листинге выше. Каждая часть, кроме [buildout], обрабатывается подключаемым механизмом системы Buildout, который называется рецепт. [buildout] обрабатывается как исключительный случай, так как содержит общие настройки.
Давайте рассмотрим [buildout]:
Первая опция (develop) указывает сборщику, что текущая папка - папка с исходниками дистрибутива, то есть содержит файл setup.py. Buildout исследует setup.py и создаст ссылку на яйцо в папке develop-eggs. Ссылочный файл должен содержать путь к пакету Python. Таким образом сборщик удостоверится, что пакеты будут всегда доступны для импорта. Значение опции develop может быть относительным путем, как указано выше, или абсолютным путем некой папки. Также можно использовать многострочные значения для указания разных путей.
Опция extends указывает сборщику включать полное содержимое файла versions.cfg в качестве части конфигурации. versions.cfg - другой файл настроек Buildout такого же формата, как и buildout.cfg. Он содержит номера релизов и другие зависимости. Вы можете устанавливать многострочные значения опции extends для включения нескольких файлов настроек.
Опция parts содержит список всех частей, которые должны обрабатываться системой Buildout. Buildout ожидает, что на каждую часть конфигурационного файла существует рецепт.
Теперь рассмотрим часть app:
Эта часть заботится о всех яйцах (eggs), которые необходимы для работы приложения. Пакет zc.recipe.egg - это расширенный рецепт системы Buildout, содержащий множество функций для работы с яйцами. Большинство зависимостей будут связаны с яйцом главного приложения. Опция eggs содержит список всех яиц. Первое яйцо, ticketcollector - это главное локально разрабатываемое яйцо. Последняя опция - interpreter определяет имя интерпретатора, который создал эту часть. Интерпретатор содержит пути ко всех яйцам и их зависимостям, которые содержатся в списке eggs, так что вы можете импортировать любой модуль, который присутствует в списке зависимостей.
Последняя часть создает загрузчик тестов:
Рецепт testrunner создает загрузчик тестов, используя модуль zope.testing. Единственная необязательная опция - eggs, в которой вы указываете список яиц.
Сборка проекта
Теперь вы можете выполнить команду bin/buildout. Ее выполнение займет некоторое время, так как необходимо загрузить все пакеты с !PyPI. Когда вы запустите сборщик, он выдаст вам примерно следующее:
1 jack@computer:/projects/ticketcollector$ ./bin/buildout
2 Develop: '/projects/ticketcollector/.'
3 Installing app.
4 Generated script '/projects/ticketcollector/bin/paster'.
5 Generated interpreter '/projects/ticketcollector/bin/breampy'.
6 Installing zope_conf.
7 Installing test.
8 Generated script '/projects/ticketcollector/bin/test'.
В этом примере все яйца уже находятся в папке eggs. Если их там нет, они будут автоматически загружены и установлены. Сборщик также создает несколько скриптов в папке bin:
Команда paster используется для запуска веб сервера.
Команда breampy предоставляет интерпретатор Python, который содержит все яйца, доступные в проекте.
Команда test используется для запуска тестов.
Теперь у нас есть базовое дерево проекта, на основе которого мы продолжим строить наше приложение.
Настройка PasteDeploy
BlueBream использует WSGI для запуска сервера путем использования PasteDeploy. В PasteDeploy есть два файла настроек: один для внедрения (deploy.ini), другой для разработки (debug.ini).
Давайте подробнее рассмотрим содержимое debug.ini:
Сначала - раздел [app:main]:
Раздел [app:main] определяет, какое яйцо следует использовать. PasteDeploy ожидает, что точка входа paste.app_factory будет определена в яйце. Если вы обратитесь к файлу setup.py, вы увидите, что она определяется следующим образом:
Имя отчки входа должно быть main. В противном случае, оно должно явно указыватся в файле настроек (debug.ini и deploy.ini). Например, если определение следующее:
Конфигурацию PasteDeploy следует изменить к следующему виду:
Следующий раздел ([server:main]) определяет WSGI сервер:
В этом разделе вы можете изменить имя хоста, порт и сервер самостоятельно. В случае, если вы используете любой другой WSGI сервер, он должен быть включен в список зависимостей в настройках Buildoout.
Последний раздел ([DEFAULT]) - место, где вы определяете значения по умолчанию:
WSGI приложение, которое определено в tc.main.startup ожидает определения опции zope_conf в разделе [DEFAULT]. Следовательно, эта опция необязательная. Она определяет путь к главному конфигурационному файлу zope. Мы рассмотрим конфигурационный файл zope более детально в следующем разделе.
Файл debug.ini содержит полезные настройки для отладки приложений:
1 [loggers]
2 keys = root, wsgi
3
4 [handlers]
5 keys = console, accesslog
6
7 [formatters]
8 keys = generic, accesslog
9
10 [formatter_generic]
11 format = %(asctime)s %(levelname)s [%(name)s] %(message)s
12
13 [formatter_accesslog]
14 format = %(message)s
15
16 [handler_console]
17 class = StreamHandler
18 args = (sys.stderr,)
19 level = ERROR
20 formatter = generic
21
22 [handler_accesslog]
23 class = FileHandler
24 args = (os.path.join('var', 'log', 'access.log'),
25 'a')
26 level = INFO
27 formatter = accesslog
28
29 [logger_root]
30 level = INFO
31 handlers = console
32
33 [logger_wsgi]
34 level = INFO
35 handlers = accesslog
36 qualname = wsgi
37 propagate = 0
38
39 [filter:translogger]
40 use = egg:Paste#translogger
41 setup_console_handler = False
42 logger_name = wsgi
43
44 [filter-app:main]
45 # Change the last part from 'ajax' to 'pdb' for a post-mortem debugger
46 # on the console:
47 use = egg:z3c.evalexception#ajax
48 next = zope
49
50 [app:zope]
51 use = egg:ticketcollector
52 filter-with = translogger
53
54 [server:main]
55 use = egg:Paste#http
56 host = 127.0.0.1
57 port = 8080
58
59 [DEFAULT]
60 # set the name of the debug zope.conf file
61 zope_conf = %(here)s/etc/zope-debug.conf
Отладочная конфигурация использует filter-app вместо app для подключения WSGI middleware. На сегодняшний день включено только (z3c.evalexception#ajax) middleware. Вы можете посмотреть документацию PastDeploy на предмет получения более подробной информации об этих разделах конфигурации. Конфигурационный файл Zope определен здесь (etc/zope-debug.conf) по другому, нежели при настройках для внедрения.
Конфигурация Zope
Подобно конфигурации PasteDeploy, конфигурация Zope состоит из файлов etc/zope.conf и etc/zope-debug.conf.
Вот содержимое etc/zope.conf:
1 # Identify the component configuration used to define the site:
2 site-definition etc/site.zcml
3
4 <zodb>
5
6 <filestorage>
7 path var/filestorage/Data.fs
8 blob-dir var/blob
9 </filestorage>
10
11 # Uncomment this if you want to connect to a ZEO server instead:
12 # <zeoclient>
13 # server localhost:8100
14 # storage 1
15 # # ZEO client cache, in bytes
16 # cache-size 20MB
17 # # Uncomment to have a persistent disk cache
18 # #client zeo1
19 # </zeoclient>
20 </zodb>
21
22 <eventlog>
23 # This sets up logging to both a file and to standard output (STDOUT).
24 # The "path" setting can be a relative or absolute filesystem path or
25 # the tokens STDOUT or STDERR.
26
27 <logfile>
28 path var/log/z3.log
29 formatter zope.exceptions.log.Formatter
30 </logfile>
31
32 <logfile>
33 path STDOUT
34 formatter zope.exceptions.log.Formatter
35 </logfile>
36 </eventlog>
В файле zope.conf указывается главный загружаемый ZCML файл (определения сайта). Все пути указываются относительно папки верхнего уровня, где находится файл настроек PasteDeploy.
Определение сайта
BlueBream использует ZCML для индивидуальной конфигурации приложения. ZCML - XML-ный декларативный язык настроек. Как вы только что видели в файле zope.conf, главный файл настроек размещается в файле etc/site.zcml. Вот стандартный листинг:
1 <configure
2 xmlns="http://namespaces.zope.org/zope"
3 xmlns:browser="http://namespaces.zope.org/browser">
4
5 <include package="zope.component" file="meta.zcml" />
6 <include package="zope.security" file="meta.zcml" />
7 <include package="zope.publisher" file="meta.zcml" />
8 <include package="zope.i18n" file="meta.zcml" />
9 <include package="zope.browserresource" file="meta.zcml" />
10 <include package="zope.browsermenu" file="meta.zcml" />
11 <include package="zope.browserpage" file="meta.zcml" />
12 <include package="zope.securitypolicy" file="meta.zcml" />
13 <include package="zope.principalregistry" file="meta.zcml" />
14 <include package="zope.app.publication" file="meta.zcml" />
15 <include package="zope.app.form.browser" file="meta.zcml" />
16 <include package="zope.app.container.browser" file="meta.zcml" />
17 <include package="zope.app.pagetemplate" file="meta.zcml" />
18 <include package="zope.app.publisher.xmlrpc" file="meta.zcml" />
19
20 <include package="zope.browserresource" />
21 <include package="zope.copypastemove" />
22 <include package="zope.publisher" />
23 <include package="zope.component" />
24 <include package="zope.traversing" />
25 <include package="zope.site" />
26 <include package="zope.annotation" />
27 <include package="zope.container" />
28 <include package="zope.componentvocabulary" />
29 <include package="zope.formlib" />
30 <include package="zope.app.appsetup" />
31 <include package="zope.app.security" />
32 <include package="zope.app.publication" />
33 <include package="zope.app.form.browser" />
34 <include package="zope.app.basicskin" />
35 <include package="zope.browsermenu" />
36 <include package="zope.principalregistry" />
37 <include package="zope.authentication" />
38 <include package="zope.securitypolicy" />
39 <include package="zope.login" />
40 <include package="zope.session" />
41 <include package="zope.app.zcmlfiles" file="menus.zcml" />
42 <include package="zope.app.authentication" />
43 <include package="zope.app.security.browser" />
44 <include package="zope.traversing.browser" />
45 <include package="zope.app.pagetemplate" />
46 <include package="zope.app.schema" />
47
48 <include package="tc.main" />
49
50 </configure>
Главный файл настроек site.zcml содержит ссылки на другие файлы настроек, индивидуальные для каждого пакета. ZCML включает несколько директив, как include, page, defaultView и т.д., доступные через разные пространства имен XML. В site.zcml по умолчанию пространство имен XML - http://namespaces.zope.org/zope. Если вы взглянете в начало site.zcml, вы увидите ссылку на XML-ное пространство имен:
Директива include доступна в пространство именhttp://namespaces.zope.org/zope. Если вы посмотрите другие файлы настроек, вы увидите, что они используют и другие пространства имен, как http://namespaces.zope.org/browser, содрежащие другие директивы, например, page.
В конце site.zcml включены индивидуальные конфигурационные файлы для проекта. Например, следующая директива:
{{{!#highlight xml <include package="tc.main" /> }}}
обеспечит загрузку файла src/tc/collector/configure.zcml.
Вы можете определить общую конфигурацию всего приложения в site.zcml. Содержимое файла src/tc/collector/configure.zcml примерно следующее:
1 <configure
2 xmlns="http://namespaces.zope.org/zope"
3 xmlns:browser="http://namespaces.zope.org/browser"
4 i18n_domain="ticketcollector">
5
6 <include file="securitypolicy.zcml" />
7
8 <!-- The following registration (defaultView) register 'index' as
9 the default view for a container. The name of default view
10 can be changed to a different value, for example, 'index.html'.
11 More details about defaultView registration is available here:
12 http://bluebream.zope.org/doc/1.0/howto/defaultview.html
13 -->
14
15 <browser:defaultView
16 for="zope.container.interfaces.IContainer"
17 name="index"
18 />
19
20 <!-- To remove the sample application delete the following line
21 and remove the `welcome` folder from this directory.
22 -->
23 <include package=".welcome" />
24
25 </configure>
Файл securitypolicy.zcml содержит определение политик безопасности. Как видно из создержимого файла configure.zcml, он подключает пакет welcome. По умолчанию, если вы подключаете пакет, и я вно не указываете имя файла настроек, он подключит configure.zcml.
Метаданные пакета
BlueBream использует Setuptools для создания дистрибутива приложения, но вы можете легко заменить его на Distribute.
Файл setup.py для вашего пакета ticketcollector будет иметь следующий вид:
1 from setuptools import setup, find_packages
2
3 setup(name='ticketcollector',
4 version='0.1',
5 description='Ticket Collector',
6 long_description="""\
7 A ticket collector application""",
8 # Get strings from http://www.python.org/pypi?%3Aaction=list_classifiers
9 classifiers=[],
10 keywords='',
11 author='Baiju M',
12 author_email='baiju@example.com',
13 url='',
14 license='ZPL',
15 package_dir={'': 'src'},
16 packages=find_packages('src'),
17 namespace_packages=['tc',],
18 include_package_data=True,
19 zip_safe=False,
20 install_requires=['setuptools',
21 'zope.securitypolicy',
22 'zope.component',
23 'zope.annotation',
24 'zope.app.dependable',
25 'zope.app.appsetup',
26 'zope.app.content',
27 'zope.publisher',
28 'zope.app.broken',
29 'zope.app.component',
30 'zope.app.generations',
31 'zope.app.error',
32 'zope.app.interface',
33 'zope.app.publisher',
34 'zope.app.security',
35 'zope.app.form',
36 'zope.app.i18n',
37 'zope.app.locales',
38 'zope.app.zopeappgenerations',
39 'zope.app.principalannotation',
40 'zope.app.basicskin',
41 'zope.app.rotterdam',
42 'zope.app.folder',
43 'zope.app.wsgi',
44 'zope.formlib',
45 'zope.i18n',
46 'zope.app.pagetemplate',
47 'zope.app.schema',
48 'zope.app.container',
49 'zope.app.debug',
50 'z3c.testsetup',
51 'zope.app.testing',
52 'zope.testbrowser',
53 'zope.login',
54 'zope.app.zcmlfiles',
55 ],
56 entry_points = """
57 [paste.app_factory]
58 main = tc.main.startup:application_factory
59
60 [paste.global_paster_command]
61 shell = tc.main.debug:Shell
62 """,
63 )
Большинство данных в файле setup.py получено при вводе данных во время создания проекта по шаблону. Ключевой аргумент install_requires, который содержит список всех зависимостей пакета. Существует две точки входа. Первая используется в PasteDeploy для поиска фабрики WSGI приложения, а вторая регистрирует команду скрипта paster с именем shell.
Запуск тестов
BlueBream использует zope.testing в качестве главного фреймворка для автоматизованного тестирования. Вместе с zope.testing можно также использовать модули unittest и doctest, которые входят в стандратную библиотеку языка Python. Также есть модуль zope.testbrowser, который используется для функционального тестирования. Для настройки тестов, слоев, и т.д. BlueBream использует пакет z3c.testsetup.
BlueBream использует рецепт системы Buildout - zc.recipe.testrunner для генерации скрипта запуска.
Если вы посмотрите на конфигурацию сборщика, то увидите там часть, отвечающую за настрйку запуска тестов:
{{{!#highlight ini [test] recipe = zc.recipe.testrunner eggs = ticketcollector }}}
Рецепт testrunner создает скрипт запуска тестов на основе модуля zope.testing. Единственная необязательная опция - eggs, в которой приводится список необходимых яиц.
Для запуска всех тестов используется команда bin/test:
1 jack@computer:/projects/ticketcollector$ bin/test
Эта команда отыщет все тесты и выполнит их.
Создание объекта приложения
Контейнеры
В этом разделе мы рассмострим одну из основных концепций BlueBream - контейнеры. Как упоминалось раньше, BlueBream использует объектную базу данных ZODB для хранения объектов. Представьте себе ее как контейнер для хранения объектов; внутренний объект этого контейнера может служить контейнером для других объектов, и так далее.
Иерархию объектов можна представить следующим образом:
+-----------------------+ | | | +---------+ +--+ | | | | +--+ | | | +--+ | | | | +--+ | | | +---------+ +--+ | | +--+ | +-----------------------+
BlueBream позаботится о персистентности объектов. Для того, чтобы сделать объект персистентным, его нужно пронаследовать от persistent.Persistent.
Вот некоторые классы в BlueBream, которые наследуются от persistent.Persistent:
- zope.container.btree.BTreeContainer
- zope.container.folder.Folder
- zope.site.folder.Folder
Если вы пронаследуетесь от любого из этих классов, экземпляр важего класса будет персистентным. Вторая вещь, которую вам необходимо сделать, чтобы сделать объект персистентным - добавить его в существующий контейнер. Вы можете проекспериментировать, используя отладочную оболочку BlueBream. Но перед этим, создайте класс контейнера где-нибудь в коде, и проимпортируйте его. Вы можете добавить это определения контейнера в файл src/tc/collector/init.py (удалите этот код после экспериментов):
Теперь откройте отладочную оболочку, как показано ниже:
Название root обозначает корень дерева объектов базы данных (контейнер верхнего уровня). Проимпортируйте ваш собственный класс, создайте его экземпляр, и добавльте его в корневую папку:
ZODB - транзакционная база данных, так что после внесения изменений, вам придется их зафиксировать (commit). Для того, чтобы зафиксировать (commit) изменения используйте функцию transaction.commit, как показано ниже:
Теперь, когда вы покинете отладочную оболочку, и откроее ее снова, вы увидите, что можете получить доступ к персистентному объекту:
Делать такие случайные объекты персистентными - не очень хорошая идея. Следующий раздел объяснит, как создавать формальную схему объектов. Теперь вы можете удалить объект из базы, а определение класса MyContainer из файла src/tc/collector/init.py. Вы можете удалить объект так:
Объявление интерфейса
Если вы никогда не работали с zope.interface, перед тем как продолжить, рекомендуем вам прочесть раздел Interface руководства по BlueBream.
В качестве первого шага по созданию главного контейнера приложения, который будет хранить все другие объекты, вам следует создать его интерфейс. Давайте назовем его ICollector. Для того, чтобы указать интерфейсу описывать контейнер, необходимо пронаследованть его от zope.container.interfaces.IContainer или любого другого интерфейса, который от него наследуется. Также в главный контейнер приложения рекомендуется добавлять менеджер сайта. Для того, чтобы позже добавить менеджер сайта, рекомендуется пронаследоваться от интерфейса zope.site.interfaces.IFolder. IFolder наследуется от IContainer.
Давайте создадим новый пакет Python с именем collector в src/tc:
Теперь можно создать файл src/tc/collector/interfaces.py, который будет хранить наши интерфейсы:
1 from zope.site.interfaces import IFolder
2 from zope.schema import TextLine
3 from zope.schema import Text
4
5 class ICollector(IFolder):
6 """The main application container"""
7
8 name = TextLine(
9 title=u"Name",
10 description=u"Name of application container",
11 default=u"",
12 required=True)
13
14 description = Text(
15 title=u"Description",
16 description=u"Description of application container",
17 default=u"",
18 required=False)
Определенный здесь интерфейс - это схема для главного объекта приложения. В схеме определены два поля: name и description. Эта схема позже может быть использована для автоматической генерации веб форм.
Реализация интерфейса
Схема может быть описана как план ваших объектов, так как определяет поля, которые объект должен реализовать, и действия, которые он должен выполнять. После этого, вы можете создавать конкретные классы, которые реализуют вашу схему.
Дальше вам нужно релизовать описанный интерфейс. Для реализации IContainer, вы можете пронаследоваться от zope.site.folder.Folder. Вы можете создать реализацию в src/tc/collector/ticketcollector.py:
Для того, чтобы объявить, что класс реализует некий интерфейс, вы можете использовать функцию implements из пакета zope.interface.
Регистрация компонентов
Когда интерфейсы и их реализации готовы, нужно выполнить их настройку в ZCML. Откройте файл src/tc/collector/configure.zcml в режжиме редактирвоания и введите следующее для регистрации интерфейса ICollector как компонента содержимого:
zope.app.content.interfaces.IContentType представляет контент-тип. Если интерфейс предоставляет тип интерфейса IContentType, то все объекты, которые предоставляют этот интерфейс считаются контент-объектами.
Для установки аннотаций для объектов коллектора нам нужно указать, что он реализует интерфейс zope.annotation.interfaces.IAttributeAnnotatable. Пример конфигурации ниже также объявляет, что наш класс Collector реализует интерфейс zope.container.interfaces.IContentContainer. Эти два класса - примеры интерфейсов-маркеров (marker interfaces), то есть интерфейсов, которые обозначают, что объект принадлежит к специальному типу. Преимущество в том, что для этого не вводятся никакие дополнительные атрибуты или методы.
В этом же файле (src/tc/collector/configure.zcml) перед директивой </configure> добавьте следующие строки:
1 <class class="tc.collector.ticketcollector.Collector">
2 <implements
3 interface="zope.annotation.interfaces.IAttributeAnnotatable"
4 />
5 <implements
6 interface="zope.container.interfaces.IContentContainer"
7 />
8 <require
9 permission="zope.Public"
10 interface="tc.collector.interfaces.ICollector"
11 />
12 <require
13 permission="zope.Public"
14 set_schema="tc.collector.interfaces.ICollector"
15 />
16 </class>
Директива class - это комплексная директива, то есть может содержать поддирективы, такие как implements и require. Директива class также содержит настройки прав доступа к экземплярам класса Collector.
Вид для добавления коллекторов
Теперь содержимое компонента готово к использованию, но здесь нужна также веб страница, которая позволить добавить объект коллектор заявок. Для создания формы вы можете использовать пакет zope.formlib. Для этого нужно добавить определение класса в файл src/tc/collector/views.py следующим образом:
1 from zope.site import LocalSiteManager
2 from zope.formlib import form
3
4 from tc.collector.interfaces import ICollector
5
6 from tc.collector.ticketcollector import Collector
7
8 class AddTicketCollector(form.AddForm):
9
10 form_fields = form.Fields(ICollector)
11
12 def createAndAdd(self, data):
13 name = data['name']
14 description = data.get('description', u'')
15 collector = Collector()
16 collector.name = name
17 collector.description = description
18 self.context[name] = collector
19 collector.setSiteManager(LocalSiteManager(collector))
20 self.request.response.redirect(".")
Функция createAndAdd будет вызвана, когда пользователь нажмет кнопку Add в веб форме. Последняя строчка сзади очень важная:
1 collector.setSiteManager(LocalSiteManager(collector))
Эта строчка добавляет менеджер сайта в коллектор с тем, чтобы использовать его как локальный реестр компонентов, таких как, например, локальные утилиты.
Как вы уже успели увидеть в предыдущем разделе директива browser:page используется для регистрации страницы. Вы можете использовать имя add_ticket_collector, чтобы зарегистрировать ее на интерфейс zope.site.interfaces.IRootFolder. Добавьте эти строчки в файл src/tc/collector/configure.zcml:
Разработка пакета теперь закончена, но он еще не подключен из главного пакета. Для того, чтобы включить этот пакет в главный (tc.main), вам следует изменить файл src/tc/main/configure.zcml, добавив эту строчку перед </configure>:
1 <include package="tc.collector" />
Для добавления коллектора заявок сначала необходимо войти в сайт используя логин форму: http://localhost:8080/@@login.html. Вы можете предоставить данные удостоверения, которые присутствуют в файле src/tc/main/securitypolicy.zcml:
По умолчанию имя пользователя и пароль - admin, admin. Вам следует изменить их на другие. После успешного входа, перейдите по ссылке: http://localhost:8080/@@add_ticket_collector. Вы должны увидеть форму, в кторой можно ввести данные для полей name и description. Введите в поле имя значение mycollector. После ввода данных, отправьте форму.
Вы можете увидеть, что размер файла var/filestorage/Data.fs растет с добавлением объектов. Data.fs - файл, в котором физиически хранятся персистентные объекты.
Вы также можете кдостоверится, что объект действительно сохранен в базе данных через оболочку Python. Если вы войдете в оболочку Python и попытаетесь получить доступ к корневому объекту, то увидите что в нем есть вами добавленный объект:
1 jack@computer:/projects/ticketcollector$ ./bin/paster shell debug.ini
2 ...
3 Welcome to the interactive debug prompt.
4 The 'root' variable contains the ZODB root folder.
5 The 'app' variable contains the Debugger, 'app.publish(path)' simulates a request.
6 >>> list(root.keys())
7 [u'mycollector']
Через отладочную оболочку вы можете просматривать, добавлять, обновлять или удалять Python объекты или атрибуты.
Вид по умолчанию для коллектора
Если вы попытаетесь получить доступ к коллектору по ссылке http://localhost:8080/mycollector, то получите ошибку NotFound, примерно следующего содержания:
URL: http://localhost:8080/mycollector ... NotFound: Object: <tc.collector.ticketcollector.Collector object at 0x9fe44ac>, name: u'@@index'
Эта ошибка возникает, потому что нет вида с именем index, зарегистрированного на интерфейс ICollector. Этот раздел покажет вам, как создать вид по умолчанию для интерфейсв ICollector.
Как вы уже увидели в разделе Первые шаги, вы можете создать простой вид и зарегистрировать его в ZCML.
В файле src/tc/collector/views.py добавьте новый вид:
Потом добавьте следующее в src/tc/collector/configure.zcml:
<browser:page for="tc.collector.interfaces.ICollector" name="index" permission="zope.Public" class="tc.collector.views.TicketCollectorMainView" />
Теперь пройдите по ссылке http://localhost:8080/mycollector. Вы должны увидет следующее:
Hello ticket collector!
В следующем разделе вы получите информацию о главной странице для коллектора, а также об использовании шаблонов страниц Zope (Zope Page Templates).
Создание главной страницы
Страница браузера
Страница браузера может быть создана с использованием шаблона. form.DisplayForm поддерживает атрибуты template и form_fields. Вы также можете убрать метод _ _call_ _ из TicketCollectorMainView. Обновите класс TicketCollectorMainView в файле src/tc/collector/views.py до следующего вида:
Вы можете создать src/tc/collector/collectormain.pt со следующим содержимым:
Теперь перейдите по ссылке http://localhost:8080/mycollector. Вы должны увидеть
1 Welcome to ticket collector!.
Выводы
Эта часть учебника покрывает основы создания веб приложений с помощью BlueBream. Мы основательно описали, как использовать шаблон проекта bluebream для создания нового проекта. Мы обсудили процесс построения приложения с помощью Buildout. Мы создали контейнер приложения. И наконец, вид по умолчанию для созданного контейнера приложения. Учебник - часть 2 расширяет приложения путем введения дополнительных функций.
Перевод: Ростислав Дзинько