Lightweight JavaEE

with Guice

(c) copyright 2013 nuboat in wonderlandSunday, June 16, 13

About MeCTO & Co-Founder @ Signature App House

Software Architecture @ FICO.com

Blogger at thjug.blogspot.com

Twitter Addict

Programmer lover <3

(c) copyright 2013 nuboat in wonderlandSunday, June 16, 13

RequirementJava SDK 7u21 or latest

Netbeans JavaEE 7.3 or latest

PostgreSQL 9.2 or latest

Chrome Browser latest version

Postman - REST Client

(c) copyright 2013 nuboat in wonderlandSunday, June 16, 13

TopicsNetbeans - Create Development Test Deploy

Maven - Library Management

Servlet + JAX-RS - RESTful Webservice

Guice - Transaction & Dependency Injection

JPA - Object Relational Mapping

Shiro - Encrypt Password

TestNG - Unit Test Framework

(c) copyright 2013 nuboat in wonderlandSunday, June 16, 13

Netbeans

NetBeans IDE lets you quickly and easily develop Java desktop, mobile, and web applications, while also providing great tools for PHP and C/C++ developers. It is free and open source and has a large community of users and developers around the world.

Best Support for Latest Java Technologies

NetBeans IDE provides first-class comprehensive support for the newest Java technologies and latest Java enhancements before other IDEs. It is the first IDE providing support for JDK 7, Java EE 7, and JavaFX 2.

With its constantly improving Java Editor, many rich features and an extensive range of tools, templates and samples, NetBeans IDE sets the standard for developing with cutting edge technologies out of the box

Sunday, June 16, 13

MavenStandard Build Infrastructure

Build Tool

Dependency Management Tool

Quality Tool

Opensource Apache Project

(c) copyright 2013 nuboat in wonderland

http://thjug.blogspot.com/2013/04/what-is-maven-1.html

Sunday, June 16, 13

MVN Standard Directory

(c) copyright 2013 nuboat in wonderland

my-app|-- pom.xml|-- target|-- src |-- main | `-- java | `-- resources | `-- webapp | |-- test `-- java `-- resources

Sunday, June 16, 13

Jersey

Jersey is the open source, production quality, JAX-RS (JSR 311 & JSR 339) Reference Implementation for building RESTful Web services. But, it is also more than the Reference Implementation. Jersey provides an API so that developers may extend Jersey to suit their needs.

Sunday, June 16, 13

GuiceGoogle Guice (pronounced "juice")[1] is an open source software framework for the Java platform released by Google under the Apache License. It provides support for dependency injection using annotations to configure Java objects.[2] Dependency injection is a design pattern whose core principle is to separate behavior from dependency resolution.

Example@InjectLogger Logger logger;@Inject SigninFacade facade;@Inject EntityManager em;

Sunday, June 16, 13

JPADevelopment of a new version of JPA, namely JPA 2.0 JSR 317 was started in July 2007. JPA 2.0 was approved as final on December 10, 2009.The focus of JPA 2.0 was to address features that were present in some of the popular ORM vendors but couldn't gain consensus approval for JPA 1.0.The main features included in this update are:• Expanded object-relational mapping functionality

• support for collections of embedded objects, linked in the ORM with a many-to-one relationship

• multiple levels of embedded objects• ordered lists• combinations of access types

• A criteria query API• standardization of query 'hints'[clarify]

• standardization of additional metadata to support DDL generation• support for validation

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

Create Project

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

Create Project

Sunday, June 16, 13

pom.xmlModel Attribute

(c) copyright 2013 nuboat in wonderland

<modelVersion>4.0.0</modelVersion>

<groupId>com.thjug</groupId> <artifactId>Services</artifactId> <version>1.0-SNAPSHOT</version> <packaging>war</packaging>

<name>Services</name>

<properties> <endorsed.dir>${project.build.directory}/endorsed</endorsed.dir> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties>

Sunday, June 16, 13

pom.xmlRepositories Attribute

(c) copyright 2013 nuboat in wonderland

! <repositories>! ! <repository>! ! ! <id>EclipseLink</id>! ! ! <url>http://download.eclipse.org/rt/eclipselink/maven.repo</url>! ! </repository>! </repositories>

Sunday, June 16, 13

pom.xmlServlet Dependency

(c) copyright 2013 nuboat in wonderland

! ! <dependency>! ! ! <groupId>org.apache.openejb</groupId>! ! ! <artifactId>javaee-api</artifactId>! ! ! <version>6.0-5</version>! ! </dependency>! ! <dependency>! ! ! <groupId>com.sun.jersey</groupId>! ! ! <artifactId>jersey-server</artifactId>! ! ! <version>1.17.1</version>! ! </dependency>! ! <dependency>! ! ! <groupId>com.sun.jersey</groupId>! ! ! <artifactId>jersey-servlet</artifactId>! ! ! <version>1.17.1</version>! ! </dependency>! ! <dependency>! ! ! <groupId>com.sun.jersey.contribs</groupId>! ! ! <artifactId>jersey-guice</artifactId>! ! ! <version>1.17.1</version>! ! </dependency>

Sunday, June 16, 13

pom.xmlCommon Dependency

(c) copyright 2013 nuboat in wonderland

! ! <dependency>! ! ! <groupId>commons-lang</groupId>! ! ! <artifactId>commons-lang</artifactId>! ! ! <version>2.6</version>! ! </dependency>! ! <dependency>! ! ! <groupId>commons-io</groupId>! ! ! <artifactId>commons-io</artifactId>! ! ! <version>2.4</version>! ! </dependency>! ! <dependency>! ! ! <groupId>commons-fileupload</groupId>! ! ! <artifactId>commons-fileupload</artifactId>! ! ! <version>1.3</version>! ! </dependency>

Sunday, June 16, 13

pom.xmlGuice Dependency

(c) copyright 2013 nuboat in wonderland

! ! <dependency>! ! ! <groupId>com.google.inject</groupId>! ! ! <artifactId>guice</artifactId>! ! ! <version>3.0</version>! ! </dependency>! ! <dependency>! ! ! <groupId>com.google.inject.extensions</groupId>! ! ! <artifactId>guice-servlet</artifactId>! ! ! <version>3.0</version>! ! </dependency>! ! <dependency>! ! ! <groupId>com.google.inject.extensions</groupId>! ! ! <artifactId>guice-persist</artifactId>! ! ! <version>3.0</version>! ! </dependency>

Sunday, June 16, 13

pom.xmlModel Dependency

(c) copyright 2013 nuboat in wonderland

! ! <dependency>! ! ! <groupId>postgresql</groupId>! ! ! <artifactId>postgresql</artifactId>! ! ! <version>9.1-901-1.jdbc4</version>! ! </dependency>! ! <dependency>! ! ! <groupId>org.eclipse.persistence</groupId>! ! ! <artifactId>eclipselink</artifactId>! ! ! <version>2.5.0</version>! ! ! <exclusions>! ! ! ! <exclusion>! ! ! ! ! <artifactId>commonj.sdo</artifactId>! ! ! ! ! <groupId>commonj.sdo</groupId>! ! ! ! </exclusion>! ! ! </exclusions>! ! </dependency>

Sunday, June 16, 13

pom.xmlLogging Dependency

(c) copyright 2013 nuboat in wonderland

! ! <dependency>! ! ! <groupId>ch.qos.logback</groupId>! ! ! <artifactId>logback-classic</artifactId>! ! ! <version>1.0.13</version>! ! </dependency>! ! <dependency>! ! ! <groupId>commons-logging</groupId>! ! ! <artifactId>commons-logging</artifactId>! ! ! <version>1.1.3</version>! ! </dependency>

Sunday, June 16, 13

pom.xmlSecurity Dependency

(c) copyright 2013 nuboat in wonderland

! ! <dependency>! ! ! <groupId>org.apache.shiro</groupId>! ! ! <artifactId>shiro-core</artifactId>! ! ! <version>1.2.2</version>! ! </dependency>

Sunday, June 16, 13

pom.xmlTest Dependency

(c) copyright 2013 nuboat in wonderland

! ! <dependency>! ! ! <groupId>org.testng</groupId>! ! ! <artifactId>testng</artifactId>! ! ! <version>6.8.5</version>! ! ! <scope>test</scope>! ! </dependency>

Sunday, June 16, 13

web.xml

(c) copyright 2013 nuboat in wonderland

! <display-name>Services</display-name>! <filter>! ! <filter-name>guiceFilter</filter-name>! ! <filter-class>com.google.inject.servlet.GuiceFilter</filter-class>! </filter>! <filter-mapping>! ! <filter-name>guiceFilter</filter-name>! ! <url-pattern>/*</url-pattern>! </filter-mapping>! <listener>! ! <description>Guice Initiate</description>! ! <listener-class>com.thjug.base.ServletContextListener</listener-class>! </listener>! <welcome-file-list>! ! <welcome-file>index.jsp</welcome-file>! </welcome-file-list>

Sunday, June 16, 13

web.xml

(c) copyright 2013 nuboat in wonderland

! <display-name>Services</display-name>! <filter>! ! <filter-name>guiceFilter</filter-name>! ! <filter-class>com.google.inject.servlet.GuiceFilter</filter-class>! </filter>! <filter-mapping>! ! <filter-name>guiceFilter</filter-name>! ! <url-pattern>/*</url-pattern>! </filter-mapping>! <listener>! ! <description>Guice Initiate</description>! ! <listener-class>com.thjug.base.ServletContextListener</listener-class>! </listener>! <welcome-file-list>! ! <welcome-file>index.jsp</welcome-file>! </welcome-file-list>

Sunday, June 16, 13

logback.xml

(c) copyright 2013 nuboat in wonderland

<?xml version="1.0" encoding="UTF-8"?><configuration>! <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">! ! <layout class="ch.qos.logback.classic.PatternLayout">! ! ! <Pattern>%d{HH:mm:ss.SSS} %logger{0} - %msg%n</Pattern>! ! </layout>! </appender>

! <logger name="com.thjug" level="DEBUG"/>

! <root level="debug">! ! <appender-ref ref="STDOUT" />! </root></configuration>

Sunday, June 16, 13

persistence.xml

(c) copyright 2013 nuboat in wonderland

<?xml version="1.0" encoding="UTF-8"?><persistence version="2.0" xmlns="http://java.sun.com/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd">! <persistence-unit name="dbUnit" transaction-type="RESOURCE_LOCAL">! ! <provider>org.eclipse.persistence.jpa.PersistenceProvider</provider>! ! <class>com.thjug.entity.Account</class>! ! <class>com.thjug.entity.History</class>! ! <shared-cache-mode>ENABLE_SELECTIVE</shared-cache-mode>! ! <properties>! ! ! <property name="eclipselink.logging.level" value="FINE"/>! ! ! <property name="eclipselink.logging.parameters" value="true"/>! ! ! <property name="javax.persistence.jdbc.driver" value="org.postgresql.Driver"/>! ! ! <property name="javax.persistence.jdbc.url" value="jdbc:postgresql://localhost:5432/training"/>! ! ! <property name="javax.persistence.jdbc.user" value="training"/>! ! ! <property name="javax.persistence.jdbc.password" value="password"/>! ! </properties>! </persistence-unit></persistence>

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

import com.google.inject.Guice;import com.google.inject.Injector;import com.google.inject.Singleton;import com.google.inject.persist.jpa.JpaPersistModule;import com.google.inject.servlet.GuiceServletContextListener;import com.sun.jersey.guice.JerseyServletModule;import com.sun.jersey.guice.spi.container.servlet.GuiceContainer;import com.sun.jersey.spi.container.servlet.ServletContainer;import com.thjug.restws.Echo;import com.thjug.restws.Signin;import com.thjug.restws.Status;

public class ServletContextListener extends GuiceServletContextListener {! @Override! protected Injector getInjector() {! ! final Injector injector = Guice.createInjector(new JerseyServletModule() {! ! ! @Override! ! ! protected void configureServlets() {! ! ! ! bind(Echo.class);! ! ! ! bind(Status.class);! ! ! ! bind(Signin.class);! ! ! ! bind(ServletContainer.class).in(Singleton.class);! ! ! ! serve("/rest/*").with(GuiceContainer.class);! ! ! }! ! }, new JpaPersistModule("dbUnit"));! ! injector.getInstance(JPAInitializer.class);! ! return injector;! }}

ServletContextListener.java

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

import com.google.inject.Inject;import com.google.inject.Singleton;import com.google.inject.persist.PersistService;

@Singletonpublic final class JPAInitializer {

! @Inject! public JPAInitializer(final PersistService service) {! ! service.start();! }

}

JPAInitializer.java

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

import javax.ws.rs.GET;import javax.ws.rs.Path;import javax.ws.rs.core.Response;

@Path("/status")public final class Status {

! @GET! public final Response getJson() {! ! return Response.status(200).entity("live!").build();! }

}

Status.java

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

import javax.ws.rs.GET;import javax.ws.rs.Path;import javax.ws.rs.PathParam;import javax.ws.rs.Produces;import javax.ws.rs.core.MediaType;import javax.ws.rs.core.Response;import org.slf4j.Logger;import org.slf4j.LoggerFactory;

@Path("/echo")public final class Echo {

! private static final Logger LOG = LoggerFactory.getLogger(Echo.class);

! @GET! @Path("/{param}")! @Produces(MediaType.APPLICATION_JSON)! public final Response getJson(@PathParam("param") final String msg) {! ! final String echomsg = msg.length() <= 24 ? msg : msg.substring(0, 24);

! ! LOG.info("Echo: {}", echomsg);! ! return Response.status(200).entity(echomsg).build();! }

}

Echo.java

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

import com.google.inject.Inject;import com.thjug.facade.SigninFacade;import javax.ws.rs.FormParam;import javax.ws.rs.POST;import javax.ws.rs.Path;import javax.ws.rs.core.Response;import org.slf4j.Logger;import org.slf4j.LoggerFactory;

@Path("/signin")public final class Signin {! private static final Logger LOG = LoggerFactory.getLogger(Signin.class);! @Inject! private SigninFacade facade;! @POST! public final Response getJson(! ! ! @FormParam("username") final String username,! ! ! @FormParam("password") final String password) {! ! LOG.info("Username: {} Password: {}", username, password);! ! String result;! ! try {! ! ! result = (facade.authen(username, password)) ? "pass" : "fail";! ! } catch (final Exception e) {! ! ! LOG.error(e.getMessage(), e);! ! ! result = e.getMessage();! ! }! ! return Response.status(200).entity(result).build();! }}

Signin.java

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

public enum Enable {

! T('T', "True"),! F('F', "False");! private char id;! private String text;

! private Enable(final char id, final String text) {! ! this.id = id;! ! this.text = text;! }

! public char getId() {! ! return id;! }

! public String getText() {! ! return text;! }}

Enum - Enable.java

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

@Entity@Table(name = "ACCOUNT")@NamedQueries({! @NamedQuery(name = Account.countAll, query = "SELECT COUNT(a) FROM Account a"),! @NamedQuery(name = Account.findByUsername, query = "SELECT a FROM Account a WHERE UPPER(a.username) = ?1"),})public class Account implements Serializable {

! private static final long serialVersionUID = 1L;! public static final String countAll = "Account.countAll";! public static final String findByUsername = "Account.findByUsername";

! @Id! @Basic(optional = false)! @NotNull! @Column(name = "id", nullable = false)! @SequenceGenerator(name = "account_seq_gen", sequenceName = "account_id_seq", allocationSize = 1)! @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "account_seq_gen")! private Integer id;

.......! @Basic(optional = false)! @NotNull! @Size(min = 1, max = 64)! @Column(name = "username")! private String username;

......

Entity - Account.java

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

@Inject! private transient Provider<EntityManager> provider;

! public T create(final T entity) {! ! getEntityManager().persist(entity);! ! return entity;! }

! public T find(final Object id) {! ! return getEntityManager().getReference(entityClass, id);! }

! public T edit(final T entity) {! ! return getEntityManager().merge(entity);! }

! public void remove(final T entity) {! ! getEntityManager().remove(getEntityManager().merge(entity));! }

! protected EntityManager getEntityManager() {! ! return this.provider.get();! }

CRUD - Create Read Update Delete

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

! protected <S> S findOne(final String namequery, final Object... param) {! ! final Query q = getEntityManager().createNamedQuery(namequery);! ! for (int i = 0; i < param.length; i++) {! ! ! q.setParameter(i + 1, param[i]);! ! }! ! return (S) q.getSingleResult();! }! protected List<T> findAll(final String namequery, final Object... param) {! ! final Query q = getEntityManager().createNamedQuery(namequery);! ! for (int i = 0; i < param.length; i++) {! ! ! q.setParameter(i + 1, param[i]);! ! }! ! return q.getResultList();! }! protected List<T> findRange(final String namequery, final int offset, final int limit, final Object... param) {! ! final Query q = getEntityManager().createNamedQuery(namequery);! ! for (int i = 0; i < param.length; i++) {! ! ! q.setParameter(i + 1, param[i]);! ! }! ! if (limit != 0) {! ! ! q.setMaxResults(limit);! ! }! ! if (offset != 0) {! ! ! q.setFirstResult(offset);! ! }! ! return q.getResultList();! }

AbstractService<T>.java

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

Facade Pattern

http://java.dzone.com/articles/design-patterns-uncovered-1

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

Facade Pattern in Project

Signin SigninFacade

SigninService

HistoryService

Client Facade

Class 1

Class 2

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

import com.google.inject.ImplementedBy;import com.thjug.facade.impl.SigninFacadeImpl;

@ImplementedBy(value = SigninFacadeImpl.class)public interface SigninFacade {

! public boolean authen(final String username, final String password)! ! ! throws Exception;}

SigninFacade.java

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

import com.thjug.facade.*;import com.google.inject.Inject;import com.google.inject.persist.Transactional;import com.thjug.entity.Account;import com.thjug.service.AccountService;import org.apache.shiro.crypto.hash.Sha256Hash;

public class SigninFacadeImpl implements SigninFacade {

! @Inject! AccountService accountService;! @Inject! HistoryService historyService;

! @Override! @Transactional! public boolean authen(final String username, final String password)! ! ! throws Exception {! ! final Account account = accountService.findByUsername(username.toUpperCase());! ! final String cyphertext = new Sha256Hash(password).toHex();! ! final boolean result = (cyphertext.equals(account.getPasswd())) ? true : false;

! ! historyService.keepLog("authen", account, Boolean.toString(result));! ! return result;! }}

SigninFacadeImpl.java

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

import com.thjug.entity.Account;

public class AccountService extends AbstractService<Account> {

! public AccountService() {! ! super(Account.class);! }

! public Account findByUsername(final String username) throws Exception {! ! return findOne(Account.findByUsername, username);! }

}

AccountService.java

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

import com.thjug.entity.Account;import com.thjug.entity.History;

public class HistoryService extends AbstractService<History> {

! public HistoryService() {! ! super(History.class);! }

! public void keepLog(final String action, final Account account, final String result) {! ! // TODO! }

}

HistoryService.java

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

import com.google.inject.Guice;import com.google.inject.Injector;import com.google.inject.persist.jpa.JpaPersistModule;import com.thjug.base.JPAInitializer;

public abstract class AbstractFacadeNGTest {

! protected final Injector injector;

! public AbstractFacadeNGTest() {! ! injector = Guice.createInjector(new JpaPersistModule("dbUnit"));! ! injector.getInstance(JPAInitializer.class);! }

}

AbstractFacadeNGTest.java

Sunday, June 16, 13

(c) copyright 2013 nuboat in wonderland

import static org.testng.Assert.*;import org.testng.annotations.Test;

public class SigninFacadeImplNGTest extends AbstractFacadeNGTest {

! @Test! public void testAuthen() throws Exception {! ! String username = "admin";! ! String password = "password";! ! SigninFacadeImpl instance = injector.getInstance(SigninFacadeImpl.class);

! ! boolean expResult = true;! ! boolean result = instance.authen(username, password);! ! assertEquals(result, expResult);! }}

SigninFacadeImplNGTest.java

Sunday, June 16, 13

Source Code Availableon

https://github.com/nuboat/Services

git clone git@github.com:nuboat/Services.git

(c) copyright 2013 nuboat in wonderlandSunday, June 16, 13

THANK YOU :)

(c) copyright 2013 nuboat in wonderlandSunday, June 16, 13