Added: tomee/site/trunk/content/master/pt/examples/async-methods.html URL: http://svn.apache.org/viewvc/tomee/site/trunk/content/master/pt/examples/async-methods.html?rev=1866555&view=auto ============================================================================== --- tomee/site/trunk/content/master/pt/examples/async-methods.html (added) +++ tomee/site/trunk/content/master/pt/examples/async-methods.html Sat Sep 7 14:25:49 2019 @@ -0,0 +1,444 @@ +<!DOCTYPE html> +<html lang="en"> + +<head> + <meta charset="UTF-8"> + <meta http-equiv="X-UA-Compatible" content="IE=edge"> + <meta name="viewport" content="width=device-width, initial-scale=1"> + <title>Apache TomEE</title> + <meta name="description" + content="Apache TomEE is a lightweight, yet powerful, JavaEE Application server with feature rich tooling." /> + <meta name="keywords" content="tomee,asf,apache,javaee,jee,shade,embedded,test,junit,applicationcomposer,maven,arquillian" /> + <meta name="author" content="Luka Cvetinovic for Codrops" /> + <link rel="icon" href="../../../favicon.ico"> + <link rel="icon" type="image/png" href="../../../favicon.png"> + <meta name="msapplication-TileColor" content="#80287a"> + <meta name="theme-color" content="#80287a"> + <link rel="stylesheet" type="text/css" href="../../../css/normalize.css"> + <link rel="stylesheet" type="text/css" href="../../../css/bootstrap.css"> + <link rel="stylesheet" type="text/css" href="../../../css/owl.css"> + <link rel="stylesheet" type="text/css" href="../../../css/animate.css"> + <link rel="stylesheet" type="text/css" href="../../../fonts/font-awesome-4.1.0/css/font-awesome.min.css"> + <link rel="stylesheet" type="text/css" href="../../../fonts/eleganticons/et-icons.css"> + <link rel="stylesheet" type="text/css" href="../../../css/jqtree.css"> + <link rel="stylesheet" type="text/css" href="../../../css/idea.css"> + <link rel="stylesheet" type="text/css" href="../../../css/cardio.css"> + + <script type="text/javascript"> + + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-2717626-1']); + _gaq.push(['_setDomainName', 'apache.org']); + _gaq.push(['_trackPageview']); + + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + + </script> +</head> + +<body> + <div class="preloader"> + <img src="../../../img/loader.gif" alt="Preloader image"> + </div> + <nav class="navbar"> + <div class="container"> + <div class="row"> <div class="col-md-12"> + + <!-- Brand and toggle get grouped for better mobile display --> + <div class="navbar-header"> + <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + <a class="navbar-brand" href="/"> + <span> + + + <img src="../../../img/logo-active.png"> + + + </span> + Apache TomEE + </a> + </div> + <!-- Collect the nav links, forms, and other content for toggling --> + <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1"> + <ul class="nav navbar-nav navbar-right main-nav"> + <li><a href="../../../docs.html">Documentation</a></li> + <li><a href="../../../community/index.html">Community</a></li> + <li><a href="../../../security/security.html">Security</a></li> + <li><a href="../../../download-ng.html">Downloads</a></li> + </ul> + </div> + <!-- /.navbar-collapse --> + </div></div> + </div> + <!-- /.container-fluid --> + </nav> + + + <div id="main-block" class="container main-block"> + <div class="row title"> + <div class="col-md-12"> + <div class='page-header'> + + <h1>Métodos AssÃncronos</h1> + </div> + </div> + </div> + <div class="row"> + + <div class="col-md-12"> + <div id="preamble"> +<div class="sectionbody"> +<div class="paragraph"> +<p>A anotação @Asynchronous foi introduzida no EJB 3.1 como um simples meio +de criar processamento assÃcrono.</p> +</div> +<div class="paragraph"> +<p>Toda vez que um método anotado com <code>@Asynchronous</code> é invocado por qualquer um que +vai imediatamente retornar independentemente de quanto tempo o método realmente leva.</p> +</div> +<div class="paragraph"> +<p>Cada invocação retorna um objeto <a href="http://download.oracle.com/javase/6/docs/api/java/util/concurrent/Future.html";>Future</a> +que essencialmente inicia <em>vazio</em> e terá mais tarde o seu valor preenchido pelo contêiner quando o método relacionado é chamado concluir.</p> +</div> +<div class="paragraph"> +<p>Retornar um objeto <code>Future</code> não é necessário e os métodos <code>@ Asynchronous</code> podem retornar <code>void</code>.</p> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_exemplo">Exemplo</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>Aqui, no <code>JobProcessorTest</code>,</p> +</div> +<div class="paragraph"> +<p><code>final Future<String> red = processor.addJob("red");</code> prossegue para a +próxima declaração,</p> +</div> +<div class="paragraph"> +<p><code>final Future<String> orange = processor.addJob("orange");</code></p> +</div> +<div class="paragraph"> +<p>sem aguardar pelo método addJob() para completar. E depois poderÃamos +perguntar pelo resultado usando o método <code>Future <?>. get ()</code> como</p> +</div> +<div class="paragraph"> +<p><code>assertEquals("blue", blue.get());</code></p> +</div> +<div class="paragraph"> +<p>Aguardar que o processamento seja concluÃdo (se ainda não estiver concluÃdo) +e obter o resultado. Se você não se importar com o resultado, você poderia +simplesmente ter seu método assÃncrono como um método vazio.</p> +</div> +<div class="paragraph"> +<p>Veja a documentação para saber mais: <a href="http://download.oracle.com/javase/6/docs/api/java/util/concurrent/Future.html";>Future</a></p> +</div> +<div class="quoteblock"> +<blockquote> +<div class="paragraph"> +<p>Uma Future representa o resultado de um cálculo assÃncrono. Métodos +são fornecidos para verificar se o cálculo está completo, para aguardar +a conclusão, e para recuperar o resultado do cálculo. O resultado +pode somente ser recuperado usando o método get quando o cálculo estiver +completado, bloqueando se necessário, até que esteja pronto. O cancelamento é +realizada pelo método de cancelamento. Método adicionais são fornecidos para +determinar se a tarefa completou normalmente ou foi cancelada. Uma vez +o cálculo foi concluÃdo, o cálculo não pode ser cancelado. Se você +gostaria de usar um Future para causa de cancelabilidade mas não +fornecer um resultado utilizável, você pode declarar tipos do formulário Future <?> e +retornar null como resultado da tarefa subjacente.</p> +</div> +</blockquote> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_o_código">O código</h2> +<div class="sectionbody"> +<div class="literalblock"> +<div class="content"> +<pre>@Singleton +public class JobProcessor { +@Asynchronous +@Lock(READ) +@AccessTimeout(-1) +public Future<String> addJob(String jobName) { + + // Finja que este trabalho leva um tempo + doSomeHeavyLifting(); + + // Devolva nosso resultado + return new AsyncResult<String>(jobName); +} + +private void doSomeHeavyLifting() { + try { + Thread.sleep(SECONDS.toMillis(10)); + } catch (InterruptedException e) { + Thread.interrupted(); + throw new IllegalStateException(e); + } + } +}</pre> +</div> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_teste">Teste</h2> +<div class="sectionbody"> +<div class="literalblock"> +<div class="content"> +<pre>public class JobProcessorTest extends TestCase { + +public void test() throws Exception { + + final Context context = EJBContainer.createEJBContainer().getContext(); + + final JobProcessor processor = (JobProcessor) context.lookup("java:global/async-methods/JobProcessor"); + + final long start = System.nanoTime(); + + // Enfileirar um monte de trabalho + final Future<String> red = processor.addJob("red"); + final Future<String> orange = processor.addJob("orange"); + final Future<String> yellow = processor.addJob("yellow"); + final Future<String> green = processor.addJob("green"); + final Future<String> blue = processor.addJob("blue"); + final Future<String> violet = processor.addJob("violet"); + + // Aguarde o resultado - 1 minuto de trabalho + assertEquals("blue", blue.get()); + assertEquals("orange", orange.get()); + assertEquals("green", green.get()); + assertEquals("red", red.get()); + assertEquals("yellow", yellow.get()); + assertEquals("violet", violet.get()); + + // Quanto tempo levou? + final long total = TimeUnit.NANOSECONDS.toSeconds(System.nanoTime() - start); + + // A execução deve ser em torno de 9 a 21 segundos + // O tempo de execução depende do número de encadeamentos disponÃveis para execução assÃncrona. + //No melhor dos casos, é 10s mais algum tempo de processamento mÃnimo. + assertTrue("Expected > 9 but was: " + total, total > 9); + assertTrue("Expected < 21 but was: " + total, total < 21); + + } +}</pre> +</div> +</div> +<div class="literalblock"> +<div class="content"> +<pre>------------------------------------------------------- + T E S T S +------------------------------------------------------- +Running org.superbiz.async.JobProcessorTest +INFO - ******************************************************************************** +INFO - OpenEJB http://tomee.apache.org/ +INFO - Startup: Wed Feb 27 12:46:11 BRT 2019 +INFO - Copyright 1999-2018 (C) Apache OpenEJB Project, All Rights Reserved. +INFO - Version: 8.0.0-SNAPSHOT +INFO - Build date: 20190227 +INFO - Build time: 04:12 +INFO - ******************************************************************************** +INFO - openejb.home = /home/soro/git/apache/tomee/examples/async-methods +INFO - openejb.base = /home/soro/git/apache/tomee/examples/async-methods +INFO - Created new singletonService org.apache.openejb.cdi.ThreadSingletonServiceImpl@22f71333 +INFO - Succeeded in installing singleton service +INFO - Using 'javax.ejb.embeddable.EJBContainer=true' +INFO - Cannot find the configuration file [conf/openejb.xml]. Will attempt to create one for the beans deployed. +INFO - Configuring Service(id=Default Security Service, type=SecurityService, provider-id=Default Security Service) +INFO - Configuring Service(id=Default Transaction Manager, type=TransactionManager, provider-id=Default Transaction Manager) +INFO - Creating TransactionManager(id=Default Transaction Manager) +INFO - Creating SecurityService(id=Default Security Service) +INFO - Found EjbModule in classpath: /home/soro/git/apache/tomee/examples/async-methods/target/classes +INFO - Beginning load: /home/soro/git/apache/tomee/examples/async-methods/target/classes +INFO - Configuring enterprise application: /home/soro/git/apache/tomee/examples/async-methods +INFO - Auto-deploying ejb JobProcessor: EjbDeployment(deployment-id=JobProcessor) +INFO - Configuring Service(id=Default Singleton Container, type=Container, provider-id=Default Singleton Container) +INFO - Auto-creating a container for bean JobProcessor: Container(type=SINGLETON, id=Default Singleton Container) +INFO - Creating Container(id=Default Singleton Container) +INFO - Configuring Service(id=Default Managed Container, type=Container, provider-id=Default Managed Container) +INFO - Auto-creating a container for bean org.superbiz.async.JobProcessorTest: Container(type=MANAGED, id=Default Managed Container) +INFO - Creating Container(id=Default Managed Container) +INFO - Using directory /tmp for stateful session passivation +INFO - Enterprise application "/home/soro/git/apache/tomee/examples/async-methods" loaded. +INFO - Assembling app: /home/soro/git/apache/tomee/examples/async-methods +INFO - Jndi(name="java:global/async-methods/JobProcessor!org.superbiz.async.JobProcessor") +INFO - Jndi(name="java:global/async-methods/JobProcessor") +INFO - Existing thread singleton service in SystemInstance(): org.apache.openejb.cdi.ThreadSingletonServiceImpl@22f71333 +INFO - Some Principal APIs could not be loaded: org.eclipse.microprofile.jwt.JsonWebToken out of org.eclipse.microprofile.jwt.JsonWebToken not found +INFO - OpenWebBeans Container is starting... +INFO - Adding OpenWebBeansPlugin : [CdiPlugin] +INFO - All injection points were validated successfully. +INFO - OpenWebBeans Container has started, it took 316 ms. +INFO - Created Ejb(deployment-id=JobProcessor, ejb-name=JobProcessor, container=Default Singleton Container) +INFO - Started Ejb(deployment-id=JobProcessor, ejb-name=JobProcessor, container=Default Singleton Container) +INFO - Deployed Application(path=/home/soro/git/apache/tomee/examples/async-methods) +Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 23.491 sec + +Results : + +Tests run: 1, Failures: 0, Errors: 0, Skipped: 0</pre> +</div> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_como_funciona_debaixo_dos_panos">Como funciona debaixo dos panos</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>Sob os panos, o que faz esse trabalho é:</p> +</div> +<div class="ulist"> +<ul> +<li> +<p>O <code>JobProcessor</code> que é o chamador vê que não é realmente uma instância de +<code>JobProcessor</code>. Pelo contrário, é uma subclasse ou proxy que tem todos os métodos sobrescrito. Métodos que devem ser assÃncronos são manipulados diferentemente.</p> +</li> +<li> +<p>Chamadas para um método assÃncrono simplesmente resultam em um <code>Runnable</code> sendo +criado envolve o método e os parâmetros que você deu. Este runnable é +dado a um +<a href="http://download.oracle.com/javase/6/docs/api/java/util/concurrent/Executor.html";>Executor</a> +que é simplesmente uma fila de trabalho anexada a um conjunto de encadeamentos.</p> +</li> +<li> +<p>Depois de adicionar o trabalho à fila, a versão com proxy do método +retorna uma implementação de <code>Future</code> que está ligada ao` Runnable` +que agora está esperando na fila.</p> +</li> +<li> +<p>Quando o <code>Runnable</code> finalmente executa o método no <em>real</em> +Na instância <code>JobProcessor</code>, ele pegará o valor de retorno e o configurará +o <code>Future</code> tornando-o disponÃvel para o chamador.</p> +</li> +</ul> +</div> +<div class="paragraph"> +<p>Importante notar que o objeto <code>AsyncResult</code> o` JobProcessor` +retornado não é o mesmo objeto <code>Future</code> que o chamador está segurando.</p> +</div> +<div class="paragraph"> +<p>Seria legal se o <code>JobProcessor</code> real pudesse retornar` String` e +a versão do chamador de <code>JobProcessor</code> poderia retornar` Future <String> `, +mas nós não vimos nenhuma maneira de fazer isso sem adicionar mais complexidade.</p> +</div> +<div class="paragraph"> +<p>Então o <code>AsyncResult</code> é um simples objeto wrapper. O contêiner vai puxar +o <code>String</code> para fora, lançar o ` AsyncResult`, então colocar o <code>String</code> em +<em>real</em> <code>Future</code> que o chamador está segurando.</p> +</div> +<div class="paragraph"> +<p>Para obter progresso ao longo do caminho, simplesmente passe um objeto seguro para thread como <a href="http://download.oracle.com/javase/6/docs/api/java/util/concurrent/atomic/AtomicInteger.html";>AtomicInteger</a> +para o método <code>@ Asynchronous</code> e ter o código do bean periodicamente atualizado +com o percentual completo.</p> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_exemplos_relacionados">Exemplos relacionados</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>Para processamento assÃncrono complexo, a resposta do JavaEE é +<code>@ MessageDrivenBean</code>. Dê uma olhada no exemplo +<a href="../simple-mdb/README.html">simple-mdb</a></p> +</div> +</div> +</div> + </div> + + </div> + </div> +<footer> + <div class="container"> + <div class="row"> + <div class="col-sm-6 text-center-mobile"> + <h3 class="white">Be simple. Be certified. Be Tomcat.</h3> + <h5 class="light regular light-white">"A good application in a good server"</h5> + <ul class="social-footer"> + <li><a href="https://www.facebook.com/ApacheTomEE/";><i class="fa fa-facebook"></i></a></li> + <li><a href="https://twitter.com/apachetomee";><i class="fa fa-twitter"></i></a></li> + <li><a href="https://plus.google.com/communities/105208241852045684449";><i class="fa fa-google-plus"></i></a></li> + </ul> + </div> + <div class="col-sm-6 text-center-mobile"> + <div class="row opening-hours"> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../latest/docs/documentation.html" class="white">Documentation</a></h5> + <ul class="list-unstyled"> + <li><a href="../../../latest/docs/admin/configuration/index.html" class="regular light-white">How to configure</a></li> + <li><a href="../../../latest/docs/admin/file-layout.html" class="regular light-white">Dir. Structure</a></li> + <li><a href="../../../latest/docs/developer/testing/index.html" class="regular light-white">Testing</a></li> + <li><a href="../../../latest/docs/admin/cluster/index.html" class="regular light-white">Clustering</a></li> + </ul> + </div> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../latest/examples/" class="white">Examples</a></h5> + <ul class="list-unstyled"> + <li><a href="../../../latest/examples/simple-cdi-interceptor.html" class="regular light-white">CDI Interceptor</a></li> + <li><a href="../../../latest/examples/rest-cdi.html" class="regular light-white">REST with CDI</a></li> + <li><a href="../../../latest/examples/ejb-examples.html" class="regular light-white">EJB</a></li> + <li><a href="../../../latest/examples/jsf-managedBean-and-ejb.html" class="regular light-white">JSF</a></li> + </ul> + </div> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../community/index.html" class="white">Community</a></h5> + <ul class="list-unstyled"> + <li><a href="../../../community/contributors.html" class="regular light-white">Contributors</a></li> + <li><a href="../../../community/social.html" class="regular light-white">Social</a></li> + <li><a href="../../../community/sources.html" class="regular light-white">Sources</a></li> + </ul> + </div> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../security/index.html" class="white">Security</a></h5> + <ul class="list-unstyled"> + <li><a href="http://apache.org/security"; target="_blank" class="regular light-white">Apache Security</a></li> + <li><a href="http://apache.org/security/projects.html"; target="_blank" class="regular light-white">Security Projects</a></li> + <li><a href="http://cve.mitre.org"; target="_blank" class="regular light-white">CVE</a></li> + </ul> + </div> + </div> + </div> + </div> + <div class="row bottom-footer text-center-mobile"> + <div class="col-sm-12 light-white"> + <p>Copyright © 1999-2016 The Apache Software Foundation, Licensed under the Apache License, Version 2.0. Apache TomEE, TomEE, Apache, the Apache feather logo, and the Apache TomEE project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.</p> + </div> + </div> + </div> + </footer> + <!-- Holder for mobile navigation --> + <div class="mobile-nav"> + <ul> + <li><a hef="../../../latest/docs/admin/index.html">Administrators</a> + <li><a hef="../../../latest/docs/developer/index.html">Developers</a> + <li><a hef="../../../latest/docs/advanced/index.html">Advanced</a> + <li><a hef="../../../community/index.html">Community</a> + </ul> + <a href="#" class="close-link"><i class="arrow_up"></i></a> + </div> + <!-- Scripts --> + <script src="../../../js/jquery-1.11.1.min.js"></script> + <script src="../../../js/owl.carousel.min.js"></script> + <script src="../../../js/bootstrap.min.js"></script> + <script src="../../../js/wow.min.js"></script> + <script src="../../../js/typewriter.js"></script> + <script src="../../../js/jquery.onepagenav.js"></script> + <script src="../../../js/tree.jquery.js"></script> + <script src="../../../js/highlight.pack.js"></script> + <script src="../../../js/main.js"></script> + </body> + +</html> +
Added: tomee/site/trunk/content/master/pt/examples/async-postconstruct.html URL: http://svn.apache.org/viewvc/tomee/site/trunk/content/master/pt/examples/async-postconstruct.html?rev=1866555&view=auto ============================================================================== --- tomee/site/trunk/content/master/pt/examples/async-postconstruct.html (added) +++ tomee/site/trunk/content/master/pt/examples/async-postconstruct.html Sat Sep 7 14:25:49 2019 @@ -0,0 +1,326 @@ +<!DOCTYPE html> +<html lang="en"> + +<head> + <meta charset="UTF-8"> + <meta http-equiv="X-UA-Compatible" content="IE=edge"> + <meta name="viewport" content="width=device-width, initial-scale=1"> + <title>Apache TomEE</title> + <meta name="description" + content="Apache TomEE is a lightweight, yet powerful, JavaEE Application server with feature rich tooling." /> + <meta name="keywords" content="tomee,asf,apache,javaee,jee,shade,embedded,test,junit,applicationcomposer,maven,arquillian" /> + <meta name="author" content="Luka Cvetinovic for Codrops" /> + <link rel="icon" href="../../../favicon.ico"> + <link rel="icon" type="image/png" href="../../../favicon.png"> + <meta name="msapplication-TileColor" content="#80287a"> + <meta name="theme-color" content="#80287a"> + <link rel="stylesheet" type="text/css" href="../../../css/normalize.css"> + <link rel="stylesheet" type="text/css" href="../../../css/bootstrap.css"> + <link rel="stylesheet" type="text/css" href="../../../css/owl.css"> + <link rel="stylesheet" type="text/css" href="../../../css/animate.css"> + <link rel="stylesheet" type="text/css" href="../../../fonts/font-awesome-4.1.0/css/font-awesome.min.css"> + <link rel="stylesheet" type="text/css" href="../../../fonts/eleganticons/et-icons.css"> + <link rel="stylesheet" type="text/css" href="../../../css/jqtree.css"> + <link rel="stylesheet" type="text/css" href="../../../css/idea.css"> + <link rel="stylesheet" type="text/css" href="../../../css/cardio.css"> + + <script type="text/javascript"> + + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-2717626-1']); + _gaq.push(['_setDomainName', 'apache.org']); + _gaq.push(['_trackPageview']); + + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + + </script> +</head> + +<body> + <div class="preloader"> + <img src="../../../img/loader.gif" alt="Preloader image"> + </div> + <nav class="navbar"> + <div class="container"> + <div class="row"> <div class="col-md-12"> + + <!-- Brand and toggle get grouped for better mobile display --> + <div class="navbar-header"> + <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + <a class="navbar-brand" href="/"> + <span> + + + <img src="../../../img/logo-active.png"> + + + </span> + Apache TomEE + </a> + </div> + <!-- Collect the nav links, forms, and other content for toggling --> + <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1"> + <ul class="nav navbar-nav navbar-right main-nav"> + <li><a href="../../../docs.html">Documentation</a></li> + <li><a href="../../../community/index.html">Community</a></li> + <li><a href="../../../security/security.html">Security</a></li> + <li><a href="../../../download-ng.html">Downloads</a></li> + </ul> + </div> + <!-- /.navbar-collapse --> + </div></div> + </div> + <!-- /.container-fluid --> + </nav> + + + <div id="main-block" class="container main-block"> + <div class="row title"> + <div class="col-md-12"> + <div class='page-header'> + + <h1>@Asynchronous @PostConstruct</h1> + </div> + </div> + </div> + <div class="row"> + + <div class="col-md-12"> + <div class="paragraph"> +<p>Colocar <code>@ Asynchronous</code> no <code>@ PostConstruct</code> de um EJB não é uma +parte suportada do Java EE, mas neste exemplo mostraremos um padrão que funciona +tão bem com pouco esforço.</p> +</div> +<div class="paragraph"> +<p>O coração deste padrão é para:</p> +</div> +<div class="ulist"> +<ul> +<li> +<p>passar a construção <code> logic</code> para um método <code>@ Asynchronous</code> através de um +<code>java.util.concurrent.Callable</code></p> +</li> +<li> +<p>garantir que o bean não processe invocações até que a construção seja +completada através de um método <code>@ AroundInvoke</code> no bean e no +<code>java.util.concurrent.Future</code></p> +</li> +</ul> +</div> +<div class="paragraph"> +<p>Simples e efetiva. O resultado é um inicialização rápida da aplicação que ainda é thread-safe.</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>package org.superbiz.asyncpost; + +import javax.annotation.PostConstruct; +import javax.ejb.EJB; +import javax.ejb.Lock; +import javax.ejb.LockType; +import javax.ejb.Singleton; +import javax.interceptor.AroundInvoke; +import javax.interceptor.InvocationContext; +import java.util.concurrent.Callable; +import java.util.concurrent.Future; + +import static java.util.concurrent.TimeUnit.SECONDS; + +@Singleton +@Lock(LockType.READ) +public class SlowStarter { + + @EJB + private Executor executor; + + private Future construct; + + private String color; + private String shape; + + @PostConstruct + private void construct() throws Exception { + construct = executor.submit(new Callable() { + @Override + public Object call() throws Exception { + Thread.sleep(SECONDS.toMillis(10)); + SlowStarter.this.color = "orange"; + SlowStarter.this.shape = "circle"; + return null; + } + }); + } + + @AroundInvoke + private Object guaranteeConstructionComplete(InvocationContext context) throws Exception { + construct.get(); + return context.proceed(); + } + + public String getColor() { + return color; + } + + public String getShape() { + return shape; + } +}</pre> +</div> +</div> +<div class="paragraph"> +<p>O <code>Executor</code> é um simples padrão, útil para muitas coisas, que expõe uma +interface funcionalmente equivalente a <code>java.util.concurrent.ExecutorService</code>, +mas com o conjunto de encadeamentos subjacente controlado pelo contêiner.</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>package org.superbiz.asyncpost; + +import javax.ejb.AsyncResult; +import javax.ejb.Asynchronous; +import javax.ejb.Lock; +import javax.ejb.LockType; +import javax.ejb.Singleton; +import java.util.concurrent.Callable; +import java.util.concurrent.Future; + +@Singleton +@Lock(LockType.READ) +public class Executor { + + @Asynchronous + public <T> Future<T> submit(Callable<T> task) throws Exception { + return new AsyncResult<T>(task.call()); + } + +}</pre> +</div> +</div> +<div class="paragraph"> +<p>Finalmente um caso de teste mostrando a utilidade do <code>@AroundInvoke</code> chamado no nosso +bean que chama o <code>construct.get()</code></p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>package org.superbiz.asyncpost; + +import junit.framework.Assert; +import org.junit.Test; + +import javax.ejb.EJB; +import javax.ejb.embeddable.EJBContainer; + +public class SlowStarterTest { + + @EJB + private SlowStarter slowStarter; + + @Test + public void test() throws Exception { + + // Inicia o Container + EJBContainer.createEJBContainer().getContext().bind("inject", this); + + // Imaediatamente acessa os campos inicializado no PostConstruct + // Isso falhará sem a chamada @AroundInvoke para construct.get () + Assert.assertEquals("orange", slowStarter.getColor()); + Assert.assertEquals("circle", slowStarter.getShape()); + } +}</pre> +</div> +</div> + </div> + + </div> + </div> +<footer> + <div class="container"> + <div class="row"> + <div class="col-sm-6 text-center-mobile"> + <h3 class="white">Be simple. Be certified. Be Tomcat.</h3> + <h5 class="light regular light-white">"A good application in a good server"</h5> + <ul class="social-footer"> + <li><a href="https://www.facebook.com/ApacheTomEE/";><i class="fa fa-facebook"></i></a></li> + <li><a href="https://twitter.com/apachetomee";><i class="fa fa-twitter"></i></a></li> + <li><a href="https://plus.google.com/communities/105208241852045684449";><i class="fa fa-google-plus"></i></a></li> + </ul> + </div> + <div class="col-sm-6 text-center-mobile"> + <div class="row opening-hours"> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../latest/docs/documentation.html" class="white">Documentation</a></h5> + <ul class="list-unstyled"> + <li><a href="../../../latest/docs/admin/configuration/index.html" class="regular light-white">How to configure</a></li> + <li><a href="../../../latest/docs/admin/file-layout.html" class="regular light-white">Dir. Structure</a></li> + <li><a href="../../../latest/docs/developer/testing/index.html" class="regular light-white">Testing</a></li> + <li><a href="../../../latest/docs/admin/cluster/index.html" class="regular light-white">Clustering</a></li> + </ul> + </div> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../latest/examples/" class="white">Examples</a></h5> + <ul class="list-unstyled"> + <li><a href="../../../latest/examples/simple-cdi-interceptor.html" class="regular light-white">CDI Interceptor</a></li> + <li><a href="../../../latest/examples/rest-cdi.html" class="regular light-white">REST with CDI</a></li> + <li><a href="../../../latest/examples/ejb-examples.html" class="regular light-white">EJB</a></li> + <li><a href="../../../latest/examples/jsf-managedBean-and-ejb.html" class="regular light-white">JSF</a></li> + </ul> + </div> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../community/index.html" class="white">Community</a></h5> + <ul class="list-unstyled"> + <li><a href="../../../community/contributors.html" class="regular light-white">Contributors</a></li> + <li><a href="../../../community/social.html" class="regular light-white">Social</a></li> + <li><a href="../../../community/sources.html" class="regular light-white">Sources</a></li> + </ul> + </div> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../security/index.html" class="white">Security</a></h5> + <ul class="list-unstyled"> + <li><a href="http://apache.org/security"; target="_blank" class="regular light-white">Apache Security</a></li> + <li><a href="http://apache.org/security/projects.html"; target="_blank" class="regular light-white">Security Projects</a></li> + <li><a href="http://cve.mitre.org"; target="_blank" class="regular light-white">CVE</a></li> + </ul> + </div> + </div> + </div> + </div> + <div class="row bottom-footer text-center-mobile"> + <div class="col-sm-12 light-white"> + <p>Copyright © 1999-2016 The Apache Software Foundation, Licensed under the Apache License, Version 2.0. Apache TomEE, TomEE, Apache, the Apache feather logo, and the Apache TomEE project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.</p> + </div> + </div> + </div> + </footer> + <!-- Holder for mobile navigation --> + <div class="mobile-nav"> + <ul> + <li><a hef="../../../latest/docs/admin/index.html">Administrators</a> + <li><a hef="../../../latest/docs/developer/index.html">Developers</a> + <li><a hef="../../../latest/docs/advanced/index.html">Advanced</a> + <li><a hef="../../../community/index.html">Community</a> + </ul> + <a href="#" class="close-link"><i class="arrow_up"></i></a> + </div> + <!-- Scripts --> + <script src="../../../js/jquery-1.11.1.min.js"></script> + <script src="../../../js/owl.carousel.min.js"></script> + <script src="../../../js/bootstrap.min.js"></script> + <script src="../../../js/wow.min.js"></script> + <script src="../../../js/typewriter.js"></script> + <script src="../../../js/jquery.onepagenav.js"></script> + <script src="../../../js/tree.jquery.js"></script> + <script src="../../../js/highlight.pack.js"></script> + <script src="../../../js/main.js"></script> + </body> + +</html> + Added: tomee/site/trunk/content/master/pt/examples/bean-validation-design-by-contract.html URL: http://svn.apache.org/viewvc/tomee/site/trunk/content/master/pt/examples/bean-validation-design-by-contract.html?rev=1866555&view=auto ============================================================================== --- tomee/site/trunk/content/master/pt/examples/bean-validation-design-by-contract.html (added) +++ tomee/site/trunk/content/master/pt/examples/bean-validation-design-by-contract.html Sat Sep 7 14:25:49 2019 @@ -0,0 +1,436 @@ +<!DOCTYPE html> +<html lang="en"> + +<head> + <meta charset="UTF-8"> + <meta http-equiv="X-UA-Compatible" content="IE=edge"> + <meta name="viewport" content="width=device-width, initial-scale=1"> + <title>Apache TomEE</title> + <meta name="description" + content="Apache TomEE is a lightweight, yet powerful, JavaEE Application server with feature rich tooling." /> + <meta name="keywords" content="tomee,asf,apache,javaee,jee,shade,embedded,test,junit,applicationcomposer,maven,arquillian" /> + <meta name="author" content="Luka Cvetinovic for Codrops" /> + <link rel="icon" href="../../../favicon.ico"> + <link rel="icon" type="image/png" href="../../../favicon.png"> + <meta name="msapplication-TileColor" content="#80287a"> + <meta name="theme-color" content="#80287a"> + <link rel="stylesheet" type="text/css" href="../../../css/normalize.css"> + <link rel="stylesheet" type="text/css" href="../../../css/bootstrap.css"> + <link rel="stylesheet" type="text/css" href="../../../css/owl.css"> + <link rel="stylesheet" type="text/css" href="../../../css/animate.css"> + <link rel="stylesheet" type="text/css" href="../../../fonts/font-awesome-4.1.0/css/font-awesome.min.css"> + <link rel="stylesheet" type="text/css" href="../../../fonts/eleganticons/et-icons.css"> + <link rel="stylesheet" type="text/css" href="../../../css/jqtree.css"> + <link rel="stylesheet" type="text/css" href="../../../css/idea.css"> + <link rel="stylesheet" type="text/css" href="../../../css/cardio.css"> + + <script type="text/javascript"> + + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-2717626-1']); + _gaq.push(['_setDomainName', 'apache.org']); + _gaq.push(['_trackPageview']); + + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + + </script> +</head> + +<body> + <div class="preloader"> + <img src="../../../img/loader.gif" alt="Preloader image"> + </div> + <nav class="navbar"> + <div class="container"> + <div class="row"> <div class="col-md-12"> + + <!-- Brand and toggle get grouped for better mobile display --> + <div class="navbar-header"> + <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + <a class="navbar-brand" href="/"> + <span> + + + <img src="../../../img/logo-active.png"> + + + </span> + Apache TomEE + </a> + </div> + <!-- Collect the nav links, forms, and other content for toggling --> + <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1"> + <ul class="nav navbar-nav navbar-right main-nav"> + <li><a href="../../../docs.html">Documentation</a></li> + <li><a href="../../../community/index.html">Community</a></li> + <li><a href="../../../security/security.html">Security</a></li> + <li><a href="../../../download-ng.html">Downloads</a></li> + </ul> + </div> + <!-- /.navbar-collapse --> + </div></div> + </div> + <!-- /.container-fluid --> + </nav> + + + <div id="main-block" class="container main-block"> + <div class="row title"> + <div class="col-md-12"> + <div class='page-header'> + + <h1>Design Bean Validation por Contrato</h1> + </div> + </div> + </div> + <div class="row"> + + <div class="col-md-12"> + <div class="sect1"> +<h2 id="_bean_validation_design_por_contrato">Bean Validation - Design por Contrato</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>O Bean Validation (também conhecida como JSR 303) contém um apêndice opcional que lida com validação de método.</p> +</div> +<div class="paragraph"> +<p>Algumas implementações desta JSR implementam este apêndice (Apache bval, +Hibernate validator por exemplo).</p> +</div> +<div class="paragraph"> +<p>O OpenEJB fornece um interceptador na qual permite você usar esta feature para +fazer o design por contrato.</p> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_design_por_contrato">Design por contrato</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>O objetivo é ser capaz de configurar com um grão mais fino seu contrato. No +exemplo você pode especificar os centÃmetros mÃnimos de um homem do esporte que deve pular +no salto com vara:</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>@Local +public interface PoleVaultingManager { + int points(@Min(120) int centimeters); +}</pre> +</div> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_usando">Usando</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>TomEE e OpenEJB não fornecem mais +<code>BeanValidationAppendixInterceptor</code> desde que o Bean Validation 1.1 o faz +(com um uso ligeiramente diferente, mas exatamente o mesmo recurso).</p> +</div> +<div class="paragraph"> +<p>Então basicamente você não necessita configurar qualquer coisa para usar isto.</p> +</div> +<div class="paragraph"> +<p>Se um paramentro não é validado uma exceção é lançada, é um +EJBException que envolve um <code>ConstraintViolationException</code>:</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>try { + gamesManager.addSportMan("I lose", "EN"); + fail("no space should be in names"); +} catch (EJBException wrappingException) { + assertTrue(wrappingException.getCause() instanceof ConstraintViolationException); + ConstraintViolationException exception = ConstraintViolationException.class.cast(wrappingException.getCausedByException()); + assertEquals(1, exception.getConstraintViolations().size()); +}</pre> +</div> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_exemplo">Exemplo</h2> +<div class="sectionbody"> +<div class="sect2"> +<h3 id="_olympicgamesmanager">OlympicGamesManager</h3> +<div class="literalblock"> +<div class="content"> +<pre>package org.superbiz.designbycontract; + +import javax.ejb.Stateless; +import javax.validation.constraints.NotNull; +import javax.validation.constraints.Pattern; +import javax.validation.constraints.Size; + +@Stateless +public class OlympicGamesManager { + public String addSportMan(@Pattern(regexp = "^[A-Za-z]+$") String name, @Size(min = 2, max = 4) String country) { + if (country.equals("USA")) { + return null; + } + return new StringBuilder(name).append(" [").append(country).append("]").toString(); + } +}</pre> +</div> +</div> +</div> +<div class="sect2"> +<h3 id="_polevaultingmanager">PoleVaultingManager</h3> +<div class="literalblock"> +<div class="content"> +<pre>package org.superbiz.designbycontract; + +import javax.ejb.Local; +import javax.validation.constraints.Min; + +@Local +public interface PoleVaultingManager { + int points(@Min(120) int centimeters); +}</pre> +</div> +</div> +</div> +<div class="sect2"> +<h3 id="_polevaultingmanagerbean">PoleVaultingManagerBean</h3> +<div class="literalblock"> +<div class="content"> +<pre>package org.superbiz.designbycontract; + +import javax.ejb.Stateless; + +@Stateless +public class PoleVaultingManagerBean implements PoleVaultingManager { + @Override + public int points(int centimeters) { + return centimeters - 120; + } +}</pre> +</div> +</div> +</div> +<div class="sect2"> +<h3 id="_olympicgamestest">OlympicGamesTest</h3> +<div class="literalblock"> +<div class="content"> +<pre>public class OlympicGamesTest { + private static Context context; + + @EJB + private OlympicGamesManager gamesManager; + + @EJB + private PoleVaultingManager poleVaultingManager; + + @BeforeClass + public static void start() { + Properties properties = new Properties(); + properties.setProperty(BeanContext.USER_INTERCEPTOR_KEY, BeanValidationAppendixInterceptor.class.getName()); + context = EJBContainer.createEJBContainer(properties).getContext(); + } + + @Before + public void inject() throws Exception { + context.bind("inject", this); + } + + @AfterClass + public static void stop() throws Exception { + if (context != null) { + context.close(); + } + } + + @Test + public void sportMenOk() throws Exception { + assertEquals("IWin [FR]", gamesManager.addSportMan("IWin", "FR")); + } + + @Test + public void sportMenKoBecauseOfName() throws Exception { + try { + gamesManager.addSportMan("I lose", "EN"); + fail("no space should be in names"); + } catch (EJBException wrappingException) { + assertTrue(wrappingException.getCause() instanceof ConstraintViolationException); + ConstraintViolationException exception = ConstraintViolationException.class.cast(wrappingException.getCausedByException()); + assertEquals(1, exception.getConstraintViolations().size()); + } + } + + @Test + public void sportMenKoBecauseOfCountry() throws Exception { + try { + gamesManager.addSportMan("ILoseTwo", "TOO-LONG"); + fail("country should be between 2 and 4 characters"); + } catch (EJBException wrappingException) { + assertTrue(wrappingException.getCause() instanceof ConstraintViolationException); + ConstraintViolationException exception = ConstraintViolationException.class.cast(wrappingException.getCausedByException()); + assertEquals(1, exception.getConstraintViolations().size()); + } + } + + @Test + public void polVaulting() throws Exception { + assertEquals(100, poleVaultingManager.points(220)); + } + + @Test + public void tooShortPolVaulting() throws Exception { + try { + poleVaultingManager.points(119); + fail("the jump is too short"); + } catch (EJBException wrappingException) { + assertTrue(wrappingException.getCause() instanceof ConstraintViolationException); + ConstraintViolationException exception = ConstraintViolationException.class.cast(wrappingException.getCausedByException()); + assertEquals(1, exception.getConstraintViolations().size()); + } + } +}</pre> +</div> +</div> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_executando">Executando</h2> +<div class="sectionbody"> +<div class="literalblock"> +<div class="content"> +<pre>------------------------------------------------------- + T E S T S +------------------------------------------------------- +Running OlympicGamesTest +Apache OpenEJB 4.0.0-beta-1 build: 20111002-04:06 +http://tomee.apache.org/ +INFO - openejb.home = /Users/dblevins/examples/bean-validation-design-by-contract +INFO - openejb.base = /Users/dblevins/examples/bean-validation-design-by-contract +INFO - Using 'javax.ejb.embeddable.EJBContainer=true' +INFO - Configuring Service(id=Default Security Service, type=SecurityService, provider-id=Default Security Service) +INFO - Configuring Service(id=Default Transaction Manager, type=TransactionManager, provider-id=Default Transaction Manager) +INFO - Found EjbModule in classpath: /Users/dblevins/examples/bean-validation-design-by-contract/target/classes +INFO - Beginning load: /Users/dblevins/examples/bean-validation-design-by-contract/target/classes +INFO - Configuring enterprise application: /Users/dblevins/examples/bean-validation-design-by-contract +INFO - Configuring Service(id=Default Stateless Container, type=Container, provider-id=Default Stateless Container) +INFO - Auto-creating a container for bean PoleVaultingManagerBean: Container(type=STATELESS, id=Default Stateless Container) +INFO - Configuring Service(id=Default Managed Container, type=Container, provider-id=Default Managed Container) +INFO - Auto-creating a container for bean OlympicGamesTest: Container(type=MANAGED, id=Default Managed Container) +INFO - Enterprise application "/Users/dblevins/examples/bean-validation-design-by-contract" loaded. +INFO - Assembling app: /Users/dblevins/examples/bean-validation-design-by-contract +INFO - Jndi(name="java:global/bean-validation-design-by-contract/PoleVaultingManagerBean!org.superbiz.designbycontract.PoleVaultingManager") +INFO - Jndi(name="java:global/bean-validation-design-by-contract/PoleVaultingManagerBean") +INFO - Jndi(name="java:global/bean-validation-design-by-contract/OlympicGamesManager!org.superbiz.designbycontract.OlympicGamesManager") +INFO - Jndi(name="java:global/bean-validation-design-by-contract/OlympicGamesManager") +INFO - Jndi(name="java:global/EjbModule236054577/OlympicGamesTest!OlympicGamesTest") +INFO - Jndi(name="java:global/EjbModule236054577/OlympicGamesTest") +INFO - Created Ejb(deployment-id=OlympicGamesManager, ejb-name=OlympicGamesManager, container=Default Stateless Container) +INFO - Created Ejb(deployment-id=PoleVaultingManagerBean, ejb-name=PoleVaultingManagerBean, container=Default Stateless Container) +INFO - Created Ejb(deployment-id=OlympicGamesTest, ejb-name=OlympicGamesTest, container=Default Managed Container) +INFO - Started Ejb(deployment-id=OlympicGamesManager, ejb-name=OlympicGamesManager, container=Default Stateless Container) +INFO - Started Ejb(deployment-id=PoleVaultingManagerBean, ejb-name=PoleVaultingManagerBean, container=Default Stateless Container) +INFO - Started Ejb(deployment-id=OlympicGamesTest, ejb-name=OlympicGamesTest, container=Default Managed Container) +INFO - Deployed Application(path=/Users/dblevins/examples/bean-validation-design-by-contract) +Tests run: 5, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.245 sec + +Results : + +Tests run: 5, Failures: 0, Errors: 0, Skipped: 0</pre> +</div> +</div> +</div> +</div> + </div> + + </div> + </div> +<footer> + <div class="container"> + <div class="row"> + <div class="col-sm-6 text-center-mobile"> + <h3 class="white">Be simple. Be certified. Be Tomcat.</h3> + <h5 class="light regular light-white">"A good application in a good server"</h5> + <ul class="social-footer"> + <li><a href="https://www.facebook.com/ApacheTomEE/";><i class="fa fa-facebook"></i></a></li> + <li><a href="https://twitter.com/apachetomee";><i class="fa fa-twitter"></i></a></li> + <li><a href="https://plus.google.com/communities/105208241852045684449";><i class="fa fa-google-plus"></i></a></li> + </ul> + </div> + <div class="col-sm-6 text-center-mobile"> + <div class="row opening-hours"> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../latest/docs/documentation.html" class="white">Documentation</a></h5> + <ul class="list-unstyled"> + <li><a href="../../../latest/docs/admin/configuration/index.html" class="regular light-white">How to configure</a></li> + <li><a href="../../../latest/docs/admin/file-layout.html" class="regular light-white">Dir. Structure</a></li> + <li><a href="../../../latest/docs/developer/testing/index.html" class="regular light-white">Testing</a></li> + <li><a href="../../../latest/docs/admin/cluster/index.html" class="regular light-white">Clustering</a></li> + </ul> + </div> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../latest/examples/" class="white">Examples</a></h5> + <ul class="list-unstyled"> + <li><a href="../../../latest/examples/simple-cdi-interceptor.html" class="regular light-white">CDI Interceptor</a></li> + <li><a href="../../../latest/examples/rest-cdi.html" class="regular light-white">REST with CDI</a></li> + <li><a href="../../../latest/examples/ejb-examples.html" class="regular light-white">EJB</a></li> + <li><a href="../../../latest/examples/jsf-managedBean-and-ejb.html" class="regular light-white">JSF</a></li> + </ul> + </div> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../community/index.html" class="white">Community</a></h5> + <ul class="list-unstyled"> + <li><a href="../../../community/contributors.html" class="regular light-white">Contributors</a></li> + <li><a href="../../../community/social.html" class="regular light-white">Social</a></li> + <li><a href="../../../community/sources.html" class="regular light-white">Sources</a></li> + </ul> + </div> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../security/index.html" class="white">Security</a></h5> + <ul class="list-unstyled"> + <li><a href="http://apache.org/security"; target="_blank" class="regular light-white">Apache Security</a></li> + <li><a href="http://apache.org/security/projects.html"; target="_blank" class="regular light-white">Security Projects</a></li> + <li><a href="http://cve.mitre.org"; target="_blank" class="regular light-white">CVE</a></li> + </ul> + </div> + </div> + </div> + </div> + <div class="row bottom-footer text-center-mobile"> + <div class="col-sm-12 light-white"> + <p>Copyright © 1999-2016 The Apache Software Foundation, Licensed under the Apache License, Version 2.0. Apache TomEE, TomEE, Apache, the Apache feather logo, and the Apache TomEE project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.</p> + </div> + </div> + </div> + </footer> + <!-- Holder for mobile navigation --> + <div class="mobile-nav"> + <ul> + <li><a hef="../../../latest/docs/admin/index.html">Administrators</a> + <li><a hef="../../../latest/docs/developer/index.html">Developers</a> + <li><a hef="../../../latest/docs/advanced/index.html">Advanced</a> + <li><a hef="../../../community/index.html">Community</a> + </ul> + <a href="#" class="close-link"><i class="arrow_up"></i></a> + </div> + <!-- Scripts --> + <script src="../../../js/jquery-1.11.1.min.js"></script> + <script src="../../../js/owl.carousel.min.js"></script> + <script src="../../../js/bootstrap.min.js"></script> + <script src="../../../js/wow.min.js"></script> + <script src="../../../js/typewriter.js"></script> + <script src="../../../js/jquery.onepagenav.js"></script> + <script src="../../../js/tree.jquery.js"></script> + <script src="../../../js/highlight.pack.js"></script> + <script src="../../../js/main.js"></script> + </body> + +</html> + Added: tomee/site/trunk/content/master/pt/examples/cdi-application-scope.html URL: http://svn.apache.org/viewvc/tomee/site/trunk/content/master/pt/examples/cdi-application-scope.html?rev=1866555&view=auto ============================================================================== --- tomee/site/trunk/content/master/pt/examples/cdi-application-scope.html (added) +++ tomee/site/trunk/content/master/pt/examples/cdi-application-scope.html Sat Sep 7 14:25:49 2019 @@ -0,0 +1,339 @@ +<!DOCTYPE html> +<html lang="en"> + +<head> + <meta charset="UTF-8"> + <meta http-equiv="X-UA-Compatible" content="IE=edge"> + <meta name="viewport" content="width=device-width, initial-scale=1"> + <title>Apache TomEE</title> + <meta name="description" + content="Apache TomEE is a lightweight, yet powerful, JavaEE Application server with feature rich tooling." /> + <meta name="keywords" content="tomee,asf,apache,javaee,jee,shade,embedded,test,junit,applicationcomposer,maven,arquillian" /> + <meta name="author" content="Luka Cvetinovic for Codrops" /> + <link rel="icon" href="../../../favicon.ico"> + <link rel="icon" type="image/png" href="../../../favicon.png"> + <meta name="msapplication-TileColor" content="#80287a"> + <meta name="theme-color" content="#80287a"> + <link rel="stylesheet" type="text/css" href="../../../css/normalize.css"> + <link rel="stylesheet" type="text/css" href="../../../css/bootstrap.css"> + <link rel="stylesheet" type="text/css" href="../../../css/owl.css"> + <link rel="stylesheet" type="text/css" href="../../../css/animate.css"> + <link rel="stylesheet" type="text/css" href="../../../fonts/font-awesome-4.1.0/css/font-awesome.min.css"> + <link rel="stylesheet" type="text/css" href="../../../fonts/eleganticons/et-icons.css"> + <link rel="stylesheet" type="text/css" href="../../../css/jqtree.css"> + <link rel="stylesheet" type="text/css" href="../../../css/idea.css"> + <link rel="stylesheet" type="text/css" href="../../../css/cardio.css"> + + <script type="text/javascript"> + + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-2717626-1']); + _gaq.push(['_setDomainName', 'apache.org']); + _gaq.push(['_trackPageview']); + + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + + </script> +</head> + +<body> + <div class="preloader"> + <img src="../../../img/loader.gif" alt="Preloader image"> + </div> + <nav class="navbar"> + <div class="container"> + <div class="row"> <div class="col-md-12"> + + <!-- Brand and toggle get grouped for better mobile display --> + <div class="navbar-header"> + <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + <a class="navbar-brand" href="/"> + <span> + + + <img src="../../../img/logo-active.png"> + + + </span> + Apache TomEE + </a> + </div> + <!-- Collect the nav links, forms, and other content for toggling --> + <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1"> + <ul class="nav navbar-nav navbar-right main-nav"> + <li><a href="../../../docs.html">Documentation</a></li> + <li><a href="../../../community/index.html">Community</a></li> + <li><a href="../../../security/security.html">Security</a></li> + <li><a href="../../../download-ng.html">Downloads</a></li> + </ul> + </div> + <!-- /.navbar-collapse --> + </div></div> + </div> + <!-- /.container-fluid --> + </nav> + + + <div id="main-block" class="container main-block"> + <div class="row title"> + <div class="col-md-12"> + <div class='page-header'> + + <h1>CDI @ApplicationScoped</h1> + </div> + </div> + </div> + <div class="row"> + + <div class="col-md-12"> + <div id="preamble"> +<div class="sectionbody"> +<div class="paragraph"> +<p>Este exemplo mostra o uso da anotação <code>@ApplicationScoped</code> para objetos injetados. Um objeto +que é definido como <code>@ApplicationScoped</code> é criado apenas uma vez durante toda a aplicação.</p> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_exemplo">Exemplo</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>Este cenário é similar ao do exemplo cdi-request-scope. Um visitante do restaurante pede uma sopa ao garçom. +O garçom então entrega a sopa para o visitante. Outro visitante pode pedir a mesma sopa que visitante anterior pediu - nessa situação que o <code>@ApplicationScoped</code> é usado.</p> +</div> +<div class="sect2"> +<h3 id="_garçom_waiter">Garçom (Waiter)</h3> +<div class="paragraph"> +<p>O <code>Waiter</code> session bean recebe uma requisição da classe de teste através do método <code>orderSoup()</code> passando o nome pelo parâmetro <code>soup</code> (sopa). O método <code>orderWhatTheOtherGuyHad()</code> retorna o valor (nome da sopa) do campo <code>soup</code>.</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>@Stateless +public class Waiter { + + @Inject + public Soup soup; + + public String orderSoup(String name){ + soup.setName(name); + return soup.getName(); + } + + public String orderWhatTheOtherGuyHad() { + String name = soup.getName(); + return name; + } +}</pre> +</div> +</div> +</div> +<div class="sect2"> +<h3 id="_sopa">Sopa</h3> +<div class="paragraph"> +<p>A classe <code>Soup</code> (sopa) é um POJO injetável definido como <code>@ApplicationScoped</code>. Isso significa que a instancia será criada apenas uma vez durante toda execução da aplicação. Tente mudar a anotação <code>@ApplicationScoped</code> para <code>@RequestScoped</code> e veja o que acontece.</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>@ApplicationScoped +public class Soup { + + private String name = "Soup of the day"; + + @PostConstruct + public void afterCreate() { + System.out.println("Soup created"); + } + + public String getName() { + return name; + } + + public void setName(String name){ + this.name = name; + } +}</pre> +</div> +</div> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_caso_de_teste">Caso de teste</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>Esta é a classe de entrada para este exemplo. Primeiramente é feito um pedido da sopa através do método <code>orderSoup()</code> +O atributo <code>soup</code> recebe o nome da sopa. Depois o método <code>orderWhatTheOtherGuyHad()</code> retorna a sopa do contexto da aplicação.</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>public class RestaurantTest { + + private static String TOMATO_SOUP = "Tomato Soup"; + private EJBContainer container; + + @EJB + private Waiter joe; + + @Before + public void startContainer() throws Exception { + container = EJBContainer.createEJBContainer(); + container.getContext().bind("inject", this); + } + + @Test + public void orderSoup(){ + String someSoup = joe.orderSoup(TOMATO_SOUP); + assertEquals(TOMATO_SOUP, someSoup); + + String sameSoup = joe.orderWhatTheOtherGuyHad(); + assertEquals(TOMATO_SOUP, sameSoup); + } + + @After + public void closeContainer() throws Exception { + container.close(); + } +}</pre> +</div> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_executando">Executando</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>Na saida voce pode ver que existe apenas uma instancia de <code>Soup</code> criada, apenas uma para toda a aplicação.</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>------------------------------------------------------- + T E S T S +------------------------------------------------------- +Running org.superbiz.cdi.applicationscope.RestaurantTest +Apache OpenEJB 7.0.0-SNAPSHOT build: 20111224-11:09 +http://tomee.apache.org/ +INFO - openejb.home = C:\Users\Daniel\workspaces\openejb\openejb\examples\cdi-application-scope +INFO - openejb.base = C:\Users\Daniel\workspaces\openejb\openejb\examples\cdi-application-scope +INFO - Using 'javax.ejb.embeddable.EJBContainer=true' +INFO - Configuring Service(id=Default Security Service, type=SecurityService, provider-id=Default Security Service) +INFO - Configuring Service(id=Default Transaction Manager, type=TransactionManager, provider-id=Default Transaction Manager) +INFO - Found EjbModule in classpath: c:\Users\Daniel\workspaces\openejb\openejb\examples\cdi-application-scope\target\classes +INFO - Beginning load: c:\Users\Daniel\workspaces\openejb\openejb\examples\cdi-application-scope\target\classes +INFO - Configuring enterprise application: c:\Users\Daniel\workspaces\openejb\openejb\examples\cdi-application-scope +INFO - Configuring Service(id=Default Managed Container, type=Container, provider-id=Default Managed Container) +INFO - Auto-creating a container for bean cdi-application-scope.Comp: Container(type=MANAGED, id=Default Managed Container) +INFO - Configuring Service(id=Default Stateless Container, type=Container, provider-id=Default Stateless Container) +INFO - Auto-creating a container for bean Waiter: Container(type=STATELESS, id=Default Stateless Container) +INFO - Enterprise application "c:\Users\Daniel\workspaces\openejb\openejb\examples\cdi-application-scope" loaded. +INFO - Assembling app: c:\Users\Daniel\workspaces\openejb\openejb\examples\cdi-application-scope +INFO - Jndi(name="java:global/cdi-application-scope/Waiter!org.superbiz.cdi.applicationscope.Waiter") +INFO - Jndi(name="java:global/cdi-application-scope/Waiter") +INFO - Created Ejb(deployment-id=Waiter, ejb-name=Waiter, container=Default Stateless Container) +INFO - Started Ejb(deployment-id=Waiter, ejb-name=Waiter, container=Default Stateless Container) +INFO - Deployed Application(path=c:\Users\Daniel\workspaces\openejb\openejb\examples\cdi-application-scope) +Soup created +INFO - Undeploying app: c:\Users\Daniel\workspaces\openejb\openejb\examples\cdi-application-scope +Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.42 sec + +Results : + +Tests run: 1, Failures: 0, Errors: 0, Skipped: 0</pre> +</div> +</div> +</div> +</div> + </div> + + </div> + </div> +<footer> + <div class="container"> + <div class="row"> + <div class="col-sm-6 text-center-mobile"> + <h3 class="white">Be simple. Be certified. Be Tomcat.</h3> + <h5 class="light regular light-white">"A good application in a good server"</h5> + <ul class="social-footer"> + <li><a href="https://www.facebook.com/ApacheTomEE/";><i class="fa fa-facebook"></i></a></li> + <li><a href="https://twitter.com/apachetomee";><i class="fa fa-twitter"></i></a></li> + <li><a href="https://plus.google.com/communities/105208241852045684449";><i class="fa fa-google-plus"></i></a></li> + </ul> + </div> + <div class="col-sm-6 text-center-mobile"> + <div class="row opening-hours"> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../latest/docs/documentation.html" class="white">Documentation</a></h5> + <ul class="list-unstyled"> + <li><a href="../../../latest/docs/admin/configuration/index.html" class="regular light-white">How to configure</a></li> + <li><a href="../../../latest/docs/admin/file-layout.html" class="regular light-white">Dir. Structure</a></li> + <li><a href="../../../latest/docs/developer/testing/index.html" class="regular light-white">Testing</a></li> + <li><a href="../../../latest/docs/admin/cluster/index.html" class="regular light-white">Clustering</a></li> + </ul> + </div> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../latest/examples/" class="white">Examples</a></h5> + <ul class="list-unstyled"> + <li><a href="../../../latest/examples/simple-cdi-interceptor.html" class="regular light-white">CDI Interceptor</a></li> + <li><a href="../../../latest/examples/rest-cdi.html" class="regular light-white">REST with CDI</a></li> + <li><a href="../../../latest/examples/ejb-examples.html" class="regular light-white">EJB</a></li> + <li><a href="../../../latest/examples/jsf-managedBean-and-ejb.html" class="regular light-white">JSF</a></li> + </ul> + </div> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../community/index.html" class="white">Community</a></h5> + <ul class="list-unstyled"> + <li><a href="../../../community/contributors.html" class="regular light-white">Contributors</a></li> + <li><a href="../../../community/social.html" class="regular light-white">Social</a></li> + <li><a href="../../../community/sources.html" class="regular light-white">Sources</a></li> + </ul> + </div> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../security/index.html" class="white">Security</a></h5> + <ul class="list-unstyled"> + <li><a href="http://apache.org/security"; target="_blank" class="regular light-white">Apache Security</a></li> + <li><a href="http://apache.org/security/projects.html"; target="_blank" class="regular light-white">Security Projects</a></li> + <li><a href="http://cve.mitre.org"; target="_blank" class="regular light-white">CVE</a></li> + </ul> + </div> + </div> + </div> + </div> + <div class="row bottom-footer text-center-mobile"> + <div class="col-sm-12 light-white"> + <p>Copyright © 1999-2016 The Apache Software Foundation, Licensed under the Apache License, Version 2.0. Apache TomEE, TomEE, Apache, the Apache feather logo, and the Apache TomEE project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.</p> + </div> + </div> + </div> + </footer> + <!-- Holder for mobile navigation --> + <div class="mobile-nav"> + <ul> + <li><a hef="../../../latest/docs/admin/index.html">Administrators</a> + <li><a hef="../../../latest/docs/developer/index.html">Developers</a> + <li><a hef="../../../latest/docs/advanced/index.html">Advanced</a> + <li><a hef="../../../community/index.html">Community</a> + </ul> + <a href="#" class="close-link"><i class="arrow_up"></i></a> + </div> + <!-- Scripts --> + <script src="../../../js/jquery-1.11.1.min.js"></script> + <script src="../../../js/owl.carousel.min.js"></script> + <script src="../../../js/bootstrap.min.js"></script> + <script src="../../../js/wow.min.js"></script> + <script src="../../../js/typewriter.js"></script> + <script src="../../../js/jquery.onepagenav.js"></script> + <script src="../../../js/tree.jquery.js"></script> + <script src="../../../js/highlight.pack.js"></script> + <script src="../../../js/main.js"></script> + </body> + +</html> + Added: tomee/site/trunk/content/master/pt/examples/cdi-interceptors.html URL: http://svn.apache.org/viewvc/tomee/site/trunk/content/master/pt/examples/cdi-interceptors.html?rev=1866555&view=auto ============================================================================== --- tomee/site/trunk/content/master/pt/examples/cdi-interceptors.html (added) +++ tomee/site/trunk/content/master/pt/examples/cdi-interceptors.html Sat Sep 7 14:25:49 2019 @@ -0,0 +1,466 @@ +<!DOCTYPE html> +<html lang="en"> + +<head> + <meta charset="UTF-8"> + <meta http-equiv="X-UA-Compatible" content="IE=edge"> + <meta name="viewport" content="width=device-width, initial-scale=1"> + <title>Apache TomEE</title> + <meta name="description" + content="Apache TomEE is a lightweight, yet powerful, JavaEE Application server with feature rich tooling." /> + <meta name="keywords" content="tomee,asf,apache,javaee,jee,shade,embedded,test,junit,applicationcomposer,maven,arquillian" /> + <meta name="author" content="Luka Cvetinovic for Codrops" /> + <link rel="icon" href="../../../favicon.ico"> + <link rel="icon" type="image/png" href="../../../favicon.png"> + <meta name="msapplication-TileColor" content="#80287a"> + <meta name="theme-color" content="#80287a"> + <link rel="stylesheet" type="text/css" href="../../../css/normalize.css"> + <link rel="stylesheet" type="text/css" href="../../../css/bootstrap.css"> + <link rel="stylesheet" type="text/css" href="../../../css/owl.css"> + <link rel="stylesheet" type="text/css" href="../../../css/animate.css"> + <link rel="stylesheet" type="text/css" href="../../../fonts/font-awesome-4.1.0/css/font-awesome.min.css"> + <link rel="stylesheet" type="text/css" href="../../../fonts/eleganticons/et-icons.css"> + <link rel="stylesheet" type="text/css" href="../../../css/jqtree.css"> + <link rel="stylesheet" type="text/css" href="../../../css/idea.css"> + <link rel="stylesheet" type="text/css" href="../../../css/cardio.css"> + + <script type="text/javascript"> + + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-2717626-1']); + _gaq.push(['_setDomainName', 'apache.org']); + _gaq.push(['_trackPageview']); + + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + + </script> +</head> + +<body> + <div class="preloader"> + <img src="../../../img/loader.gif" alt="Preloader image"> + </div> + <nav class="navbar"> + <div class="container"> + <div class="row"> <div class="col-md-12"> + + <!-- Brand and toggle get grouped for better mobile display --> + <div class="navbar-header"> + <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + <a class="navbar-brand" href="/"> + <span> + + + <img src="../../../img/logo-active.png"> + + + </span> + Apache TomEE + </a> + </div> + <!-- Collect the nav links, forms, and other content for toggling --> + <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1"> + <ul class="nav navbar-nav navbar-right main-nav"> + <li><a href="../../../docs.html">Documentation</a></li> + <li><a href="../../../community/index.html">Community</a></li> + <li><a href="../../../security/security.html">Security</a></li> + <li><a href="../../../download-ng.html">Downloads</a></li> + </ul> + </div> + <!-- /.navbar-collapse --> + </div></div> + </div> + <!-- /.container-fluid --> + </nav> + + + <div id="main-block" class="container main-block"> + <div class="row title"> + <div class="col-md-12"> + <div class='page-header'> + + <h1>CDI Interceptors</h1> + </div> + </div> + </div> + <div class="row"> + + <div class="col-md-12"> + <div id="preamble"> +<div class="sectionbody"> +<div class="paragraph"> +<p>Vamos escrever uma aplicação simples que nos permite comprar entradas para um filme. Como toda aplicação, log é uma das questões transversais que nós temos. +Alem disso, ha alguns métodos na nossa aplicação que só podem ser acessados no horário de trabalho. Se acessados fora do horário nos vamos lançar um <code>AccessDeniedException</code>.</p> +</div> +<div class="paragraph"> +<p>Como podemos marcar quais métodos devem ser interceptados? Não seria conveniente anotar um método desta forma:</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>@Log +public void aMethod(){...}</pre> +</div> +</div> +<div class="paragraph"> +<p>ou</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>@TimeRestricted +public void bMethod(){...}</pre> +</div> +</div> +<div class="paragraph"> +<p>Vamos criar essas anotações que vão "marcar" um método para interceptação.</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>@InterceptorBinding +@Target({ TYPE, METHOD }) +@Retention(RUNTIME) +public @interface Log { +}</pre> +</div> +</div> +<div class="paragraph"> +<p>e</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>@InterceptorBinding +@Target({ TYPE, METHOD }) +@Retention(RUNTIME) +public @interface TimeRestricted { +}</pre> +</div> +</div> +<div class="paragraph"> +<p>Garanta que voce não esqueceu a anotação <code>@InterceptorBinding</code> acima! Agora nossas anotações personalizadas estão criadas, vamos anexa-las (ou vincula-las) aos interceptores.</p> +</div> +<div class="paragraph"> +<p>Aqui esta nosso interceptor de log. Um método <code>@AroundInvoke</code> e estamos quase terminando.</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>@Interceptor +@Log //Vinculando com o interceptador aqui. Agora todo método anotado com @Log ira ser interceptado pelo logMethodEntry +public class BookForAShowLoggingInterceptor implements Serializable { + private static final long serialVersionUID = 8139854519874743530L; + private Logger logger = Logger.getLogger("BookForAShowApplicationLogger"); + @AroundInvoke + public Object logMethodEntry(InvocationContext ctx) throws Exception { + logger.info("Before entering method:" + ctx.getMethod().getName()); + InterceptionOrderTracker.getMethodsInterceptedList().add(ctx.getMethod().getName()); + InterceptionOrderTracker.getInterceptedByList().add(this.getClass().getSimpleName()); + return ctx.proceed(); + } +}</pre> +</div> +</div> +<div class="paragraph"> +<p>Agora a anotação <code>@Log</code> que nos criamos esta vinculada a esse interceptador. (Da mesma forma nos vinculamos <code>@TimeRestrict</code> para <code>TimeBasedRestrictingInterceptor</code>. Veja no código)</p> +</div> +<div class="paragraph"> +<p>Tudo pronto, vamos anotar a nÃvel de classe ou método e se divertir interceptando!</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>@Log +@Stateful +public class BookForAShowOneInterceptorApplied implements Serializable { + private static final long serialVersionUID = 6350400892234496909L; + public List<String> getMoviesList() { + List<String> moviesAvailable = new ArrayList<String>(); + moviesAvailable.add("12 Angry Men"); + moviesAvailable.add("Kings speech"); + return moviesAvailable; + } + public Integer getDiscountedPrice(int ticketPrice) { + return ticketPrice - 50; + } + // Suponha que existam mais métodos +}</pre> +</div> +</div> +<div class="paragraph"> +<p>A anotação <code>@Log</code> aplicada em nÃvel de classe denota que todos os métodos serão interceptados com <code>BookForAShowLoggingInterceptor</code>.</p> +</div> +<div class="paragraph"> +<p>Antes de dizer-mos "tudo pronto" tem apenas uma coisa que precisamos fazer! Habilitar os interceptadores!</p> +</div> +<div class="paragraph"> +<p>Vamos criar rapidamente um arquivo <code>beans.xml</code> no caminho <code>src/main/resources/META-INF/beans.xml</code>:</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre><beans> + <interceptors> + <class>org.superbiz.cdi.bookshow.interceptors.BookForAShowLoggingInterceptor + </class> + <class>org.superbiz.cdi.bookshow.interceptors.TimeBasedRestrictingInterceptor + </class> + </interceptors> +</beans></pre> +</div> +</div> +<div class="paragraph"> +<p>Por padrão, um arquivo de bean não tem interceptadores habilitados; Um interceptador deve ser explicitamente habilitado para "escutar" sua classe no arquivo <code>beans.xml</code>.</p> +</div> +<div class="paragraph"> +<p>A ordem da anotação que intercepta não importa.</p> +</div> +<div class="paragraph"> +<p>Exemplo:</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>@TimeRestrict +@Log +void cMethod(){}</pre> +</div> +</div> +<div class="paragraph"> +<p>Existe o elemento <code>interceptors</code> no <code>bean.xml</code> não apenas para "habilitar" os interceptadores, mas também define a "ordem de execução" deles. Nesse caso <code>BookForAShowLoggingInterceptor</code> vai ser aplicado primeiro e depois <code>TimeBasedRestrictingInterceptor</code></p> +</div> +<div class="paragraph"> +<p>Agora você já sabe que a ordem somente é determinada pelo elemento <code>interceptors</code> no <code>beans.xml</code>. A regra é clara, interceptadores que aparecem antes na lista são chamados primeiro.</p> +</div> +<div class="paragraph"> +<p>Perceba também que um método pode ser marcado para interceptação utilizando vários interceptors apenas adicionando a anotação acima.</p> +</div> +<div class="paragraph"> +<p>Isso traz outra questão. No caso acima nós temos dois interceptadores aplicados juntos. Mas e se nos quisermos algo como 4 interceptadores? Isso vai ir longe…​. Ter tantas anotações não deixa meu código feio?</p> +</div> +<div class="paragraph"> +<p>Não se preocupe! Apenas crie uma anotação que herda das outras</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>@Inherited +@InterceptorBinding +@Target({ TYPE, METHOD }) +@Retention(RUNTIME) +@Log +@TimeRestricted +public @interface TimeRestrictAndLog { +}</pre> +</div> +</div> +<div class="paragraph"> +<p>Este interceptador faz herança.</p> +</div> +<div class="paragraph"> +<p>O código abaixo demonstra a maioria dos casos que nos discutimos.</p> +</div> +<div class="paragraph"> +<p>Não esqueça que forma antiga de binding com <code>@Interceptors(WhicheverInterceptor.class)</code> também é suportada. De uma olhada em <code>BookForAShowOldStyleInterceptorBinding</code> onde os comentários explicam como a maneira mais nova (que conversamos acima) é melhor.</p> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_o_código">O código</h2> +<div class="sectionbody"> +<div class="sect2"> +<h3 id="_bookforashowoneinterceptorapplied">BookForAShowOneInterceptorApplied</h3> +<div class="paragraph"> +<p><code>BookForAShowOneInterceptorApplied</code> mostra apenas um simples interceptador de <code>@Log</code> sendo aplicado.</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>package org.superbiz.cdi.bookshow.beans; + +import org.superbiz.cdi.bookshow.interceptorbinding.Log; + +import javax.ejb.Stateful; +import java.io.Serializable; +import java.util.ArrayList; +import java.util.List; + +@Log +@Stateful +public class BookForAShowOneInterceptorApplied implements Serializable { + private static final long serialVersionUID = 6350400892234496909L; + + public List<String> getMoviesList() { + List<String> moviesAvailable = new ArrayList<String>(); + moviesAvailable.add("12 Angry Men"); + moviesAvailable.add("Kings speech"); + return moviesAvailable; + } + + public Integer getDiscountedPrice(int ticketPrice) { + return ticketPrice - 50; + } +}</pre> +</div> +</div> +</div> +<div class="sect2"> +<h3 id="_bookforashowtwointerceptorsapplied">BookForAShowTwoInterceptorsApplied</h3> +<div class="paragraph"> +<p><code>BookForAShowTwoInterceptorsApplied</code> mostra ambos <code>@Log</code> e <code>@TimeRestricted</code> sendo aplicados.</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>package org.superbiz.cdi.bookshow.beans; + +import org.superbiz.cdi.bookshow.interceptorbinding.Log; +import org.superbiz.cdi.bookshow.interceptorbinding.TimeRestricted; + +import javax.ejb.Stateful; +import java.io.Serializable; +import java.util.ArrayList; +import java.util.List; + +@Log +@Stateful +public class BookForAShowTwoInterceptorsApplied implements Serializable { + private static final long serialVersionUID = 6350400892234496909L; + + public List<String> getMoviesList() { + List<String> moviesAvailable = new ArrayList<String>(); + moviesAvailable.add("12 Angry Men"); + moviesAvailable.add("Kings speech"); + return moviesAvailable; + } + + @TimeRestricted + public Integer getDiscountedPrice(int ticketPrice) { + return ticketPrice - 50; + } +}</pre> +</div> +</div> +</div> +<div class="sect2"> +<h3 id="_bookshowinterceptorbindinginheritanceexplored">BookShowInterceptorBindingInheritanceExplored</h3> +<div class="paragraph"> +<p><code>BookShowInterceptorBindingInheritanceExplored</code> mostra como <code>@TimeRestrictAndLog</code> (interceptor-binding-inheritance) pode ser usado como uma alternativa em vez de anotar o método com muitas anotações explicitamente.</p> +</div> +<div class="literalblock"> +<div class="content"> +<pre>package org.superbiz.cdi.bookshow.beans; + +import org.superbiz.cdi.bookshow.interceptorbinding.TimeRestrictAndLog; + +import javax.ejb.Stateful; +import java.io.Serializable; +import java.util.ArrayList; +import java.util.List; + +@Stateful +public class BookShowInterceptorBindingInheritanceExplored implements Serializable { + private static final long serialVersionUID = 6350400892234496909L; + + public List<String> getMoviesList() { + List<String> moviesAvailable = new ArrayList<String>(); + moviesAvailable.add("12 Angry Men"); + moviesAvailable.add("Kings speech"); + return moviesAvailable; + } + + @TimeRestrictAndLog + public Integer getDiscountedPrice(int ticketPrice) { + return ticketPrice - 50; + } +}</pre> +</div> +</div> +</div> +</div> +</div> + </div> + + </div> + </div> +<footer> + <div class="container"> + <div class="row"> + <div class="col-sm-6 text-center-mobile"> + <h3 class="white">Be simple. Be certified. Be Tomcat.</h3> + <h5 class="light regular light-white">"A good application in a good server"</h5> + <ul class="social-footer"> + <li><a href="https://www.facebook.com/ApacheTomEE/";><i class="fa fa-facebook"></i></a></li> + <li><a href="https://twitter.com/apachetomee";><i class="fa fa-twitter"></i></a></li> + <li><a href="https://plus.google.com/communities/105208241852045684449";><i class="fa fa-google-plus"></i></a></li> + </ul> + </div> + <div class="col-sm-6 text-center-mobile"> + <div class="row opening-hours"> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../latest/docs/documentation.html" class="white">Documentation</a></h5> + <ul class="list-unstyled"> + <li><a href="../../../latest/docs/admin/configuration/index.html" class="regular light-white">How to configure</a></li> + <li><a href="../../../latest/docs/admin/file-layout.html" class="regular light-white">Dir. Structure</a></li> + <li><a href="../../../latest/docs/developer/testing/index.html" class="regular light-white">Testing</a></li> + <li><a href="../../../latest/docs/admin/cluster/index.html" class="regular light-white">Clustering</a></li> + </ul> + </div> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../latest/examples/" class="white">Examples</a></h5> + <ul class="list-unstyled"> + <li><a href="../../../latest/examples/simple-cdi-interceptor.html" class="regular light-white">CDI Interceptor</a></li> + <li><a href="../../../latest/examples/rest-cdi.html" class="regular light-white">REST with CDI</a></li> + <li><a href="../../../latest/examples/ejb-examples.html" class="regular light-white">EJB</a></li> + <li><a href="../../../latest/examples/jsf-managedBean-and-ejb.html" class="regular light-white">JSF</a></li> + </ul> + </div> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../community/index.html" class="white">Community</a></h5> + <ul class="list-unstyled"> + <li><a href="../../../community/contributors.html" class="regular light-white">Contributors</a></li> + <li><a href="../../../community/social.html" class="regular light-white">Social</a></li> + <li><a href="../../../community/sources.html" class="regular light-white">Sources</a></li> + </ul> + </div> + <div class="col-sm-3 text-center-mobile"> + <h5><a href="../../../security/index.html" class="white">Security</a></h5> + <ul class="list-unstyled"> + <li><a href="http://apache.org/security"; target="_blank" class="regular light-white">Apache Security</a></li> + <li><a href="http://apache.org/security/projects.html"; target="_blank" class="regular light-white">Security Projects</a></li> + <li><a href="http://cve.mitre.org"; target="_blank" class="regular light-white">CVE</a></li> + </ul> + </div> + </div> + </div> + </div> + <div class="row bottom-footer text-center-mobile"> + <div class="col-sm-12 light-white"> + <p>Copyright © 1999-2016 The Apache Software Foundation, Licensed under the Apache License, Version 2.0. Apache TomEE, TomEE, Apache, the Apache feather logo, and the Apache TomEE project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.</p> + </div> + </div> + </div> + </footer> + <!-- Holder for mobile navigation --> + <div class="mobile-nav"> + <ul> + <li><a hef="../../../latest/docs/admin/index.html">Administrators</a> + <li><a hef="../../../latest/docs/developer/index.html">Developers</a> + <li><a hef="../../../latest/docs/advanced/index.html">Advanced</a> + <li><a hef="../../../community/index.html">Community</a> + </ul> + <a href="#" class="close-link"><i class="arrow_up"></i></a> + </div> + <!-- Scripts --> + <script src="../../../js/jquery-1.11.1.min.js"></script> + <script src="../../../js/owl.carousel.min.js"></script> + <script src="../../../js/bootstrap.min.js"></script> + <script src="../../../js/wow.min.js"></script> + <script src="../../../js/typewriter.js"></script> + <script src="../../../js/jquery.onepagenav.js"></script> + <script src="../../../js/tree.jquery.js"></script> + <script src="../../../js/highlight.pack.js"></script> + <script src="../../../js/main.js"></script> + </body> + +</html> +
