Дослідження Lift

Редакція Lift 2.0

Написано

Derek Chen-Becker, Marius Danciu та Tyler Weir

Присвячення

Подяки

Частина I.  Основи

1 Ласкаво просимо до Lift!

1.1  Чому Lift?

1.2  Що потрібно знати перед початком

• Мова Scala та стандартна бібліотека. Ця книга не призначена бути вступом в Scala: є декілька дуже гарних книжок, що гідні цієї ролі. Ви можете знайти список книжок Scala на сайті Scala, http://www.scala-lang.org/node/959.
• HTML та XML. Lift значною мірою покладається на XHTML для підтримки шаблонів, так що вам слідує розуміти такі речі, як  DocTypes, елементи, атрибути та простори імен.
• Загальна обробка HTTP, включаючи надсилання GET та POST, коди відповіді, та типи вмісту.

1.3  Типографічні домовленості

1.4  Отримання додаткової інформаціїї щодо Lift

1. Перше місце, де треба шукати, це веб сайт Lift на http://liftweb.net/. Є посилання на безліч інформації на сайті. Зокрема:
   1. Lift Wiki розташований на http://www.assembla.com/wiki/show/liftweb. Wiki підтримує не тільки David, але також багато активних членів спільноти Lift, включаючи авторів. Частини книги надихнуті та позичені зі вмісту Wiki. Зокрема, там є посилання на всю згенеровану документацію, не тільки для стабільної гілки, але також для нестабільшої голови, якщо ви відчуваєте себе готовим до пригод. Є також екстенсивний розділ HowTo та статті по просунутим темам, що охоплюють значний обсяг інформації.
   2. Список розсилки http://groups.google.com/group/liftweb дуже активний, та якщо є речі, що не викладені в цій книзі, ви можете почуватись вільно запитувати питання там. Є багато дуже розумних людей, що можуть відповісти на ваші питання. Будь ласка, публікуйте окремі питання щодо книги до Lift Book Google Group на http://groups.google.com/group/the-lift-book. Будь-що інше, специфічне до Lift є чесною грою для списку розсилки.
2. Tim Perrett, інший комітер Lift, пише книгу про Lift для Manning, що називається Lift in Action. Більше подробиць може бути знайдено на сайті сторінки http://www.manning.com/perrett/.
3. Lift має канал IRC на irc://irc.freenode.net/lift, що звичайно має декілька людей в кожний окремий момент. Це чудове місце для балачок щодо проблем та ідей навколо Lift.

1.5  Ваше перше застосування Lift

• Eclipsehttp://www.eclipse.org/ Розробник Scala Plugin рекомендує використання версію Eclipse Classic IDE
  NetBeanshttp://www.netbeans.org Потребує використання NetBeans 6.5
  IntelliJIDEA http://www.jetbrains.com/idea/index.html Потребує версію 8 Beta
  Якщо вам подобається щось більш легковажне, дистрибутив мови Scala іде з плагінами для редакторів, таких як Vim, Emacs, jEdit, тощо. Ви можете або завантажити повну дистрибуцію Scala з http://www.scala-lang.org/ та використовувати файли з misc/scala-tool-support, або ви можете отримати доступ до останніх версій напряму через інтерфейс SVN (Subversion) https://lampsvn.epfl.ch/trac/scala/browser/scala-tool-support/trunk/src. Отримання цїх плагінів для роботи з вашою IDE або вашому обраному редакторі лежить за межами цієї книги.

cd work

mvn archetype:generate -U \
  -DarchetypeGroupId=net.liftweb \
  -DarchetypeArtifactId=lift-archetype-blank \
  -DarchetypeVersion=2.0 \
  -DarchetypeRepository=http://scala-tools.org/repo-releases \
  -DgroupId=demo.helloworld \
  -DartifactId=helloworld \
  -Dversion=1.0-SNAPSHOT

cd helloworld
mvn jetty:run

[INFO] Starting scanner at interval of 5 seconds.

<prefix:element>

1. Елемент визначає, де буде прив'язано (вставлено) вміст нашого файлу index.html. Атрибут name повинен співпадати з відповідним атрибутом at нашого елемента .
2. Елемент   є спеціальним елементом, що будує меню, базуючись на SiteMap↓ (що буде пояснений в главі 7↓). SiteMap є високорівневим компонентом директорії сайту, що не тільки провадить централізоване місце для визначення меню сайту, але дозволяє вам контролювати, коли відображувати окремі посилання (базуючись на, скажімо, чи користувач увійшов в систему, та яку роль він має), та провадить механізм контроля доступу рівня сторінки.
3. Елемент дозволяє Lift (або вашому коду) відображувати повідомлення на сторінці по мірі її відображення. Це можуть бути повідомленнями статуса, повідомленнями про помилки, тощо. Lift має механізми для встановлення одного або більше повідомлень з логіки вашого коду.

• Значно складніші шаблони та прив'язки фрагментів, включаючи ввод форм та програмний вибір шаблонів
• Як використовувати SiteMap та його службові класи для провадження контекст-свідомого меню сайту та рівня контроля доступом
• Як обробляти стан в вашому застосуванні
• Рівень Lift ORM, Mapper (Глава 8↓), що провадить потужний, але легковажний, інтерфейс до баз даних
• Розвинену підтримку AJAX та Comet в застосуваннях стилю Lift for Web 2.0

2  PocketChange

Малюнок 2.1 Застосування PocketChange

2.1  Визначення моделі

• User: користувач застосування
• Account: Специфічний рахунок витрат - ми бажаємо мати більше одного для користувача
• Expense: Окрема транзакція витрати, прив'язана до певного рахунку
• Tag: Слово або фраза, що дозволяє нам категорізувати кожну витрату для подальшого пошуку і звітності

2.2 Наш перший шаблон

2.3  Написання фрагментів

2.4 Маленька перчинка AJAX

2.5 Висновок

git clone git://github.com/tjweir/pocketchangeapp.git

3 Основи Lift

3.1  Введення в Lift

3.2  Розкрутка ↓

3.2.1  Розрішення класів

3.3 Зауваження щодо стандартних імпортів

3.4  Головні об'єкти Lift

3.4.1  S↓ object

3.4.2  SHtml↓

3.4.3  LiftRules↓

3.5 Процес відтворення

1. Викоанає любе сконфігуроване переписування URL. Це охоплено в Розділі 3.7↓.
2. Виконає любі співпадаючі власні функції диспечеризації. Це поділяється на обоє, диспечеризацію з та без стану, та більш детально розкривається в Розділі 3.8↓.
3. Виконує автоматичну обробку запитів Comet та AJAX (Глава 11↓).
4. Виконує налаштування та співпадіння SiteMap. SiteMap, описаний в Главі 7↓, не тільки провадить гарну систему меню на рівні сайту, але може також виконувати контроль безпеки, перезапис URL, та іншу власну функціональність.
5. Шукає шаблон XHTML, що має використовуватись для запиту. Це обробляється через три механізми:
   1. Перевірки LiftRules.viewDispatch↓↓ RulesSeq, щоб почабачити, чи визначені влаані правила  диспечера. Ми розкажемо про власну диспечерізацію переглядів в Розділі 9.2↓.
   2. Якщо немає співпадінь viewDispatch, шукається файл шаблону ↓ , що співпадає, та використовується. Ми поговоримо про шаблони, та як вони шукаються, в Розділі 4.1↓.
   3. Якщо файл шаблону не був знайдений, намагаємось знайти перегляд↓, базуючись на неявній маршрутизації. Ми розглянемо це в  Розділі 4.4↓.
6. Обробляємо шаблон, включаючи вбудування інших шаблонів (Розділ 4.5.7↓), злиння елементів зі скомпонованих шаблонів (Розділ ↓), та виконуємо функції уривка (Глава 5↓).

3.6  Повідомлення про зауваження, попередження та помилки

3.7 Переписування URL

• Використовувати дрвужні до користувача, запам'ятовувані URL, як http://www.example.com/budget/2008
• Використовувати короткі URL, замість довгих, зкладних до запам'ятовування, подібних до http://tinyurl.com
• Використовувати порції URL для визначення, як окремий уривок або перегляд відповідатиме. Наприклад, ви можете зробити так, що профіль користувача відображуеться через URL, такий, як
  http://someplace.com/user/derek, замість того, що надсилати ім'я користувача як частини рядка запиту.

1. Розібраний шлях, як List[String]
2. Суфікс запита (тобто, “html”, “xml”, тощо)
3. Чи цей шлях відносний до кореня. Якщо так, тоді він буде починатись з /, за яким слідує залишок шляху. Наприклад, якщо ваше застосування розгорнуте на шляху контексту app (“/app”), та ми бажаємо посилатись на файл /pages/index.html, тоді відносний до кореня шлях буде /app/pages/index.html.
4. Чи він завершується на косу (“/”)

3.8 Власні функції диспечеризації

1. Глобально, через LiftRules.dispatch↓↓
2. Глобально, через LiftRules.statelessDispatchTable↓↓
3. По-сессійно, через S.addHighLevelSessionDispatcher↓↓

val width = S.param(“width”).map(_.toInt) openOr 400
val height = S.param(“height”).map(_.toInt) openOr 300

val width = S.param(“width”).dmap(400)(_.toInt)
val height = S.param(“height”).dmap(300)(_.toInt)

3.9 Перенаправлення HTTP

1. Виклик S.redirectTo. Коли ви робите це, Lift підіймає виключення, та потім його перехоплює. Це означає, що любий код після перенаправлення пропускається. Якщо ви використовуєте StatefulSnippet (Розділ 5.3.3↓), використовуйте this.redirectTo, так що ваш примірник уривку використовується при обробці перенаправлення.
   Важливо: якщо ви використовуєте S.redirectTo в блоці try/catch, вам треба переконатись, що ви не відловлюєте виключення перенаправлення (Scala використовує неперевірені виключення), або перевірте виключення перенаправлення, та знову підійміть його. Якщо ви помилково спіймаєте виключення перенаправлення, тоді саме перенаправленя не відбудеться.
2. Коли вам треба повернути LiftResponse, ви можете просто повернути відповідь RedirectResponse або RedirectWithState.

3.10 Кукіз

1. Переглядач користувача може відключити кукіз, і в такому випадку вам треба приготуватись для роботи без кукіз, або сповістити користувача, що йому потрібно ввімкнути кукіз для вашого сайта
2. Кукіз відносно небезпечні  [R]   [R]  Дивітьсяhttp://www.w3.org/Security/Faq/wwwsf2.html (Q10) та http://www.cookiecentral.com/faq/ щодо деталей про кукіз, та їх проблеми з безпекою.. Є декіка багів переглядачів, пов'язаних з даними в кукіз, які можуть читати віруси або інші сайти
3. Кукіз просто підробити, так що вам треба переконатись, що ви перевірили любі чултиві дані з кукіз

3.11 Стан сесії та запиту 

• Типо-безпечний доступ до даних, що вони містять
• Мезанізм для провадження значення по замовчанню, якщо сесія або запит досі не існують
• Механізм для очистки даних, коли життєвий цикл змінної завершується

1. Ви можете передати любий тип даних через  RequestVar, на відміну від тільки рядків даних в параметрі запиту.
2. Ви насправді передаєте посилання на функцію інжектора, на відміну від самих даних. Це може біти важливо, якщо ви не бажаєте, щоб користувач бавився з переданими даними. Одним прикладом може бути передача вартості товару зі сторінки “перегляд товару” до сторінки “додати до корзини”.

S.redirectTo("/view", () => currentAccountVar(currentAccountVar.is))

3.12 Висновок  

4 Шаблони в Lift

4.1  Template XML

4.1.1  Locating Template XML

[_][.]

• /test/template.xhtml
• /test/template_es_ES.xhtml (Spanish localized for Spain)
• /test/template_ja.xhtml

4.1.2  Processing Template XML

4.2  Designer-Friendly Templates ↓↓

4.2.1  Determining the Content Element↓

4.2.2  Invoking Snippets Via the Class Attribute↓

4.2.3  Binding via CSS transforms↓

4.3  HTML5 Support ↓↓↓

4.4  Views ↓

4.5  Tags

Usage: 

Usage: contents

Usage: ...multiple xml nodes here...

Usage: 

Usage: 
       

Usage: 

Usage: 
         children
       

Usage: 
       
       

 as of