[GitHub] [tomee] gabrielferreirapro commented on a change in pull request #513: TOMEE-2572 - translation of cdi-produces-field

[GitBox <gi...@apache.org>]

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:
users@infra.apache.org


With regards,
Apache Git Services