gabrielferreirapro commented on a change in pull request #513: TOMEE-2572 -
translation of cdi-produces-field
URL: https://github.com/apache/tomee/pull/513#discussion_r303254965
##########
File path: examples/cdi-produces-field/README_pt.adoc
##########
@@ -0,0 +1,295 @@
+= CDI Field Producer
+:index-group: CDI
+:jbake-type: page
+:jbake-status: published
+
+Este exemplo mostra o uso da anotação `@Produces`. `@Produces` é um mecanismo
do CDI que permite definir uma fonte para injeção. Este exemplo mostra uma das
duas formas de declarar um producer. Ao invés de um produces method (veja no
exemplo CDI-produces-disposes), um producer field pode ser usado. Um producer
field pode ser usado ao invés de um simples método getter. Isso pode ser usado
para injetar recursos como, contexto de persistência. Uma ressalva para o uso
de produces fields sobre produces method é que um método `@Disposes` não pode
ser usado junto de um `@Produces` field.
+
+Para o proposito deste exemplo, `type` é hard-coded em um valor especifico.
Uma implementação de Logger deve conter uma lista de LogHandlers. Nós devemos
ter três implementações da interface LogHandler.
+
+* Uma DatabaseHandler
+* Uma FileHandler
+* Uma ConsoleHandler
+
+A implementação DatabaseHandler aparentemente gravaria os logs em um banco de
dados. O FileHandler gravaria os mesmos logs em um arquivo. E o ConsoleHandler
apenas imprimiria os logs no console. Este exemplo é apenas uma ilustração de
como os conceitos dentro do CDI funcionam e não tem a intenção de fornecer uma
implementação/design de estrutura de log.
+
+== ConsoleHandler
+
+....
+package org.superbiz.cdi.produces.field;
+
+public class ConsoleHandler implements LogHandler {
+
+ private String name;
+
+ public ConsoleHandler(String name) {
+ this.name = name;
+ }
+
+ @Override
+ public String getName() {
+ return name;
+ }
+
+ @Override
+ public void writeLog(String s) {
+ System.out.printf("##### Handler: %s, Writing to the console!\n",
getName());
+ }
+}
+....
+
+== DatabaseHandler
+
+....
+package org.superbiz.cdi.produces.field;
+
+public class DatabaseHandler implements LogHandler {
+
+ private String name;
+
+ public DatabaseHandler(String name) {
+ this.name = name;
+ }
+
+ @Override
+ public String getName() {
+ return name;
+ }
+
+ @Override
+ public void writeLog(String s) {
+ System.out.printf("##### Handler: %s, Writing to the database!\n",
getName());
+ // Use connection to write log to database
+ }
+}
+....
+
+== FileHandler
+
+....
+package org.superbiz.cdi.produces.field;
+
+public class FileHandler implements LogHandler {
+
+ private String name;
+
+ public FileHandler(String name) {
+ this.name = name;
+ }
+
+ @Override
+ public String getName() {
+ return name;
+ }
+
+ @Override
+ public void writeLog(String s) {
+ System.out.printf("##### Handler: %s, Writing to the file!\n",
getName());
+ // Escreve para o arquivo de log
+ }
+}
+....
+
+== LogFactory
+
+....
+package org.superbiz.cdi.produces.field;
+
+import javax.enterprise.inject.Produces;
+
+public class LogFactory {
+
+ private int type = 2;
+
+ @Produces
+ LogHandler handler;
+
+ public LogFactory(){
+ handler = getLogHandler();
+ }
+
+ public LogHandler getLogHandler() {
+ switch (type) {
+ case 1:
+ return new FileHandler("@Produces created FileHandler!");
+ case 2:
+ return new DatabaseHandler("@Produces created
DatabaseHandler!");
+ case 3:
+ default:
+ return new ConsoleHandler("@Produces created ConsoleHandler!");
+ }
+
+ }
+}
+....
+
+== Logger
+
+....
+package org.superbiz.cdi.produces.field;
+
+public interface Logger {
+
+ public void log(String s);
+
+ public LogHandler getHandler();
+}
+....
+
+== LoggerImpl
+
+....
+package org.superbiz.cdi.produces.field;
+
+import javax.inject.Inject;
+import javax.inject.Named;
+
+@Named("logger")
+public class LoggerImpl implements Logger {
+
+ @Inject
+ private LogHandler handler;
+
+ @Override
+ public void log(String s) {
+ getHandler().writeLog(s);
+ }
+
+ public LogHandler getHandler() {
+ return handler;
+ }
+}
+....
+
+== LogHandler
+
+....
+package org.superbiz.cdi.produces.field;
+
+public interface LogHandler {
+
+ public String getName();
+
+ public void writeLog(String s);
+}
+....
+
+== beans.xml
+
+....
+<beans xmlns="http://java.sun.com/xml/ns/javaee";
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+ xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
+ http://java.sun.com/xml/ns/javaee/beans_1_0.xsd";>
+
+</beans>
+....
+
+== LoggerTest
+
+....
+package org.superbiz.cdi.produces.field;
+
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+
+import javax.ejb.embeddable.EJBContainer;
+import javax.inject.Inject;
+import javax.naming.Context;
+
+import static junit.framework.Assert.assertNotNull;
+import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertTrue;
+
+public class LoggerTest {
+
+ @Inject
+ Logger logger;
+
+ private Context ctxt;
+
+ @Before
+ public void setUp() {
+ try {
+ ctxt = EJBContainer.createEJBContainer().getContext();
+ ctxt.bind("inject", this);
+ } catch (Exception e) {
+ e.printStackTrace();
+ }
+ }
+
+ @After
+ public void cleanUp() {
+ try {
+ ctxt.unbind("inject");
+ ctxt.close();
+ } catch (Exception e) {
+ e.printStackTrace();
+ }
+ }
+
+ @Test
+ public void testLogHandler() {
+ assertNotNull(logger);
+ assertFalse("Handler should not be a ConsoleHandler",
logger.getHandler() instanceof ConsoleHandler);
+ assertFalse("Handler should not be a FileHandler", logger.getHandler()
instanceof FileHandler);
+ assertTrue("Handler should be a DatabaseHandler", logger.getHandler()
instanceof DatabaseHandler);
+ logger.log("##### Testing write\n");
+ logger = null;
+ }
+
+}
+....
+
+= Running
Review comment:
Fixed, thanks!
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
With regards,
Apache Git Services
