Прыгожыя URL-адрасы для JavaServer Faces і Java-серверы прыкладанняў

1. Рашэнне з адкрытым зыходным кодам / url / # {перапісаць} для сервлета, JSF і Java EE PrettyFaces...
2. Пачніце, гэта проста! (3 кроку)
3. 1. Уключыце PrettyFaces у свой праект
4. 2. Стварыце даволі config.xml
5. Дадаць адлюстраванні ў вашай канфігурацыі
6. 3. Запусціце прыкладанне!
7. Дакументацыя (патрэбна дапамога?)
8. Што адрознівае PrettyFaces:
9. Чаму не паспрабуйце PrettyFaces зараз ?.
10. Пытанне: Чаму мае кампаненты Tomahawk / MyFaces, альбо іншыя адданы трэція асобы, парушаюцца, калі...
11. Пытанне: Чаму пры выкарыстанні MyFaces я атрымліваю выключэнне NullPointerException пры спробе выкарыстоўваць...
12. Пытанне: Ці магу я наладзіць PrettyFaces з дапамогай анатацый?
13. Пытанне: Як я магу ўключыць рэгістрацыю, каб я мог сказаць, што адбываецца на самай справе?
14. Пытанне: Ці магу я адлюстроўваць і апрацоўваць URL-адрасы, якія ахопліваюць дынамічную колькасць знакаў '/'?
15. Пытанне: Як я магу захаваць аб'екты FacesMessage пасля выканання перанакіравання або прыгожага: перанакіравання?
16. Пытанне: Працуе PrettyFaces на IBM WebSphere?
17. Падтрымайце нас - ахвярай

Рашэнне з адкрытым зыходным кодам / url / # {перапісаць} для сервлета, JSF і Java EE

PrettyFaces - гэта бібліятэка перазапісу URL-адрасоў OpenSource з пашыранай падтрымкай JavaServer Faces - JSF 1.1, 1.2 і 2.0 - дазваляе ствараць прыгожыя URL-адрасы, здольныя да закладак. PrettyFaces элегантна вырашае праблему "RESTful URL", уключаючы такія функцыі, як: дзеянні загрузкі старонак, бясшвовая інтэграцыя з навігацыяй па асобах, дынамічнае прызначэнне ідэнтыфікацыі прагляду, разбор параметраў і сумяшчальнасць без канфігурацыі з іншымі вэб-рамкамі. Зірніце на асаблівасці »

SEO і паслядоўнасць:

Любы бізнэс ведае, наколькі важная аптымізацыя пошукавай сістэмы для продажу. PrettyFaces дазваляе пазнаёміцца ​​з SEO-адрасамі і палепшыць кліент. Дайце вашаму сайту форму, добра зразумелае пачуццё, ад адраснай радкі да кнопкі пакупкі.

Пачніце, гэта проста! (3 кроку)

Перад выкарыстаннем PrettyFaces і / або [[Перазапісаць файл] рэкамендуецца выдаліць іншыя прылады для перазапісу URL-адрасоў з прыкладання. Калі вы вырашыце пакінуць іх на месцы, могуць здарыцца дзіўныя рэчы.

Далучайся да нас у #ocpsoft - наш канал на irc.freenode.net. Акрамя таго, вы можаце прыняць удзел у пасяджэнні Dev, кожны [[Каляндар | Панядзелак у 1 вечара EST]]. Таксама, калі ласка, далучайцеся да абмеркавання нашай спіс адрасоў электроннай пошты .

1. Уключыце PrettyFaces у свой праект

Вы можаце альбо выкарыстоўваць Maven (рэкамендуецца) для ўключэння PrettyFaces у свой праект, альбо вы можаце загрузіць файл распаўсюджвання ZIP непасрэдна.

Калі вы абнаўляеце PrettyFaces 3.x, звярніце ўвагу, што ўсе функцыі сумяшчальныя зваротна, але вы можаце прагледзець кіраўніцтва па міграцыі каб даведацца пра новыя функцыі, даступныя ў апошніх выпусках. <! - для JSF 2.x -> <dependency> <groupId> org.ocpsoft.rewrite </groupId> <artifactId> перапісаць-сервлет </artifactId> <version> 3.4.1.Final </version> < / dependency> <dependency> <groupId> org.ocpsoft.rewrite </groupId> <artifactId> перапісаць-config-prettyfaces </artifactId> <version> 3.4.1.Final </version> </dependency> (Калі вы выкарыстоўваеце) старэйшая версія JSF, вы хочаце выкарыстоўваць замест папярэдняй залежнасці PrettyFaces JSF 1.x: ) <! - для JSF 1.2.x (так, вядома, нумар версіі заблытаны. прабачце!) -> <dependency> <groupId> com.ocpsoft </groupId> <artifactId> prettyfaces-jsf12 </artifactId> <version> 3.3.3 </version> </dependency>

2. Стварыце даволі config.xml

Тут вы будзеце ствараць адлюстраванне URL паміж вонкавымі шаблонамі URL і файламі ўнутранага прагляду, сервлетамі і іншымі рэсурсамі. Абавязкова замяніце адлюстраванне ніжэй на адлюстраванне, якое адпавядае вашым дадаткам.

/WEB-INF/pretty-config.xml <pretty-config xmlns = "http://ocpsoft.org/schema/rewrite-config-prettyfaces" xmlns: xsi = "http://www.w3.org/2001/ XMLSchema-экземпляр "xsi: schemaLocation =" http://ocpsoft.org/schema/rewrite-config-prettyfaces http://ocpsoft.org/xml/ns/prettyfaces/rewrite-config-prettyfaces.xsd "> <url- адлюстраванне id = "login"> <pattern value = "/ login" /> <view-id value = "/ legacy / user / login.jsp" /> </url-mapping> </pretty-config>

Дадаць адлюстраванні ў вашай канфігурацыі

Гэтая частка залежыць ад вас! Вам трэба будзе высветліць, якія URL-адрасы ў вашым дадатку вы хочаце «наладзіць» - так што праверце [[PrettyFaces Docs | documentation]] для атрымання дадатковай інфармацыі аб тым, як у поўнай меры выкарыстаць сістэму адлюстравання URL PrettyFaces.

Акрамя таго, не забудзьцеся праверыць Перапісаць прыклады ці даведачнае кіраўніцтва каб даведацца больш пра [[Перазапісаць]] і магутныя опцыі, якія ён прапануе за межамі модуля наладкі PrettyFaces.

<url-mapping id = "view-user"> <pattern value = "/ user / # {username}" /> <view-id value = "/ user / view.xhtml" /> </url-mapping> < ! - Карты "/ user / # {username}" па URL "/user/view.xhtml?username=value" ->

3. Запусціце прыкладанне!

Цяпер вы павінны быць гатовыя ісці! Устаноўлены PrettyFaces і створана ваша першае адлюстраванне URL. Калі ўсё зроблена правільна, вы павінны ўбачыць, калі PrettyFaces увайсці ў паведамленне, якое пацвярджае, што ўстаноўка прайшла паспяхова. INFO [org.ocpsoft.rewrite.servlet.RewriteFilter] RewriteFilter запускаецца ... ... INFO [org.ocpsoft.rewrite.servlet.RewriteFilter] Загружаны [] org.ocpsoft.rewrite.config.ConfigurationProvider [org.ocpsoft. rewrite.prettyfaces.PrettyFacesRewriteConfigurationProvider <1>] INFO [org.ocpsoft.rewrite.servlet.RewriteFilter] RewriteFilter ініцыялізаваны.

Дакументацыя (патрэбна дапамога?)

Задайце пытанне ў форумы , праглядаць дакументацыя , FAQ , або атрымаць крыніца !

1. Перазапіс URL-адрасоў - Заменіце непрыгожыя URL-адрасы: «/faces/page.jsf» на прыгожыя, SEO-дружалюбныя чалавечыя URL-адрасы: «/ optimized / page /»; Кліент-браўзэр ніколі не бачыць арыгінальныя URL-адрасы, нават у зыходным-HTML
2. Ідэнтыфікатар дынамічнага выгляду - Цяпер з дынамічным адлюстраваннем прагляду для URL-адрасоў (праз выразы метаду El) вы можаце адлюстроўваць розныя прагляды, заснаваныя на ўмовах выканання, эфектыўна адлучаючы URL ад прагляду JSF.
3. Дзеянні загрузкі старонак - Перад адлюстраваннем прагляду адзін або некалькі метадаў дзеянняў на адной ці некалькіх этапах.
4. Паралізаваны аналіз параметраў - Параметры HTTP, разабраныя з URL-адрасоў, захоўваюцца ў кіраваных бобах, а проста атрымаць спасылку на свой bean-параметр, каб лёгка атрымаць доступ з іншых класаў Java.
5. Navigation by ID - Вызначыце ідэнтыфікатараў старонкі ў адным месцы, лёгка спасылайцеся на іх у метадах дзеянняў і кампанентаў, выкарыстоўваючы стандартныя метады навігацыі JSF.
6. Інтэграванае праверка - для URL-адрасоў і параметраў запыту, якія могуць паўторна выкарыстоўваць існуючыя валидаторы JSF.
7. Лёгка настроены - патрабуе абсалютна мінімальнай канфігурацыі; могуць быць уключаны з дапамогай XML або анатацыі.

Што адрознівае PrettyFaces:

Прагляд прэзентацыі слайд-шоў на чаму перапіска URL важна , альбо кароткі агляд праблемы PrettyFaces вырашаюць .

Чаму не паспрабуйце PrettyFaces зараз ?.

1. Пытанне: Ці магу я выкарыстаць PrettyFaces для апрацоўкі перапісвання URL для іншых рэсурсаў на маім сэрвэры?

   А. Так. PrettyFaces па-ранейшаму патрабуе наладжанага экземпляра JSF для функцыянавання, але ён можа быць выкарыстаны для адлюстравання URL любога рэсурсу ў кантэйнере сервлета - без выкліку FacesServlet. Значэнні будуць уводзяцца ў JSF-бабы, як звычайна, але метады дзеянняў PrettyFaces не будуць запускацца (паколькі жыццёвы цыкл JSF не выконваецца для запытаў без Faces.)

   Напрыклад:

   <pretty-config xmlns = "http://ocpsoft.org/schema/rewrite-config-prettyfaces" xmlns: xsi = "http://www.w3.org/2001/XMLSchema-instance" xsi: schemaLocation = "http : //ocpsoft.org/schema/rewrite-config-prettyfaces http://ocpsoft.org/xml/ns/prettyfaces/rewrite-config-prettyfaces.xsd "> <url-mapping id =" login "> <value pattern = "/ login" /> <view-id value = "/ legacy / user / login.jsp" /> <! - Не ўваходзіць у ID JSF -> </url-mapping> <url-mapping id = "register "> <pattern value =" / register "/> <view-id value =" / face / user / register.jsf "/> <! - JSF View Id -> </url-mapping> </ pretty- config>

2. Пытанне: Чаму мае кампаненты Tomahawk / MyFaces, альбо іншыя адданы трэція асобы, парушаюцца, калі я выкарыстоўваю PrettyFaces?

   A. Паколькі перахопы PrettyFaces супастаўляюць HttpRequests, то перасылае гэтыя запыты ў JSF, неабходна, каб любыя дадатковыя фільтры паміж PrettyFaces і JSF слухалі Servlet Forwards. Гэта робіцца ў дэскрыптары разгортвання web.xml шляхам дадання наступных элементаў дыспетчара ў любыя неабходныя фільтры:

   Напрыклад:

   <filter-mapping> <filter-name> springSecurityFilterChain </filter-name> <url-pattern> / * </url-pattern> <dispatcher> ПЕРАВА </dispatcher> <dispatcher> Запыт </dispatcher> </ filter- адлюстраванне>

3. Пытанне: Чаму пры выкарыстанні MyFaces я атрымліваю выключэнне NullPointerException пры спробе выкарыстоўваць звычайную навігацыю па твары?

   A. Некаторыя версіі MyFaces цалкам не адпавядаюць спецыфікацыі JSF, таму ViewRoot з'яўляецца пустым пры апрацоўцы запыту. Гэта патч / абыходны шлях , якія могуць быць дададзеныя, каб вырашыць гэтую праблему. Вы павінны дадаць гэты ViewHandler да вашага face-config.xml.

4. Пытанне: Ці магу я наладзіць PrettyFaces з дапамогай анатацый?

   А. Так! Дзякуючы Christian Kapolteth, PrettyFaces мае падтрымку для анатацый з версіі 3.0.2-SNAPSHOT

5. Пытанне: Як я магу ўключыць рэгістрацыю, каб я мог сказаць, што адбываецца на самай справе?

   А. Стварыце або абнавіце файл log4j.properties з наступнымі значэннямі:

   ### прамыя паведамленні ў журнале stdout ### log4j.appender.stdout = org.apache.log4j.ConsoleAppender log4j.appender.stdout.Target = System.out log4j.appender.stdout.layout = org.apache.log4j.PatternLayout log4j.appender.stdout.layout.ConversionPattern =% d {АБСАЛУТ}% 5p% c {1}:% L -% m% n log4j.rootLogger = папярэджанне, stdout ### Уваход для OCPsoft log4j.logger.com.ocpsoft = інфармацыя

6. Пытанне: Ці магу я адлюстроўваць і апрацоўваць URL-адрасы, якія ахопліваюць дынамічную колькасць знакаў '/'?

   А. Так, калі ласка, прачытайце Раздзел 3.4 дакументаў.

7. Пытанне: Як я магу захаваць аб'екты FacesMessage пасля выканання перанакіравання або прыгожага: перанакіравання?

   О. Вам трэба наладзіць дадатковы MultiPageMessagesSupport PhaseListener (ці нешта падобнае)

   <? xml version = '1.0' encoding = 'UTF-8'?> <face-config xmlns = "http://java.sun.com/xml/ns/javaee" xmlns: xsi = "http: // www .w3.org / 2001 / XMLSchema-instance "xsi: schemaLocation =" http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facesconfig_2_0 .xsd "version =" 1.2 "> <lifecycle> <phase-listener> com.ocpsoft.pretty.application.MultiPageMessagesSupport </phase-listener> </lifecycle> </faces-config> Глядзі Гэты артыкул для поўнага тлумачэння таго, як гэта працуе.

8. Пытанне: Працуе PrettyFaces на IBM WebSphere?

   Адказ: Так, але для вэб-сферы патрабуецца наладка, каб паводзіць сябе як разумны сервер.

Падтрымайце нас - ахвярай

Мы вітаем ахвяраванні працягваць прадастаўленне жылля для праектаў з адкрытым зыходным кодам OCPsoft. Ці, калі вам падабаецца гэты праект, вы можаце стаць харчаванне ад PrettyFaces . Усе ахвяраванні ідуць непасрэдна, каб кампенсаваць выдаткі на вэб-хостынг.