JavaMail - 文件夹管理( Folder Management)
到目前为止，我们在前面的章节中主要使用了INBOX文件夹。 这是大多数邮件所在的默认文件夹。 有些系统可能将其称为INBOX，而另一些系统可能会将其称为其他名称。 但是，您始终可以使用名称INBOX从JavaMail API访问它。
JavaMail API将文件夹表示为抽象Folder类的实例:
public abstract class Folder extends Object
此类声明了从服务器请求命名文件夹，从文件夹中删除邮件，在文件夹中搜索特定邮件，在文件夹中列出邮件等的方法。
打开文件夹
我们无法直接创建文件夹，因为Folder类中唯一的构造函数protected 。 我们可以从以下位置获取Folder
一个会议
一家商店
或其他文件夹
以上所有类都有类似的getFolder（）方法，具有类似的签名:
public abstract Folder getFolder(String name) throws MessagingException
一些有助于获取Folder对象的方法是:
| 方法 | 描述 |
|---|---|
| boolean exists() | 检查文件夹是否确实存在。 在获取Folder对象之前使用此方法。 |
| abstract void open （int mode） | 当你得到一个Folder ，它关闭。 使用此方法打开它。 mode可以是Folder.READ_ONLY或Folder.READ_WRITE。 |
| abstract boolean isOpen （） | 如果文件夹处于打开状态，则此方法返回true如果文件夹已关闭，则返回false |
| abstract void close （boolean expunge） | 关闭文件夹。 如果expunge参数为true ，则从服务器上的实际文件中删除该文件夹中的所有已删除邮件。 否则，它们只是标记为deleted ，但仍然可以取消删除邮件。 |
基本文件夹信息
以下是Folder类中的一些返回文件夹基本信息的方法:
| 方法 | 描述 |
|---|---|
| abstract String getName （） | 返回文件夹的名称，例如“IoWiki Mail” |
| abstract String getFullName （） | 从根目录返回完整的层次结构名称，例如“books/Manisha/IoWiki Mail”。 |
| URLName getURLName （） | 返回表示此文件夹的URLName。 |
| abstract文件夹getParent （） | 返回包含此文件夹的文件夹的名称，即父文件夹。 例如，之前的“IoWiki Mail”示例中的“Manisha”。 |
| abstract int getType() | 返回一个int，指示文件夹是否可以包含消息和/或其他文件夹。 |
| int getMode() | 当模式未知时，它返回两个命名常量Folder.READ_ONLY或Folder.READ_WRITE中的一个或-1。 |
| 存储getStore （） | 返回从中检索此文件夹的Store对象。 |
| abstract char getSeparator （） | 返回将此文件夹的路径名与直接子文件夹的名称分隔开的分隔符。 |
管理文件夹
以下是一些有助于管理文件夹的方法:
| 方法 | 描述 |
|---|---|
| abstract boolean create （int type） | 这将在此文件夹的Store中创建一个新文件夹。 其中type是:Folder.HOLDS_MESSAGES或Folder.HOLDS_FOLDERS。 如果成功创建文件夹，则返回true ，否则返回false 。 |
| abstract boolean delete （boolean recurse） | 仅当文件夹关闭时，才会删除该文件夹。 否则，它会抛出IllegalStateException 。 如果recurse为true ，则删除子文件夹。 |
| abstract boolean renameTo （Folder f） | 这会更改此文件夹的名称。 必须关闭文件夹才能重命名。 否则，抛出IllegalStateException。 |
管理文件夹中的邮件
以下是一些有助于管理文件夹中的消息的方法:
| 方法 | 描述 |
|---|---|
| abstract void appendMessages （Message [] messages） | 顾名思义，数组中的消息放在此文件夹的末尾。 |
| void copyMessages （Message []消息，文件夹目标） | 这会将此文件夹中的消息复制到作为参数提供的指定文件夹中。 |
| 抽象消息[] expunge （） | 要从文件夹中删除邮件，请将其Flags.Flag.DELETED标志设置为true。 要从文件夹中物理删除已删除的邮件，您必须调用此方法。 |
列出文件夹的内容
列出文件夹包含的文件夹有四种方法:
| 方法 | 描述 |
|---|---|
| 文件夹[] list （） | 这将返回一个列出此文件夹包含的文件夹的数组。 |
| Folder [] listSubscribed （） | 这将返回一个列出该文件夹包含的所有已订阅文件夹的数组。 |
| abstract Folder [] list（String pattern） | 这与list()方法类似，只是它允许您指定模式。 模式是一个字符串，给出匹配的文件夹的名称。 |
| Folder [] listSubscribed （String pattern） | 这类似于listSubscribed()方法，但它允许您指定模式。 模式是一个字符串，给出匹配的文件夹的名称。 |
检查邮件
| 方法 | 描述 |
|---|---|
| abstract int getMessageCount （） | 可以在打开或关闭的文件夹上调用此方法。 但是，在关闭文件夹的情况下，此方法可能（或可能不）返回-1以指示不容易获得确切的消息数。 |
| abstract boolean hasNewMessages （） | 如果自上次打开以来已将新消息添加到文件夹，则返回true 。 |
| int getNewMessageCount （） | 它通过检查设置了RECENT标志的文件夹中的消息来返回新的消息计数。 |
| int getUnreadMessageCount （） | 这可以在打开或关闭的文件夹上调用。 但是，在关闭文件夹的情况下，它可能返回-1表示真正的答案太昂贵而无法获得。 |
从文件夹中获取邮件
Folder类提供了四种从打开的文件夹中检索消息的方法:
| 方法 | 描述 |
|---|---|
| abstract Message getMessage （int messageNumber） | 这将返回文件夹中的第n条消息。 文件夹中的第一条消息是数字1。 |
| 消息[] getMessages （） | 这将返回表示此文件夹中所有消息的Message对象数组。 |
| Message [] getMessages （int start，int end） | 这将从文件夹返回一个Message对象数组，从start开始，以end结束，包括end。 |
| Message [] getMessages （int [] messageNumbers） | 这将返回一个数组，该数组仅包含messageNumbers数组中由number特定标识的那些消息。 |
| void fetch （Message []消息，FetchProfile fp） | 为给定的消息预取FetchProfile中指定的项目。 FetchProfile参数指定要预取的消息中的哪些标头。 |
正在搜索文件夹
如果服务器支持搜索（许多IMAP服务器都支持搜索，而大多数POP服务器不支持），则可以轻松地在文件夹中搜索符合特定条件的邮件。 标准在SearchTerm对象中编码。 以下是两种搜索方法:
| 方法 | 描述 |
|---|---|
| 消息[] search （SearchTerm术语） | 在此文件夹中搜索与指定搜索条件匹配的邮件。 返回包含匹配消息的数组。 如果未找到匹配项，则返回空数组。 |
| 消息[] search （SearchTerm术语，消息[]消息） | 在给定的消息数组中搜索与指定搜索条件匹配的消息。 返回包含匹配消息的数组。 如果未找到匹配项，则返回空数组。 指定的Message对象必须属于此文件夹。 |
Flags
当您需要更改文件夹中整个消息集的标志时，标记修改很有用。 以下是Folder类中提供的方法:
| 方法 | 描述 |
|---|---|
| void setFlags （Message []消息，Flags标志，布尔值） | 在数组中指定的消息上设置指定的标志。 |
| void setFlags （int start，int end，Flags flag，boolean value） | 设置从开始到结束编号的消息上的指定标志，包括开始和结束。 |
| void setFlags （int [] messageNumbers，Flags flag，boolean value） | 在消息编号在数组中的消息上设置指定的标志。 |
| 抽象标志getPermanentFlags （） | 返回此文件夹支持所有消息的标志。 |
