JavaZOOM Web Site
  Software
  
Installation
  
Configuration
  
Customization
  
License

<< back

- Installation -

jMailComposer is a 100% JAVA/JSP/Servlets sendmail component.

Read [General] instructions to install jMailComposer on your servlet engine. A [WAR] archive is available to make jMailComposer installation easier (recommended!). It needs a servlet engine SERVLETS 2.2+ API compliant or a J2EE1.2+ compliant applications server. See installation instructions.

Any problem ? Read the [FAQ] first. Still a problem ? Post your question to our online JSP Forum.

General Installation

Basically, our download package structure is SERVLETS 2.2+ compliant.

Click to zoom inYou will find JAR files under a WEB-INF/lib folder. The standardized deployment descriptor file (web.xml) under WEB-INF/ folder and JSP files under / folder (document root). Most of servlet engines are compliants with this structure so jMailComposer installation is as easy as a copy/paste.



Here are basic steps to install jMailComposer on your servlet engine :

  1. Add struts.jar, uploadbean.jar, activation.jar, mail.jar, smtp.jar and jmailcomposer.jar the CLASSPATH of your web application.
    (e.g. : Put these files under WEB-INF/lib/).
  2. Copy JSP samples : blank/, resume/, contact/ folders into the documentRoot of your web application.
    (e.g. : Put all these under a folder jmailcomposer/ in your web server).
  3. Merge WEB-INF/web.xml to your webapp's deployment descriptor. This step requires JSP/Servlets/XML skills, if you don't know how to do this then we strongly recommend you to use the WAR installation.
  4. Edit blank/compose.jsp, contact/compose.jsp, resume/compose.jsp to setup SMTP server propery before launching your servlet engine.
    Browse the configuration section to learn more about jMailComposer properties.
  5. Run jMailComposer :
    Documentation : http://yourserver.com/jmailcomposer/documentation/index.html
    Template : http://yourserver.com/jmailcomposer/blank/
    Sample 1: http://yourserver.com/jmailcomposer/contact/

    Sample 2: http://yourserver.com/jmailcomposer/resume/
WAR Installation

jMailComposer is also available as a WAR archive. It's a SERVLETS 2.2 standard archive for Web Applications.
What does it mean ?... It means that WAR installation is as easy as a copy/paste, regardless to the servlet engine vendor.

  1. To install jMailComposer WAR archive, copy jmailcomposer.war under the webapps folder of your servlet engine before running it. That's all :-)
    Note that webapps folder depends on your servlet engine. It could be webapps/, applications/ ... The WAR file will be automatically uncompressed under jmailcomposer/ folder.

  2. Run jMailComposer for the first time :
    Documentation : http://yourserver.com/jmailcomposer/documentation/index.html
    Template : http://yourserver.com/jmailcomposer/blank/
    Sample 1: http://yourserver.com/jmailcomposer/contact/

    Sample 2: http://yourserver.com/jmailcomposer/resume/
    Note that at this step, jMailComposer is running but not configured yet.

  3. Once launched for the first time, stop the servlet engine to configure JSP samples as you need. You have to modify SMTP server properties. Browse the configuration section to learn more about jMailComposer properties.

The jMailComposer WAR archive is downloadable at jMailComposer Homepage.

FAQ
  • I get Javascript errors when running compose.jsp ?
    Do not access any JSP files directly, use servlets URL instead. The main URL is http://myserver.com/jmailcomposer/blank/
  • I get a 404 HTTP error on http://myserver.com/jmailcomposer/blank/ ?
    - Try http://myserver.com/jmailcomposer/blank/compose
    - Check your web deployment descriptor (web.xml). You should have <servlet-mapping> entries matching to /blank. You could find more info about lines to add into web.xml in configuration section.
  • I still get HTTP 404 error on http://myserver.com/jmailcomposer/blank/ ?
    Double check how you deployed jmailcomposer web application. You might have deployed it under "/" or "/something" so the correct main URL should be http://yourserver.com/blank/ or http://yourserver.com/something/blank/
  • I get "Access to default session denied error" when email is sending ?
    You might need a login/password to get a JavaMail session. jMailComposer supports authenticated session. Add username and password properties in compose.jsp. See configuration section to learn more.
  • How to get StackTrace from ExceptionHandler ?
    Right-click and view HTML source, full StackTrace is in HTML comments.
  • How to add a progress bar when file is uploading ?
    blank/ template includes a progress bar on uploads. It should be a good starting point.

[News] [Applets] [Servlets] [Services] [Projects] [Links] [About]

Copyright © JavaZOOM 1999-2003

Java is a trademark of Sun Microsystems,Inc. All other company and/or product names are the property of their respective owners.