KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > columba > ristretto > composer > MimePartRenderer


1 /* ***** BEGIN LICENSE BLOCK *****
2  * Version: MPL 1.1/GPL 2.0/LGPL 2.1
3  *
4  * The contents of this file are subject to the Mozilla Public License Version
5  * 1.1 (the "License"); you may not use this file except in compliance with
6  * the License. You may obtain a copy of the License at
7  * http://www.mozilla.org/MPL/
8  *
9  * Software distributed under the License is distributed on an "AS IS" basis,
10  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
11  * for the specific language governing rights and limitations under the
12  * License.
13  *
14  * The Original Code is Ristretto Mail API.
15  *
16  * The Initial Developers of the Original Code are
17  * Timo Stich and Frederik Dietz.
18  * Portions created by the Initial Developers are Copyright (C) 2004
19  * All Rights Reserved.
20  *
21  * Contributor(s):
22  *
23  * Alternatively, the contents of this file may be used under the terms of
24  * either the GNU General Public License Version 2 or later (the "GPL"), or
25  * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
26  * in which case the provisions of the GPL or the LGPL are applicable instead
27  * of those above. If you wish to allow use of your version of this file only
28  * under the terms of either the GPL or the LGPL, and not to allow others to
29  * use your version of this file under the terms of the MPL, indicate your
30  * decision by deleting the provisions above and replace them with the notice
31  * and other provisions required by the GPL or the LGPL. If you do not delete
32  * the provisions above, a recipient may use your version of this file under
33  * the terms of any one of the MPL, the GPL or the LGPL.
34  *
35  * ***** END LICENSE BLOCK ***** */
36 package org.columba.ristretto.composer;
37
38 import java.io.InputStream JavaDoc;
39 import java.nio.ByteBuffer JavaDoc;
40 import java.util.Random JavaDoc;
41
42 import org.columba.ristretto.coder.Base64;
43 import org.columba.ristretto.message.MimePart;
44
45
46 /**
47  * Abstract class that is used to render a mimepart
48  *
49  * <br>
50  * <b>RFC(s):</b> 2045
51  *
52  * @author Timo Stich <tstich@users.sourceforge.net>
53  */
54 public abstract class MimePartRenderer {
55     private static final int BOUNDARY_LENGTH = 32;
56     
57     private static Random JavaDoc random = new Random JavaDoc();
58
59
60     /**
61      * The renderer is registered for the returned mimetype(s)
62      * when calling {@link org.columba.ristretto.composer.MimeTreeRenderer#addMimePartRenderer(MimePartRenderer)}.
63      * <br>
64      * A renderer may register for all subtypes of a given type or to a
65      * specific type/subtype.
66      * <br>
67      * <b>Example:</b> "text", "multipart/signed", ...
68      *
69      * @return the registration string
70      */
71     public abstract String JavaDoc getRegisterString();
72
73
74     /**
75      * Renders the MimePart
76      *
77      * @param part the mimepart to render
78      * @return the inputstream of the rendered mimepart
79      * @throws Exception
80      */
81     public abstract InputStream JavaDoc render(MimePart part) throws Exception JavaDoc;
82
83
84     /**
85      * Creates a unique boundary that may be used to separate multiparts
86      *
87      * @return a unique boundary
88      */
89     protected CharSequence JavaDoc createUniqueBoundary() {
90         byte[] bytes = new byte[BOUNDARY_LENGTH];
91         random.nextBytes(bytes);
92         
93         return Base64.encode( ByteBuffer.wrap(bytes) );
94     }
95     
96 }
97
Popular Tags