Modified: sites/deltaspike/documentation/jsf.html ============================================================================== --- sites/deltaspike/documentation/jsf.html (original) +++ sites/deltaspike/documentation/jsf.html Mon Jul 14 07:41:38 2025 @@ -1,261 +1,515 @@ <!DOCTYPE html> +<html lang="en"> <head> - <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> - <meta charset="utf-8"> - <meta name="viewport" content="width=device-width, initial-scale=1.0"> - <meta name="description" content="deltaspike-generate-pages"> - <meta name="author" content="chm"> - <!-- No caching headers --> - <meta http-equiv="cache-control" content="no-cache"/> - <meta http-equiv="pragma" content="no-cache"/> - <meta http-equiv="expires" content="-1"/> - - <title>JSF Module</title> - - <!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. - --> - - <!-- Styles --> - <link href="https://deltaspike.apache.org/resources/css/bootstrap.css"; rel="stylesheet"> - <link href="https://deltaspike.apache.org/resources/css/bootstrap-responsive.css"; rel="stylesheet"> - <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/3.1.0/css/font-awesome.min.css"; rel="stylesheet"> - - - - - <!-- Tocify - nice dynamic autoscrolling TOC --> - <link href="https://cdnjs.cloudflare.com/ajax/libs/jquery.tocify/1.9.0/stylesheets/jquery.tocify.min.css"; rel="stylesheet"> - <script src="https://code.jquery.com/jquery-1.11.3.min.js";></script> - <script src="https://cdnjs.cloudflare.com/ajax/libs/jqueryui/1.11.4/jquery-ui.min.js";></script> - <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery.tocify/1.9.0/javascripts/jquery.tocify.min.js";></script> - - - <script type="text/javascript"> - $(function () { - $("#toc").tocify({ - scrollTo: 50, - extendPage: true, - context: "#doc-content", - selectors: "h2,h3,h4,h5" - }); - $(".fallback-toc").hide(); - }); - </script> - - - <style type="text/css"> - /* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */ -/*pre.CodeRay {background-color:#f7f7f8;}*/ -.CodeRay .line-numbers{border-right:1px solid #d8d8d8;padding:0 0.5em 0 .25em} -.CodeRay span.line-numbers{display:inline-block;margin-right:.5em;color:rgba(0,0,0,.3)} -.CodeRay .line-numbers strong{color:rgba(0,0,0,.4)} -table.CodeRay{border-collapse:separate;border-spacing:0;margin-bottom:0;border:0;background:none} -table.CodeRay td{vertical-align: top;line-height:1.45} -table.CodeRay td.line-numbers{text-align:right} -table.CodeRay td.line-numbers>pre{padding:0;color:rgba(0,0,0,.3)} -table.CodeRay td.code{padding:0 0 0 .5em} -table.CodeRay td.code>pre{padding:0} -.CodeRay .debug{color:#fff !important;background:#000080 !important} -.CodeRay .annotation{color:#007} -.CodeRay .attribute-name{color:#000080} -.CodeRay .attribute-value{color:#700} -.CodeRay .binary{color:#509} -.CodeRay .comment{color:#998;font-style:italic} -.CodeRay .char{color:#04d} -.CodeRay .char .content{color:#04d} -.CodeRay .char .delimiter{color:#039} -.CodeRay .class{color:#458;font-weight:bold} -.CodeRay .complex{color:#a08} -.CodeRay .constant,.CodeRay .predefined-constant{color:#008080} -.CodeRay .color{color:#099} -.CodeRay .class-variable{color:#369} -.CodeRay .decorator{color:#b0b} -.CodeRay .definition{color:#099} -.CodeRay .delimiter{color:#000} -.CodeRay .doc{color:#970} -.CodeRay .doctype{color:#34b} -.CodeRay .doc-string{color:#d42} -.CodeRay .escape{color:#666} -.CodeRay .entity{color:#800} -.CodeRay .error{color:#808} -.CodeRay .exception{color:inherit} -.CodeRay .filename{color:#099} -.CodeRay .function{color:#900;font-weight:bold} -.CodeRay .global-variable{color:#008080} -.CodeRay .hex{color:#058} -.CodeRay .integer,.CodeRay .float{color:#099} -.CodeRay .include{color:#555} -.CodeRay .inline{color:#000} -.CodeRay .inline .inline{background:#ccc} -.CodeRay .inline .inline .inline{background:#bbb} -.CodeRay .inline .inline-delimiter{color:#d14} -.CodeRay .inline-delimiter{color:#d14} -.CodeRay .important{color:#555;font-weight:bold} -.CodeRay .interpreted{color:#b2b} -.CodeRay .instance-variable{color:#008080} -.CodeRay .label{color:#970} -.CodeRay .local-variable{color:#963} -.CodeRay .octal{color:#40e} -.CodeRay .predefined{color:#369} -.CodeRay .preprocessor{color:#579} -.CodeRay .pseudo-class{color:#555} -.CodeRay .directive{font-weight:bold} -.CodeRay .type{font-weight:bold} -.CodeRay .predefined-type{color:inherit} -.CodeRay .reserved,.CodeRay .keyword {color:#000;font-weight:bold} -.CodeRay .key{color:#808} -.CodeRay .key .delimiter{color:#606} -.CodeRay .key .char{color:#80f} -.CodeRay .value{color:#088} -.CodeRay .regexp .delimiter{color:#808} -.CodeRay .regexp .content{color:#808} -.CodeRay .regexp .modifier{color:#808} -.CodeRay .regexp .char{color:#d14} -.CodeRay .regexp .function{color:#404;font-weight:bold} -.CodeRay .string{color:#d20} -.CodeRay .string .string .string{background:#ffd0d0} -.CodeRay .string .content{color:#d14} -.CodeRay .string .char{color:#d14} -.CodeRay .string .delimiter{color:#d14} -.CodeRay .shell{color:#d14} -.CodeRay .shell .delimiter{color:#d14} -.CodeRay .symbol{color:#990073} -.CodeRay .symbol .content{color:#a60} -.CodeRay .symbol .delimiter{color:#630} -.CodeRay .tag{color:#008080} -.CodeRay .tag-special{color:#d70} -.CodeRay .variable{color:#036} -.CodeRay .insert{background:#afa} -.CodeRay .delete{background:#faa} -.CodeRay .change{color:#aaf;background:#007} -.CodeRay .head{color:#f8f;background:#505} -.CodeRay .insert .insert{color:#080} -.CodeRay .delete .delete{color:#800} -.CodeRay .change .change{color:#66f} -.CodeRay .head .head{color:#f4f} - - body { - padding-top: 60px; - padding-bottom: 40px; - } - - .toc-like { - border-radius: 6px; - border: 1px solid #ccc; - } - - .toc-like li { - line-height: 30px; - text-indent: 10px; - } - - .toc-like li.custom-toc-header { - font-weight: bold; - background: #666; - color: white; - cursor: initial !important; - padding: 5px; - } - - .toc-like li.custom-toc-header a { - color: white; - font-style: normal; - text-shadow: none; - padding: 0; - } - - .toc-like li.custom-toc-header:hover a { - background: #666; - } - - .page-title { - text-align: left; - } - - #doc-content h2, - #doc-content h3, - #doc-content h4, - #doc-content h5, - #doc-content h6 { - padding-top: 0; - margin-top: 25px; - margin-bottom: 10px; - line-height: 1.4em; - } - - #doc-content h2 { - border-bottom: 1px solid lightgrey; - } - - - </style> - +<meta charset="UTF-8"> +<meta http-equiv="X-UA-Compatible" content="IE=edge"> +<meta name="viewport" content="width=device-width, initial-scale=1.0"> +<meta name="generator" content="Asciidoctor 2.0.23"> +<title>JSF Module</title> +<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700";> +<style> +/*! Asciidoctor default stylesheet | MIT License | https://asciidoctor.org */ +/* Uncomment the following line when using as a custom stylesheet */ +/* @import "https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700";; */ +html{font-family:sans-serif;-webkit-text-size-adjust:100%} +a{background:none} +a:focus{outline:thin dotted} +a:active,a:hover{outline:0} +h1{font-size:2em;margin:.67em 0} +b,strong{font-weight:bold} +abbr{font-size:.9em} +abbr[title]{cursor:help;border-bottom:1px dotted #dddddf;text-decoration:none} +dfn{font-style:italic} +hr{height:0} +mark{background:#ff0;color:#000} +code,kbd,pre,samp{font-family:monospace;font-size:1em} +pre{white-space:pre-wrap} +q{quotes:"\201C" "\201D" "\2018" "\2019"} +small{font-size:80%} +sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline} +sup{top:-.5em} +sub{bottom:-.25em} +img{border:0} +svg:not(:root){overflow:hidden} +figure{margin:0} +audio,video{display:inline-block} +audio:not([controls]){display:none;height:0} +fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em} +legend{border:0;padding:0} +button,input,select,textarea{font-family:inherit;font-size:100%;margin:0} +button,input{line-height:normal} +button,select{text-transform:none} +button,html input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer} +button[disabled],html input[disabled]{cursor:default} +input[type=checkbox],input[type=radio]{padding:0} +button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0} +textarea{overflow:auto;vertical-align:top} +table{border-collapse:collapse;border-spacing:0} +*,::before,::after{box-sizing:border-box} +html,body{font-size:100%} +body{background:#fff;color:rgba(0,0,0,.8);padding:0;margin:0;font-family:"Noto Serif","DejaVu Serif",serif;line-height:1;position:relative;cursor:auto;-moz-tab-size:4;-o-tab-size:4;tab-size:4;word-wrap:anywhere;-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased} +a:hover{cursor:pointer} +img,object,embed{max-width:100%;height:auto} +object,embed{height:100%} +img{-ms-interpolation-mode:bicubic} +.left{float:left!important} +.right{float:right!important} +.text-left{text-align:left!important} +.text-right{text-align:right!important} +.text-center{text-align:center!important} +.text-justify{text-align:justify!important} +.hide{display:none} +img,object,svg{display:inline-block;vertical-align:middle} +textarea{height:auto;min-height:50px} +select{width:100%} +.subheader,.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{line-height:1.45;color:#7a2518;font-weight:400;margin-top:0;margin-bottom:.25em} +div,dl,dt,dd,ul,ol,li,h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6,pre,form,p,blockquote,th,td{margin:0;padding:0} +a{color:#2156a5;text-decoration:underline;line-height:inherit} +a:hover,a:focus{color:#1d4b8f} +a img{border:0} +p{line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility} +p aside{font-size:.875em;line-height:1.35;font-style:italic} +h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{font-family:"Open Sans","DejaVu Sans",sans-serif;font-weight:300;font-style:normal;color:#ba3925;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:.5em;line-height:1.0125em} +h1 small,h2 small,h3 small,#toctitle small,.sidebarblock>.content>.title small,h4 small,h5 small,h6 small{font-size:60%;color:#e99b8f;line-height:0} +h1{font-size:2.125em} +h2{font-size:1.6875em} +h3,#toctitle,.sidebarblock>.content>.title{font-size:1.375em} +h4,h5{font-size:1.125em} +h6{font-size:1em} +hr{border:solid #dddddf;border-width:1px 0 0;clear:both;margin:1.25em 0 1.1875em} +em,i{font-style:italic;line-height:inherit} +strong,b{font-weight:bold;line-height:inherit} +small{font-size:60%;line-height:inherit} +code{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;color:rgba(0,0,0,.9)} +ul,ol,dl{line-height:1.6;margin-bottom:1.25em;list-style-position:outside;font-family:inherit} +ul,ol{margin-left:1.5em} +ul li ul,ul li ol{margin-left:1.25em;margin-bottom:0} +ul.circle{list-style-type:circle} +ul.disc{list-style-type:disc} +ul.square{list-style-type:square} +ul.circle ul:not([class]),ul.disc ul:not([class]),ul.square ul:not([class]){list-style:inherit} +ol li ul,ol li ol{margin-left:1.25em;margin-bottom:0} +dl dt{margin-bottom:.3125em;font-weight:bold} +dl dd{margin-bottom:1.25em} +blockquote{margin:0 0 1.25em;padding:.5625em 1.25em 0 1.1875em;border-left:1px solid #ddd} +blockquote,blockquote p{line-height:1.6;color:rgba(0,0,0,.85)} +@media screen and (min-width:768px){h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2} +h1{font-size:2.75em} +h2{font-size:2.3125em} +h3,#toctitle,.sidebarblock>.content>.title{font-size:1.6875em} +h4{font-size:1.4375em}} +table{background:#fff;margin-bottom:1.25em;border:1px solid #dedede;word-wrap:normal} +table thead,table tfoot{background:#f7f8f7} +table thead tr th,table thead tr td,table tfoot tr th,table tfoot tr td{padding:.5em .625em .625em;font-size:inherit;color:rgba(0,0,0,.8);text-align:left} +table tr th,table tr td{padding:.5625em .625em;font-size:inherit;color:rgba(0,0,0,.8)} +table tr.even,table tr.alt{background:#f8f8f7} +table thead tr th,table tfoot tr th,table tbody tr td,table tr td,table tfoot tr td{line-height:1.6} +h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2;word-spacing:-.05em} +h1 strong,h2 strong,h3 strong,#toctitle strong,.sidebarblock>.content>.title strong,h4 strong,h5 strong,h6 strong{font-weight:400} +.center{margin-left:auto;margin-right:auto} +.stretch{width:100%} +.clearfix::before,.clearfix::after,.float-group::before,.float-group::after{content:" ";display:table} +.clearfix::after,.float-group::after{clear:both} +:not(pre).nobreak{word-wrap:normal} +:not(pre).nowrap{white-space:nowrap} +:not(pre).pre-wrap{white-space:pre-wrap} +:not(pre):not([class^=L])>code{font-size:.9375em;font-style:normal!important;letter-spacing:0;padding:.1em .5ex;word-spacing:-.15em;background:#f7f7f8;border-radius:4px;line-height:1.45;text-rendering:optimizeSpeed} +pre{color:rgba(0,0,0,.9);font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;line-height:1.45;text-rendering:optimizeSpeed} +pre code,pre pre{color:inherit;font-size:inherit;line-height:inherit} +pre>code{display:block} +pre.nowrap,pre.nowrap pre{white-space:pre;word-wrap:normal} +em em{font-style:normal} +strong strong{font-weight:400} +.keyseq{color:rgba(51,51,51,.8)} +kbd{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;display:inline-block;color:rgba(0,0,0,.8);font-size:.65em;line-height:1.45;background:#f7f7f7;border:1px solid #ccc;border-radius:3px;box-shadow:0 1px 0 rgba(0,0,0,.2),inset 0 0 0 .1em #fff;margin:0 .15em;padding:.2em .5em;vertical-align:middle;position:relative;top:-.1em;white-space:nowrap} +.keyseq kbd:first-child{margin-left:0} +.keyseq kbd:last-child{margin-right:0} +.menuseq,.menuref{color:#000} +.menuseq b:not(.caret),.menuref{font-weight:inherit} +.menuseq{word-spacing:-.02em} +.menuseq b.caret{font-size:1.25em;line-height:.8} +.menuseq i.caret{font-weight:bold;text-align:center;width:.45em} +b.button::before,b.button::after{position:relative;top:-1px;font-weight:400} +b.button::before{content:"[";padding:0 3px 0 2px} +b.button::after{content:"]";padding:0 2px 0 3px} +p a>code:hover{color:rgba(0,0,0,.9)} +#header,#content,#footnotes,#footer{width:100%;margin:0 auto;max-width:62.5em;*zoom:1;position:relative;padding-left:.9375em;padding-right:.9375em} +#header::before,#header::after,#content::before,#content::after,#footnotes::before,#footnotes::after,#footer::before,#footer::after{content:" ";display:table} +#header::after,#content::after,#footnotes::after,#footer::after{clear:both} +#content{margin-top:1.25em} +#content::before{content:none} +#header>h1:first-child{color:rgba(0,0,0,.85);margin-top:2.25rem;margin-bottom:0} +#header>h1:first-child+#toc{margin-top:8px;border-top:1px solid #dddddf} +#header>h1:only-child{border-bottom:1px solid #dddddf;padding-bottom:8px} +#header .details{border-bottom:1px solid #dddddf;line-height:1.45;padding-top:.25em;padding-bottom:.25em;padding-left:.25em;color:rgba(0,0,0,.6);display:flex;flex-flow:row wrap} +#header .details span:first-child{margin-left:-.125em} +#header .details span.email a{color:rgba(0,0,0,.85)} +#header .details br{display:none} +#header .details br+span::before{content:"\00a0\2013\00a0"} +#header .details br+span.author::before{content:"\00a0\22c5\00a0";color:rgba(0,0,0,.85)} +#header .details br+span#revremark::before{content:"\00a0|\00a0"} +#header #revnumber{text-transform:capitalize} +#header #revnumber::after{content:"\00a0"} +#content>h1:first-child:not([class]){color:rgba(0,0,0,.85);border-bottom:1px solid #dddddf;padding-bottom:8px;margin-top:0;padding-top:1rem;margin-bottom:1.25rem} +#toc{border-bottom:1px solid #e7e7e9;padding-bottom:.5em} +#toc>ul{margin-left:.125em} +#toc ul.sectlevel0>li>a{font-style:italic} +#toc ul.sectlevel0 ul.sectlevel1{margin:.5em 0} +#toc ul{font-family:"Open Sans","DejaVu Sans",sans-serif;list-style-type:none} +#toc li{line-height:1.3334;margin-top:.3334em} +#toc a{text-decoration:none} +#toc a:active{text-decoration:underline} +#toctitle{color:#7a2518;font-size:1.2em} +@media screen and (min-width:768px){#toctitle{font-size:1.375em} +body.toc2{padding-left:15em;padding-right:0} +body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #dddddf;padding-bottom:8px} +#toc.toc2{margin-top:0!important;background:#f8f8f7;position:fixed;width:15em;left:0;top:0;border-right:1px solid #e7e7e9;border-top-width:0!important;border-bottom-width:0!important;z-index:1000;padding:1.25em 1em;height:100%;overflow:auto} +#toc.toc2 #toctitle{margin-top:0;margin-bottom:.8rem;font-size:1.2em} +#toc.toc2>ul{font-size:.9em;margin-bottom:0} +#toc.toc2 ul ul{margin-left:0;padding-left:1em} +#toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:0;margin-top:.5em;margin-bottom:.5em} +body.toc2.toc-right{padding-left:0;padding-right:15em} +body.toc2.toc-right #toc.toc2{border-right-width:0;border-left:1px solid #e7e7e9;left:auto;right:0}} +@media screen and (min-width:1280px){body.toc2{padding-left:20em;padding-right:0} +#toc.toc2{width:20em} +#toc.toc2 #toctitle{font-size:1.375em} +#toc.toc2>ul{font-size:.95em} +#toc.toc2 ul ul{padding-left:1.25em} +body.toc2.toc-right{padding-left:0;padding-right:20em}} +#content #toc{border:1px solid #e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;border-radius:4px} +#content #toc>:first-child{margin-top:0} +#content #toc>:last-child{margin-bottom:0} +#footer{max-width:none;background:rgba(0,0,0,.8);padding:1.25em} +#footer-text{color:hsla(0,0%,100%,.8);line-height:1.44} +#content{margin-bottom:.625em} +.sect1{padding-bottom:.625em} +@media screen and (min-width:768px){#content{margin-bottom:1.25em} +.sect1{padding-bottom:1.25em}} +.sect1:last-child{padding-bottom:0} +.sect1+.sect1{border-top:1px solid #e7e7e9} +#content h1>a.anchor,h2>a.anchor,h3>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;display:block;text-decoration:none!important;visibility:hidden;text-align:center;font-weight:400} +#content h1>a.anchor::before,h2>a.anchor::before,h3>a.anchor::before,#toctitle>a.anchor::before,.sidebarblock>.content>.title>a.anchor::before,h4>a.anchor::before,h5>a.anchor::before,h6>a.anchor::before{content:"\00A7";font-size:.85em;display:block;padding-top:.1em} +#content h1:hover>a.anchor,#content h1>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,#toctitle:hover>a.anchor,.sidebarblock>.content>.title:hover>a.anchor,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible} +#content h1>a.link,h2>a.link,h3>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h4>a.link,h5>a.link,h6>a.link{color:#ba3925;text-decoration:none} +#content h1>a.link:hover,h2>a.link:hover,h3>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#a53221} +details,.audioblock,.imageblock,.literalblock,.listingblock,.stemblock,.videoblock{margin-bottom:1.25em} +details{margin-left:1.25rem} +details>summary{cursor:pointer;display:block;position:relative;line-height:1.6;margin-bottom:.625rem;outline:none;-webkit-tap-highlight-color:transparent} +details>summary::-webkit-details-marker{display:none} +details>summary::before{content:"";border:solid transparent;border-left:solid;border-width:.3em 0 .3em .5em;position:absolute;top:.5em;left:-1.25rem;transform:translateX(15%)} +details[open]>summary::before{border:solid transparent;border-top:solid;border-width:.5em .3em 0;transform:translateY(15%)} +details>summary::after{content:"";width:1.25rem;height:1em;position:absolute;top:.3em;left:-1.25rem} +.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{text-rendering:optimizeLegibility;text-align:left;font-family:"Noto Serif","DejaVu Serif",serif;font-size:1rem;font-style:italic} +table.tableblock.fit-content>caption.title{white-space:nowrap;width:0} +.paragraph.lead>p,#preamble>.sectionbody>[class=paragraph]:first-of-type p{font-size:1.21875em;line-height:1.6;color:rgba(0,0,0,.85)} +.admonitionblock>table{border-collapse:separate;border:0;background:none;width:100%} +.admonitionblock>table td.icon{text-align:center;width:80px} +.admonitionblock>table td.icon img{max-width:none} +.admonitionblock>table td.icon .title{font-weight:bold;font-family:"Open Sans","DejaVu Sans",sans-serif;text-transform:uppercase} +.admonitionblock>table td.content{padding-left:1.125em;padding-right:1.25em;border-left:1px solid #dddddf;color:rgba(0,0,0,.6);word-wrap:anywhere} +.admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0} +.exampleblock>.content{border:1px solid #e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#fff;border-radius:4px} +.sidebarblock{border:1px solid #dbdbd6;margin-bottom:1.25em;padding:1.25em;background:#f3f3f2;border-radius:4px} +.sidebarblock>.content>.title{color:#7a2518;margin-top:0;text-align:center} +.exampleblock>.content>:first-child,.sidebarblock>.content>:first-child{margin-top:0} +.exampleblock>.content>:last-child,.exampleblock>.content>:last-child>:last-child,.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child{margin-bottom:0} +.literalblock pre,.listingblock>.content>pre{border-radius:4px;overflow-x:auto;padding:1em;font-size:.8125em} +@media screen and (min-width:768px){.literalblock pre,.listingblock>.content>pre{font-size:.90625em}} +@media screen and (min-width:1280px){.literalblock pre,.listingblock>.content>pre{font-size:1em}} +.literalblock pre,.listingblock>.content>pre:not(.highlight),.listingblock>.content>pre[class=highlight],.listingblock>.content>pre[class^="highlight "]{background:#f7f7f8} +.literalblock.output pre{color:#f7f7f8;background:rgba(0,0,0,.9)} +.listingblock>.content{position:relative} +.listingblock code[data-lang]::before{display:none;content:attr(data-lang);position:absolute;font-size:.75em;top:.425rem;right:.5rem;line-height:1;text-transform:uppercase;color:inherit;opacity:.5} +.listingblock:hover code[data-lang]::before{display:block} +.listingblock.terminal pre .command::before{content:attr(data-prompt);padding-right:.5em;color:inherit;opacity:.5} +.listingblock.terminal pre .command:not([data-prompt])::before{content:"$"} +.listingblock pre.highlightjs{padding:0} +.listingblock pre.highlightjs>code{padding:1em;border-radius:4px} +.listingblock pre.prettyprint{border-width:0} +.prettyprint{background:#f7f7f8} +pre.prettyprint .linenums{line-height:1.45;margin-left:2em} +pre.prettyprint li{background:none;list-style-type:inherit;padding-left:0} +pre.prettyprint li code[data-lang]::before{opacity:1} +pre.prettyprint li:not(:first-child) code[data-lang]::before{display:none} +table.linenotable{border-collapse:separate;border:0;margin-bottom:0;background:none} +table.linenotable td[class]{color:inherit;vertical-align:top;padding:0;line-height:inherit;white-space:normal} +table.linenotable td.code{padding-left:.75em} +table.linenotable td.linenos,pre.pygments .linenos{border-right:1px solid;opacity:.35;padding-right:.5em;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none} +pre.pygments span.linenos{display:inline-block;margin-right:.75em} +.quoteblock{margin:0 1em 1.25em 1.5em;display:table} +.quoteblock:not(.excerpt)>.title{margin-left:-1.5em;margin-bottom:.75em} +.quoteblock blockquote,.quoteblock p{color:rgba(0,0,0,.85);font-size:1.15rem;line-height:1.75;word-spacing:.1em;letter-spacing:0;font-style:italic;text-align:justify} +.quoteblock blockquote{margin:0;padding:0;border:0} +.quoteblock blockquote::before{content:"\201c";float:left;font-size:2.75em;font-weight:bold;line-height:.6em;margin-left:-.6em;color:#7a2518;text-shadow:0 1px 2px rgba(0,0,0,.1)} +.quoteblock blockquote>.paragraph:last-child p{margin-bottom:0} +.quoteblock .attribution{margin-top:.75em;margin-right:.5ex;text-align:right} +.verseblock{margin:0 1em 1.25em} +.verseblock pre{font-family:"Open Sans","DejaVu Sans",sans-serif;font-size:1.15rem;color:rgba(0,0,0,.85);font-weight:300;text-rendering:optimizeLegibility} +.verseblock pre strong{font-weight:400} +.verseblock .attribution{margin-top:1.25rem;margin-left:.5ex} +.quoteblock .attribution,.verseblock .attribution{font-size:.9375em;line-height:1.45;font-style:italic} +.quoteblock .attribution br,.verseblock .attribution br{display:none} +.quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-.025em;color:rgba(0,0,0,.6)} +.quoteblock.abstract blockquote::before,.quoteblock.excerpt blockquote::before,.quoteblock .quoteblock blockquote::before{display:none} +.quoteblock.abstract blockquote,.quoteblock.abstract p,.quoteblock.excerpt blockquote,.quoteblock.excerpt p,.quoteblock .quoteblock blockquote,.quoteblock .quoteblock p{line-height:1.6;word-spacing:0} +.quoteblock.abstract{margin:0 1em 1.25em;display:block} +.quoteblock.abstract>.title{margin:0 0 .375em;font-size:1.15em;text-align:center} +.quoteblock.excerpt>blockquote,.quoteblock .quoteblock{padding:0 0 .25em 1em;border-left:.25em solid #dddddf} +.quoteblock.excerpt,.quoteblock .quoteblock{margin-left:0} +.quoteblock.excerpt blockquote,.quoteblock.excerpt p,.quoteblock .quoteblock blockquote,.quoteblock .quoteblock p{color:inherit;font-size:1.0625rem} +.quoteblock.excerpt .attribution,.quoteblock .quoteblock .attribution{color:inherit;font-size:.85rem;text-align:left;margin-right:0} +p.tableblock:last-child{margin-bottom:0} +td.tableblock>.content{margin-bottom:1.25em;word-wrap:anywhere} +td.tableblock>.content>:last-child{margin-bottom:-1.25em} +table.tableblock,th.tableblock,td.tableblock{border:0 solid #dedede} +table.grid-all>*>tr>*{border-width:1px} +table.grid-cols>*>tr>*{border-width:0 1px} +table.grid-rows>*>tr>*{border-width:1px 0} +table.frame-all{border-width:1px} +table.frame-ends{border-width:1px 0} +table.frame-sides{border-width:0 1px} +table.frame-none>colgroup+*>:first-child>*,table.frame-sides>colgroup+*>:first-child>*{border-top-width:0} +table.frame-none>:last-child>:last-child>*,table.frame-sides>:last-child>:last-child>*{border-bottom-width:0} +table.frame-none>*>tr>:first-child,table.frame-ends>*>tr>:first-child{border-left-width:0} +table.frame-none>*>tr>:last-child,table.frame-ends>*>tr>:last-child{border-right-width:0} +table.stripes-all>*>tr,table.stripes-odd>*>tr:nth-of-type(odd),table.stripes-even>*>tr:nth-of-type(even),table.stripes-hover>*>tr:hover{background:#f8f8f7} +th.halign-left,td.halign-left{text-align:left} +th.halign-right,td.halign-right{text-align:right} +th.halign-center,td.halign-center{text-align:center} +th.valign-top,td.valign-top{vertical-align:top} +th.valign-bottom,td.valign-bottom{vertical-align:bottom} +th.valign-middle,td.valign-middle{vertical-align:middle} +table thead th,table tfoot th{font-weight:bold} +tbody tr th{background:#f7f8f7} +tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:rgba(0,0,0,.8);font-weight:bold} +p.tableblock>code:only-child{background:none;padding:0} +p.tableblock{font-size:1em} +ol{margin-left:1.75em} +ul li ol{margin-left:1.5em} +dl dd{margin-left:1.125em} +dl dd:last-child,dl dd:last-child>:last-child{margin-bottom:0} +li p,ul dd,ol dd,.olist .olist,.ulist .ulist,.ulist .olist,.olist .ulist{margin-bottom:.625em} +ul.checklist,ul.none,ol.none,ul.no-bullet,ol.no-bullet,ol.unnumbered,ul.unstyled,ol.unstyled{list-style-type:none} +ul.no-bullet,ol.no-bullet,ol.unnumbered{margin-left:.625em} +ul.unstyled,ol.unstyled{margin-left:0} +li>p:empty:only-child::before{content:"";display:inline-block} +ul.checklist>li>p:first-child{margin-left:-1em} +ul.checklist>li>p:first-child>.fa-square-o:first-child,ul.checklist>li>p:first-child>.fa-check-square-o:first-child{width:1.25em;font-size:.8em;position:relative;bottom:.125em} +ul.checklist>li>p:first-child>input[type=checkbox]:first-child{margin-right:.25em} +ul.inline{display:flex;flex-flow:row wrap;list-style:none;margin:0 0 .625em -1.25em} +ul.inline>li{margin-left:1.25em} +.unstyled dl dt{font-weight:400;font-style:normal} +ol.arabic{list-style-type:decimal} +ol.decimal{list-style-type:decimal-leading-zero} +ol.loweralpha{list-style-type:lower-alpha} +ol.upperalpha{list-style-type:upper-alpha} +ol.lowerroman{list-style-type:lower-roman} +ol.upperroman{list-style-type:upper-roman} +ol.lowergreek{list-style-type:lower-greek} +.hdlist>table,.colist>table{border:0;background:none} +.hdlist>table>tbody>tr,.colist>table>tbody>tr{background:none} +td.hdlist1,td.hdlist2{vertical-align:top;padding:0 .625em} +td.hdlist1{font-weight:bold;padding-bottom:1.25em} +td.hdlist2{word-wrap:anywhere} +.literalblock+.colist,.listingblock+.colist{margin-top:-.5em} +.colist td:not([class]):first-child{padding:.4em .75em 0;line-height:1;vertical-align:top} +.colist td:not([class]):first-child img{max-width:none} +.colist td:not([class]):last-child{padding:.25em 0} +.thumb,.th{line-height:0;display:inline-block;border:4px solid #fff;box-shadow:0 0 0 1px #ddd} +.imageblock.left{margin:.25em .625em 1.25em 0} +.imageblock.right{margin:.25em 0 1.25em .625em} +.imageblock>.title{margin-bottom:0} +.imageblock.thumb,.imageblock.th{border-width:6px} +.imageblock.thumb>.title,.imageblock.th>.title{padding:0 .125em} +.image.left,.image.right{margin-top:.25em;margin-bottom:.25em;display:inline-block;line-height:0} +.image.left{margin-right:.625em} +.image.right{margin-left:.625em} +a.image{text-decoration:none;display:inline-block} +a.image object{pointer-events:none} +sup.footnote,sup.footnoteref{font-size:.875em;position:static;vertical-align:super} +sup.footnote a,sup.footnoteref a{text-decoration:none} +sup.footnote a:active,sup.footnoteref a:active,#footnotes .footnote a:first-of-type:active{text-decoration:underline} +#footnotes{padding-top:.75em;padding-bottom:.75em;margin-bottom:.625em} +#footnotes hr{width:20%;min-width:6.25em;margin:-.25em 0 .75em;border-width:1px 0 0} +#footnotes .footnote{padding:0 .375em 0 .225em;line-height:1.3334;font-size:.875em;margin-left:1.2em;margin-bottom:.2em} +#footnotes .footnote a:first-of-type{font-weight:bold;text-decoration:none;margin-left:-1.05em} +#footnotes .footnote:last-of-type{margin-bottom:0} +#content #footnotes{margin-top:-.625em;margin-bottom:0;padding:.75em 0} +div.unbreakable{page-break-inside:avoid} +.big{font-size:larger} +.small{font-size:smaller} +.underline{text-decoration:underline} +.overline{text-decoration:overline} +.line-through{text-decoration:line-through} +.aqua{color:#00bfbf} +.aqua-background{background:#00fafa} +.black{color:#000} +.black-background{background:#000} +.blue{color:#0000bf} +.blue-background{background:#0000fa} +.fuchsia{color:#bf00bf} +.fuchsia-background{background:#fa00fa} +.gray{color:#606060} +.gray-background{background:#7d7d7d} +.green{color:#006000} +.green-background{background:#007d00} +.lime{color:#00bf00} +.lime-background{background:#00fa00} +.maroon{color:#600000} +.maroon-background{background:#7d0000} +.navy{color:#000060} +.navy-background{background:#00007d} +.olive{color:#606000} +.olive-background{background:#7d7d00} +.purple{color:#600060} +.purple-background{background:#7d007d} +.red{color:#bf0000} +.red-background{background:#fa0000} +.silver{color:#909090} +.silver-background{background:#bcbcbc} +.teal{color:#006060} +.teal-background{background:#007d7d} +.white{color:#bfbfbf} +.white-background{background:#fafafa} +.yellow{color:#bfbf00} +.yellow-background{background:#fafa00} +span.icon>.fa{cursor:default} +a span.icon>.fa{cursor:inherit} +.admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;text-shadow:1px 1px 2px rgba(0,0,0,.5);cursor:default} +.admonitionblock td.icon .icon-note::before{content:"\f05a";color:#19407c} +.admonitionblock td.icon .icon-tip::before{content:"\f0eb";text-shadow:1px 1px 2px rgba(155,155,0,.8);color:#111} +.admonitionblock td.icon .icon-warning::before{content:"\f071";color:#bf6900} +.admonitionblock td.icon .icon-caution::before{content:"\f06d";color:#bf3400} +.admonitionblock td.icon .icon-important::before{content:"\f06a";color:#bf0000} +.conum[data-value]{display:inline-block;color:#fff!important;background:rgba(0,0,0,.8);border-radius:50%;text-align:center;font-size:.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans","DejaVu Sans",sans-serif;font-style:normal;font-weight:bold} +.conum[data-value] *{color:#fff!important} +.conum[data-value]+b{display:none} +.conum[data-value]::after{content:attr(data-value)} +pre .conum[data-value]{position:relative;top:-.125em} +b.conum *{color:inherit!important} +.conum:not([data-value]):empty{display:none} +dt,th.tableblock,td.content,div.footnote{text-rendering:optimizeLegibility} +h1,h2,p,td.content,span.alt,summary{letter-spacing:-.01em} +p strong,td.content strong,div.footnote strong{letter-spacing:-.005em} +p,blockquote,dt,td.content,td.hdlist1,span.alt,summary{font-size:1.0625rem} +p{margin-bottom:1.25rem} +.sidebarblock p,.sidebarblock dt,.sidebarblock td.content,p.tableblock{font-size:1em} +.exampleblock>.content{background:#fffef7;border-color:#e0e0dc;box-shadow:0 1px 4px #e0e0dc} +.print-only{display:none!important} +@page{margin:1.25cm .75cm} +@media print{*{box-shadow:none!important;text-shadow:none!important} +html{font-size:80%} +a{color:inherit!important;text-decoration:underline!important} +a.bare,a[href^="#"],a[href^="mailto:"]{text-decoration:none!important} +a[href^="http:"]:not(.bare)::after,a[href^="https:"]:not(.bare)::after{content:"(" attr(href) ")";display:inline-block;font-size:.875em;padding-left:.25em} +abbr[title]{border-bottom:1px dotted} +abbr[title]::after{content:" (" attr(title) ")"} +pre,blockquote,tr,img,object,svg{page-break-inside:avoid} +thead{display:table-header-group} +svg{max-width:100%} +p,blockquote,dt,td.content{font-size:1em;orphans:3;widows:3} +h2,h3,#toctitle,.sidebarblock>.content>.title{page-break-after:avoid} +#header,#content,#footnotes,#footer{max-width:none} +#toc,.sidebarblock,.exampleblock>.content{background:none!important} +#toc{border-bottom:1px solid #dddddf!important;padding-bottom:0!important} +body.book #header{text-align:center} +body.book #header>h1:first-child{border:0!important;margin:2.5em 0 1em} +body.book #header .details{border:0!important;display:block;padding:0!important} +body.book #header .details span:first-child{margin-left:0!important} +body.book #header .details br{display:block} +body.book #header .details br+span::before{content:none!important} +body.book #toc{border:0!important;text-align:left!important;padding:0!important;margin:0!important} +body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-break-before:always} +.listingblock code[data-lang]::before{display:block} +#footer{padding:0 .9375em} +.hide-on-print{display:none!important} +.print-only{display:block!important} +.hide-for-print{display:none!important} +.show-for-print{display:inherit!important}} +@media amzn-kf8,print{#header>h1:first-child{margin-top:1.25rem} +.sect1{padding:0!important} +.sect1+.sect1{border:0} +#footer{background:none} +#footer-text{color:rgba(0,0,0,.6);font-size:.9em}} +@media amzn-kf8{#header,#content,#footnotes,#footer{padding:0}} +</style> +<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css";> </head> - -<body> - -<div class="navbar navbar-fixed-top"> - <div class="navbar-inner"> - <div class="container"> - <a class="btn btn-navbar" data-toggle="collapse" - data-target=".nav-collapse"> <span class="icon-bar"></span> <span - class="icon-bar"></span> <span class="icon-bar"></span> - </a> - <a class="brand logocolor" href="../index.html">Apache DeltaSpike</a> - - <div class="nav-collapse"> - - - <ul class="nav"> - <li><a href="../index.html">Home</a></li> - <li class="active"><a href="../documentation">Documentation</a></li> - <li ><a href="../javadoc.html">Javadoc</a></li> - <li ><a href="../source.html">Source</a></li> - <li ><a href="../download.html">Download</a></li> - <li ><a href="../community.html">Community</a></li> - <!-- <li><a href="./support.html">Support</a></li> --> - <li ><a href="../news.html">News</a></li> - </ul> - </div> - <!--/.nav-collapse --> - <form id="search-form" action="https://www.google.com/search"; - method="get" class="navbar-search pull-right"> - <input value="deltaspike.apache.org" name="sitesearch" - type="hidden"> <input class="search-query" name="q" - id="query" type="text"> - </form> - </div> - </div> -</div> - -<div class="container"> - <div class="row-fluid"> - - - - <div class="span8"> - <div class="page-title"> - <h1>JSF Module</h1> - </div> - - <div id="doc-content"> - <div class="sect1"> +<body class="article"> +<div id="header"> +<h1>JSF Module</h1> +<div id="toc" class="toc"> +<div id="toctitle">Table of Contents</div> +<ul class="sectlevel1"> +<li><a href="#_overview">Overview</a></li> +<li><a href="#_project_setup">Project Setup</a> +<ul class="sectlevel2"> +<li><a href="#_declare_jsf_module_dependencies">Declare JSF Module Dependencies</a></li> +</ul> +</li> +<li><a href="#_jsf_messages">JSF Messages</a></li> +<li><a href="#_multi_window_handling">Multi-Window Handling</a> +<ul class="sectlevel2"> +<li><a href="#_background">Background</a></li> +<li><a href="#_available_modes">Available Modes</a></li> +<li><a href="#_configuration_2">Configuration</a></li> +<li><a href="#_based_scopes">Based Scopes</a></li> +</ul> +</li> +<li><a href="#_scopes">Scopes</a> +<ul class="sectlevel2"> +<li><a href="#_windowscoped">@WindowScoped</a></li> +<li><a href="#_viewaccessscoped">@ViewAccessScoped</a></li> +<li><a href="#_groupedconversationscoped">@GroupedConversationScoped</a></li> +<li><a href="#_viewscoped">@ViewScoped</a></li> +<li><a href="#_jsf_2_0_scopes">JSF 2.0 Scopes</a></li> +</ul> +</li> +<li><a href="#_integration_with_deltaspike_type_safe_messages">Integration with DeltaSpike Type-safe Messages</a></li> +<li><a href="#_type_safe_view_configs">Type-safe View-Configs</a> +<ul class="sectlevel2"> +<li><a href="#_intro">Intro</a></li> +<li><a href="#_motivation">Motivation</a></li> +<li><a href="#_bean_discovery_mode_annotated">Bean-discovery-mode Annotated</a></li> +<li><a href="#_basic_api_usages">Basic API Usages</a></li> +<li><a href="#_advanced_api_usages">Advanced API Usages</a></li> +<li><a href="#_path_validation">Path-Validation</a></li> +<li><a href="#_view_config_spi">View-Config SPI</a></li> +<li><a href="#_activation_of_custom_naming_conventions">Activation of Custom Naming Conventions</a></li> +</ul> +</li> +<li><a href="#_grouped_conversations">(Grouped-)Conversations</a> +<ul class="sectlevel2"> +<li><a href="#_terminating_conversations">Terminating Conversations</a></li> +<li><a href="#_sub_conversation_groups">Sub-Conversation-Groups</a></li> +</ul> +</li> +<li><a href="#_injection_in_jsf_artifacts">Injection in JSF Artifacts</a> +<ul class="sectlevel2"> +<li><a href="#_converter_and_validator">Converter and Validator</a></li> +<li><a href="#_phaselistener">PhaseListener</a></li> +</ul> +</li> +<li><a href="#_event_broadcasting">Event broadcasting</a> +<ul class="sectlevel2"> +<li><a href="#_observe_faces_requests">Observe Faces-Requests</a></li> +<li><a href="#_beforephase_afterphase">BeforePhase / AfterPhase</a></li> +<li><a href="#_jsf_systemevents">JSF SystemEvents</a></li> +</ul> +</li> +<li><a href="#_integration_with_exception_control">Integration with Exception Control</a> +<ul class="sectlevel2"> +<li><a href="#_examples">Examples</a></li> +<li><a href="#_using_a_custom_qualifier_for_jsf_exceptions">Using a Custom Qualifier for JSF Exceptions</a></li> +</ul> +</li> +<li><a href="#_double_submit_prevention">Double-Submit Prevention</a></li> +<li><a href="#_tips">Tips</a></li> +</ul> +</div> +</div> +<div id="content"> +<div class="sect1"> <h2 id="_overview">Overview</h2> <div class="sectionbody"> <div class="paragraph"> @@ -276,19 +530,19 @@ table.CodeRay td.code>pre{padding:0} </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="xml"><span class="tag"><dependency></span> - <span class="tag"><groupId></span>org.apache.deltaspike.modules<span class="tag"></groupId></span> - <span class="tag"><artifactId></span>deltaspike-jsf-module-api<span class="tag"></artifactId></span> - <span class="tag"><version></span>${deltaspike.version}<span class="tag"></version></span> - <span class="tag"><scope></span>compile<span class="tag"></scope></span> -<span class="tag"></dependency></span> - -<span class="tag"><dependency></span> - <span class="tag"><groupId></span>org.apache.deltaspike.modules<span class="tag"></groupId></span> - <span class="tag"><artifactId></span>deltaspike-jsf-module-impl<span class="tag"></artifactId></span> - <span class="tag"><version></span>${deltaspike.version}<span class="tag"></version></span> - <span class="tag"><scope></span>runtime<span class="tag"></scope></span> -<span class="tag"></dependency></span></code></pre> +<pre class="highlight"><code class="language-xml" data-lang="xml"><dependency> + <groupId>org.apache.deltaspike.modules</groupId> + <artifactId>deltaspike-jsf-module-api</artifactId> + <version>${deltaspike.version}</version> + <scope>compile</scope> +</dependency> + +<dependency> + <groupId>org.apache.deltaspike.modules</groupId> + <artifactId>deltaspike-jsf-module-impl</artifactId> + <version>${deltaspike.version}</version> + <scope>runtime</scope> +</dependency></code></pre> </div> </div> <div class="paragraph"> @@ -296,7 +550,7 @@ table.CodeRay td.code>pre{padding:0} </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code> runtime 'org.apache.deltaspike.modules:deltaspike-jsf-module-impl' +<pre class="highlight"><code> runtime 'org.apache.deltaspike.modules:deltaspike-jsf-module-impl' compile 'org.apache.deltaspike.modules:deltaspike-jsf-module-api'</code></pre> </div> </div> @@ -305,12 +559,12 @@ table.CodeRay td.code>pre{padding:0} </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="xml"><span class="tag"><dependency></span> - <span class="tag"><groupId></span>org.apache.deltaspike.modules<span class="tag"></groupId></span> - <span class="tag"><artifactId></span>deltaspike-jsf-module-impl-ee6<span class="tag"></artifactId></span> - <span class="tag"><version></span>${deltaspike.version}<span class="tag"></version></span> - <span class="tag"><scope></span>runtime<span class="tag"></scope></span> -<span class="tag"></dependency></span></code></pre> +<pre class="highlight"><code class="language-xml" data-lang="xml"><dependency> + <groupId>org.apache.deltaspike.modules</groupId> + <artifactId>deltaspike-jsf-module-impl-ee6</artifactId> + <version>${deltaspike.version}</version> + <scope>runtime</scope> +</dependency></code></pre> </div> </div> <div class="paragraph"> @@ -318,7 +572,7 @@ table.CodeRay td.code>pre{padding:0} </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code> runtime 'org.apache.deltaspike.modules:deltaspike-jsf-module-impl-ee6'</code></pre> +<pre class="highlight"><code> runtime 'org.apache.deltaspike.modules:deltaspike-jsf-module-impl-ee6'</code></pre> </div> </div> <div class="admonitionblock important"> @@ -354,18 +608,18 @@ the corresponding impact. </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@MessageBundle</span> -<span class="directive">public</span> <span class="type">interface</span> <span class="class">Messages</span> +<pre class="highlight"><code class="language-java" data-lang="java">@MessageBundle +public interface Messages { - <span class="annotation">@MessageTemplate</span>(<span class="string"><span class="delimiter">"</span><span class="content">Welcome to DeltaSpike</span><span class="delimiter">"</span></span>) - <span class="predefined-type">String</span> welcomeToDeltaSpike(); + @MessageTemplate("Welcome to DeltaSpike") + String welcomeToDeltaSpike(); } - <span class="annotation">@Model</span> - <span class="directive">public</span> <span class="type">class</span> <span class="class">MyJSFBean</span> + @Model + public class MyJSFBean { - <span class="annotation">@Inject</span> - <span class="directive">private</span> JsfMessage<Messages> messages; + @Inject + private JsfMessage<Messages> messages; ... messages.addInfo().welcomeToDeltaSpike(); @@ -488,13 +742,13 @@ We also provide a mechanism to store the </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Specializes</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">MyClientWindowConfig</span> <span class="directive">extends</span> DefaultClientWindowConfig +<pre class="highlight"><code class="language-java" data-lang="java">@Specializes +public class MyClientWindowConfig extends DefaultClientWindowConfig { - <span class="annotation">@Override</span> - <span class="directive">public</span> <span class="type">boolean</span> isClientWindowStoreWindowTreeEnabledOnButtonClick() + @Override + public boolean isClientWindowStoreWindowTreeEnabledOnButtonClick() { - <span class="keyword">return</span> <span class="predefined-constant">true</span>; + return true; } }</code></pre> </div> @@ -508,13 +762,13 @@ provide a own via:</p> </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Specializes</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">MyClientWindowConfig</span> <span class="directive">extends</span> DefaultClientWindowConfig +<pre class="highlight"><code class="language-java" data-lang="java">@Specializes +public class MyClientWindowConfig extends DefaultClientWindowConfig { - <span class="annotation">@Override</span> - <span class="directive">public</span> <span class="predefined-type">String</span> getClientWindowHtml() + @Override + public String getClientWindowHtml() { - <span class="keyword">return</span> <span class="string"><span class="delimiter">"</span><span class="content"><html><body>Loading...</body></html></span><span class="delimiter">"</span></span>; + return "<html><body>Loading...</body></html>"; } }</code></pre> </div> @@ -525,19 +779,19 @@ if you would like to always show your cu </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Specializes</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">MyClientWindowConfig</span> <span class="directive">extends</span> DefaultClientWindowConfig +<pre class="highlight"><code class="language-java" data-lang="java">@Specializes +public class MyClientWindowConfig extends DefaultClientWindowConfig { - <span class="annotation">@Override</span> - <span class="directive">public</span> <span class="type">boolean</span> isClientWindowStoreWindowTreeEnabledOnLinkClick() + @Override + public boolean isClientWindowStoreWindowTreeEnabledOnLinkClick() { - <span class="keyword">return</span> <span class="predefined-constant">false</span>; + return false; } - <span class="annotation">@Override</span> - <span class="directive">public</span> <span class="type">boolean</span> isClientWindowStoreWindowTreeEnabledOnButtonClick() + @Override + public boolean isClientWindowStoreWindowTreeEnabledOnButtonClick() { - <span class="keyword">return</span> <span class="predefined-constant">false</span>; + return false; } }</code></pre> </div> @@ -554,13 +808,13 @@ The onclick handler appends a request to </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Specializes</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">MyClientWindowConfig</span> <span class="directive">extends</span> DefaultClientWindowConfig +<pre class="highlight"><code class="language-java" data-lang="java">@Specializes +public class MyClientWindowConfig extends DefaultClientWindowConfig { - <span class="annotation">@Override</span> - <span class="directive">public</span> <span class="predefined-type">String</span> isClientWindowTokenizedRedirectEnabled() + @Override + public String isClientWindowTokenizedRedirectEnabled() { - <span class="keyword">return</span> <span class="predefined-constant">true</span>; + return true; } }</code></pre> </div> @@ -719,10 +973,10 @@ of the windowId to all links of all chil </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="xml"><span class="tag"><ds:disableClientWindow></span> - <span class="tag"><h:link</span> <span class="attribute-name">value</span>=<span class="string"><span class="delimiter">"</span><span class="content">Link without windowId</span><span class="delimiter">"</span></span> <span class="attribute-name">outcome</span>=<span class="string"><span class="delimiter">"</span><span class="content">target.xhtml</span><span class="delimiter">"</span></span> <span class="tag">/></span> -<span class="tag"></ds:disableClientWindow></span> -<span class="tag"><h:link</span> <span class="attribute-name">value</span>=<span class="string"><span class="delimiter">"</span><span class="content">Link with windowId</span><span class="delimiter">"</span></span> <span class="attribute-name">outcome</span>=<span class="string"><span class="delimiter">"</span><span class="content">target.xhtml</span><span class="delimiter">"</span></span><span class="tag">/></span></code></pre> +<pre class="highlight"><code class="language-xml" data-lang="xml"><ds:disableClientWindow> + <h:link value="Link without windowId" outcome="target.xhtml" /> +</ds:disableClientWindow> +<h:link value="Link with windowId" outcome="target.xhtml"/></code></pre> </div> </div> </div> @@ -739,14 +993,14 @@ of the windowId to all links of all chil </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Specializes</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">MyClientWindowConfig</span> <span class="directive">extends</span> DefaultClientWindowConfig +<pre class="highlight"><code class="language-java" data-lang="java">@Specializes +public class MyClientWindowConfig extends DefaultClientWindowConfig { - <span class="annotation">@Override</span> - <span class="directive">public</span> <span class="type">int</span> getMaxWindowContextCount() + @Override + public int getMaxWindowContextCount() { - <span class="comment">// return the max active windows per session</span> + // return the max active windows per session } }</code></pre> </div> @@ -761,13 +1015,13 @@ of the windowId to all links of all chil </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Specializes</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">MyJsfModuleConfig</span> <span class="directive">extends</span> JsfModuleConfig +<pre class="highlight"><code class="language-java" data-lang="java">@Specializes +public class MyJsfModuleConfig extends JsfModuleConfig { - <span class="annotation">@Override</span> - <span class="directive">public</span> ClientWindowConfig.ClientWindowRenderMode getDefaultWindowMode() + @Override + public ClientWindowConfig.ClientWindowRenderMode getDefaultWindowMode() { - <span class="comment">//...</span> + //... } }</code></pre> </div> @@ -782,10 +1036,10 @@ implementation, you can just do it, for </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@ApplicationScoped</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">MyClientWindow</span> <span class="directive">implements</span> ClientWindow +<pre class="highlight"><code class="language-java" data-lang="java">@ApplicationScoped +public class MyClientWindow implements ClientWindow { - <span class="comment">//...</span> + //... }</code></pre> </div> </div> @@ -795,13 +1049,13 @@ implementation, you can just do it, for </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Specializes</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">MyJsfModuleConfig</span> <span class="directive">extends</span> JsfModuleConfig +<pre class="highlight"><code class="language-java" data-lang="java">@Specializes +public class MyJsfModuleConfig extends JsfModuleConfig { - <span class="annotation">@Override</span> - <span class="directive">public</span> ClientWindowConfig.ClientWindowRenderMode getDefaultWindowMode() + @Override + public ClientWindowConfig.ClientWindowRenderMode getDefaultWindowMode() { - <span class="keyword">return</span> ClientWindowConfig.ClientWindowRenderMode.CUSTOM; + return ClientWindowConfig.ClientWindowRenderMode.CUSTOM; } }</code></pre> </div> @@ -840,10 +1094,10 @@ between windows.</p> </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@WindowScoped</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">PreferencesBean</span> <span class="directive">implements</span> <span class="predefined-type">Serializable</span> +<pre class="highlight"><code class="language-java" data-lang="java">@WindowScoped +public class PreferencesBean implements Serializable { - <span class="comment">//...</span> + //... }</code></pre> </div> </div> @@ -865,10 +1119,10 @@ also the reason for the name @<em>View</ </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@ViewAccessScoped</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">WizardBean</span> <span class="directive">implements</span> <span class="predefined-type">Serializable</span> +<pre class="highlight"><code class="language-java" data-lang="java">@ViewAccessScoped +public class WizardBean implements Serializable { - <span class="comment">//...</span> + //... }</code></pre> </div> </div> @@ -960,22 +1214,22 @@ and fallback to the configured default l <div class="listingblock"> <div class="title">Example</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@MessageBundle</span> -<span class="directive">public</span> <span class="type">interface</span> <span class="class">SimpleMessage</span> +<pre class="highlight"><code class="language-java" data-lang="java">@MessageBundle +public interface SimpleMessage { - <span class="annotation">@MessageTemplate</span>(<span class="string"><span class="delimiter">"</span><span class="content">{welcome_to_deltaspike}</span><span class="delimiter">"</span></span>) - <span class="predefined-type">String</span> welcomeToDeltaSpike(); + @MessageTemplate("{welcome_to_deltaspike}") + String welcomeToDeltaSpike(); } -<span class="annotation">@Model</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">PageBean</span> +@Model +public class PageBean { - <span class="annotation">@Inject</span> - <span class="directive">private</span> SimpleMessage messages; + @Inject + private SimpleMessage messages; - <span class="directive">public</span> <span class="type">void</span> actionMethod(){ - FacesContext.getCurrentInstance().addMessage(<span class="predefined-constant">null</span>,<span class="keyword">new</span> FacesMessage(messages.welcomeToDeltaSpike())); + public void actionMethod(){ + FacesContext.getCurrentInstance().addMessage(null,new FacesMessage(messages.welcomeToDeltaSpike())); } } @@ -992,20 +1246,20 @@ org/apache/deltaspike/example/message/Si ... -<span class="comment">//content (as usual in message bundle files):</span> +//content (as usual in message bundle files): welcome_to_deltaspike=Welcome to DeltaSpike -<span class="comment">//Overrided JSF messages</span> -javax.faces.component.UIInput.REQUIRED = {<span class="integer">0</span>}: Please enter a value</code></pre> +//Overrided JSF messages +javax.faces.component.UIInput.REQUIRED = {0}: Please enter a value</code></pre> </div> </div> <div class="listingblock"> <div class="title">Faces-config.xml File</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="xml"><span class="tag"><faces-config></span> - <span class="tag"><application></span> - <span class="tag"><message-bundle></span>org.apache.deltaspike.example.message.SimpleMessage<span class="tag"></message-bundle></span> - <span class="tag"></application></span> -<span class="tag"></faces-config></span></code></pre> +<pre class="highlight"><code class="language-xml" data-lang="xml"><faces-config> + <application> + <message-bundle>org.apache.deltaspike.example.message.SimpleMessage</message-bundle> + </application> +</faces-config></code></pre> </div> </div> </div> @@ -1139,7 +1393,7 @@ for a view (/page).</p> </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">class</span> <span class="class">MyPage</span> <span class="directive">implements</span> ViewConfig +<pre class="highlight"><code class="language-java" data-lang="java">public class MyPage implements ViewConfig { }</code></pre> </div> @@ -1152,9 +1406,9 @@ navigation, for example, via action-meth </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="predefined-type">Class</span><? <span class="directive">extends</span> ViewConfig> toNextPage() +<pre class="highlight"><code class="language-java" data-lang="java">public Class<? extends ViewConfig> toNextPage() { - <span class="keyword">return</span> MyPage.class; + return MyPage.class; }</code></pre> </div> </div> @@ -1168,8 +1422,8 @@ leads to the same as the first one.</p> </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@View</span> <span class="comment">//optional</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">MyPage</span> <span class="directive">implements</span> ViewConfig +<pre class="highlight"><code class="language-java" data-lang="java">@View //optional +public class MyPage implements ViewConfig { }</code></pre> </div> @@ -1180,13 +1434,13 @@ interfaces and classes. An example for i </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">interface</span> <span class="class">Pages</span> +<pre class="highlight"><code class="language-java" data-lang="java">public interface Pages { - <span class="type">class</span> <span class="class">Index</span> <span class="directive">implements</span> ViewConfig { } + class Index implements ViewConfig { } - <span class="type">interface</span> <span class="class">AdminArea</span> <span class="directive">extends</span> ViewConfig + interface AdminArea extends ViewConfig { - <span class="type">class</span> <span class="class">Index</span> <span class="directive">implements</span> Admin { } + class Index implements Admin { } } }</code></pre> </div> @@ -1215,26 +1469,26 @@ meta-data gets merged and at runtime you </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">interface</span> <span class="class">Pages</span> +<pre class="highlight"><code class="language-java" data-lang="java">public interface Pages { - <span class="annotation">@View</span>(name = <span class="string"><span class="delimiter">"</span><span class="content">home</span><span class="delimiter">"</span></span>, extension = JSP) - <span class="type">class</span> <span class="class">Index</span> <span class="directive">implements</span> ViewConfig { } + @View(name = "home", extension = JSP) + class Index implements ViewConfig { } - <span class="annotation">@View</span>(navigation = REDIRECT, viewParams = INCLUDE) - <span class="type">interface</span> <span class="class">Admin</span> <span class="directive">extends</span> ViewConfig + @View(navigation = REDIRECT, viewParams = INCLUDE) + interface Admin extends ViewConfig { - <span class="type">interface</span> <span class="class">Statistics</span> + interface Statistics { - <span class="annotation">@View</span> <span class="comment">//optional</span> - <span class="type">class</span> <span class="class">Index</span> <span class="directive">implements</span> ViewConfig { } + @View //optional + class Index implements ViewConfig { } - <span class="type">class</span> <span class="class">Home</span> <span class="directive">implements</span> Admin { } + class Home implements Admin { } } - <span class="type">class</span> <span class="class">Index</span> <span class="directive">implements</span> Admin { } + class Index implements Admin { } - <span class="annotation">@View</span>(navigation = FORWARD) - <span class="type">class</span> <span class="class">Home</span> <span class="directive">implements</span> Admin { } + @View(navigation = FORWARD) + class Home implements Admin { } } }</code></pre> </div> @@ -1253,9 +1507,9 @@ navigation target of this method is with </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="predefined-type">Class</span><? <span class="directive">extends</span> Pages.Admin> toNextPage() +<pre class="highlight"><code class="language-java" data-lang="java">public Class<? extends Pages.Admin> toNextPage() { - <span class="keyword">return</span> Pages.Admin.Index.class; + return Pages.Admin.Index.class; }</code></pre> </div> </div> @@ -1282,24 +1536,24 @@ Pages.Wizard1.Step1).</p> </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">interface</span> <span class="class">Pages</span> +<pre class="highlight"><code class="language-java" data-lang="java">public interface Pages { - <span class="type">interface</span> <span class="class">Wizard1</span> + interface Wizard1 { - <span class="type">class</span> <span class="class">Step1</span> <span class="directive">implements</span> ViewConfig { } + class Step1 implements ViewConfig { } } } -<span class="comment">//leads to the same as</span> +//leads to the same as -<span class="annotation">@Folder</span> -<span class="directive">public</span> <span class="type">interface</span> <span class="class">Pages</span> +@Folder +public interface Pages { - <span class="annotation">@Folder</span> - <span class="type">interface</span> <span class="class">Wizard1</span> + @Folder + interface Wizard1 { - <span class="annotation">@View</span> - <span class="type">class</span> <span class="class">Step1</span> <span class="directive">implements</span> ViewConfig { } + @View + class Step1 implements ViewConfig { } } }</code></pre> </div> @@ -1346,18 +1600,18 @@ two additional features:</p> </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="type">interface</span> <span class="class">Pages</span> +<pre class="highlight"><code class="language-java" data-lang="java">interface Pages { - <span class="annotation">@Folder</span>(name = <span class="string"><span class="delimiter">"</span><span class="content">/w1/</span><span class="delimiter">"</span></span>) - <span class="type">interface</span> <span class="class">Wizard1</span> + @Folder(name = "/w1/") + interface Wizard1 { - <span class="type">class</span> <span class="class">Step1</span> <span class="directive">implements</span> ViewConfig { } + class Step1 implements ViewConfig { } } - <span class="annotation">@Folder</span>(name = <span class="string"><span class="delimiter">"</span><span class="content">./w2/</span><span class="delimiter">"</span></span>) - <span class="type">interface</span> <span class="class">Wizard2</span> <span class="directive">extends</span> ViewConfig + @Folder(name = "./w2/") + interface Wizard2 extends ViewConfig { - <span class="type">class</span> <span class="class">Step1</span> <span class="directive">implements</span> Wizard2 { } <span class="comment">//ViewConfig is inherited indirectly</span> + class Step1 implements Wizard2 { } //ViewConfig is inherited indirectly } }</code></pre> </div> @@ -1392,24 +1646,24 @@ and not interfaces). On interfaces alway </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="type">interface</span> <span class="class">Pages</span> +<pre class="highlight"><code class="language-java" data-lang="java">interface Pages { - <span class="type">interface</span> <span class="class">Wizard1</span> + interface Wizard1 { - <span class="annotation">@View</span> <span class="comment">//optional</span> - <span class="type">class</span> <span class="class">Step1</span> <span class="directive">implements</span> ViewConfig { } + @View //optional + class Step1 implements ViewConfig { } - <span class="annotation">@View</span>(basePath = <span class="string"><span class="delimiter">"</span><span class="content">/</span><span class="delimiter">"</span></span>) - <span class="type">class</span> <span class="class">Step2</span> <span class="directive">implements</span> ViewConfig { } + @View(basePath = "/") + class Step2 implements ViewConfig { } - <span class="annotation">@View</span>(basePath = <span class="string"><span class="delimiter">"</span><span class="content">./</span><span class="delimiter">"</span></span>) <span class="comment">//or just "."</span> - <span class="type">class</span> <span class="class">Step3</span> <span class="directive">implements</span> ViewConfig { } + @View(basePath = "./") //or just "." + class Step3 implements ViewConfig { } - <span class="annotation">@View</span>(basePath = <span class="string"><span class="delimiter">"</span><span class="content">/w1/</span><span class="delimiter">"</span></span>) - <span class="type">class</span> <span class="class">Step4</span> <span class="directive">implements</span> ViewConfig { } + @View(basePath = "/w1/") + class Step4 implements ViewConfig { } - <span class="annotation">@View</span>(basePath = <span class="string"><span class="delimiter">"</span><span class="content">./w1/</span><span class="delimiter">"</span></span>) - <span class="type">class</span> <span class="class">Step5</span> <span class="directive">implements</span> ViewConfig { } + @View(basePath = "./w1/") + class Step5 implements ViewConfig { } } }</code></pre> </div> @@ -1448,25 +1702,25 @@ and not interfaces). On interfaces alway </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@View</span>(navigation = REDIRECT) -<span class="type">interface</span> <span class="class">Pages</span> <span class="directive">extends</span> ViewConfig +<pre class="highlight"><code class="language-java" data-lang="java">@View(navigation = REDIRECT) +interface Pages extends ViewConfig { - <span class="type">interface</span> <span class="class">Wizard1</span> <span class="directive">extends</span> Pages + interface Wizard1 extends Pages { - <span class="annotation">@View</span> - <span class="type">class</span> <span class="class">Step1</span> <span class="directive">implements</span> Wizard1 { } + @View + class Step1 implements Wizard1 { } - <span class="annotation">@View</span>(basePath = <span class="string"><span class="delimiter">"</span><span class="content">/</span><span class="delimiter">"</span></span>) - <span class="type">class</span> <span class="class">Step2</span> <span class="directive">implements</span> Wizard1 { } + @View(basePath = "/") + class Step2 implements Wizard1 { } - <span class="annotation">@View</span>(basePath = <span class="string"><span class="delimiter">"</span><span class="content">./</span><span class="delimiter">"</span></span>) - <span class="type">class</span> <span class="class">Step3</span> <span class="directive">implements</span> Wizard1 { } + @View(basePath = "./") + class Step3 implements Wizard1 { } - <span class="annotation">@View</span>(basePath = <span class="string"><span class="delimiter">"</span><span class="content">/w1/</span><span class="delimiter">"</span></span>) - <span class="type">class</span> <span class="class">Step4</span> <span class="directive">implements</span> Wizard1 { } + @View(basePath = "/w1/") + class Step4 implements Wizard1 { } - <span class="annotation">@View</span>(basePath = <span class="string"><span class="delimiter">"</span><span class="content">./w1/</span><span class="delimiter">"</span></span>) - <span class="type">class</span> <span class="class">Step5</span> <span class="directive">implements</span> Wizard1 { } + @View(basePath = "./w1/") + class Step5 implements Wizard1 { } } }</code></pre> </div> @@ -1500,16 +1754,16 @@ values are static strings or EL-expressi </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">interface</span> <span class="class">Pages</span> <span class="directive">extends</span> ViewConfig +<pre class="highlight"><code class="language-java" data-lang="java">public interface Pages extends ViewConfig { - <span class="annotation">@NavigationParameter</span>(key = <span class="string"><span class="delimiter">"</span><span class="content">param1</span><span class="delimiter">"</span></span>, value = <span class="string"><span class="delimiter">"</span><span class="content">staticValue1</span><span class="delimiter">"</span></span>) - <span class="type">class</span> <span class="class">Index</span> <span class="directive">implements</span> Pages { } + @NavigationParameter(key = "param1", value = "staticValue1") + class Index implements Pages { } - <span class="annotation">@NavigationParameter</span>.List({ - <span class="annotation">@NavigationParameter</span>(key = <span class="string"><span class="delimiter">"</span><span class="content">param1</span><span class="delimiter">"</span></span>, value = <span class="string"><span class="delimiter">"</span><span class="content">staticValue1</span><span class="delimiter">"</span></span>), - <span class="annotation">@NavigationParameter</span>(key = <span class="string"><span class="delimiter">"</span><span class="content">param2</span><span class="delimiter">"</span></span>, value = <span class="string"><span class="delimiter">"</span><span class="content">#{myBean.property1}</span><span class="delimiter">"</span></span>) + @NavigationParameter.List({ + @NavigationParameter(key = "param1", value = "staticValue1"), + @NavigationParameter(key = "param2", value = "#{myBean.property1}") }) - <span class="type">class</span> <span class="class">Overview</span> <span class="directive">implements</span> Pages { } + class Overview implements Pages { } }</code></pre> </div> </div> @@ -1519,22 +1773,22 @@ them statically for particular methods:< </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Model</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">PageBean</span> +<pre class="highlight"><code class="language-java" data-lang="java">@Model +public class PageBean { - <span class="annotation">@NavigationParameter</span>(key = <span class="string"><span class="delimiter">"</span><span class="content">param2</span><span class="delimiter">"</span></span>, value = <span class="string"><span class="delimiter">"</span><span class="content">#{myBean.property1}</span><span class="delimiter">"</span></span>) - <span class="directive">public</span> <span class="predefined-type">Class</span><? <span class="directive">extends</span> ViewConfig> actionMethod1() + @NavigationParameter(key = "param2", value = "#{myBean.property1}") + public Class<? extends ViewConfig> actionMethod1() { - <span class="keyword">return</span> SimplePageConfig.class; + return SimplePageConfig.class; } - <span class="annotation">@NavigationParameter</span>.List({ - <span class="annotation">@NavigationParameter</span>(key = <span class="string"><span class="delimiter">"</span><span class="content">param1</span><span class="delimiter">"</span></span>, value = <span class="string"><span class="delimiter">"</span><span class="content">staticValue1</span><span class="delimiter">"</span></span>), - <span class="annotation">@NavigationParameter</span>(key = <span class="string"><span class="delimiter">"</span><span class="content">param2</span><span class="delimiter">"</span></span>, value = <span class="string"><span class="delimiter">"</span><span class="content">staticValue2</span><span class="delimiter">"</span></span>) + @NavigationParameter.List({ + @NavigationParameter(key = "param1", value = "staticValue1"), + @NavigationParameter(key = "param2", value = "staticValue2") }) - <span class="directive">public</span> <span class="predefined-type">Class</span><? <span class="directive">extends</span> ViewConfig> actionMethod2() + public Class<? extends ViewConfig> actionMethod2() { - <span class="keyword">return</span> SimplePageConfig.class; + return SimplePageConfig.class; } }</code></pre> </div> @@ -1548,24 +1802,24 @@ conditions).</p> </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Named</span> -<span class="annotation">@SessionScoped</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">PageBean</span> +<pre class="highlight"><code class="language-java" data-lang="java">@Named +@SessionScoped +public class PageBean { - <span class="directive">private</span> <span class="type">int</span> currentValue = -<span class="integer">10</span>; + private int currentValue = -10; - <span class="annotation">@Inject</span> - <span class="directive">private</span> NavigationParameterContext navigationParameterContext; + @Inject + private NavigationParameterContext navigationParameterContext; - <span class="directive">public</span> <span class="predefined-type">Class</span><? <span class="directive">extends</span> ViewConfig> actionMethod() + public Class<? extends ViewConfig> actionMethod() { currentValue++; - <span class="keyword">if</span> (currentValue >= <span class="integer">0</span>) + if (currentValue >= 0) { - <span class="local-variable">this</span>.navigationParameterContext.addPageParameter(<span class="string"><span class="delimiter">"</span><span class="content">cv</span><span class="delimiter">"</span></span>, <span class="local-variable">this</span>.currentValue); + this.navigationParameterContext.addPageParameter("cv", this.currentValue); } - <span class="keyword">return</span> SimplePageConfig.class; + return SimplePageConfig.class; } }</code></pre> </div> @@ -1594,20 +1848,20 @@ plug-in would be needed.)</p> </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Secured</span>(CustomAccessDecisionVoter.class) -<span class="directive">public</span> <span class="type">interface</span> <span class="class">SecuredPages</span> {} +<pre class="highlight"><code class="language-java" data-lang="java">@Secured(CustomAccessDecisionVoter.class) +public interface SecuredPages {} -<span class="annotation">@View</span>(navigation = REDIRECT) -<span class="directive">public</span> <span class="type">interface</span> <span class="class">Pages</span> <span class="directive">extends</span> ViewConfig +@View(navigation = REDIRECT) +public interface Pages extends ViewConfig { - <span class="type">class</span> <span class="class">Index</span> <span class="directive">implements</span> Pages { } + class Index implements Pages { } - <span class="type">interface</span> <span class="class">Admin</span> <span class="directive">extends</span> Pages, SecuredPages + interface Admin extends Pages, SecuredPages { - <span class="type">class</span> <span class="class">Index</span> <span class="directive">implements</span> Admin { } + class Index implements Admin { } - <span class="annotation">@View</span>(navigation = FORWARD) - <span class="type">class</span> <span class="class">Home</span> <span class="directive">implements</span> Admin { } + @View(navigation = FORWARD) + class Home implements Admin { } } }</code></pre> </div> @@ -1618,18 +1872,18 @@ this case you would need:</p> </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@View</span>(navigation = REDIRECT) -<span class="directive">public</span> <span class="type">interface</span> <span class="class">Pages</span> <span class="directive">extends</span> ViewConfig +<pre class="highlight"><code class="language-java" data-lang="java">@View(navigation = REDIRECT) +public interface Pages extends ViewConfig { - <span class="type">class</span> <span class="class">Index</span> <span class="directive">implements</span> Pages { } + class Index implements Pages { } - <span class="annotation">@Secured</span>(CustomAccessDecisionVoter.class) - <span class="type">interface</span> <span class="class">Admin</span> <span class="directive">extends</span> Pages + @Secured(CustomAccessDecisionVoter.class) + interface Admin extends Pages { - <span class="type">class</span> <span class="class">Index</span> <span class="directive">implements</span> Admin { } + class Index implements Admin { } - <span class="annotation">@View</span>(navigation = FORWARD) - <span class="type">class</span> <span class="class">Home</span> <span class="directive">implements</span> Admin { } + @View(navigation = FORWARD) + class Home implements Admin { } } }</code></pre> </div> @@ -1639,19 +1893,19 @@ this case you would need:</p> </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@View</span>(navigation = REDIRECT) -<span class="directive">public</span> <span class="type">interface</span> <span class="class">Pages</span> <span class="directive">extends</span> ViewConfig +<pre class="highlight"><code class="language-java" data-lang="java">@View(navigation = REDIRECT) +public interface Pages extends ViewConfig { - <span class="type">class</span> <span class="class">Index</span> <span class="directive">implements</span> Pages { } + class Index implements Pages { } - <span class="type">interface</span> <span class="class">Admin</span> <span class="directive">extends</span> Pages + interface Admin extends Pages { - <span class="annotation">@Secured</span>(CustomAccessDecisionVoter.class) - <span class="type">class</span> <span class="class">Index</span> <span class="directive">implements</span> Admin { } + @Secured(CustomAccessDecisionVoter.class) + class Index implements Admin { } - <span class="annotation">@Secured</span>(CustomAccessDecisionVoter.class) - <span class="annotation">@View</span>(navigation = FORWARD) - <span class="type">class</span> <span class="class">Home</span> <span class="directive">implements</span> Admin { } + @Secured(CustomAccessDecisionVoter.class) + @View(navigation = FORWARD) + class Home implements Admin { } } }</code></pre> </div> @@ -1668,19 +1922,19 @@ example shows the usage of <code>@PreRen </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="comment">//@View //optional</span> -<span class="annotation">@ViewControllerRef</span>(MyPageController.class) -<span class="directive">public</span> <span class="type">class</span> <span class="class">MyPage</span> <span class="directive">implements</span> ViewConfig +<pre class="highlight"><code class="language-java" data-lang="java">//@View //optional +@ViewControllerRef(MyPageController.class) +public class MyPage implements ViewConfig { } -<span class="annotation">@Model</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">MyPageController</span> +@Model +public class MyPageController { - <span class="annotation">@PreRenderView</span> - <span class="directive">protected</span> <span class="type">void</span> load() + @PreRenderView + protected void load() { - <span class="comment">//...</span> + //... } }</code></pre> </div> @@ -1693,19 +1947,19 @@ display the exception.</p> <div class="listingblock"> <div class="title">Example</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@ExceptionHandler</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">ErrorViewAwareExceptionHandler</span> { - <span class="annotation">@Inject</span> - <span class="directive">private</span> ViewConfigResolver viewConfigResolver; +<pre class="highlight"><code class="language-java" data-lang="java">@ExceptionHandler +public class ErrorViewAwareExceptionHandler { + @Inject + private ViewConfigResolver viewConfigResolver; - <span class="directive">public</span> <span class="type">void</span> onIllegalStateException(<span class="annotation">@Handles</span> ExceptionEvent<<span class="exception">IllegalStateException</span>> e) + public void onIllegalStateException(@Handles ExceptionEvent<IllegalStateException> e) { FacesContext facesContext = FacesContext.getCurrentInstance(); - <span class="predefined-type">String</span> viewId = viewConfigResolver.getDefaultErrorViewConfigDescriptor().getViewId(); + String viewId = viewConfigResolver.getDefaultErrorViewConfigDescriptor().getViewId(); UIViewRoot viewRoot = facesContext.getApplication().getViewHandler().createView(facesContext, viewId); facesContext.setViewRoot(viewRoot); - <span class="comment">//... - e.g.: store the exception in a page-bean for the default-error-view</span> + //... - e.g.: store the exception in a page-bean for the default-error-view } }</code></pre> </div> @@ -1722,22 +1976,22 @@ many view/s.</p> <div class="listingblock"> <div class="title">Example</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">interface</span> <span class="class">Pages</span> <span class="directive">extends</span> ViewConfig +<pre class="highlight"><code class="language-java" data-lang="java">public interface Pages extends ViewConfig { - <span class="type">class</span> <span class="class">Index</span> <span class="directive">implements</span> Pages { } + class Index implements Pages { } } -<span class="annotation">@ViewRef</span>(Pages.Index.class) -<span class="comment">//...</span>
[... 1082 lines stripped ...]
