added preliminary mailing list support
[org.ibex.mail.git] / src / org / ibex / mail / target / Mailbox.java
index a7f32d5..f5bf940 100644 (file)
+// Copyright 2000-2005 the Contributors, as shown in the revision logs.
+// Licensed under the Apache Public Source License 2.0 ("the License").
+// You may not use this file except in compliance with the License.
+
 package org.ibex.mail.target;
 import org.ibex.mail.*;
 import org.ibex.util.*;
 import org.ibex.mail.*;
+import org.ibex.js.*;
 import java.io.*;
 import java.net.*;
 import java.util.*;
 import java.text.*;
 
-public class Mailbox extends Target {
-
-    // metadata
-    public void   set(Message m, String key, String val) { throw new MailException.MetadataNotSupported(); }
-    public String get(Message m, String key)             { throw new MailException.MetadataNotSupported(); }
-
-    // flags
-    public final boolean getFlag(Message m, int flags)   { return (flags(m) & flag) == flags; }
-    public final void    setFlag(Message m, int flag)   { flags(m, flags | flag); }
-    public final void    clearFlag(Message m, int flag) { flags(m, flags & ~flag); }
-    protected abstract void flags(Message m, int newFlags);  // set the flags for a given message
-    protected abstract int  flags(Message m);                // get the flags for a given message
-    public    abstract int  uid(Message m);                  // get the uid for a given message              (see IMAP RFC)
-    public    abstract int  num(Message m);                  // get the "message number" for a given message (see IMAP RFC)
-    public    abstract int  uidNext();                       // get the next uid to be assigned 
-    public    abstract int  uidValidity();                   // get the uid validity identifier              (see IMAP RFC)
-
-    // messages
-    public int     add(Message message)                      throws MailException { throw new Error("not implemented"); }
-    public int     delete(Message message)                   throws MailException { throw new Error("not implemented"); }
-    public void    query(Query q, Message.Visitor v)         throws MailException { throw new Error("not implemented"); }
-    public int     count(Query q)                            throws MailException { throw new Error("not implemented"); }
-    public void    move(Query q, Mailbox dest, boolean copy) throws MailException { throw new Error("not implemented"); }
-
-    // submailboxes
-    public void    rename(String newName)                    throws MailException { throw new Error("not implemented"); }
-    public void    destroy()                                 throws MailException { throw new Error("not implemented"); }
-    public Mailbox slash(String name, boolean create)        throws MailException { throw new Error("not implemented"); }
-
-    /** a fast-write, slow-read place to stash all messages we touch -- in case of a major f*ckup */
-    public static class Transcript extends Mailbox {
-        private String path;
-        public Transcript(String path) throws MailException { new File(this.path = path).mkdirs(); }
-        private static String lastTime = null;
-        private static int lastCounter = 0;
-
-        /** returns a message identifier */
-        public synchronized int add(Message message) throws MailException {
-            try {
-                File today = new File(path + File.separatorChar + (new SimpleDateFormat("yy-MMM-dd").format(new Date())));
-                today.mkdirs();
-                
-                String time = new SimpleDateFormat("HH:mm:ss").format(new Date());
-                synchronized (Transcript.class) {
-                    if (lastTime != null && lastTime.equals(time)) {
-                        time += "." + (++lastCounter);
-                    } else {
-                        lastTime = time;
-                    }
-                }
-                
-                File target = new File(today.getPath() + File.separatorChar + time + ".txt");
-                OutputStream os = new FileOutputStream(target);
-                message.dump(os);
-                os.close();
-                return -1;
-            } catch (IOException e) { throw new MailException.IOException(e); }
-        }
+/** abstract superclass for mailboxes, which store messages along with their flags */
+public abstract class Mailbox extends JS.Obj implements Target {
+
+    public JS get(JS key) throws JSExn {
+        return slash(JSU.toString(key), true);
     }
 
-    public static class FileBased extends Mailbox {
-        private String path;
-        private FileBased(String path) throws MailException { new File(this.path = path).mkdirs(); }
-        public Mailbox slash(String name, boolean create) throws MailException {
-            // FIXME: create
-            return new FileBased(path + "/" + name);
-        }
+    public static final String STORAGE_ROOT =
+        System.getProperty("ibex.mail.root", File.separatorChar + "var" + File.separatorChar + "org.ibex.mail");
 
-        public int[] list() {
-            String[] names = new File(path).list();
-            int[] ret = new int[names.length];
-            for(int i=0, j=0; j<ret.length; i++, j++) {
-                try {
-                    ret[j] = Integer.parseInt(names[i].substring(0, names[i].length() - 1));
-                } catch (NumberFormatException nfe) {
-                    Log.warn(FileBased.class, "NumberFormatException: " + names[i].substring(0, names[i].length() - 1));
-                    j--;
-                    int[] newret = new int[ret.length - 1];
-                    System.arraycopy(ret, 0, newret, 0, newret.length);
-                    ret = newret;
-                }
-            }
-            return ret;
-        }
 
-        /** returns a message identifier */
-        public synchronized int add(Message message) throws MailException {
-            try {
-                int[] all = list();
-                int max = 0;
-                for(int i=0; i<all.length; i++) max = Math.max(max, all[i]);
-                int target = max++;
-                File f = new File(path + File.separatorChar + max + ".-");
-                FileOutputStream fo = new FileOutputStream(f);
-                message.dump(fo);
-                fo.close();
-                f.renameTo(new File(path + File.separatorChar + max + "."));
-                return target;
-            } catch (IOException e) { throw new MailException.IOException(e); }
-        }
+    // Required Methods //////////////////////////////////////////////////////////////////////////////
 
-        public Message get(int messagenum) throws MailException {
-            File f = new File(path + File.separatorChar + messagenum + ".");        
-            if (!f.exists()) throw new MailException.IOException(new FileNotFoundException(f.toString()));
-            //try {
-                // FIXME: need to store envelope from/to
-                //Message ret = new Message(new LineReader(new InputStreamReader(new FileInputStream(f))));
-                // FIXME: set answered/read/etc here
-                //return ret;
-            //return null;
-                /*
-            } catch (MailException.Malformed malf) {
-                Log.error(this, "This should never happen");
-                Log.error(this, malf);
-                return null;
-            }
-                */
-            return null;
-        }
+    /** phantom mailboxes merely contain others; like the alt.binaries in alt.binaries.warez */
+    public abstract boolean          phantom();
+    public abstract Mailbox.Iterator iterator(Query q);
+    public abstract void             add(Message message);
+    public abstract void             add(Message message, int flags);
+    public abstract void             move(Query q, Mailbox dest);
+    public abstract void             copy(Query q, Mailbox dest);
+    public abstract int              count(Query q);
+    public abstract int              uidNext();
+    public abstract void             rename(String newName);      /* FIXME: IMAP semantics require creating parent dirs */
+    public abstract void             destroy(boolean recursive);
+    public abstract Mailbox          slash(String name, boolean create);
+    public abstract String[]         children();
 
-        // query types: stringmatch (headers, body), header element, deletion status, date range, message size
-        public Message[] query(int maxResults) {
-            throw new RuntimeException("FileBased.query() not implemented yet");
-        }
 
-    }
+    // Thunks ////////////////////////////////////////////////////////////////////////////
 
+    public final    void             accept(Message m) { add(m); }
+    public          Mailbox.Iterator iterator() { return iterator(Query.all()); }
 
-    String user;
-    private static Hashtable cache = new Hashtable();
-    public static Mailbox getForUser(String user) {
-        Mailbox ret = (Mailbox)cache.get(user);
-        if (ret == null) ret = new Mailbox(user);
-        return ret;
-    }
-    Mailbox(String user) { this.user = user; }
-    public Mailbox slash(String name) throws MailException {
-        throw new Error(this.getClass().getName() + " does not support the slash() method"); }
-    public synchronized int add(Message message) throws MailException {
-        FileOutputStream fos = new FileOutputStream("/var/mail/" + user, true);
-        PrintWriter pw = new PrintWriter(new OutputStreamWriter(fos));
-        pw.println("From " + message.envelopeFrom);
-        pw.flush();
-        message.dump(fos);
-        fos.close();
-        return -1;
+
+    // Default Implementation //////////////////////////////////////////////////////////////////////////////
+
+    private int randomUidValidity = new Random().nextInt();
+    public  int uidValidity()  { return randomUidValidity; }
+
+    /** default, inefficient implementation of Mailbox; only requires a few methods to be implemented */
+    public static abstract class Default extends Mailbox {
+        public Mailbox.Iterator iterator(Query q) { return new Mailbox.Iterator.QueryIterator(q, this); }
+        public boolean phantom() { return false; }
+        public void copy(Query q, Mailbox dest) { for(Mailbox.Iterator it = iterator(q); it.next();) dest.add(it.cur()); }
+        public int count(Query q) { int count = 0; for(Mailbox.Iterator it = iterator(q); it.next();) count++; return count; }
+        public void rename(String newName) { throw new MailException("not supported"); }
+        public void  destroy(boolean recursive) { throw new MailException("not supported"); }
+        public Mailbox slash(String name, boolean create) { return null; }
+        public String[] children() { return new String[] { }; }
+        public void move(Query q, Mailbox dest) {
+            for(Mailbox.Iterator it = iterator(q);it.next();) { dest.add(it.cur()); it.delete(); }
+        }
+        public static abstract class Iterator implements Mailbox.Iterator {
+            public boolean seen() { return false; }
+            public boolean deleted() { return false; }
+            public boolean flagged() { return false; }
+            public boolean draft() { return false; }
+            public boolean answered() { return false; }
+            public boolean recent() { return false; }
+            public void    seen(boolean on) { }
+            public void    deleted(boolean on) { }
+            public void    flagged(boolean on) { }
+            public void    draft(boolean on) { }
+            public void    answered(boolean on) { }
+            public void    recent(boolean on) { }
+            public void    set(String key, String val) { throw new MailException("not supported"); }
+            public String  get(String key) { throw new MailException("not supported"); }
+            public int flags() {
+                return 
+                    (deleted() ? Flag.DELETED : 0) |
+                    (seen() ? Flag.SEEN : 0) |
+                    (answered() ? Flag.ANSWERED : 0) |
+                    (draft() ? Flag.DRAFT : 0) |
+                    (recent() ? Flag.RECENT : 0);
+            }
+            public void addFlags(int flags) {
+                if ((flags & Flag.DELETED) == Flag.DELETED) deleted(true);
+                if ((flags & Flag.SEEN) == Flag.SEEN) seen(true);
+                if ((flags & Flag.FLAGGED) == Flag.FLAGGED) flagged(true);
+                if ((flags & Flag.DRAFT) == Flag.DRAFT) draft(true);
+                if ((flags & Flag.RECENT) == Flag.RECENT) recent(true);
+            }
+            public void removeFlags(int flags) {
+                if ((flags & Flag.DELETED) == Flag.DELETED) deleted(false);
+                if ((flags & Flag.SEEN) == Flag.SEEN) seen(false);
+                if ((flags & Flag.FLAGGED) == Flag.FLAGGED) flagged(false);
+                if ((flags & Flag.DRAFT) == Flag.DRAFT) draft(false);
+                if ((flags & Flag.RECENT) == Flag.RECENT) recent(false);
+            }
+            public void setFlags(int flags) {
+                if ((flags & Flag.DELETED) == Flag.DELETED) deleted(true); else deleted(false);
+                if ((flags & Flag.SEEN) == Flag.SEEN) seen(true); else seen(false);
+                if ((flags & Flag.FLAGGED) == Flag.FLAGGED) flagged(true); else flagged(false);
+                if ((flags & Flag.DRAFT) == Flag.DRAFT) draft(true); else draft(false);
+                if ((flags & Flag.RECENT) == Flag.RECENT) recent(true); else recent(false);
+            }
+        }
     }
 
 
-    private static final String STORAGE_ROOT =
-        System.getProperty("ibex.mail.root", File.separatorChar + "var" + File.separatorChar + "org.ibex.mail");
-    public static FileBased root = null;
-    public static Transcript transcript = null;
-    static {
-        try {
-            root = new FileBased(STORAGE_ROOT + File.separatorChar);
-            transcript = new Transcript(STORAGE_ROOT + File.separatorChar + "transcript");
-        } catch (Exception e) {
-            e.printStackTrace();
+    // Iterator Definition //////////////////////////////////////////////////////////////////////////////
+
+    public static interface Iterator {
+        public abstract Message cur();
+        public abstract Headers head();
+        public abstract boolean next();
+        public abstract int     uid();
+        public abstract int     num();
+        public abstract void    delete();
+
+        public abstract void    set(String key, String val);
+        public abstract String  get(String key);
+
+        public abstract boolean seen();
+        public abstract boolean deleted();
+        public abstract boolean flagged();
+        public abstract boolean draft();
+        public abstract boolean answered();
+        public abstract boolean recent();
+
+        public abstract void    seen(boolean on);
+        public abstract void    deleted(boolean on);
+        public abstract void    flagged(boolean on);
+        public abstract void    draft(boolean on);
+        public abstract void    answered(boolean on);
+        public abstract void    recent(boolean on);
+
+        public abstract int     flags();
+        public abstract void    addFlags(int flags);
+        public abstract void    removeFlags(int flags);
+        public abstract void    setFlags(int flags);
+
+        public static class Wrapper implements Iterator {
+            private Iterator it;
+            public Wrapper(Iterator it) { this.it = it; }
+            public Message cur() { return it.cur(); }
+            public Headers head() { return it.head(); }
+            public boolean next() { return it.next(); }
+            public int     uid() { return it.uid(); }
+            public int     flags() { return it.flags(); }
+            public int     num() { return it.num(); }
+            public void    set(String key, String val) { it.set(key, val); }
+            public String  get(String key) { return it.get(key); }
+            public void    delete() { it.delete(); }
+            public boolean seen() { return it.seen(); }
+            public boolean deleted() { return it.deleted(); }
+            public boolean flagged() { return it.flagged(); }
+            public boolean draft() { return it.draft(); }
+            public boolean answered() { return it.answered(); }
+            public boolean recent() { return it.recent(); }
+            public void    seen(boolean on) { it.seen(on); }
+            public void    deleted(boolean on) { it.deleted(on); }
+            public void    flagged(boolean on) { it.flagged(on); }
+            public void    draft(boolean on) { it.draft(on); }
+            public void    answered(boolean on) { it.answered(on); }
+            public void    recent(boolean on) { it.recent(on); }
+            public void    addFlags(int flags) { it.addFlags(flags); }
+            public void    removeFlags(int flags) { it.removeFlags(flags); }
+            public void    setFlags(int flags) { it.setFlags(flags); }
+        }
+
+        class QueryIterator extends Mailbox.Iterator.Wrapper {
+            Query q;
+            public QueryIterator(Query q, Mailbox m) { super(m.iterator()); this.q = q; }
+            public boolean next() {
+               if (q == null) return false;
+               do { if (!super.next()) return false; } while(!q.match(this)); return true; }
+        }
+
+        public static class NullIterator extends Mailbox.Default.Iterator {
+            public NullIterator() { }
+            public Message cur() { return null; }
+            public Headers head() { return null; }
+            public boolean next() { return false; }
+            public int     uid() { return 0; }
+            public int     flags() { return 0; }
+            public int     num() { return 0; }
+            public void    set(String key, String val) { }
+            public String  get(String key) { return null; }
+            public void    delete() { }
+            public boolean seen() { return false; }
+            public boolean deleted() { return false; }
+            public boolean flagged() { return false; }
+            public boolean draft() { return false; }
+            public boolean answered() { return false; }
+            public boolean recent() { return false; }
+            public void    seen(boolean on) { }
+            public void    deleted(boolean on) { }
+            public void    flagged(boolean on) { }
+            public void    draft(boolean on) { }
+            public void    answered(boolean on) { }
+            public void    recent(boolean on) { }
         }
     }
 
-    public final void    accept(Message m) throws MailException { add(m); }
+    /** constants for the six IMAP flags */
+    public static class Flag {
+        public static final int DELETED  = 0x0001;
+        public static final int SEEN     = 0x0002;
+        public static final int FLAGGED  = 0x0004;
+        public static final int DRAFT    = 0x0008;
+        public static final int ANSWERED = 0x0010;
+        public static final int RECENT   = 0x0020;
+    }
+    
 }