Summary of Functionalities

1. All of the web pages use JSP and MySQL for output,
   can be easily modified. It runs on multiple platforms.
   It works on WinNT or Win2000 or Linux or FreeBSD and etc. 
2. Web pages templates use Cascading Style Sheet function.
   When changing background color and boarder size of tables,
   users only need to modify one file.
3. JSP is built for Dynamic Scripting Language,
   and the code is executed on the server, therefore,
   reduce the risks running on the client's side and
   it can be used by both IE and NC. The conflict won't occur.
4. All Web pages supports multi-languages,
   and it is ready to be configured in different languages.
   In addition, it can be easily set up in different languages platform.
5. It uses Session object to prevent unauthorized accesses by unauthorized users.
6. Has the capability to verify administrators,
   and to change the password, users' information instantly online.
7. It consists fully manageable function,
   and Webmaster can delete all the administrators online.
8. Initiate.jsp is a setup file developed for the first time installation.
   It only needs to be run once and it will set up all the tables and files
   for databases automatically. 
9. The system also provides upload capability.
   It allows administrator to upload files from his/her computer to server,
   therefore, provides normal users to connects and browse attachments. 
10.System will follow the GPL policy, it can only be used for authorized users.



uG(Announcement System)v\²G

1. ϥ JSP + MySQL XA۷Ƽu!B󥭥xSʡC
   (ibWinNT or Win2000 or Linux or FreeBSD...Uا@~x)
2. ˦ĥCascading Style Sheet (CSS)˦A
   ܧICB]wؽuʲӡAuݧ@ɮסC
3. JSP(Java Server Pages)Dynamic Scripting LanguageAiServerݧu@F
   jjCClinݰWIAGIEάONCҥiAΡA|ͤۮe~C
4. NҦHyҲդơAKPytϥΡAiӯܤWyC
5. QSession\AHDkϥΪ̡C
6. ƺ޲z̨ҥ\ABbuWYɧ󴫱KXκ޲z̭ӤHơC
7. Ƨ㪺޲zҦA޲z(̰޲zv)uWWRҦ޲z̡C
8. 󭺦wˡAht~gFl]w(initiate.jsp)A
   un@Yi۰ʫإߦnҦƮwθơC
9. tδѡuɮפWǡv\A\޲ẕNۤvqɮסAWǦܦAݡC
   HѤ@ϥΪ̳sܪ[ɮתsC
10.ӨtαNuGPLڡAHv覡}C



Installation Guide:

1. Please download and install Java Servlet Engine,
   Java Servlet Development Kit (JSDK),
   Java 2 SDK, Standard Edition Version 1.3.0_02 Software
   for Windows 95/98/2000/NT/ME/ 4.0 (Intel platform)
   for http://java.sun.com/j2se/1.3/download-windows.html .
   The file should be j2sdk1_3_0_02-win.exe and
   should be stored in "C:\jdk1.3.0.2".
   For different platform, go to http://java.sun.com/j2se/1.3/

2. Please download and install JSP engine (Web Server).
   Tomcat and Resin servers are used the most for now.
   Please select either one of following two servers to install:
   (1) Resin can be downloaded from http://www.caucho.com/download/index.xtp .
       From the directory, you can find the newest version of Resin Server (resin-1.2.2.zip).
       After compressed, install the server in directory the "C:\resin1.2.2".
   (2) Tomcat can be downloaded from http://jakarta ,
       apache.org/site/binindex.html. From the directory,
       you can find the newest version of Tomcat Server (Jakarta-tomcat-3.2.1.zip).
       After compressed, install the server in directory the "C:\Jakarta-tomcat".
   Note: the author uses Resin Server to develop the system.

3. Please self download and install MySQL database.
   It can be downloaded from http://www.mysql.com .
   Please select MySQL to enter the related download page.
   From download page, select the right one for your OS platform,
   for example, for windows 95/98/NT/2000. Download and unzip it,
   and run setup to install. Install it in directory "C:\mm.mysql.jdbc-1.2c".

4. Please self download and install JDBC interface for MySQL database.
   Download at http://www.mysql.com/downloads/api-jdbc.html .
   From download page, the newest version of interface can be found
   (mm.mysql.jdbc-1.2c.tar.gz).
   Unzip it and install in directory "C:\mm.mysql.jdbc-1.2c".

5. The system consists uploading components (installation not needed).
   jspsmartUpload components of jspsmart company can provide
   the capability of uploading files.
   jspsmartUpload can be download at http://www.jspsmart.com .
   At downloading page, users are required to enter personal information
   to be able to download jspsmartUpload component files.
   (jspSmartUpload.tar.gz or jspSmartUpload.zip)

6. The required environment for the system is as follow:
   In the example using Resin Server,
   please open "C:\resin1.2.2\conf\resin.conf",
   and insert following information:
   <web-app id='announce'>
      <classpath id='announce/WEB-inf/classes'
          source='announce/web-inf/classes'
          compile = 'true'/>
   </Web-app>
   The information above enables Resin Server to read tools of jspsmartUpload components.
   For Tomcat server, please modify yourself.

7. Unzip compress file (announce.zip) to JSP server path.
   For Resin server, it will be "C:\resin1.2.2\doc"
   (doc is the menu for Resin server to execute).
   Therefore, the full path will be "C:\resin1.2.2\doc\announce".

8. language.jsp is the language setup file,
   it can easily set up for different language and environment.
   For now, the system supports English and Tradtional Chinese.
   languaEn.jsp for English
   languCh.jsp for Traditional Chinese
   please modify file language.asp to display the required languages.

9. Running for the first time, please first execute initiate.jsp in the browser,
   it will automatically set up database table and files needed for the system.
   Please be caution, it will redirect to main program announce.jsp after initial set up.

10.Browse announce.jsp main files, click on file management selection on the upper right hand,
   then enter user name and password:
   User: admin01	
   Password: admin01

   Administrator logins the system with this will have the highest right
   in managing the system, such as, add/delete/modify new administrators.

11. The system is not open to everyone. Users can apply for the account,
    but administrator account will be verified by higher authority.
    After entering as administrator, he/she will be able to post or delete any messages.

2001/05/20 by T.J.C( mailto:tjc@pchome.com.tw )



uG(Announcement System)vw˻G(UCBJA1. to 4.
tΩҥnn)

1. ЦۦUæwJava Servlet EngineC
   SunqJava Sverlet Development Kit (²JSDK)C
   Java 2 SDK, Standard Edition Version 1.3.0_02 Software for
   Windows 95/98/2000/NT/ME 4.0(Intel Platform)
      http://java.sun.com/j2se/1.3/download-windows.html
   UAɮ׬ j2sdk1_3_0_02-win.exeAw˫᪺ؿ C:\jdk1.3.0.2C
   or
   Yn藍Px  http://java.sun.com/j2se/1.3/

2. ЦۦUæwJSP (WebA)C
   ثe`ΪOTomcatAPResinACUCJSPAХ@بӦwˡG
  (1)ResinU( http://www.caucho.com/download/index.xtp )A
     bUANiResinA̷s(resin-1.2.2.zip)A
     Y᪺w˥ؿuC:\resin1.2.2vC
  (2)TomcatU( http://jakarta.apache.org/site/binindex.html )A
     bUANiTomcatA̷s(jakarta-tomcat-3.2.1.zip)A
     Y᪺w˥ؿuC:\jakarta-tomcatvC
  P.S.G
        @̧YOϥβĤ@ResinAAӶ}otΪC

3. ЦۦUæwMySQLƮw(Database)C
   MySQLU( http://www.mysql.com )AпMySQLHiJUA
   bUAANz@~xӿMySQLC
   ҦpAfor Windows 95/98/NT/2000 (Intel)C
   UθYA۫KiHw˵{(SETUP)iwˡA
   w]w˥ؿuC:\mysqlvC

4. ЦۦUæwMySQLƮwJDBCɭC
   JDBCU( http://www.mysql.com/downloads/api-jdbc.html )A
   bUANiJDBCɮת̷s(mm.mysql.jdbc-1.2c.tar.gz)A
   Y᪺w˥ؿuC:\mm.mysql.jdbc-1.2cvC

5. tΤw]tuɮפWǡv(YiKUw)C
   jspsmartqjspsmartUploadAiHѡuɮפWǡv\C
   jspsmartUploadU( http://www.jspsmart.com )A
   bUAݥ񧴭ӤHƤiUjspsmartUploadɮ
   (jspSmartUpload.tar.gz  jspSmartUpload.zip)C

6. tΩһݭnҳ]wpUG
   HResinA(JSP)ҡAЦۦ}ҡuC:\resin1.2.2\conf\resin.confvɮסA
   HK[JUCơG
    <web-app id='announce'>
       <classpath id='announce/WEB-inf/classes'
                  source='announce/web-inf/classes'
                  compile='true'/>
    </web-app>
   WzơAOResinA(JSP)ŪjspsmartUpload(ɮפW)OuC
   LApϥTomcatAAhЦۦtH]wק蠟C

7. NtΪYɮ(announce.zip)AYJSPAw]|UC
   pHResinAҡAYuC:\resin1.2.2\docv(docResinA檺w]ؿ)C
   ЦۦإannounceƧAñNYɮ׸YܨUC
   ҥHA㤧|NuC:\resin1.2.2\doc\announcevC

8. language.jspy]wɡAHKPytϥΡAӧ令AXϥҡC
   ثe䴩yءAEnglish M Traditional ChineseC
   languaEn.jsp for English
   languaCh.jsp for Traditional Chinese(c餤)
   аwһݭnܻyAӧɦWlanguage.jspYiC

9. Ĥ@eAХbs initiate.jsp(tΪȤƵ{)A
   N۰ʦaإߨtΩһݭnƮwθơC
   !!Ъ`NAtΩȤƧANsɦVܥD{ announce.jspC

10.s announce.jsp D{ɮסAUkW誺[޲zҦ]ﶵAJ
   ϥΪ̦W٤αKXG
                     ϥΪ̦W١G admin01
                     ϥΪ̱KXG admin01
   HnJtΤw޲z̡A㦳޲z̳̰vIiBz[J޲z̪ӽСB
   ΧR޲z̪bC
   ޲z̪KXέӤH򥻸Ʀb޲zҦiۦܧC

11.tΪ޲zҦĥb}񪺤覡AϥΪ̥iۦӽХ[JA
   ޲z̪ogL̰޲z̪f֡C
   nJ޲zҦA޲z̴Niw۵oiΧRiC


2001/05/20 by T.J.C( mailto:tjc@pchome.com.tw )