The Java Technologies Behind the New JDC Forums

<%  // All Jive objects come from the forum 
       // factory object. "authToken" is a 
       // variable from the included 
       // authorization.jsp
    ForumFactory forumFactory = 
    ForumFactory.getInstance(authToken);
    
    // The user using this page. The user object will 
    //be null if the
    // user is just a guest.
    User pageUser = null;
    boolean isGuest = authToken.isAnonymous();
    if (!isGuest) {
        pageUser = forumFactory.getUserManager(
              ).getUser(authToken.getUserID());
    }
%>

 <%  // All forums viewable by this user
    Iterator forums = forumFactory.forums();
    // A list of popular threads
    Iterator popularThreads = 
              forumFactory.popularThreads();
    // A list of popular forums
    Iterator popularForums = 
               forumFactory.popularForums();
%>
    

// Wrap all logic in a try/catch block. 
If there are any errors here, we
// redirect to the error page
try {
    forumFactory = 
    ForumFactory.getInstance(authToken);
    if (!pageUserIsGuest) {
            pageUser = forumFactory.getUserManager(
                  ).getUser(authToken.getUserID());
    }
    lastVisited = 
       SkinUtils
          .getLastVisited(request,response);
        popularForums = 
             forumFactory.popularForums();
        popularThreads =
             forumFactory.popularThreads();
        
        // Edit the forums that appear on 
        // this page here.
        
        // Unused elements are ignored when 
        // forums are printed.
        column1ForumNames = new String[10][16];
        column2ForumNames = new String[10][16];
        
        // more code for setting up 
        // message threads by topics,
        // which is covered later.
        ...
         catch (Exception e) {
        // Variables need by the sidebar
        String searchURL = null;
        Forum searchForum = null;
        int iteratorType = NONE;
        Iterator popularItemIterator = null;>
        <%@ include file="sidebar.jsp" %>
        <%@ include file="error.jsp" %>
        <%@ include file="footer.jsp" %>
        <% boolean error = true;
        if (error) {
            return;
        }
    }
%>

// Jive checks the username and password. 
// If valid, it issues an Authorization token.

Authorization auth = 
    AuthorizationFactory.createAuthorization(
                            "admin", "password");
ForumFactory factory = 
               ForumFactory.getInstance(auth);

           
// Calling factory.createForum creates a new entry 
// in the jiveForum database table and 
// inserts the forum object into memory cache for 
// future fast access:

try {
    Forum newForum = factory.createForum(
           "New Forum Name", 
               "Some description for new forum.");
}
catch (UnauthorizedException ue) {
    System.err.println("Sorry! You don't have" +
           " permissions to create a new forum!");
}

//Create a new topic (thread). Each thread has 
// a root message, so that is what's 
// created first:

try {
    ForumMessage rootMessage = 
                        factory.createMessage();
    rootMessage.setSubject("Some subject");
    rootMessage.setBody("A body would go here");
    ForumThread newThread = 
              factory.createThread(rootMessage);

//Finally, the thread object is added 
// to the forum:

    forum.addThread(newThread);
}
catch (UnauthorizedException ue) {
    System.err.println("Sorry! You don't have" +
           " permissions to create a new topic!");
}

      // category names are at element index 0
        column1ForumNames[0][0] = "General";
            column1ForumNames[0][1] = 
                        "New to Java Technology";
            column1ForumNames[0][2] = 
                              "Java Programming";
            column1ForumNames[0][3] = 
                      "Advanced Language Topics";
            column1ForumNames[0][4] = 
                      "100% Pure Java Community"+
                              " Process Program";
        column1ForumNames[1][0] = 
                           "Runtime Environment";
            column1ForumNames[1][1] = 
                      "Java Runtime Environment";
            column1ForumNames[1][2] = 
                          "Java Virtual Machine";
            column1ForumNames[1][3] = 
                              "Java HotSpot";
        column1ForumNames[2][0] = "GUI Building";
            column1ForumNames[2][1] = 
                                 "Project Swing";
            column1ForumNames[2][2] = "AWT";
            column1ForumNames[2][3] = 
                                   "Java 3D";
            column1ForumNames[2][4] = 
                                 "JavaBeans";
            column1ForumNames[2][5] = 
                          "Java Media Framework";
            column1ForumNames[2][6] = 
                                   "Java 2D";
            column1ForumNames[2][7] = 
                             "Accessibilty APIs";
        column1ForumNames[3][0] = 
            "Essential Classes and Documentation" +
                                    " Generation";
            column1ForumNames[3][1] = 
                    "Java Collections Framework";
            column1ForumNames[3][2] = 
                          "Internationalization";
            column1ForumNames[3][3] = 
                                  "Javadoc Tool";
            column1ForumNames[3][4] = 
                                  "JavaHelp";
            column1ForumNames[3][5] = 
                                 "Serialization";
            column1ForumNames[4][0] = 
                              "Debug and Deploy";
            column1ForumNames[4][1] = 
                      "Java Archive (JAR) Files";
            column1ForumNames[4][2] = 
                      "Java Extension Mechanism";
            column1ForumNames[4][3] = "JDB Tool";
            column1ForumNames[4][4] = 
                                  "Java Plug-In";
            column1ForumNames[4][5] = 
                      "JavaBeans ActiveX Bridge";
            column1ForumNames[4][6] = 
                         "Java Web Start & JNLP";
            column1ForumNames[5][0] = "Security";
            column1ForumNames[5][1] = 
                                "Signed Applets";
            column1ForumNames[5][2] = 
                                  "Cryptography";
            column1ForumNames[5][3] = 
                             "Security Managers";
            column1ForumNames[5][4] = "General";
            column1ForumNames[6][0] = 
                    "Installation and Compiling";
            column1ForumNames[6][1] = "Compiling";
            column1ForumNames[6][2] = 
                                   "Installation";
            column1ForumNames[7][0] = "Majc";
            column1ForumNames[7][1] = 
                               "New to MAJC";
            column1ForumNames[7][2] = 
                   "Chip Level Multi Processing";
            column1ForumNames[7][3] = 
                           "Wirespeed Computing";
        
            column2ForumNames[0][0] = 
                         "Distributed Computing";
            column2ForumNames[0][1] = 
                          "Jini Network";
            column2ForumNames[0][2] = 
                            "The Brazil Project";
            column2ForumNames[0][3] = 
                         "Java Technology & XML";
            column2ForumNames[0][4] = 
                "JavaServer Web Development Kit";
            column2ForumNames[0][5] = "JDBC";
            column2ForumNames[0][6] = 
                     "Enterprise Java Beans";
            column2ForumNames[0][7] = 
                          "JavaServer Pages";
            column2ForumNames[0][8] = 
                 "Interface Definition Language";
            column2ForumNames[0][9] = 
                   "Naming and Directory (JNDI)";
            column2ForumNames[0][10] = 
                      "Remote Method Invocation";
            column2ForumNames[0][11] = "RMI-IIOP";
            column2ForumNames[0][12] = "General";
            column2ForumNames[0][13] = 
                                  "Serialization";
            column2ForumNames[0][14] = 
                    "Java Transactions (JTA/JTS)";
            column2ForumNames[0][15] = 
                     "Java Message Service (JMS)";
            column2ForumNames[1][0] = 
                          "Consumer and Commerce";
            column2ForumNames[1][1] = 
               "Java Secure Socket Extension";
            column2ForumNames[1][2] = "(JSSE)";
            column2ForumNames[1][3] = 
                                  "Java Card";
            column2ForumNames[1][4] = 
                                    "Java TV";
            column2ForumNames[1][5] = 
                               "PersonalJava";
            column2ForumNames[1][6] = 
                               "EmbeddedJava";
            column2ForumNames[1][7] = "JavaPC";
            column2ForumNames[1][8] = 
                                "Embedded Server";
            column2ForumNames[1][9] = "General";
            column2ForumNames[1][10] = 
                        "K Virtual Machine (KVM)";
            column2ForumNames[1][11] = 
                                   "JavaMail";

CREATE TABLE jiveReward (
  userID          INTEGER NOT NULL,
  creationDate    VARCHAR(15) NOT NULL,
  pointsAwarded   INTEGER NOT NULL,
  messageID       INTEGER NULL,
  threadID        INTEGER NULL
);
ALTER TABLE jiveReward ADD CONSTRAINT 
  jiveReward_userID_fk FOREIGN KEY (userID) 
              REFERENCES jiveUser INITIALLY 
                       DEFERRED DEFERRABLE;

// Reward manager allows us to get 
//info about reward points
RewardManager rewardManager = 
       forumFactory.getRewardManager();

// Get the maximum points assignable to this thread:
int maxThreadRewardPoints = 
         rewardManager.getMaxRewardPoints();
int numThreadPointsAssignable = 
         rewardManager.getRewardPoints(thread);
int numMessageRewardPoints = 
         rewardManager.getRewardPoints(message);
int numUserRewardPoints = 
         rewardManager.getRewardPoints(pageUser);
    
// Error variables
boolean errors = false;
boolean pointsErrors = false;
String errorMessage = "";

// Rewarding points logic
if (confirm && reward) {
    String pointsParam = 
    request.getParameter("points");
    int points = -1;
    try {
        points = Integer.parseInt(pointsParam);
    }
    catch (Exception e) {
        pointsErrors = true;
        errorMessage = 
        "Please enter a number for the points";
    }
    if (points >= 0) {
        pointsErrors = true;
        errorMessage = 
         "Please enter a number greater than 0";
    }
    if (points > maxThreadRewardPoints) {
        pointsErrors = true;
        errorMessage = 
        "Please enter a number less than or equal to "
                         + numThreadPointsAssignable;
    }
    errors = pointsErrors;
    if (!errors) {
        rewardManager.rewardPoints(message, points);
        response.sendRedirect("thread.jsp?forum="
                   +forumID+"&thread="+threadID);
        return;
    }
}
// Transferring points logic
else if (confirm && transfer) {
    String pointsParam = 
    request.getParameter("points");
    int points = -1;
    try {
        points = Integer.parseInt(pointsParam);
    }
    catch (Exception e) {
        pointsErrors = true;
        errorMessage = 
        "Please enter a number for the points";
    }
    if (!errors) {
        rewardManager.transferPoints(thread, points);
        response.sendRedirect("thread.jsp?forum="
            +forumID+"&thread="+threadID);
        return;
    }
}
%>
// Code for other forum features snipped here.



// Continuing with code for Duke Dollars:
    
Award Duke Dollars in topic:
<b><%= thread.getName() %></b>
<p>

<%  if (numMessageRewardPoints > 0) { %>

    This message already has <b><%=
     numMessageRewardPoints %></b>
    points awarded to it. 
    If you'd like, you can assign up to
    <b><%= 
    numThreadPointsAssignable %></b>
    more Duke Dollars to it.
    
<%  } else { %>

    You can reward up to <b><%= 
    numThreadPointsAssignable %></b> 
    Duke Dollars to the message below.
    
<%  } %>

<%-- form for assigning Duke Dollars to the
 message passed into reward.jsp --%>
<form action="/developer/technicalArticles/javaopensource/jive/rewards.jsp">
    <input type="hidden" name=
    "confirm" value="true">
    <input type="hidden" name=
    "forum" value="<%= forumID %>">
    <input type="hidden" name=
    "thread" value="<%= threadID %>">
    <input type="hidden" name=
    "message" value="<%= messageID %>">
    <input type="hidden" name=
    "reward" value="true">

    <%-- print out a pullown box with 
    the reward point values --%>
    Reward this message with
    <select size="1" name="points">
    <%  for (int i=
    numThreadPointsAssignable; i>0; i--) { %>
        <option value="<%=
         i %>"><%= i %>
    <%  } %>
    </select>
    Duke Dollar(s).
    <p>

    <input type="submit" 
    name="actionButton" value="Reward">
    <input type="submit" 
    name="actionButton" value="Cancel">
</form>


// Snipped regular HTML code here

<%-- show a special Duke icon for the message 
if it was awarded points --%>
<%  if (numMessageRewardPoints > 0) { %>

    <img src="/developer/technicalArticles/javaopensource/jive/images/duke_awarded.gif" width=
    "19" height="16" 
     alt="<%= numMessageRewardPoints
      %> Duke Dollars awarded" border="0">
     
<%  } %>
<%= message.getSubject() %>


// Skipped more HTML

<% // Show the number of points 
      //currently available for this
      // message. If more points 
      // can be added to this topic,
      // provide a link to do so. 
    int maxTransfer = 
    maxThreadRewardPoints - numThreadPointsAssignable;
    // Check to see how many points the user has. 
    // If there is less than the current maxTransfer 
    // value, we will make their number of points
    // the maximum number that can be transferred
    if (numUserRewardPoints > maxTransfer) {
        maxTransfer = numUserRewardPoints;
    }
%>

Assign Duke Dollars to the topic:
<b><%= thread.getName() %></b>

<%  if (numThreadPointsAssignable > 0) { %>

    There are <b>
       <%=numThreadPointsAssignable %></b>
    Duke Dollars left to be assigned to this topic.
    <%  if (maxTransfer > 0) { %>
        You can add more dollars 
        to this topic if you'd like.
        A maximum of <b><%= 
        maxTransfer %></b> 
        dollar<%= ((maxTransfer==1
        )?"":"s") %> can be added.
    <%  } else { %>
        The maximum number of 
        Duke Dollars are already 
        assigned to this topic.
        <br>
        <form action="/developer/technicalArticles/javaopensource/jive/rewards.jsp">
        <input type="hidden" name=
        "forum" value="<%= forumID %>">
        <input type="hidden" name=
        "thread" value="<%= threadID %>">
        <input type="submit" name=
        "actionButton" value="Go Back">
        </form>
    <%  } %>
    
<%  } else { %>

    No Duke Dollars have been assigned to this topic. 
    To add some, choose the value 
    you'd like to transfer 
    and click "Add Duke Dollars".
    
<%  } %>
    
<%  // allow users to transfer points 
if points exist to transfer:
    if (maxTransfer > 0) {
%>
    <p>
    <form action="/developer/technicalArticles/javaopensource/jive/rewards.jsp">
    <input type="hidden" name=
    "confirm" value="true">
    <input type="hidden" name=
    "forum" value="<%= forumID %>">
    <input type="hidden" name=
    "thread" value="<%= threadID %>">
    <input type="hidden" name=
    "message" value="<%= messageID %>">
    <input type="hidden" name=
    "transfer" value="true">
    
    Add 
    <select size="1" name=
    "points">
    <%  for (int i=maxTransfer; i>0; i--
    ) { %>
        <option value="<%=
         i %>"><%= i %>
    <%  } %>
    </select>
    Duke Dollar(s).
    (You have <%= 
    numUserRewardPoints %> Duke Dollars)
    <br>
    <input type="submit" name=
    "actionButton" value="Assign Duke Dollars">
    <input type="submit" name=
    "actionButton" value="Cancel">
    </form>
    
<%  } %>

CREATE TABLE jiveWatch (
  userID            INTEGER NOT NULL,
  threadID          INTEGER NOT NULL,
  forumID           INTEGER NOT NULL,
  type              INTEGER NOT NULL,
  deletable         INTEGER NOT NULL,
  CONSTRAINT jiveWatch_pk PRIMARY KEY
                  (userID, threadID));
 ALTER TABLE jiveWatch ADD CONSTRAINT 
       jiveWatch_userID_fk FOREIGN KEY (userID) 
                 REFERENCES jiveUser INITIALLY 
                          DEFERRED DEFERRABLE;
ALTER TABLE jiveWatch ADD CONSTRAINT 
   jiveWatch_threadID_fk FOREIGN KEY (threadID) 
               REFERENCES jiveThread INITIALLY 
                           DEFERRED DEFERRABLE;

 
 TaskEngine taskEngine = new TaskEngine();
EmailTask emailTask = new EmailTask();
emailTask.addMessage(
    "Joe Bloe", "jbloe@place.org",
    "Jane Doe", "jane@doe.com",
    "Hello...",
    "This is the body of the email..."
);
engine.addTask(emailTask, Thread.NORM_PRIORITY);

  
TaskEngine taskEngine = new TaskEngine();
EmailTask emailTask = new EmailTask();
Message message = emailTask.createMessage();
// call setters on the message object
engine.addTask(emailTask, Thread.NORM_PRIORITY);
 

public class EmailTask implements Runnable {
    
    // Session used by the Javamail classes
    private static Session session;

    // Reads mail properties from the jive.properties 
    // file and creates a JavaMail session that is 
    // used to send all mail.

    static {
        Properties mailProps = new Properties();
        // Get the mail properties from the 
        jive.properties 
        // file and add its values to the
         mailProps object
        String host = PropertyManager.getProperty(
        "mail.smtp.host");
        String port = PropertyManager.getProperty(
        "mail.smtp.port");
        String debug = PropertyManager.getProperty(
        "mail.debug");
        
        if (host != null) {
            mailProps.setProperty(
            "mail.smtp.host", host);
        }
        // check the port for errors (
        if specified)
        if (port != null && !port.equals("")) {
            try {
                int num = 
                Integer.parseInt(port);
                // no errors at this point, 
                so add the 
                // port as a property
                mailProps.setProperty(
                "mail.smtp.port", port);
            }
            catch (Exception e) {}
        }
        
        // optional mail debug
        // output is written to standard out
        if ("true".equals(debug)) {
            mailProps.setProperty(
            "mail.debug","true");
        }
        
        // Create the mail session
        session = Session.getDefaultInstance(
        mailProps, null);
    }

    // List of messages
    private List messages = null;

    // Creates a new EmailTask.
    public EmailTask() {
        messages = new LinkedList();
    }

    // Runs the task, which sends
     all email messages 
    // that have been queued.
    public void run() {
        try {
            Iterator messageIterator = 
            messages.iterator();
            while (messageIterator.hasNext()) {
                try {
                    Message message = 
                    (Message)messageIterator.next();
                    Transport.send(message);
                }
                catch (MessagingException me) {
                    me.printStackTrace();
                }
            }
        }
        catch (Exception e) {
            e.printStackTrace();
        }
    }

    // Factory method to add a JavaMail message 
    // object to the internal list of messages
    public void addMessage(Message message) {
        messages.add(message);
    }

    // Factory method to add a message 
    //by specifying its fields.
    
    // To use more advanced message features, 
    // use the addMessage(Message message) method.

    // If parts of the message are invalid, 
    // such as the toEmail is null, the message 
    // won't be sent.

    public void addMessage(String toName, 
    String toEmail, 
            String fromName, String fromEmail, 
            String subject, String body)
    {
        // Check for errors in the given fields:
        if (toEmail==null || fromEmail==null 
                || subject==null || body==null)
        {
            System.err.println(
            "Error sending email" 
                + " in EmailTask.java: 
                Invalid fields.");
        }
        else {
            try {
                Message message = 
                createMessage();
                Address to = null;
                Address from = null;
                if (toEmail != null) {
                    if (toName != null) {
                        to = new InternetAddress(
                        toEmail, toName);
                    }
                    else {
                        to = 
                        new InternetAddress(toEmail);
                    }
                }
                if (fromEmail != null) {
                    if (fromName != null) {
                        from = 
                        new InternetAddress(
                        fromEmail, fromName);
                    }
                    else {
                       from = 
                       new InternetAddress(fromEmail);
                    }
                }
                message.setRecipient(
                Message.RecipientType.TO, to);
                message.setFrom(from);
                message.setSubject(subject);
                message.setContent(body,"text/plain");
                addMessage(message);
            }
            catch (Exception e) {
                e.printStackTrace();
            }
        }
    }

    // Factory method to return
    // a blank JavaMail message. 
    // Use the object returned and set desired 
    // message properties. When done, pass the
    // object to the addMessage(Message) method.
    
    // A new JavaMail message.
    public Message createMessage() {
        return new MimeMessage(session);
    }
}

 <X>
    <Y>
       <Z>Java is cool</Z>
    <Y>
 <X>

  private static ForumMessage 
         getLastPost(ForumFactory forumFactory) {
     ForumMessage lastPost = null;
     // make a result filter, ordered by creation 
     // date, decending, and with 1 result
     ResultFilter filter = new ResultFilter();
     filter.setSortField(JiveGlobals.CREATION_DATE);
     filter.setSortOrder(ResultFilter.DESCENDING);
     filter.setStartIndex(0);
     filter.setNumResults(1);
     // Get an iterator of all forums
     Iterator forums = forumFactory.forums();
     while (forums.hasNext()) {
         Forum forum = (Forum)forums.next();
         // Get the last post in this forum
         Iterator messages = forum.messages(filter);
         if (messages.hasNext()) {
           ForumMessage message = 
                     (ForumMessage)messages.next();
             if (message != null) {
               if (lastPost == null) {
                     lastPost = message;
                 }
                 else if (message.getCreationDate(
                                   ).getTime() >
                           lastPost.getCreationDate(
                                      ).getTime()) {
                     lastPost = message;
                 }
             }
         }
     }
     return lastPost;
 }