Getting Started(Create new web site)

(For windows machine)

Install

1. Install  Apache Tomcat 6.0 and  Eclipse IDE for Java EE Developers(Ganymede-SR1).
2. Get Acornsnap from DownloadInstallers page, and install it(Acornsnap will overwrap Apache Tomcat installation).
3. Install Eclipse plugin(sorry, it is manualy at the moment).
   1. The plugin(jar file) named "jp.co.lumber_mill.acorn3_tools_1.0.0.jar" had been placed at your desktop.
   2. Move the jar file into Eclipse's dropins folder.
   3. If installation is successful, you can see the icon of acorn in the toolbar.
   4. If the icon does not exist, try to relaunch by "eclipse.exe -clean".
4. Launch eclipse with Java EE perspective, and do the following.
   1. Pursue along "Window > Preferences > Web", and set encoding to "ISO 10646/Unicode(UTF-8)" in CSS,HTML and JSP Files.
   2. Create new server(Tomcat 6.0) in Servers view(if the server already exists, delete it first).
   3. Create new Dynamic Web Project.
   4. Copy all files(and directories) from "$TOMCAT_HOME\webapps\acorn3-blank" to new project's "WebContent" folder(You will overwrite "WEB-INF" folder which already exists).
   5. Right-click on "WebContent/index.jsp", and pursue along "Run as > Run On Server" and click "Finish" button(without any changes).
5. If you see the message "Welcome aboard", You accomplish!

And if the Eclipse pluing installed successfully, you see the icon below in Eclipse toolbar.

Make first action

In this section, we make a simple chat page(like  Twitter) named Lwitter.

1. Making your own application will proceed along MVC, rough scheme is given as follows:
   1. Create data definitions in "WebContent/WEB-INF/db".
   2. Generate models in "src/models".
   3. Generate controllers in "src/controllers".
   4. Generate views in "WebContent/WEB-INF/views".
   5. Run on server and testing it. If you add new objects in data definitions, you may need to "Clean.." server(on Servers view).
2. First, stop Server(on Servers view) and right-click on "Tomcat v6.0" to execute "Clean..".
3. Create new file named "WebContent/WEB-INF/db/dd.sql", and edit it as below:

   CREATE TABLE lwitter (
   id INTEGER NOT NULL IDENTITY,
   created_at TIMESTAMP NOT NULL DEFAULT now(),
   userid VARCHAR NOT NULL DEFAULT 'anonymous',
   mumble VARCHAR NOT NULL DEFAULT '',
   PRIMARY KEY(id)
   );
   

4. Generate a model from lwitter table. Acornsnap's model(M) is a subclass of ActiveRecord class. Generated code is below:

   package models;
   
   public class LwitterRecord extends jp.co.lumber_mill.database.ActiveRecord{
   
     @jp.co.lumber_mill.database.PrimaryKey
     @jp.co.lumber_mill.database.NotNull
     public java.lang.Integer id;
   
     @jp.co.lumber_mill.database.NotNull
     public java.sql.Timestamp created_at;
   
     @jp.co.lumber_mill.database.NotNull
     public java.lang.String userid;
   
     @jp.co.lumber_mill.database.NotNull
     public java.lang.String mumble;
   
     @Override
     public String getTableName() {
       return "lwitter";
     }
   
     @Override
     public String[] getNames() {
       return new String[]{"id","created_at","userid","mumble"};
     }
   
     @Override
     public String[] getNamesAsLabel() {
       return new String[]{"ID","CREATED_AT","USERID","MUMBLE"};
     }
   }
   

   package models;
   
   public class LwitterModel extends LwitterRecord {
   
   }
   

5. Generate controller named "Lwitter" and related views. Acornsnap's controller(C) is a subclass of AbstractController. And each action is defined as its public method. In this case, index method(=action) is only created. Acornsnap's view(V) is a plain JSP have same name as the method. In this case, the view is "index.jsp" in "WebContent?/WEB-INF/views/lwitter" folder.
6. Edit "src/controllers/Lwitter.java" as below:

   package controllers;
   
   import jp.co.lumber_mill.acornsnap.AbstractController;
   import jp.co.lumber_mill.database.Order;
   import models.LwitterModel;
   
   public class Lwitter extends AbstractController {
   
     @Override
     public void index() throws Exception {
       if("post".equalsIgnoreCase(request.getMethod())){
         LwitterModel lm = new LwitterModel();
         map(lm);
         save(lm);
       }
       
       LwitterModel lms[] = findAll(new LwitterModel(), 1, 20, null, Order.create("created_at DESC"));
       request.setAttribute("lms", lms);
     }
   }
   

7. Edit "WebContent/WEB-INF/views/lwitter/index.jsp" as below:

   <%@ page language="java" contentType="text/html; charset=UTF-8"
       pageEncoding="UTF-8"%>
   <%@page import="models.LwitterModel"%>
   <%@page import="jp.co.lumber_mill.html.Form"%>    
   <%
     LwitterModel[] lms = (LwitterModel[]) request.getAttribute("lms");
     Form form = new Form("index",Form.POST);
     form.setModel(new LwitterModel());
   %>
   <%= form.begin() %>
     <%= form.createTextInput("userid",6) %>
     <%= form.createTextInput("mumble",30) %>
     <%= form.createSubmitButton("Submit") %>
   <%= form.end() %>
   <hr/>
   <%
     if(lms == null || lms.length == 0){
       out.println("<p>No data.</p>");
     }else{
       out.println("<table style='width: 100%'>");
       for(int i=0;i<lms.length;i++){
   %>
     <tr><td><%= lms[i].userid %></td><td><%= lms[i].mumble %></td></tr>
   <%      
       }
       out.println("</table>");
     }
   %>
   

8. Finally, start the server(on Servers view), and open the url http://localhost:8080/(Name of your project)/action/lwitter/index.

Followings are all you have created.

• (your project)
  • Java Resources: src/
    • controllers/
      • Lwitter.java
    • models/
      • LwitterModel.java
      • LwitterRecord.java
  • WebContent/
    • WEB-INF/
      • db/
        • dd.sql
      • views/
        • lwitter/
          • index.jsp

Deploy to server machine

(For linux machine)

In this section, We will deploy and run webapp into a server machine running with  Fedora.

First, you need to install Apache Tomcat 6.0 using 'yum' command, and give a user the authority to execute any command as root and tomcat user via 'visudo' command.

# service sshd start
# yum -y install tomcat6
# visudo 

(visudo's example:)

#Defaults  requiretty -- Comment out or remove this line.

username ALL =(root,tomcat) NOPASSWD: ALL

Then you may need to create database directory if you want to store the files of databases.

# mkdir /var/lib/tomcat6/databases
# chown root:tomcat /var/lib/tomcat6/databases

Once you've got them, back to Eclipse(with Acornsnap plugin).

1. Select the web project, and click Acornsnap's toolbar icon(Acornsnap tools will launch).
2. Pursue along "Action > Deploy to remote host..".
3. Add new host formatted as "username@hostname:sshport", and keep selecting the row.
4. Check "Send acornsnap files". You need it only first.
5. Click "Deploy".