Groups

A user creates a group and other, who are interested int the topic, join the group and they share messages, links, and files.

This application can be used in any intranet enviornment like a company or college.

Technologies and Products used

• Tomcat 4.x
• Oracle8i
• Java Server Pages (JSP)
• Java Beans
• Commons-fileupload library
• Java Mail
• Mail Server - CMailServer

Major Operations

The following are the major operations of this application:

Operation	Description	Related Files and Objects
Login page	Allows user to log into the application using user name and password.	login.jsp, UserBean Javabean
Forgot password	Send password of the user as mail to user's email address by taking username	forgotpassword.jsp, JavaMail API
Home page	Display details of groups to which user is a member and other links such as Search For Group, Join A Group, Change Password etc.	home.jsp , UserBean JavaBean
Change Password	Allows user to change his/her password.	changepassword.jsp, UserBean JavaBean
Log out	Allows user to log out of the application.	logout.jsp
Create Group	Takes group name and description and creates a new group.	creategroup.html, creategroup.jsp, UserBean JavaBean, GroupBean JavaBean
Search Groups	Searches for groups based on name, description and creation date.	searchgroup.jsp, listgroups.jsp
Join group	Displays list of groups to which current user is a member and allows user to join the selected group.	othergroups.jsp,listgroups.jsp, GroupBean JavaBean, UserBean JavaBean
Manage Group	Allows the owner of the group to change group details or delete group.	managegroup.jsp, GroupBean JavaBean, deletegroup stored procedure.
Group Home	Displays details of the selected group and links related to group.	grouphome.jsp , UserBean JavaBean
Leave group	Allows user to leave the group.	leavegroup.jsp, GroupBean JavaBean, UserBean JavaBean
List Messages	Displays messages of the current group. Provides link to post new message.	messages.jsp
Post Message	Takes message subject and body and adds message.	postmessage.jsp, MessageBean JavaBean, UserBean JavaBean
Delete Message	Deletes the message. Only owner of the message can delete the message.	deletemessage.jsp, MessageBean JavaBean
List Files	Displays files of the current group. Provides link to add new file.	files.jsp
Add File	Allows user to upload file from client. It takes name of the file and description. File is copies into files directory of the application in the server.	addfile.jsp, commons-fileupload library, UserBean JavaBean.
Delete File	Deletes the file. Only owner of the file can delete the file.	deletefile.jsp
Invite Others	Allows user to send mail to others with invitaion message.	invite.html, invite.jsp, JavaMail API, UserBean JavaBean

Note:

• Create Table commands to create realated to this application are placed in tables.sql file.
• Links related code is left to students as assignment.

Steps To Run Application

The following are the steps to related to be taken to run this application :

1. Download groups.zip and unzip it into webapps directory of Tomcat installation directory. A directory with the name groups is created.
2. Make sure you copy classes111.zip ( after renaming it to classes111.jar) or classes12.jar into WEB-INF/lib directory
3. Copycommons-fileupload.jar WEB-INF/lib directory. You can find this file in Jakarta Struts.
4. Set the PATH and CLASSPATH using the batch file S.BAT that is placed in /WEB-INF/classes/groups directory. Make necessary changes to S.BAT according to location of JDK and TOMCAT in your system.
5. Compile JavaBean in /WEB-INF/classes/groups directory as follows:

        javac *.java
      

6. Create account groups with password groups in Oracle Database. If you cannot do this, you can still use SCOTT account with TIGER password. Then palce tables in SCOTT account instead of GROUPS account.
   Make sure you change username and password in DBUtil.java accordingly.
7. Log onto Oracle using either groups account or scott account.
8. Create required tables in Oracle using tables.sql file.
9. Create files folder in webapps/groups directory.
10. Make sure CMailServer is running and create email accounts for users in it.
11. If you are using other than Tomcat 4.0 then copy JavaMail related jar files to WEB-INF/lib directory. You can down load JavaMail from java.sun.com.
12. Run the application using the following url:

       http://localhost:8080/groups
     

13. You should see login page of the application.

Deploying Application In Weblogic Server

1. Copy groups application to some directory inside Weblogic directory. This step is optional.
2. Set PATH and CLASSPATH using ws.bat file that is in WEB-INF/classes/groups directory. Change PATH and CLASSPATH according to installation of Weblogic server in your system.
3. Compile JavaBeans using

     javac *.java
    

4. Start Weblogic server
5. Goto Admin Console
6. Select Web Applications Node in left side tree.
7. Select Configure a new Web Application... from right side frame.
8. Select directory where groups application is placed and click on Select link on the left of the directory.
9. From available servers, select the server and click on right arrow.
10. Click on Configure and Deploy button.
11. Once Deployed columns shows True, you can access it as follows:

    http://localhost:7001/groups