KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > columba > ristretto > message > Message


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.message;
37
38 import java.io.IOException JavaDoc;
39 import java.util.logging.Logger JavaDoc;
40
41 import org.columba.ristretto.io.Source;
42
43
44 /**
45  * Container for a header and a mimetree, representing a message.
46  *
47  *
48  * @author Timo Stich <tstich@users.sourceforge.net>
49  */
50 public class Message {
51
52     /** JDK 1.4+ logging framework logger, used for logging. */
53     private static final Logger JavaDoc LOG = Logger.getLogger("org.columba.ristretto.message");
54
55
56     protected Header header;
57     protected MimeTree mimePartCollection;
58     protected Source source;
59     
60     
61     /**
62      * Constructs an empty Message.
63      */
64     public Message() {
65     }
66
67     /**
68      * Get the ith MimePart.
69      *
70      * @param i
71      * @return the ith MimePart
72      */
73     public MimePart getMimePart(int i) {
74         return mimePartCollection.get(i);
75
76     }
77
78     /**
79      *
80      *
81      * @return the number of available MimeParts
82      */
83     public int getMimePartCount() {
84         if (mimePartCollection != null)
85             return mimePartCollection.count();
86         else
87             return 0;
88     }
89
90     /**
91      * @return the MimeTree of the message.
92      */
93     public MimeTree getMimePartTree() {
94         return mimePartCollection;
95     }
96
97     /**
98      * Set the MimeTree of the message.
99      *
100      * @param ac
101      */
102     public void setMimePartTree(MimeTree ac) {
103         mimePartCollection = ac;
104     }
105
106     /**
107      *
108      *
109      * @return the Header of the message
110      */
111     public Header getHeader() {
112         return header;
113     }
114
115     /**
116      * Sets the Header of the message.
117      *
118      * @param h
119      */
120     public void setHeader(Header h) {
121         this.header = h;
122     }
123
124     /**
125      * @return the Source of the message.
126      */
127     public Source getSource() {
128         return source;
129     }
130
131     /**
132      * Set the Source of the message.
133      *
134      * @param source
135      */
136     public void setSource(Source source) {
137         this.source = source;
138     }
139
140     /**
141      * Make a Source#deepClose() on the associated
142      * Source. This ensures that all resources allocated
143      * with this message are released.
144      */
145     public void close() {
146         try {
147             source.deepClose();
148         } catch (IOException JavaDoc e) {
149             LOG.warning( e.getLocalizedMessage() );
150         }
151     }
152     
153     /**
154      * @see java.lang.Object#finalize()
155      */
156     protected void finalize() throws Throwable JavaDoc {
157         super.finalize();
158         source.deepClose();
159     }
160 }
Popular Tags