mailing list improvements
[org.ibex.mail.git] / src / org / ibex / mail / target / Mailbox.java
index 5e3e67f..13b376f 100644 (file)
@@ -1,13 +1,23 @@
+// 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 abstract class Mailbox extends Target {
+/** 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 final String STORAGE_ROOT =
         System.getProperty("ibex.mail.root", File.separatorChar + "var" + File.separatorChar + "org.ibex.mail");
@@ -15,37 +25,90 @@ public abstract class Mailbox extends Target {
 
     // Required Methods //////////////////////////////////////////////////////////////////////////////
 
+    /** 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 int              add(Message message);
+    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 int              uidValidity();
-    public abstract void             rename(String newName);
-    public abstract void             destroy();
+    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();
 
 
     // Thunks ////////////////////////////////////////////////////////////////////////////
 
-    public final    void             accept(Message m) { add(m); }
+    public          void             accept(Message m) { add(m); }
     public          Mailbox.Iterator iterator() { return iterator(Query.all()); }
 
 
     // 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() { throw new MailException("not supported"); }
-        public Mailbox slash(String name, boolean create) { 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);
+            }
+        }
     }
 
 
@@ -53,18 +116,22 @@ public abstract class Mailbox extends Target {
 
     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);
@@ -72,12 +139,19 @@ public abstract class Mailbox extends Target {
         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); }
@@ -94,13 +168,74 @@ public abstract class Mailbox extends Target {
             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() { do { if (!super.next()) return false; } while(!q.match(this)); return true; }
+            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) { }
         }
     }
-    
+
+    /** 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;
+    }
+
+    public static class MailboxWrapper extends Mailbox {
+        
+        private Mailbox m;
+        public MailboxWrapper(Mailbox m) { this.m = m; }
+
+        public boolean          phantom() { return m.phantom(); }
+        public Mailbox.Iterator iterator(Query q) { return m.iterator(q); }
+        public void             add(Message message) { m.add(message); }
+        public void             add(Message message, int flags) { m.add(message, flags); }
+        public void             move(Query q, Mailbox dest) { m.move(q, dest); }
+        public void             copy(Query q, Mailbox dest) { m.copy(q, dest); }
+        public int              count(Query q) { return m.count(q); }
+        public int              uidNext() { return m.uidNext(); }
+        public void             rename(String newName) { m.rename(newName); }
+        public void             destroy(boolean recursive) { m.destroy(recursive); }
+        public Mailbox          slash(String name, boolean create) { return m.slash(name, create); }
+        public String[]         children() { return m.children(); }
+        public Mailbox.Iterator iterator() { return m.iterator(); }
+        public int              uidValidity()  { return m.uidValidity(); }
+    }
+
 }