Project "POPpers"

Contents

1. What is "POPpers" ?
2. Download
3. How to use
4. URLName parameters
5. Properties
6. History
7. Questions and comments

1. What is "POPpers" ?

"POPpers" is a JavaMail POP3 provider.
"POPpers" supports:
1. Local store.
2. Management subfolders. Create/Rename/Delete Folder objects are supported.
3. Event notification.
4. APOP authorization.
Sun released POP3 provider, but it does not include a local store into which messages can be downloaded and stored. And only contains single Folder named "INBOX".


NOTE: "POPpers" is free software. Please read GNU General Public License.

2. Download (version 0.9.2)

"POPpers" zip archive.
poppers-0.9.2.zip (127,677 bytes)

3. How to use

3.1 Add "poppers.jar" to your CLASSPATH

Extract Zip file to your local-disk.
jar xvf poppers_0_9_1.zip
4 files will be extracted.

File	Description
poppers.jar	POPpers
poppers-src.zip	POPpers source codeNOTE
license.html	License(Japanese)
license_en.html	License

^NOTE Source code contains many comments, but all comments are written in Japanese.(Shift-JIS)
Add "poppers.jar" to your classpath.
For example:
 Windows95/98
set CLASSPATH=%CLASSPATH%;c:\classes\poppers.jar
(c:\classes is a folder that contains poppers.jar)
 Linux (bash)
export CLASSPATH=$CLASSPATH:/usr/local/classes/poppers.jar
(/usr/local/classes is a directory that contains poppers.jar)
If you're using JDK1.2.x, copy poppers.jar intojre\lib\ext\.
(You don't have to modify CLASSPATH)

3.2 Use the JavaMail client

To use the POP3 provider, use "pop3" as the protocol-name.
For example,

 java SimpleClient -L pop3://user:password@host/
 (JavaMail package contains SimpleClient demo program)
 

4. URLName parameters

POPpers supports URLName parameters following:
• localstore=local directory
  You can specify local directory that store messages.
  For example, store messages to /usr/home/user/mailbox/
pop3://user:password@host/?localstore=/usr/home/user/mailbox/
  
• authmode=NORMAL | APOP
  You can specify POP3 authentication mode.
  For example, use APOP authentication.
  pop3://user:password@host/?authmode=APOP
  
To set multiple parameters, separate each parameters with '&':
For example,
pop3://user:password@host/?localstore=/user/home/user/mailbox/&authmode=APOP

5. Properties

POPpers supports some properties.
This section lists the environment properties that are used by POPpers.

 To set properties:
1. Create Properties object:
   Properties props = new Properties();

props.put("jp.gr.java_conf.roadster.net.pop.authMode", "APOP");
2. Obtain Session instance:
   Session session = Session.getDefaultInstance(props, authenticator);

6. History

Version0.9.1->0.9.2

1. Recovers index file when folder.idx file is broken.(Thanks to Jeff Gay)
2. Changes saver thread priority (NORMAL_PRIORITY-1 to NORMAL_PRIORITY+1).

7. Questions and comments

Contact me at freebeans@xqb.biglobe.ne.jp if you have any questions and comments

Here is a Java Mail Client.