nl.nn.adapterframework.filesystem

Class ImapFileSystem

java.lang.Object

nl.nn.adapterframework.filesystem.FileSystemBase<F>

nl.nn.adapterframework.filesystem.ConnectedFileSystemBase<M,C>

nl.nn.adapterframework.filesystem.MailFileSystemBase<jakarta.mail.Message,jakarta.mail.internet.MimeBodyPart,com.sun.mail.imap.IMAPFolder>

nl.nn.adapterframework.filesystem.ImapFileSystem

All Implemented Interfaces:

HasPhysicalDestination, IBasicFileSystem<jakarta.mail.Message>, IMailFileSystem<jakarta.mail.Message,jakarta.mail.internet.MimeBodyPart>, IWithAttachments<jakarta.mail.Message,jakarta.mail.internet.MimeBodyPart>

public class ImapFileSystem
extends MailFileSystemBase<jakarta.mail.Message,jakarta.mail.internet.MimeBodyPart,com.sun.mail.imap.IMAPFolder>

Field Summary

Fields inherited from class nl.nn.adapterframework.filesystem.FileSystemBase

log

Fields inherited from interface nl.nn.adapterframework.filesystem.IMailFileSystem

BCC_RECEPIENTS_KEY, BEST_REPLY_ADDRESS_KEY, CC_RECEPIENTS_KEY, DATETIME_RECEIVED_KEY, DATETIME_SENT_KEY, FROM_ADDRESS_KEY, MAIL_MESSAGE_ID, REPLY_ADDRESS_FIELDS_DEFAULT, REPLY_TO_RECEPIENTS_KEY, RETURN_PATH_HEADER, SENDER_ADDRESS_KEY, TO_RECEPIENTS_KEY

Constructor Summary

Constructors

Constructor and Description
ImapFileSystem()

Method Summary

Modifier and Type	Method and Description
protected void	closeConnection(com.sun.mail.imap.IMAPFolder folder) Close connection to the FileSystem, releasing all resources.
void	configure()
jakarta.mail.Message	copyFile(jakarta.mail.Message f, String destinationFolder, boolean createFolder, boolean resultantMustBeReturned) Copies the file to a another folder.
protected com.sun.mail.imap.IMAPFolder	createConnection() Create a fresh connection to the FileSystem.
void	createFolder(String folderName)
void	deleteFile(jakarta.mail.Message f)
boolean	exists(jakarta.mail.Message f)
void	extractAttachment(jakarta.mail.internet.MimeBodyPart attachment, SaxElementBuilder attachmentsXml)
void	extractEmail(jakarta.mail.Message emailMessage, SaxElementBuilder emailXml)
boolean	folderExists(String foldername)
void	forwardMail(jakarta.mail.Message emailMessage, String destination)
Map<String,Object>	getAdditionalAttachmentProperties(jakarta.mail.internet.MimeBodyPart a)
Map<String,Object>	getAdditionalFileProperties(jakarta.mail.Message f)
String	getAttachmentContentType(jakarta.mail.internet.MimeBodyPart a)
String	getAttachmentFileName(jakarta.mail.internet.MimeBodyPart a)
String	getAttachmentName(jakarta.mail.internet.MimeBodyPart a)
long	getAttachmentSize(jakarta.mail.internet.MimeBodyPart a)
String	getCanonicalName(jakarta.mail.Message f)
jakarta.mail.Message	getFileFromAttachment(jakarta.mail.internet.MimeBodyPart a)
long	getFileSize(jakarta.mail.Message f)
Message	getMimeContent(jakarta.mail.Message emailMessage)
Date	getModificationTime(jakarta.mail.Message f)
String	getName(jakarta.mail.Message f) Get a string representation of an identification of a file.
int	getNumberOfFilesInFolder(String foldername)
String	getParentFolder(jakarta.mail.Message f)
String	getPhysicalDestinationName()
String	getSubject(jakarta.mail.Message emailMessage)
Iterator<jakarta.mail.internet.MimeBodyPart>	listAttachments(jakarta.mail.Message f)
DirectoryStream<jakarta.mail.Message>	listFiles(String foldername) Lists all files in 'folder' or in the 'root' of the filesystem (when folder is null).
jakarta.mail.Message	moveFile(jakarta.mail.Message f, String destinationFolder, boolean createFolder, boolean resultantMustBeReturned) Moves the file to a another folder.
Message	readAttachment(jakarta.mail.internet.MimeBodyPart a)
Message	readFile(jakarta.mail.Message f, String charset)
void	removeFolder(String folderName, boolean removeNonEmptyFolder)
void	setHost(String host) The hostname of the IMAP server
void	setPort(int port) The port of the IMAP server
jakarta.mail.Message	toFile(String filename) Get a file 'F' representation of an identification of a file.
jakarta.mail.Message	toFile(String defaultFolder, String filename) Creates a reference to a file.

Methods inherited from class nl.nn.adapterframework.filesystem.MailFileSystemBase

setAuthAlias, setBaseFolder, setPassword, setReadMimeContents, setReplyAddressFields, setUsername

Methods inherited from class nl.nn.adapterframework.filesystem.ConnectedFileSystemBase

close, getConnection, open, pendingRelease, releaseConnection

Methods inherited from class nl.nn.adapterframework.filesystem.FileSystemBase

getMaxNumberOfMessagesToList, isOpen, setMaxNumberOfMessagesToList

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface nl.nn.adapterframework.filesystem.IMailFileSystem

getReplyAddressFields

Methods inherited from interface nl.nn.adapterframework.filesystem.IBasicFileSystem

close, isOpen, open

Methods inherited from interface nl.nn.adapterframework.core.HasPhysicalDestination

getDomain

Constructor Detail

ImapFileSystem

public ImapFileSystem()

Method Detail

configure

public void configure()
               throws ConfigurationException

Throws:

ConfigurationException

createConnection

protected com.sun.mail.imap.IMAPFolder createConnection()
                                                 throws FileSystemException

Description copied from class: ConnectedFileSystemBase

Create a fresh connection to the FileSystem.

Specified by:

createConnection in class ConnectedFileSystemBase<jakarta.mail.Message,com.sun.mail.imap.IMAPFolder>

Throws:

FileSystemException

closeConnection

protected void closeConnection(com.sun.mail.imap.IMAPFolder folder)
                        throws FileSystemException

Description copied from class: ConnectedFileSystemBase

Close connection to the FileSystem, releasing all resources.

Overrides:

closeConnection in class ConnectedFileSystemBase<jakarta.mail.Message,com.sun.mail.imap.IMAPFolder>

Throws:

FileSystemException

getName

public String getName(jakarta.mail.Message f)

Description copied from interface: IBasicFileSystem

Get a string representation of an identification of a file. Must pair up with the implementation of IBasicFileSystem.toFile(String). Can reflect name a file has in its folder, is not expected to be unique over folders.

getParentFolder

public String getParentFolder(jakarta.mail.Message f)
                       throws FileSystemException

Throws:

FileSystemException

toFile

public jakarta.mail.Message toFile(String filename)
                            throws FileSystemException

Description copied from interface: IBasicFileSystem

Get a file 'F' representation of an identification of a file. Must pair up with the implementation of IBasicFileSystem.getName(Object).

Throws:

FileSystemException

toFile

public jakarta.mail.Message toFile(String defaultFolder,
                                   String filename)
                            throws FileSystemException

Description copied from interface: IBasicFileSystem

Creates a reference to a file. If filename is not absolute, it will be created in 'defaultFolder'.

Throws:

FileSystemException

exists

public boolean exists(jakarta.mail.Message f)
               throws FileSystemException

Throws:

FileSystemException

folderExists

public boolean folderExists(String foldername)
                     throws FileSystemException

Throws:

FileSystemException

getNumberOfFilesInFolder

public int getNumberOfFilesInFolder(String foldername)
                             throws FileSystemException

Specified by:

getNumberOfFilesInFolder in interface IBasicFileSystem<jakarta.mail.Message>

Overrides:

getNumberOfFilesInFolder in class FileSystemBase<jakarta.mail.Message>

Throws:

FileSystemException

listFiles

public DirectoryStream<jakarta.mail.Message> listFiles(String foldername)
                                                throws FileSystemException

Description copied from interface: IBasicFileSystem

Lists all files in 'folder' or in the 'root' of the filesystem (when folder is null). Should list only 'files', no folders.

Throws:

FileSystemException

deleteFile

public void deleteFile(jakarta.mail.Message f)
                throws FileSystemException

Throws:

FileSystemException

moveFile

public jakarta.mail.Message moveFile(jakarta.mail.Message f,
                                     String destinationFolder,
                                     boolean createFolder,
                                     boolean resultantMustBeReturned)
                              throws FileSystemException

Description copied from interface: IBasicFileSystem

Moves the file to a another folder. Does not need to check for existence of the source or non-existence of the destination. Returns the moved file, or null if no file was moved or there is no reference to the moved file.
If the reference to the moved file is unknown after the move, then:
if resultantMustBeReturned is set, then an Exception must be thrown, preferably before the file is moved;
if resultantMustBeReturned is not set, then a null result returned might also mean the file was moved successfully, but with unknown destination;

resultantMustBeReturned - TODO

Throws:

FileSystemException

copyFile

public jakarta.mail.Message copyFile(jakarta.mail.Message f,
                                     String destinationFolder,
                                     boolean createFolder,
                                     boolean resultantMustBeReturned)
                              throws FileSystemException

Description copied from interface: IBasicFileSystem

Copies the file to a another folder. Does not need to check for existence of the source or non-existence of the destination. Returns the copied file, or null if no file was copied or there is no reference to the copied file. If the reference to the copied file is unknown after the copy, then:
if resultantMustBeReturned is set, then an Exception must be thrown, preferably before the file is copied;
if resultantMustBeReturned is not set, then a null result returned might also mean the file was copied successfully, but with unknown destination;

resultantMustBeReturned - TODO

Throws:

FileSystemException

createFolder

public void createFolder(String folderName)
                  throws FileSystemException

Throws:

FileSystemException

removeFolder

public void removeFolder(String folderName,
                         boolean removeNonEmptyFolder)
                  throws FileSystemException

Throws:

FileSystemException

readFile

public Message readFile(jakarta.mail.Message f,
                        String charset)
                 throws FileSystemException,
                        IOException

Throws:

FileSystemException

IOException

listAttachments

public Iterator<jakarta.mail.internet.MimeBodyPart> listAttachments(jakarta.mail.Message f)
                                                             throws FileSystemException

Throws:

FileSystemException

getAttachmentName

public String getAttachmentName(jakarta.mail.internet.MimeBodyPart a)
                         throws FileSystemException

Throws:

FileSystemException

readAttachment

public Message readAttachment(jakarta.mail.internet.MimeBodyPart a)
                       throws FileSystemException,
                              IOException

Throws:

FileSystemException

IOException

getAttachmentSize

public long getAttachmentSize(jakarta.mail.internet.MimeBodyPart a)
                       throws FileSystemException

Throws:

FileSystemException

getAttachmentContentType

public String getAttachmentContentType(jakarta.mail.internet.MimeBodyPart a)
                                throws FileSystemException

Throws:

FileSystemException

getAttachmentFileName

public String getAttachmentFileName(jakarta.mail.internet.MimeBodyPart a)
                             throws FileSystemException

Throws:

FileSystemException

getFileFromAttachment

public jakarta.mail.Message getFileFromAttachment(jakarta.mail.internet.MimeBodyPart a)
                                           throws FileSystemException

Throws:

FileSystemException

getAdditionalAttachmentProperties

public Map<String,Object> getAdditionalAttachmentProperties(jakarta.mail.internet.MimeBodyPart a)
                                                     throws FileSystemException

Throws:

FileSystemException

getFileSize

public long getFileSize(jakarta.mail.Message f)
                 throws FileSystemException

Throws:

FileSystemException

getCanonicalName

public String getCanonicalName(jakarta.mail.Message f)
                        throws FileSystemException

Throws:

FileSystemException

getModificationTime

public Date getModificationTime(jakarta.mail.Message f)
                         throws FileSystemException

Throws:

FileSystemException

getAdditionalFileProperties

public Map<String,Object> getAdditionalFileProperties(jakarta.mail.Message f)
                                               throws FileSystemException

Throws:

FileSystemException

forwardMail

public void forwardMail(jakarta.mail.Message emailMessage,
                        String destination)
                 throws FileSystemException

Throws:

FileSystemException

getPhysicalDestinationName

public String getPhysicalDestinationName()

Specified by:

getPhysicalDestinationName in interface HasPhysicalDestination

Overrides:

getPhysicalDestinationName in class MailFileSystemBase<jakarta.mail.Message,jakarta.mail.internet.MimeBodyPart,com.sun.mail.imap.IMAPFolder>

getSubject

public String getSubject(jakarta.mail.Message emailMessage)
                  throws FileSystemException

Throws:

FileSystemException

getMimeContent

public Message getMimeContent(jakarta.mail.Message emailMessage)
                       throws FileSystemException

Throws:

FileSystemException

extractEmail

public void extractEmail(jakarta.mail.Message emailMessage,
                         SaxElementBuilder emailXml)
                  throws FileSystemException,
                         SAXException

Throws:

FileSystemException

SAXException

extractAttachment

public void extractAttachment(jakarta.mail.internet.MimeBodyPart attachment,
                              SaxElementBuilder attachmentsXml)
                       throws FileSystemException,
                              SAXException

Throws:

FileSystemException

SAXException

setHost

public void setHost(String host)

The hostname of the IMAP server

setPort

public void setPort(int port)

The port of the IMAP server

Default value

993