MyBooks

MyBooks is a simple web application developed with Mentawai. A great number of Mentawai features, like data lists, dynamic messages, validation, authentication, connection pooling, custom tags, etc. are used in this application. It also illustrates the design pattern DAO + IoC.

To play with the MyBooks application you can click here.

There are two different implementations for the MyBooks application:

MyBooks-ACTION.zip - Action and Business Model are separated. Action is coupled to Mentawai. Business Model is not coupled.

MyBooks-POJO.zip - Action and Business Model are together in a single class totally decoupled from the Mentawai framework.

To get a feeling about the Mentawai programmatic configuration for a complete application, take a look in the ApplicationManagers below:

MyBooks-ACTION ApplicationManager.java

package org.mentawai.mybooks;

// imports here...

public class ApplicationManager extends org.mentawai.core.ApplicationManager {
   
   private ConnectionHandler connHandler = null;

public void init(Context application) {

// turn-on debug mode
      setDebugMode(true);

// ConnectionPool (ConnectionHandler)
      this.connHandler = new C3P0ConnectionHandler("com.mysql.jdbc.Driver", "jdbc:mysql://localhost/mybooks?autoReconnect=true", "mybooks", "mybooks");

}

@Override
   public void loadActions() {
      
      filter(new ExceptionFilter());
      on(EXCEPTION, fwd("/error.jsp"));

// Authentication for all actions (except for the ones that implement AuthenticationFree)
      filter(new AuthenticationFilter());
      on(LOGIN, redir("/login.jsp")); // global consequence

// Validation for all actions that implement Validatable
      filter(new ValidatorFilter());
      
      // Connection Pooling
      filter(new ConnectionFilter("connection", connHandler));

// IoC (Inversion of Control)
      filter(new IoCFilter());
      
      // IoC services (Business Model)
      ioc("userService", UserService.class);
      ioc("bookService", BookService.class);
      ioc("loginService", LoginService.class);
      ioc("registrationService", RegistrationService.class);
      
      // IoC components (DAOs)
      ioc("userDAO", MySQLUserDAO.class);
      ioc("bookDAO", MySQLBookDAO.class);
      ioc("userBooksDAO", MySQLUserBooksDAO.class);
      ioc("transaction", JdbcTransaction.class);

// Auto-wiring
      filter(new DIFilter());
      
      // Dependencies
      di("connection", Connection.class); // DAOs depend on Connection
      
      di("userDAO", UserDAO.class); // Services depend on DAOs
      di("bookDAO", BookDAO.class);
      di("userBooksDAO", UserBooksDAO.class);

// Injection
      filter(new InjectionFilter());
      
      // LoginAction
      action(LoginAction.class, "login")
         .on(SUCCESS, redir("/welcome.jsp"))
         .on(ERROR, fwd("/login.jsp"));

// RegistrationAction
      action(RegistrationAction.class, "register")
         .on(SUCCESS, redir("/welcome.jsp"))
         .on(ERROR, fwd("/registration.jsp"));
      
      // BookAction.searchToAdd
      action(BookAction.class, "searchToAdd")
         .on(SUCCESS, fwd("/book/showbooks.jsp"))
         .on(NOBOOKS, fwd("/book/createbook.jsp"))
         .on(ERROR, fwd("/welcome.jsp"));

// BookAction.search
      action(BookAction.class, "search")
         .on(SUCCESS, fwd("/book/search.jsp"));

// BookAction.addToUser
      action(BookAction.class, "addToUser")
         .on(SUCCESS, fwd("/welcome.jsp"))
         .on(ERROR, fwd("/book/showbooks.jsp"))
         .on(ALREADYHASBOOK, fwd("/welcome.jsp"));

// BookAction.create
      action(BookAction.class, "create")
         .on(SUCCESS, fwd("/book/createbook.jsp"))
         .on(ERROR, redir("/welcome.jsp"));

// BookAction.createAndAddToUser
      action(BookAction.class, "createAndAddToUser")
         .on(SUCCESS, fwd("/welcome.jsp"))
         .on(ERROR, fwd("/book/createbook.jsp"))
         .on(BOOKALREADYCREATED, fwd("/welcome.jsp"))
         .filter(new TransactionFilter("transaction")); // make this action atomic...

// BookAction.show
      action(BookAction.class, "show")
         .on(SUCCESS, fwd("/book/show.jsp"))
         .on(ERROR, redir("/"));

// BookAction.remove
      action(BookAction.class, "remove")
         .on(ERROR, redir("/welcome.jsp"))
         .on(SUCCESS, fwd("/welcome.jsp"));
      
      // UserAction.search
      action(UserAction.class, "search")
         .on(SUCCESS, fwd("/user/search.jsp"));

// UserAction.show
      action(UserAction.class, "show")
         .on(SUCCESS, fwd("/user/show.jsp"))
         .on(ERROR, redir("/"));

// LogoutAction
      action(LogoutAction.class)
         .on(SUCCESS, redir("/"));
      
   }
}

MyBooks-POJO ApplicationManager.java

package org.mentawai.mybooks;

// imports here...

public class ApplicationManager extends org.mentawai.core.ApplicationManager {
   
   private ConnectionHandler connHandler = null;

public void init(Context application) {

// turn-on debug mode
      setDebugMode(true);

// ConnectionPool (ConnectionHandler)
      this.connHandler = new C3P0ConnectionHandler("com.mysql.jdbc.Driver", "jdbc:mysql://localhost/mybooks?autoReconnect=true", "mybooks", "mybooks");

}

@Override
   public void loadActions() {
      
      filter(new ExceptionFilter());
      on(EXCEPTION, fwd("/error.jsp"));

// Authentication for all actions (except for the ones that implement AuthenticationFree)
      filter(new AuthenticationFilter());
      on(LOGIN, redir("/login.jsp")); // global consequence
      
      // Pojo Action Filter Stack
      filter(PojoAction.getFilterStack());

// Connection Pooling
      filter(new ConnectionFilter("connection", connHandler));

// IoC (Inversion of Control)
      filter(new IoCFilter());
      
      // IoC components (DAOs)
      ioc("userDAO", MySQLUserDAO.class);
      ioc("bookDAO", MySQLBookDAO.class);
      ioc("userBooksDAO", MySQLUserBooksDAO.class);
      ioc("transaction", JdbcTransaction.class);

// Auto-wiring
      filter(new DIFilter());
      
      // Dependencies
      di("connection", Connection.class); // DAOs depend on Connection
      
      // Injection
      filter(new InjectionFilter());
      
      // LoginAction
      action("/LoginAction", LoginService.class, "login")
         .filter(new AuthenticationFreeMarkerFilter())
         .filter(new LoginServiceValidation())
         .on(SUCCESS, redir("/welcome.jsp"))
         .on(ERROR, fwd("/login.jsp"));

// RegistrationAction
      action("/RegistrationAction", RegistrationService.class, "register")
         .filter(new RegistrationServiceValidation())
         .filter(new AuthenticationFreeMarkerFilter())
         .on(SUCCESS, redir("/welcome.jsp"))
         .on(ERROR, fwd("/registration.jsp"));
      
      // BookAction.searchToAdd
      action("/BookAction", BookService.class, "searchToAdd")
         .filter(new BookServiceValidation())
         .on(SUCCESS, fwd("/book/showbooks.jsp"))
         .on(NOBOOKS, fwd("/book/createbook.jsp"))
         .on(ERROR, fwd("/welcome.jsp"));

// BookAction.search
      action("/BookAction", BookService.class, "search")
         .on(SUCCESS, fwd("/book/search.jsp"));

// BookAction.addToUser
      action("/BookAction", BookService.class, "addToUser")
         .on(SUCCESS, fwd("/welcome.jsp"))
         .on(ERROR, fwd("/book/showbooks.jsp"))
         .on(ALREADYHASBOOK, fwd("/welcome.jsp"));

// BookAction.create
      action("/BookAction", BookService.class, "create")
         .on(SUCCESS, fwd("/book/createbook.jsp"))
         .on(ERROR, redir("/welcome.jsp"));

// BookAction.createAndAddToUser
      action("/BookAction", BookService.class, "createAndAddToUser")
         .filter(new BookServiceValidation())
         .on(SUCCESS, fwd("/welcome.jsp"))
         .on(ERROR, fwd("/book/createbook.jsp"))
         .on(BOOKALREADYCREATED, fwd("/welcome.jsp"))
         .filter(new TransactionFilter("transaction")); // make this action atomic...

// BookAction.show
      action("/BookAction", BookService.class, "show")
         .on(SUCCESS, fwd("/book/show.jsp"))
         .on(ERROR, redir("/"));

// BookAction.remove
      action("/BookAction", BookService.class, "remove")
         .on(ERROR, redir("/welcome.jsp"))
         .on(SUCCESS, fwd("/welcome.jsp"));
      
      // UserAction.search
      action("/UserAction", UserService.class, "search")
         .on(SUCCESS, fwd("/user/search.jsp"));

// UserAction.show
      action("/UserAction", UserService.class, "show")
         .on(SUCCESS, fwd("/user/show.jsp"))
         .on(ERROR, redir("/"));

// LogoutAction
      action(LogoutAction.class)
         .on(SUCCESS, redir("/"));
      
   }
}