Draft

java.lang.Object

i2p.susi.webmail.Mail

i2p.susi.webmail.Draft

class Draftextends Mail

Represents a draft email message with attachments and Bcc support. Differences from Mail: - Never multipart, body is always text/plain UTF-8 - Attachments are just headers containing name, type, encoding, and path to file - Bcc is a header

Field Summary
Modifier and Type
Field
Description
private final List<Attachment>
attachments
Files attached to the draft.
private String[]
bcc
Blind copies, addresses only, enclosed by angle brackets.
private static final String
HDR_ATTACH
Header marking an attachment in a sent message.
static final String
HDR_BCC
Header line carrying the blind-copy recipients of a draft, which a draft otherwise has no way to express in the body.
private long
size
Size of the draft's contents, in bytes.
Fields inherited from class Mail
cc, contentType, date, dateOnly, dateString, error, formattedDate, HEADER_MATCH, localFormattedDate, markForDeletion, messageID, quotedDate, reply, sender, shortSender, shortSubject, subject, to, uidl
Modifier and Type
Field
Description
(package private) String[]
cc
Addresses only, enclosed by <>.
String
contentType
Content-Type header value.
Date
date
The parsed message date.
String
dateOnly
Long date-only format for mail list tooltips.
String
dateString
Raw date string from the Date header.
String
error
Error message from parsing, or empty.
String
formattedDate
Formatted date string in UTC.
(package private) static final byte[]
HEADER_MATCH
Also used by MailPart See MailPart for why we don't do \r\n\r\n.
String
localFormattedDate
Formatted date string in local time zone.
boolean
markForDeletion
Whether this message is flagged for deletion.
String
messageID
Message-ID as received, not HTML escaped.
String
quotedDate
Quoted date in local time zone, longer format.
String
reply
Address only, enclosed by <>.
String
sender
As received, trimmed only, not HTML escaped.
String
shortSender
Sender name or address truncated with …
String
shortSubject
Subject truncated with ….
String
subject
As received, trimmed only, not HTML escaped.
(package private) String[]
to
May be null.
final String
uidl
Unique ID assigned by the POP3 server.
Constructor Summary
Constructors
Constructor
Description
Draft(String uidl)
Start an empty draft with no attachments.
Method Summary
All Methods
Modifier and Type
Method
Description
int
addAttachment(Attachment a)
Adds an attachment if not already present.
void
clearAttachments()
Removes all attachments and deletes their data files.
StringBuilder
encodeAttachments()
Encodes all attachments as header lines for storage.
List<Attachment>
getAttachments()
The live attachment list, so callers can add or drop entries directly.
String[]
getBcc()
The blind-copy recipients found in the draft's Bcc header, with no header meaning none were entered.
long
getSize()
Includes size of attachments.
boolean
hasAttachment()
Is any file attached to this draft?
void
removeAttachment(int index)
Removes an attachment by index and deletes its data file.
void
setBody(Buffer rb)
Overridden to process attachment and Bcc headers.
void
setSize(long size)
Does nothing: a draft computes its own size from the body and its attachments, so there is no server-reported size to record.
Methods inherited from class Mail
appendRecipients, appendRecipients, deleteTempBodyFile, getAddress, getAttachmentType, getBody, getHeader, getPart, getRecipientsFromList, getRecipientsFromList, hasBody, hasHeader, hasPart, isNew, isSpam, setHeader, setNew, validateAddress
Modifier and Type
Method
Description
static void
appendRecipients(PrintWriter out, String[] recipients, String prefix)
Adds all items from the array to the builder, separated by commas This is for display of a forwarded email.
static void
appendRecipients(StringBuilder buf, ArrayList<String> recipients, String prefix)
Adds all items from the list to the builder, separated by tabs.
(package private) static void
deleteTempBodyFile(Buffer rb)
Delete the backing file of a body buffer if it is a susimail-new-* temp file.
static String
getAddress(String address)
Pull the first e-mail address out of a header line.
String
getAttachmentType()
Get the attachment type.
Buffer
getBody()
This contains the header also.
Buffer
getHeader()
This may or may not contain the body also.
MailPart
getPart()
The parsed message part.
static boolean
getRecipientsFromList(ArrayList<String> recipients, String[] ccs, boolean ok)
A little misnamed.
static boolean
getRecipientsFromList(ArrayList<String> recipients, String text, boolean ok)
A little misnamed.
boolean
hasBody()
Whether the body has been loaded.
boolean
hasHeader()
Whether the header has been fetched for this UIDL.
boolean
hasPart()
Whether the body has been parsed into a MailPart.
boolean
isNew()
Whether this message is new (unread).
boolean
isSpam()
Whether this message is identified as spam.
void
setHeader(Buffer rb)
Record the header bytes fetched from the server.
void
setNew(boolean isNew)
Mark this message read or unread.
static boolean
validateAddress(String address)
Check an address for the shape a mail server will accept.
Methods inherited from class Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details
- attachments
  private final List<Attachment> attachments
  Files attached to the draft.
- bcc
  private String[] bcc
  Blind copies, addresses only, enclosed by angle brackets.
- size
  private long size
  Size of the draft's contents, in bytes.
- HDR_ATTACH
  private static final String HDR_ATTACH
  Header marking an attachment in a sent message.
  See Also:
  Constant Field Values
- HDR_BCC
  public static final String HDR_BCC
  Header line carrying the blind-copy recipients of a draft, which a draft otherwise has no way to express in the body.
  See Also:
  Constant Field Values
Constructor Details
- Draft
  public Draft(String uidl)
  Start an empty draft with no attachments.
  Parameters:
  uidl - unique ID for this draft
Method Details
- setBody
  public void setBody(Buffer rb)
  Overridden to process attachment and Bcc headers.
  Overrides:
  setBody in class Mail
  Parameters:
  rb - buffer containing body data
- getSize
  public long getSize()
  Includes size of attachments.
  Overrides:
  getSize in class Mail
  Returns:
  body plus attachment size in bytes
- setSize
  public void setSize(long size)
  Does nothing: a draft computes its own size from the body and its attachments, so there is no server-reported size to record.
  Overrides:
  setSize in class Mail
  Parameters:
  size - the message size
- hasAttachment
  public boolean hasAttachment()
  Is any file attached to this draft?
  Overrides:
  hasAttachment in class Mail
  Returns:
  whether attachment is present
- getBcc
  public String[] getBcc()
  The blind-copy recipients found in the draft's Bcc header, with no header meaning none were entered.
  Returns:
  may be null
- getAttachments
  public List<Attachment> getAttachments()
  The live attachment list, so callers can add or drop entries directly.
  Returns:
  non-null, not a copy
- addAttachment
  public int addAttachment(Attachment a)
  Adds an attachment if not already present.
  Parameters:
  a - the attachment to add
  Returns:
  the index of the attachment
- removeAttachment
  public void removeAttachment(int index)
  Removes an attachment by index and deletes its data file.
  Parameters:
  index - the 0-based position in the attachment list; out of range is ignored
- clearAttachments
  public void clearAttachments()
  Removes all attachments and deletes their data files.
- encodeAttachments
  public StringBuilder encodeAttachments()
  Encodes all attachments as header lines for storage.
  Returns:
  the encoded attachment headers

Field Summary

Fields inherited from class Mail

Constructor Summary

Method Summary

Methods inherited from class Mail

Methods inherited from class Object

Field Details

attachments

bcc

size

HDR_ATTACH

HDR_BCC

Constructor Details

Method Details

setBody

getSize

setSize

hasAttachment

getBcc

getAttachments

addAttachment

removeAttachment

clearAttachments

encodeAttachments