Modified: sites/deltaspike/documentation/core.html ============================================================================== --- sites/deltaspike/documentation/core.html (original) +++ sites/deltaspike/documentation/core.html Mon Jul 14 07:41:38 2025 @@ -1,261 +1,519 @@ <!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>Core 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>Core 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>Core Module</h1> - </div> - - <div id="doc-content"> - <div id="preamble"> +<body class="article"> +<div id="header"> +<h1>Core Module</h1> +<div id="toc" class="toc"> +<div id="toctitle">Table of Contents</div> +<ul class="sectlevel1"> +<li><a href="#_project_setup">Project Setup</a></li> +<li><a href="#_deltaspike_configuration">DeltaSpike Configuration</a></li> +<li><a href="#_deltaspike_cipherservice">DeltaSpike CipherService</a> +<ul class="sectlevel2"> +<li><a href="#_internal_configuration">Internal configuration</a></li> +</ul> +</li> +<li><a href="#_beanprovider">BeanProvider</a> +<ul class="sectlevel2"> +<li><a href="#_dependentprovider">DependentProvider</a></li> +</ul> +</li> +<li><a href="#_beanmanagerprovider">BeanManagerProvider</a></li> +<li><a href="#_annotationinstanceprovider">AnnotationInstanceProvider</a></li> +<li><a href="#_type_safe_projectstage">Type-safe ProjectStage</a></li> +<li><a href="#_exclude">@Exclude</a> +<ul class="sectlevel2"> +<li><a href="#_custom_expressioninterpreter">Custom ExpressionInterpreter</a></li> +</ul> +</li> +<li><a href="#_type_safe_view_config">Type-safe View-Config</a></li> +<li><a href="#_literals">Literals</a></li> +<li><a href="#_messages_and_i18n">Messages and i18n</a> +<ul class="sectlevel2"> +<li><a href="#_dynamic_message_builder">Dynamic Message Builder</a></li> +</ul> +</li> +<li><a href="#_injecting_resources">Injecting Resources</a> +<ul class="sectlevel2"> +<li><a href="#_custom_resource_providers">Custom resource providers</a></li> +</ul> +</li> +<li><a href="#_exception_control">Exception Control</a> +<ul class="sectlevel2"> +<li><a href="#_usage">Usage</a></li> +<li><a href="#_exception_handlers">Exception Handlers</a></li> +<li><a href="#_exception_chain_processing">Exception Chain Processing</a></li> +<li><a href="#_apis_for_exception_information_and_flow_control">APIs for Exception Information and Flow Control</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="#_creating_a_custom_cdi_scope">Creating a Custom CDI Scope</a></li> +</ul> +</li> +<li><a href="#_deactivatable">Deactivatable</a> +<ul class="sectlevel2"> +<li><a href="#_deactivate_deactivatable_classes_via_config">Deactivate Deactivatable-Classes via Config</a></li> +</ul> +</li> +<li><a href="#_asynchronous_operations">Asynchronous Operations</a></li> +<li><a href="#_futureable_configuration">@Futureable configuration</a></li> +<li><a href="#_utilities">Utilities</a> +<ul class="sectlevel2"> +<li><a href="#_annotationutils">AnnotationUtils</a></li> +<li><a href="#_arraysutils">ArraysUtils</a></li> +<li><a href="#_beanutils">BeanUtils</a></li> +<li><a href="#_contextutils">ContextUtils</a></li> +<li><a href="#_classdeactivationutils">ClassDeactivationUtils</a></li> +<li><a href="#_exceptionutils">ExceptionUtils</a></li> +<li><a href="#_propertyfileutils">PropertyFileUtils</a></li> +<li><a href="#_proxyutils">ProxyUtils</a></li> +<li><a href="#_stringutils">StringUtils</a></li> +</ul> +</li> +</ul> +</div> +</div> +<div id="content"> +<div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>The Core module provides fundamental and defining DeltaSpike API and utility classes. As such, this module must be included in every project that uses DeltaSpike. @@ -361,7 +619,7 @@ has been found, an <code>IllegalStateExc <div class="listingblock"> <div class="title">Resolving a Simple Contextual Instance</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java">MyBean myBean = BeanProvider.getContextualReference(MyBean.class, <span class="predefined-constant">false</span>);</code></pre> +<pre class="highlight"><code class="language-java" data-lang="java">MyBean myBean = BeanProvider.getContextualReference(MyBean.class, false);</code></pre> </div> </div> <div class="paragraph"> @@ -373,7 +631,7 @@ qualifier example for further details).< <div class="listingblock"> <div class="title">Resolving an Optional Contextual Instance</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java">MyServiceInterface optionalService = BeanProvider.getContextualReference(MyServiceInterface.class, <span class="predefined-constant">true</span>);</code></pre> +<pre class="highlight"><code class="language-java" data-lang="java">MyServiceInterface optionalService = BeanProvider.getContextualReference(MyServiceInterface.class, true);</code></pre> </div> </div> <div class="paragraph"> @@ -384,10 +642,10 @@ implement a corresponding literal for pr <div class="listingblock"> <div class="title">Literal Implementation for '@MyQualifier'</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="keyword">import</span> <span class="include">jakarta.enterprise.util.AnnotationLiteral</span>; -<span class="comment">//...</span> +<pre class="highlight"><code class="language-java" data-lang="java">import jakarta.enterprise.util.AnnotationLiteral; +//... -<span class="directive">public</span> <span class="type">class</span> <span class="class">MyQualifierLiteral</span> <span class="directive">extends</span> AnnotationLiteral<MyQualifier> <span class="directive">implements</span> MyQualifier +public class MyQualifierLiteral extends AnnotationLiteral<MyQualifier> implements MyQualifier { }</code></pre> </div> @@ -399,7 +657,7 @@ qualifier <code>@MyQualifier</code>.</p> <div class="listingblock"> <div class="title">Resolving a Simple Contextual Instance with Qualifier</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java">MyBean myBean = BeanProvider.getContextualReference(MyBean.class, <span class="predefined-constant">false</span>, <span class="keyword">new</span> MyQualifierLiteral());</code></pre> +<pre class="highlight"><code class="language-java" data-lang="java">MyBean myBean = BeanProvider.getContextualReference(MyBean.class, false, new MyQualifierLiteral());</code></pre> </div> </div> <div class="paragraph"> @@ -410,13 +668,13 @@ the following examples show how to do a <div class="listingblock"> <div class="title">Resolving a Simple Contextual Instance by Name</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="predefined-type">Object</span> myBean = BeanProvider.getContextualReference(<span class="string"><span class="delimiter">"</span><span class="content">myBean</span><span class="delimiter">"</span></span>, <span class="predefined-constant">false</span>);</code></pre> +<pre class="highlight"><code class="language-java" data-lang="java">Object myBean = BeanProvider.getContextualReference("myBean", false);</code></pre> </div> </div> <div class="listingblock"> <div class="title">Resolving a Simple Contextual Instance by Name and Expected Type</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java">MyBean myBean = BeanProvider.getContextualReference(<span class="string"><span class="delimiter">"</span><span class="content">myBean</span><span class="delimiter">"</span></span>, <span class="predefined-constant">false</span>, MyBean.class);</code></pre> +<pre class="highlight"><code class="language-java" data-lang="java">MyBean myBean = BeanProvider.getContextualReference("myBean", false, MyBean.class);</code></pre> </div> </div> <div class="paragraph"> @@ -429,7 +687,7 @@ dependent scoped instances).</p> <div class="listingblock"> <div class="title">Resolving All Contextual Instances of a Given Type</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="predefined-type">List</span><MyServiceInterface> myServiceList = BeanProvider.getContextualReferences(MyServiceInterface.class, <span class="predefined-constant">false</span>);</code></pre> +<pre class="highlight"><code class="language-java" data-lang="java">List<MyServiceInterface> myServiceList = BeanProvider.getContextualReferences(MyServiceInterface.class, false);</code></pre> </div> </div> <div class="paragraph"> @@ -441,7 +699,7 @@ filter dependent scoped instances.</p> <div class="listingblock"> <div class="title">Resolving All Contextual Instances of a Given Type without Dependent-scoped Instances</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="predefined-type">List</span><MyServiceInterface> myServiceList = BeanProvider.getContextualReferences(MyServiceInterface.class, <span class="predefined-constant">false</span>, <span class="predefined-constant">false</span>);</code></pre> +<pre class="highlight"><code class="language-java" data-lang="java">List<MyServiceInterface> myServiceList = BeanProvider.getContextualReferences(MyServiceInterface.class, false, false);</code></pre> </div> </div> <div class="paragraph"> @@ -453,7 +711,7 @@ fields.</p> <div class="listingblock"> <div class="title">Manually Inject Fields</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java">BeanProvider.injectFields(myObject);</code></pre> +<pre class="highlight"><code class="language-java" data-lang="java">BeanProvider.injectFields(myObject);</code></pre> </div> </div> <div class="sect2"> @@ -474,10 +732,10 @@ the contextual instance which declares t <div class="listingblock"> <div class="title">Obtaining and destroying an instance of a dependent-scoped bean using DependentProvider</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java">DependentProvider<MyBean> myBeanProvider = BeanProvider.getDependent(MyBean.class); +<pre class="highlight"><code class="language-java" data-lang="java">DependentProvider<MyBean> myBeanProvider = BeanProvider.getDependent(MyBean.class); MyBean myBean = myBeanProvider.get(); -<span class="comment">// ...work with myBean...</span> +// ...work with myBean... myBeanProvider.destroy();</code></pre> </div> @@ -498,14 +756,14 @@ it is easier to use the <code>BeanProvid <div class="listingblock"> <div class="title">Resolving the BeanManager</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="comment">//in most cases the following works without problems:</span> -<span class="annotation">@Inject</span> -<span class="directive">private</span> BeanManager beanManager; +<pre class="highlight"><code class="language-java" data-lang="java">//in most cases the following works without problems: +@Inject +private BeanManager beanManager; -<span class="comment">//use</span> +//use BeanManager beanManager = BeanManagerProvider.getInstance().getBeanManager(); -<span class="comment">//if CDI based injection is not available.</span></code></pre> +//if CDI based injection is not available.</code></pre> </div> </div> <div class="paragraph"> @@ -528,12 +786,12 @@ the lookup strategy you used before, you </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">CurrentUserLiteral</span> <span class="directive">extends</span> AnnotationLiteral<CurrentUser> <span class="directive">implements</span> CurrentUser {}</code></pre> +<pre class="highlight"><code class="language-java" data-lang="java">public class CurrentUserLiteral extends AnnotationLiteral<CurrentUser> implements CurrentUser {}</code></pre> </div> </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java">CurrentUser user = <span class="keyword">new</span> CurrentUserLiteral() {};</code></pre> +<pre class="highlight"><code class="language-java" data-lang="java">CurrentUser user = new CurrentUserLiteral() {};</code></pre> </div> </div> <div class="paragraph"> @@ -548,7 +806,7 @@ especially for CDI extension authors. Fo <p>avoiding a compile-time dependency on an annotation class</p> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="predefined-type">Class</span><? <span class="directive">extends</span> <span class="predefined-type">Annotation</span>> priorityAnnotationClass = ClassUtils.tryToLoadClassForName(<span class="string"><span class="delimiter">"</span><span class="content">javax.annotation.Priority</span><span class="delimiter">"</span></span>); +<pre class="highlight"><code class="language-java" data-lang="java">Class<? extends Annotation> priorityAnnotationClass = ClassUtils.tryToLoadClassForName("javax.annotation.Priority"); priorityAnnotationInstance = AnnotationInstanceProvider.of(priorityAnnotationClass, mapOfMemberValues);</code></pre> </div> </div> @@ -557,7 +815,7 @@ priorityAnnotationInstance = AnnotationI <p>getting an instance of a dynamically obtained annotation class</p> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="predefined-type">Annotation</span> exceptionQualifier = AnnotationInstanceProvider.of(jsfModuleConfig.getExceptionQualifier());</code></pre> +<pre class="highlight"><code class="language-java" data-lang="java">Annotation exceptionQualifier = AnnotationInstanceProvider.of(jsfModuleConfig.getExceptionQualifier());</code></pre> </div> </div> </li> @@ -565,7 +823,7 @@ priorityAnnotationInstance = AnnotationI <p>or simply for the sake of a prettier syntax compared to <code>AnnotationLiteral</code></p> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java">CurrentUser principal = AnnotationInstanceProvider.of(CurrentUser.class);</code></pre> +<pre class="highlight"><code class="language-java" data-lang="java">CurrentUser principal = AnnotationInstanceProvider.of(CurrentUser.class);</code></pre> </div> </div> </li> @@ -594,8 +852,8 @@ by CDI even if they are in a CDI enabled <div class="listingblock"> <div class="title">Excluding a Bean in any Case</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Exclude</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">NoBean</span> +<pre class="highlight"><code class="language-java" data-lang="java">@Exclude +public class NoBean { }</code></pre> </div> @@ -603,8 +861,8 @@ by CDI even if they are in a CDI enabled <div class="listingblock"> <div class="title">Excluding a Bean in Case of ProjectStageDevelopment</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Exclude</span>(ifProjectStage = ProjectStage.Development.class) -<span class="directive">public</span> <span class="type">class</span> <span class="class">MyBean</span> +<pre class="highlight"><code class="language-java" data-lang="java">@Exclude(ifProjectStage = ProjectStage.Development.class) +public class MyBean { }</code></pre> </div> @@ -612,21 +870,21 @@ by CDI even if they are in a CDI enabled <div class="listingblock"> <div class="title">Excluding a Bean if the ProjectStage is different from Development</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Exclude</span>(exceptIfProjectStage = ProjectStage.Development.class) -<span class="directive">public</span> <span class="type">class</span> <span class="class">MyDevBean</span> +<pre class="highlight"><code class="language-java" data-lang="java">@Exclude(exceptIfProjectStage = ProjectStage.Development.class) +public class MyDevBean { }</code></pre> </div> </div> <div class="paragraph"> <p>The following usage allows to exclude a bean based on a configured value -(see the <a href="configuration.adocl#_configsources_provided_by_default">supported configuration sources</a>).</p> +(see the <a href="configuration.adocl.html#_configsources_provided_by_default">supported configuration sources</a>).</p> </div> <div class="listingblock"> <div class="title">Excluding a Bean based on an Expression which Evaluates to True</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Exclude</span>(onExpression = <span class="string"><span class="delimiter">"</span><span class="content">db==prodDB</span><span class="delimiter">"</span></span>) -<span class="directive">public</span> <span class="type">class</span> <span class="class">DevDbBean</span> +<pre class="highlight"><code class="language-java" data-lang="java">@Exclude(onExpression = "db==prodDB") +public class DevDbBean { }</code></pre> </div> @@ -639,21 +897,21 @@ expressions.</p> <div class="listingblock"> <div class="title">Excluding a Bean based on a Custom Expression</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Exclude</span>(onExpression = <span class="string"><span class="delimiter">"</span><span class="content">db eq prodDB</span><span class="delimiter">"</span></span>, interpretedBy = SimpleExpressionInterpreter.class) -<span class="directive">public</span> <span class="type">class</span> <span class="class">DevDbBean</span> +<pre class="highlight"><code class="language-java" data-lang="java">@Exclude(onExpression = "db eq prodDB", interpretedBy = SimpleExpressionInterpreter.class) +public class DevDbBean { } -<span class="directive">public</span> <span class="type">class</span> <span class="class">SimpleExpressionInterpreter</span> <span class="directive">implements</span> ExpressionInterpreter<<span class="predefined-type">String</span>, <span class="predefined-type">Boolean</span>> +public class SimpleExpressionInterpreter implements ExpressionInterpreter<String, Boolean> { - <span class="annotation">@Override</span> - <span class="directive">public</span> <span class="predefined-type">Boolean</span> evaluate(<span class="predefined-type">String</span> expression) + @Override + public Boolean evaluate(String expression) { - <span class="keyword">if</span>(expression.contains(<span class="string"><span class="delimiter">"</span><span class="content"> eq </span><span class="delimiter">"</span></span>)) + if(expression.contains(" eq ")) { - <span class="comment">//...</span> + //... } - <span class="comment">//...</span> + //... } }</code></pre> </div> @@ -670,9 +928,9 @@ active if it is not excluded during the <div class="listingblock"> <div class="title">Excluding an Alternative implementation if the ProjectStage is different from Development</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Exclude</span>(exceptIfProjectStage = ProjectStage.Development.class) -<span class="annotation">@Alternative</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">MyDevBean</span> +<pre class="highlight"><code class="language-java" data-lang="java">@Exclude(exceptIfProjectStage = ProjectStage.Development.class) +@Alternative +public class MyDevBean { }</code></pre> </div> @@ -688,32 +946,32 @@ ExpressionInterpreter is needed:</p> </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Alternative</span> -<span class="annotation">@Exclude</span>(onExpression = <span class="string"><span class="delimiter">"</span><span class="content">environment!=HSQL</span><span class="delimiter">"</span></span>, interpretedBy = ConfigAwareExpressionInterpreter.class) -<span class="directive">public</span> <span class="type">class</span> <span class="class">DevDbBean</span> <span class="directive">implements</span> DbBean +<pre class="highlight"><code class="language-java" data-lang="java">@Alternative +@Exclude(onExpression = "environment!=HSQL", interpretedBy = ConfigAwareExpressionInterpreter.class) +public class DevDbBean implements DbBean { } -<span class="directive">public</span> <span class="type">class</span> <span class="class">ConfigAwareExpressionInterpreter</span> <span class="directive">implements</span> ExpressionInterpreter<<span class="predefined-type">String</span>, <span class="predefined-type">Boolean</span>> +public class ConfigAwareExpressionInterpreter implements ExpressionInterpreter<String, Boolean> { - <span class="directive">public</span> <span class="predefined-type">Boolean</span> evaluate(<span class="predefined-type">String</span> expression) + public Boolean evaluate(String expression) { - <span class="keyword">if</span> (expression == <span class="predefined-constant">null</span>) + if (expression == null) { - <span class="keyword">return</span> <span class="predefined-constant">false</span>; + return false; } - <span class="predefined-type">String</span><span class="type">[]</span> values = expression.split(<span class="string"><span class="delimiter">"</span><span class="content">!=</span><span class="delimiter">"</span></span>); + String[] values = expression.split("!="); - <span class="keyword">if</span> (values.length != <span class="integer">2</span>) + if (values.length != 2) { - <span class="keyword">throw</span> <span class="keyword">new</span> <span class="exception">IllegalArgumentException</span>(<span class="string"><span class="delimiter">"</span><span class="content">'</span><span class="delimiter">"</span></span> + expression + <span class="string"><span class="delimiter">"</span><span class="content">' is not a supported syntax</span><span class="delimiter">"</span></span>); + throw new IllegalArgumentException("'" + expression + "' is not a supported syntax"); } - <span class="predefined-type">String</span> configuredValue = ConfigResolver.getPropertyValue(values[<span class="integer">0</span>], <span class="predefined-constant">null</span>); + String configuredValue = ConfigResolver.getPropertyValue(values[0], null); - <span class="comment">//exclude if null or the configured value is different</span> - <span class="keyword">return</span> configuredValue == <span class="predefined-constant">null</span> || !values[<span class="integer">1</span>].trim().equalsIgnoreCase(configuredValue); + //exclude if null or the configured value is different + return configuredValue == null || !values[1].trim().equalsIgnoreCase(configuredValue); } }</code></pre> </div> @@ -739,11 +997,11 @@ abstract class <code>jakarta.enterprise. <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="directive">abstract</span> <span class="type">class</span> <span class="class">PayByQualifier</span> - <span class="directive">extends</span> AnnotationLiteral<PayBy> - <span class="directive">implements</span> PayBy {} +<pre class="highlight"><code class="language-java" data-lang="java">public abstract class PayByQualifier + extends AnnotationLiteral<PayBy> + implements PayBy {} - PayBy paybyCheque = <span class="keyword">new</span> PayByQualifier() { <span class="directive">public</span> PaymentMethod value() { <span class="keyword">return</span> CHEQUE; } };</code></pre> + PayBy paybyCheque = new PayByQualifier() { public PaymentMethod value() { return CHEQUE; } };</code></pre> </div> </div> <div class="paragraph"> @@ -807,11 +1065,11 @@ messages (which are hardcoded in this ca <div class="listingblock"> <div class="title">Simple Type-safe Message</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(); }</code></pre> </div> </div> @@ -824,11 +1082,11 @@ file extension).</p> <div class="listingblock"> <div class="title">Internationalized Type-safe Message</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(); } org.apache.deltaspike.example.message.SimpleMessage @@ -840,7 +1098,7 @@ org/apache/deltaspike/example/message/Si org/apache/deltaspike/example/message/SimpleMessage_de.properties ... -<span class="comment">//content (as usual in message bundle files):</span> +//content (as usual in message bundle files): welcome_to_deltaspike=Welcome to DeltaSpike</code></pre> </div> </div> @@ -851,12 +1109,12 @@ a lookup in a custom message bundle know <div class="listingblock"> <div class="title">Internationalized Type-safe Message</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@MessageBundle</span> -<span class="annotation">@MessageContextConfig</span>(messageResolver = CustomMessageResolver.class) -<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 +@MessageContextConfig(messageResolver = CustomMessageResolver.class) +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(); }</code></pre> </div> </div> @@ -871,25 +1129,25 @@ simple type-safe message.</p> <div class="listingblock"> <div class="title">Internationalized Type-safe Message with Parameter/s</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@MessageBundle</span> -<span class="annotation">@MessageContextConfig</span>(messageInterpolator = CustomMessageInterpolator.class) -<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 +@MessageContextConfig(messageInterpolator = CustomMessageInterpolator.class) +public interface SimpleMessage { - <span class="comment">//in the message bundle: welcome_to=Welcome to %s</span> + //in the message bundle: welcome_to=Welcome to %s - <span class="annotation">@MessageTemplate</span>(<span class="string"><span class="delimiter">"</span><span class="content">{welcome_to}</span><span class="delimiter">"</span></span>) - <span class="predefined-type">String</span> welcomeTo(<span class="predefined-type">String</span> name); + @MessageTemplate("{welcome_to}") + String welcomeTo(String name); } -<span class="comment">//...</span> -<span class="directive">public</span> <span class="type">class</span> <span class="class">MyBean</span> +//... +public class MyBean { - <span class="annotation">@Inject</span> - <span class="directive">private</span> SimpleMessage messages; + @Inject + private SimpleMessage messages; - <span class="directive">public</span> <span class="predefined-type">String</span> welcomeToDeltaSpike + public String welcomeToDeltaSpike { - <span class="keyword">return</span> <span class="local-variable">this</span>.messages.welcomeTo(<span class="string"><span class="delimiter">"</span><span class="content">DeltaSpike</span><span class="delimiter">"</span></span>); + return this.messages.welcomeTo("DeltaSpike"); } }</code></pre> </div> @@ -911,18 +1169,18 @@ uses printf-style format strings.</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">MyBean</span> +<pre class="highlight"><code class="language-java" data-lang="java">public class MyBean { - <span class="annotation">@Inject</span> - <span class="directive">private</span> MessageContext messageContext; + @Inject + private MessageContext messageContext; - <span class="directive">public</span> <span class="type">void</span> action() + public void action() { - Message message = <span class="local-variable">this</span>.messageContext.message(); - write(message.template(<span class="string"><span class="delimiter">"</span><span class="content">Hello %s from %s</span><span class="delimiter">"</span></span>).argument(<span class="string"><span class="delimiter">"</span><span class="content">World</span><span class="delimiter">"</span></span>).argument(<span class="string"><span class="delimiter">"</span><span class="content">DeltaSpike</span><span class="delimiter">"</span></span>)); + Message message = this.messageContext.message(); + write(message.template("Hello %s from %s").argument("World").argument("DeltaSpike")); } - <span class="comment">//...</span> + //... }</code></pre> </div> </div> @@ -932,15 +1190,15 @@ can also specify the message sources dyn </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Inject</span> -<span class="directive">private</span> MessageContext messageContext; +<pre class="highlight"><code class="language-java" data-lang="java">@Inject +private MessageContext messageContext; -<span class="directive">public</span> <span class="type">void</span> action() +public void action() { - Message message = <span class="local-variable">this</span>.messageContext.messageSource(<span class="string"><span class="delimiter">"</span><span class="content">org.apache.deltaspike.example.message.Messages</span><span class="delimiter">"</span></span>).message(); - write(message.template(<span class="string"><span class="delimiter">"</span><span class="content">{hello}</span><span class="delimiter">"</span></span>).argument(<span class="string"><span class="delimiter">"</span><span class="content">World</span><span class="delimiter">"</span></span>).argument(<span class="string"><span class="delimiter">"</span><span class="content">DeltaSpike</span><span class="delimiter">"</span></span>)); + Message message = this.messageContext.messageSource("org.apache.deltaspike.example.message.Messages").message(); + write(message.template("{hello}").argument("World").argument("DeltaSpike")); } -<span class="comment">//...</span> +//... -> org/apache/deltaspike/example/message/Messages.properties @@ -948,7 +1206,7 @@ org/apache/deltaspike/example/message/Me org/apache/deltaspike/example/message/Messages_de.properties ... -<span class="comment">//content (as usual) in message bundle files:</span> +//content (as usual) in message bundle files: hello=Hello %s from %s</code></pre> </div> </div> @@ -976,12 +1234,12 @@ instance to the current messageContext:< </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Inject</span> -<span class="directive">private</span> MessageContext messageContext; +<pre class="highlight"><code class="language-java" data-lang="java">@Inject +private MessageContext messageContext; -<span class="comment">//...</span> +//... -Message message = <span class="local-variable">this</span>.messageContext.messageResolver(<span class="keyword">new</span> CustomMessageResolver()).message();</code></pre> +Message message = this.messageContext.messageResolver(new CustomMessageResolver()).message();</code></pre> </div> </div> <div class="paragraph"> @@ -1006,11 +1264,11 @@ messageContext:</p> </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Inject</span> -<span class="directive">private</span> MessageContext messageContext; +<pre class="highlight"><code class="language-java" data-lang="java">@Inject +private MessageContext messageContext; -<span class="comment">//...</span> -Message message = <span class="local-variable">this</span>.messageContext.messageInterpolator(<span class="keyword">new</span> CustomMessageInterpolator()).message();</code></pre> +//... +Message message = this.messageContext.messageInterpolator(new CustomMessageInterpolator()).message();</code></pre> </div> </div> </div> @@ -1052,9 +1310,9 @@ property file reading.</p> </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Inject</span> -<span class="annotation">@InjectableResource</span>(location=<span class="string"><span class="delimiter">"</span><span class="content">myfile.properties</span><span class="delimiter">"</span></span>) -<span class="directive">private</span> <span class="predefined-type">InputStream</span> inputStream;</code></pre> +<pre class="highlight"><code class="language-java" data-lang="java">@Inject +@InjectableResource(location="myfile.properties") +private InputStream inputStream;</code></pre> </div> </div> <div class="paragraph"> @@ -1116,17 +1374,17 @@ business logic lookup into an inventory </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">InventoryActions</span> { - <span class="annotation">@PersistenceContext</span> <span class="directive">private</span> EntityManager em; - <span class="annotation">@Inject</span> <span class="directive">private</span> <span class="predefined-type">Event</span><ExceptionToCatchEvent> catchEvent; - - <span class="directive">public</span> <span class="predefined-type">Integer</span> queryForItem(Item item) { - <span class="keyword">try</span> { - <span class="predefined-type">Query</span> q = em.createQuery(<span class="string"><span class="delimiter">"</span><span class="content">SELECT i from Item i where i.id = :id</span><span class="delimiter">"</span></span>); - q.setParameter(<span class="string"><span class="delimiter">"</span><span class="content">id</span><span class="delimiter">"</span></span>, item.getId()); - <span class="keyword">return</span> q.getSingleResult(); - } <span class="keyword">catch</span> (PersistenceException e) { - catchEvent.fire(<span class="keyword">new</span> ExceptionToCatchEvent(e)); +<pre class="highlight"><code class="language-java" data-lang="java">public class InventoryActions { + @PersistenceContext private EntityManager em; + @Inject private Event<ExceptionToCatchEvent> catchEvent; + + public Integer queryForItem(Item item) { + try { + Query q = em.createQuery("SELECT i from Item i where i.id = :id"); + q.setParameter("id", item.getId()); + return q.getSingleResult(); + } catch (PersistenceException e) { + catchEvent.fire(new ExceptionToCatchEvent(e)); } } }</code></pre> @@ -1200,8 +1458,8 @@ bean for handler methods.</p> </div> <div class="listingblock"> <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">MyHandlers</span> {}</code></pre> +<pre class="highlight"><code class="language-java" data-lang="java">@ExceptionHandler +public class MyHandlers {}</code></pre> </div> </div> <div class="paragraph"> @@ -1225,12 +1483,12 @@ represents all exceptions).</p> </div> <div class="listingblock"> <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">MyHandlers</span> +<pre class="highlight"><code class="language-java" data-lang="java">@ExceptionHandler +public class MyHandlers { - <span class="type">void</span> printExceptions(<span class="annotation">@Handles</span> ExceptionEvent<<span class="predefined-type">Throwable</span>> evt) + void printExceptions(@Handles ExceptionEvent<Throwable> evt) { - <span class="predefined-type">System</span>.out.println(<span class="string"><span class="delimiter">"</span><span class="content">Something bad happened:</span><span class="delimiter">"</span></span> + + System.out.println("Something bad happened:" + evt.getException().getMessage()); evt.handleAndContinue(); } @@ -1296,17 +1554,17 @@ features of handlers to log all exceptio </div> <div class="listingblock"> <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">MyHandlers</span> +<pre class="highlight"><code class="language-java" data-lang="java">@ExceptionHandler +public class MyHandlers { - <span class="type">void</span> logExceptions(<span class="annotation">@BeforeHandles</span> <span class="annotation">@WebRequest</span> ExceptionEvent<<span class="predefined-type">Throwable</span>> evt, <span class="predefined-type">Logger</span> log) + void logExceptions(@BeforeHandles @WebRequest ExceptionEvent<Throwable> evt, Logger log) { - log.warn(<span class="string"><span class="delimiter">"</span><span class="content">Something bad happened: </span><span class="delimiter">"</span></span> + evt.getException().getMessage()); + log.warn("Something bad happened: " + evt.getException().getMessage()); } - <span class="type">void</span> logExceptions(<span class="annotation">@Handles</span> <span class="annotation">@WebRequest</span> ExceptionEvent<<span class="predefined-type">Throwable</span>> evt, <span class="predefined-type">Logger</span> log) + void logExceptions(@Handles @WebRequest ExceptionEvent<Throwable> evt, Logger log) { - <span class="comment">// possibly send a HTTP Error code</span> + // possibly send a HTTP Error code } }</code></pre> </div> @@ -1354,14 +1612,14 @@ non-deterministic.</p> </div> <div class="listingblock"> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="type">void</span> handleIOExceptionFirst(<span class="annotation">@Handles</span>(ordinal = <span class="integer">100</span>) ExceptionEvent<<span class="exception">IOException</span>> evt) +<pre class="highlight"><code class="language-java" data-lang="java">void handleIOExceptionFirst(@Handles(ordinal = 100) ExceptionEvent<IOException> evt) { - <span class="predefined-type">System</span>.out.println(<span class="string"><span class="delimiter">"</span><span class="content">Invoked first</span><span class="delimiter">"</span></span>); + System.out.println("Invoked first"); } -<span class="type">void</span> handleIOExceptionSecond(<span class="annotation">@Handles</span> ExceptionEvent<<span class="exception">IOException</span>> evt) +void handleIOExceptionSecond(@Handles ExceptionEvent<IOException> evt) { - <span class="predefined-type">System</span>.out.println(<span class="error">â</span>Invoked second<span class="error">â</span>); + System.out.println(âInvoked secondâ); }</code></pre> </div> </div> @@ -1566,10 +1824,10 @@ all scopes are only implemented in the < <div class="listingblock"> <div class="title">Example</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Scope</span> -<span class="annotation">@Retention</span>(<span class="predefined-type">RetentionPolicy</span>.RUNTIME) -<span class="annotation">@Target</span>({<span class="predefined-type">ElementType</span>.TYPE,<span class="predefined-type">ElementType</span>.METHOD,<span class="predefined-type">ElementType</span>.FIELD}) -<span class="directive">public</span> <span class="annotation">@interface</span> ACustomScope {}</code></pre> +<pre class="highlight"><code class="language-java" data-lang="java">@Scope +@Retention(RetentionPolicy.RUNTIME) +@Target({ElementType.TYPE,ElementType.METHOD,ElementType.FIELD}) +public @interface ACustomScope {}</code></pre> </div> </div> </li> @@ -1578,14 +1836,14 @@ all scopes are only implemented in the < <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">class</span> <span class="class">ACustomScopeExtension</span> <span class="directive">implements</span> Extension, <span class="predefined-type">Serializable</span> { +<pre class="highlight"><code class="language-java" data-lang="java">public class ACustomScopeExtension implements Extension, Serializable { - <span class="directive">public</span> <span class="type">void</span> addACustomScope(<span class="annotation">@Observes</span> <span class="directive">final</span> BeforeBeanDiscovery event) { - event.addScope(ACustomScope.class, <span class="predefined-constant">true</span>, <span class="predefined-constant">false</span>); + public void addACustomScope(@Observes final BeforeBeanDiscovery event) { + event.addScope(ACustomScope.class, true, false); } - <span class="directive">public</span> <span class="type">void</span> registerACustomScopeContext(<span class="annotation">@Observes</span> <span class="directive">final</span> AfterBeanDiscovery event) { - event.addContext(<span class="keyword">new</span> ACustomScopeContext()); + public void registerACustomScopeContext(@Observes final AfterBeanDiscovery event) { + event.addContext(new ACustomScopeContext()); } }</code></pre> </div> @@ -1597,41 +1855,41 @@ jakarta.enterprise.inject.spi.Bean insta <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">class</span> <span class="class">ACustomScopeContext</span> <span class="directive">implements</span> <span class="predefined-type">Context</span>, <span class="predefined-type">Serializable</span> { +<pre class="highlight"><code class="language-java" data-lang="java">public class ACustomScopeContext implements Context, Serializable { - <span class="comment">// Get the scope type of the context object.</span> - <span class="directive">public</span> <span class="predefined-type">Class</span><? <span class="directive">extends</span> <span class="predefined-type">Annotation</span>> getScope() { - <span class="keyword">return</span> ACustomScope.class; + // Get the scope type of the context object. + public Class<? extends Annotation> getScope() { + return ACustomScope.class; } - <span class="comment">// Return an existing instance of certain contextual type or create a new instance by calling</span> - <span class="comment">// jakarta.enterprise.context.spi.Contextual.create(CreationalContext) and return the new instance.</span> - <span class="directive">public</span> <T> T get(Contextual<T> contextual, CreationalContext<T> creationalContext) { + // Return an existing instance of certain contextual type or create a new instance by calling + // jakarta.enterprise.context.spi.Contextual.create(CreationalContext) and return the new instance. + public <T> T get(Contextual<T> contextual, CreationalContext<T> creationalContext) { Bean bean = (Bean) contextual; - <span class="comment">// you can store the bean somewhere</span> - <span class="keyword">if</span> (somewhere.containsKey(bean.getName())) { - <span class="keyword">return</span> (T) somewhere.get(bean.getName()); - } <span class="keyword">else</span> { + // you can store the bean somewhere + if (somewhere.containsKey(bean.getName())) { + return (T) somewhere.get(bean.getName()); + } else { T t = (T) bean.create(creationalContext); somewhere.put(bean.getName(), t); - <span class="keyword">return</span> t; + return t; } } - <span class="comment">// Return an existing instance of a certain contextual type or a null value.</span> - <span class="directive">public</span> <T> T get(Contextual<T> contextual) { + // Return an existing instance of a certain contextual type or a null value. + public <T> T get(Contextual<T> contextual) { Bean bean = (Bean) contextual; - <span class="comment">// you can store the bean somewhere</span> - <span class="keyword">if</span> (somewhere.containsKey(bean.getName())) { - <span class="keyword">return</span> (T) somewhere.get(bean.getName()); - } <span class="keyword">else</span> { - <span class="keyword">return</span> <span class="predefined-constant">null</span>; + // you can store the bean somewhere + if (somewhere.containsKey(bean.getName())) { + return (T) somewhere.get(bean.getName()); + } else { + return null; } } - <span class="comment">// Determines if the context object is active.</span> - <span class="directive">public</span> <span class="type">boolean</span> isActive() { - <span class="keyword">return</span> <span class="predefined-constant">true</span>; + // Determines if the context object is active. + public boolean isActive() { + return true; } }</code></pre> @@ -1673,18 +1931,18 @@ we can disable the SecurityExtension pro <div class="listingblock"> <div class="title">Disable a specific extension</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">class</span> <span class="class">CustomClassDeactivator</span> <span class="directive">implements</span> ClassDeactivator +<pre class="highlight"><code class="language-java" data-lang="java">public class CustomClassDeactivator implements ClassDeactivator { - <span class="directive">private</span> <span class="directive">static</span> <span class="directive">final</span> <span class="type">long</span> serialVersionUID = <span class="integer">1L</span>; + private static final long serialVersionUID = 1L; - <span class="annotation">@Override</span> - <span class="directive">public</span> <span class="predefined-type">Boolean</span> isActivated(<span class="predefined-type">Class</span><? <span class="directive">extends</span> Deactivatable> targetClass) + @Override + public Boolean isActivated(Class<? extends Deactivatable> targetClass) { - <span class="keyword">if</span> (targetClass.equals(SecurityExtension.class)) + if (targetClass.equals(SecurityExtension.class)) { - <span class="keyword">return</span> <span class="predefined-type">Boolean</span>.FALSE; + return Boolean.FALSE; } - <span class="keyword">return</span> <span class="predefined-constant">null</span>; <span class="comment">//no result for the given class</span> + return null; //no result for the given class } }</code></pre> </div> @@ -1710,21 +1968,21 @@ because you might disable mechanisms nee <div class="listingblock"> <div class="title">Possible but not suggested</div> <div class="content"> -<pre class="CodeRay highlight"><code data-lang="java"><span class="directive">public</span> <span class="type">class</span> <span class="class">WhitelistFilter</span> <span class="directive">implements</span> ClassDeactivator +<pre class="highlight"><code class="language-java" data-lang="java">public class WhitelistFilter implements ClassDeactivator { - <span class="directive">private</span> <span class="predefined-type">List</span><<span class="predefined-type">Class</span><?>> limitedExtensions =
[... 165 lines stripped ...]
