svn commit: r701653 - /james/mime4j/trunk/src/main/java/org/apache/james/mime4j/util/MimeUtil.java

[ba...@apache.org]

Author: bago
Date: Sat Oct  4 08:38:21 2008
New Revision: 701653

URL: http://svn.apache.org/viewvc?rev=701653&view=rev
Log:
Add utility methods for creating message boundaries and message IDs (MIME4J-81)
Patch kindly provided by Markus Wiederkehr

Modified:
    james/mime4j/trunk/src/main/java/org/apache/james/mime4j/util/MimeUtil.java

Modified: james/mime4j/trunk/src/main/java/org/apache/james/mime4j/util/MimeUtil.java
URL: http://svn.apache.org/viewvc/james/mime4j/trunk/src/main/java/org/apache/james/mime4j/util/MimeUtil.java?rev=701653&r1=701652&r2=701653&view=diff
==============================================================================
--- james/mime4j/trunk/src/main/java/org/apache/james/mime4j/util/MimeUtil.java (original)
+++ james/mime4j/trunk/src/main/java/org/apache/james/mime4j/util/MimeUtil.java Sat Oct  4 08:38:21 2008
@@ -24,6 +24,7 @@
 
 import java.util.HashMap;
 import java.util.Map;
+import java.util.Random;
 
 
 /**
@@ -104,7 +105,13 @@
      * See <a href='http://www.faqs.org/rfcs/rfc1864.html'>RFC1864</a>.
      */
     public static final String MIME_HEADER_MD5 = "content-md5";
+
+    // used to create unique ids
+    private static final Random random = new Random();
     
+    // used to create unique ids
+    private static int counter = 0;
+
     private MimeUtil() {
         // this is an utility class to be used statically.
         // this constructor protect from instantiation.
@@ -340,4 +347,55 @@
 
         return result;
     }
+
+    /**
+     * Creates a new unique message boundary string that can be used as boundary
+     * parameter for the Content-Type header field of a message.
+     * 
+     * @return a new unique message boundary string.
+     */
+    public static String createUniqueBoundary() {
+        StringBuffer sb = new StringBuffer();
+        sb.append("-=Part.");
+        sb.append(Integer.toHexString(nextCounterValue()));
+        sb.append('.');
+        sb.append(Long.toHexString(random.nextLong()));
+        sb.append('.');
+        sb.append(Long.toHexString(System.currentTimeMillis()));
+        sb.append('.');
+        sb.append(Long.toHexString(random.nextLong()));
+        sb.append("=-");
+        return sb.toString();
+    }
+
+    /**
+     * Creates a new unique message identifier that can be used in message
+     * header field such as Message-ID or In-Reply-To. If the given host name is
+     * not <code>null</code> it will be used as suffix for the message ID
+     * (following an at sign).
+     * 
+     * The resulting string is enclosed in angle brackets (&lt; and &gt;);
+     * 
+     * @param hostName host name to be included in the message ID or
+     *            <code>null</code> if no host name should be included.
+     * @return a new unique message identifier.
+     */
+    public static String createUniqueMessageId(String hostName) {
+        StringBuffer sb = new StringBuffer("<Mime4j.");
+        sb.append(Integer.toHexString(nextCounterValue()));
+        sb.append('.');
+        sb.append(Long.toHexString(random.nextLong()));
+        sb.append('.');
+        sb.append(Long.toHexString(System.currentTimeMillis()));
+        if (hostName != null) {
+            sb.append('@');
+            sb.append(hostName);
+        }
+        sb.append('>');
+        return sb.toString();
+    }
+
+    private static synchronized int nextCounterValue() {
+        return counter++;
+    }
 }



---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org