Java Client Exchange Web Services - EWS

Following snippets explains you to write Java Clients that consumes Microsoft Exchange Web Services.

From Exchange Server 2010 Microsoft stopped WEBDAV support on exchange server.  Java Clients using WEBDAV needs to migrate to consume EWS to fetch mail, compose, send  emails ..etc 

Read five email items from inbox

package demo;

import java.net.URI;

import microsoft.exchange.webservices.data.ExchangeCredentials;
import microsoft.exchange.webservices.data.ExchangeService;
import microsoft.exchange.webservices.data.FindItemsResults;
import microsoft.exchange.webservices.data.Item;
import microsoft.exchange.webservices.data.ItemView;
import microsoft.exchange.webservices.data.WebCredentials;
import microsoft.exchange.webservices.data.WellKnownFolderName;

public class EWSDemo {
 public static void main(String[] args) throws Exception {
  ExchangeService service = new ExchangeService();
  // Provide Crendentials
  ExchangeCredentials credentials = new WebCredentials("username", "password");
  service.setCredentials(credentials);

  // Set Exchange WebSevice URL
  service.setUrl(new URI("https://myexchangehost/EWS/exchange.asmx"));

  // Get five items from mail box
  ItemView view = new ItemView(5);

  // Search Inbox
  FindItemsResults findResults = service.findItems(WellKnownFolderName.Inbox, view);

  // iterate thru items
  for (Item item : findResults.getItems()) {
   System.out.println(item.getSubject());
  }

 }
} 

Reading Body 

 
item.getBody()

 Reading body using the method item.getBody() it yields to exception

 
Exception in thread "main" microsoft.exchange.webservices.data.ServiceObjectPropertyException: You must load or assign this property before you can read its value.

To overcome it first the body needs to be loaded.

item.load();

Reading Non default mail box
Some time it is possible for single user to have multiple mail boxes. Following snippet shows you to access non default mail box for eg sysadmin@abc.com

Mailbox mb = new Mailbox();
mb.setAddress("syadmin@abc.com");
FolderId folderId = new FolderId(WellKnownFolderName.Inbox, mb);
  
// Search Inbox syadmin@abc.com
FindItemsResults findResults = service.findItems( folderId, view);

Reading UnRead Emails

  // Get five items from mail box
  ItemView view = new ItemView(5);
  
  //Set Filter to Read UnRead emails
  SearchFilter itemFilter = new SearchFilter.IsEqualTo(EmailMessageSchema.IsRead, true);
  // Search Inbox
  FindItemsResults findResults = service.findItems(WellKnownFolderName.Inbox,itemFilter,view);

  // iterate thru items
  for (Item item : findResults.getItems()) {
     System.out.println(item.getSubject());
  }

Marking mail as read

// iterate thru items
  for (Item item : findResults.getItems()) {
   //Type cast it to EmailMessage
   EmailMessage em = (EmailMessage) item;
   em.setIsRead(true);
   em.update(ConflictResolutionMode.AlwaysOverwrite);
   System.out.println(em.getSubject());
  }

Reading mail Headers and body

// iterate thru items
  for (Item item : findResults.getItems()) {
   item.load();
   String subject=item.getSubject();
   //Read Body
   String body = MessageBody.getStringFromMessageBody(item.getBody());
   System.out.println(subject);
   System.out.println(body);
   //Reading Header
   InternetMessageHeaderCollection headers = item.getInternetMessageHeaders();
   for(InternetMessageHeader header:headers){
    System.out.println("Header Name: "+header.getName()+" Header Value: "+header.getValue() );
   }
  }