# officedev/ews-java-api architecture

> Architecture diagram of the GitHub repository officedev/ews-java-api, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/officedev/ews-java-api
- Repository: https://github.com/officedev/ews-java-api

## Overview

The EWS Java API is a client library for applications accessing Exchange mailbox data. A typical workflow configures an Exchange service, optionally discovers the account’s endpoint, constructs an operation request, exchanges SOAP/XML with Exchange, and exposes parsed service objects and responses. The tree and excerpts support the core serialization, request, and object-model layers; major API domains are represented from the source tree, but their internal call paths were not sampled.

Main entry points: [`src/main/java/microsoft/exchange/webservices/data/core/ExchangeService.java`](https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/ExchangeService.java) (Exchange service), [`src/main/java/microsoft/exchange/webservices/data/core/request/ServiceRequestBase.java`](https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/request/ServiceRequestBase.java) (Request execution), [`src/main/java/microsoft/exchange/webservices/data/core/service/ServiceObject.java`](https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/service/ServiceObject.java) (Service objects), [`src/main/java/microsoft/exchange/webservices/data/core/request`](https://github.com/officedev/ews-java-api/tree/master/src/main/java/microsoft/exchange/webservices/data/core/request) (Operation requests)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client and discovery"]
  node_exchange["Exchange service"]
  node_autodiscover["Autodiscover"]
end

subgraph group_transport["Requests and XML"]
  node_operations["Operation requests"]
  node_requestbase["Request execution"]
  node_xmlreader["XML reader"]
  node_xmlwriter["XML writer"]
  node_response["Service responses"]
end

subgraph group_model["Mailbox object model"]
  node_serviceobject["Service objects<br/>[ServiceObject.java]"]
  node_propertybag["Property storage<br/>[PropertyBag.java]"]
  node_schema["Object schemas"]
  node_propertydefs["Property definitions"]
end

subgraph group_domains["Mailbox capabilities"]
  node_itemsfolders["Items and folders"]
  node_search["Search and filters"]
  node_availability["Availability"]
  node_sync["Mailbox synchronization"]
  node_notifications["Notifications"]
end

node_application(("Java application"))
node_exchangehost(("Exchange server"))

node_application -.->|"uses"| node_exchange
node_exchange -->|"discovers settings"| node_autodiscover
node_exchange -.->|"creates requests"| node_operations
node_operations -.->|"executes via"| node_requestbase
node_requestbase -->|"uses service"| node_exchange
node_requestbase -->|"reads XML"| node_xmlreader
node_requestbase -->|"writes XML"| node_xmlwriter
node_requestbase -->|"parses response"| node_response
node_exchangehost -.->|"exchanges SOAP"| node_requestbase
node_xmlreader -->|"loads objects"| node_serviceobject
node_serviceobject -->|"stores properties"| node_propertybag
node_serviceobject -->|"gets schema"| node_schema
node_schema -.->|"registers properties"| node_propertydefs
node_propertydefs -->|"writes XML"| node_xmlwriter
node_exchange -.->|"offers operations"| node_itemsfolders
node_exchange -.->|"offers search"| node_search
node_exchange -.->|"offers availability"| node_availability
node_exchange -.->|"offers synchronization"| node_sync
node_exchange -.->|"offers notifications"| node_notifications

click node_exchange "https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/ExchangeService.java"
click node_autodiscover "https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/autodiscover/AutodiscoverService.java"
click node_operations "https://github.com/officedev/ews-java-api/tree/master/src/main/java/microsoft/exchange/webservices/data/core/request"
click node_requestbase "https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/request/ServiceRequestBase.java"
click node_xmlreader "https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/EwsServiceXmlReader.java"
click node_xmlwriter "https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/EwsServiceXmlWriter.java"
click node_response "https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/response/ServiceResponse.java"
click node_serviceobject "https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/service/ServiceObject.java"
click node_propertybag "https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/PropertyBag.java"
click node_schema "https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/service/schema/ServiceObjectSchema.java"
click node_propertydefs "https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/property/definition/PropertyDefinitionBase.java"
click node_itemsfolders "https://github.com/officedev/ews-java-api/tree/master/src/main/java/microsoft/exchange/webservices/data/core/service"
click node_search "https://github.com/officedev/ews-java-api/tree/master/src/main/java/microsoft/exchange/webservices/data/search"
click node_availability "https://github.com/officedev/ews-java-api/tree/master/src/main/java/microsoft/exchange/webservices/data/misc/availability"
click node_sync "https://github.com/officedev/ews-java-api/tree/master/src/main/java/microsoft/exchange/webservices/data/sync"
click node_notifications "https://github.com/officedev/ews-java-api/tree/master/src/main/java/microsoft/exchange/webservices/data/notification"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_exchange,node_autodiscover toneBlue
class node_operations,node_requestbase,node_xmlreader,node_xmlwriter,node_response toneAmber
class node_serviceobject,node_propertybag,node_schema,node_propertydefs,node_exchangehost toneMint
class node_itemsfolders,node_search,node_availability,node_sync,node_notifications toneRose
class node_application toneIndigo
```

## Components

### Client and discovery

- [Exchange service](https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/ExchangeService.java): `src/main/java/microsoft/exchange/webservices/data/core/ExchangeService.java`
- [Autodiscover](https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/autodiscover/AutodiscoverService.java): `src/main/java/microsoft/exchange/webservices/data/autodiscover/AutodiscoverService.java`

### Requests and XML

- [Operation requests](https://github.com/officedev/ews-java-api/tree/master/src/main/java/microsoft/exchange/webservices/data/core/request): `src/main/java/microsoft/exchange/webservices/data/core/request`
- [Request execution](https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/request/ServiceRequestBase.java): `src/main/java/microsoft/exchange/webservices/data/core/request/ServiceRequestBase.java`
- [XML reader](https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/EwsServiceXmlReader.java): `src/main/java/microsoft/exchange/webservices/data/core/EwsServiceXmlReader.java`
- [XML writer](https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/EwsServiceXmlWriter.java): `src/main/java/microsoft/exchange/webservices/data/core/EwsServiceXmlWriter.java`
- [Service responses](https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/response/ServiceResponse.java): `src/main/java/microsoft/exchange/webservices/data/core/response/ServiceResponse.java`

### Mailbox object model

- [Service objects](https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/service/ServiceObject.java): `src/main/java/microsoft/exchange/webservices/data/core/service/ServiceObject.java`
- [Property storage](https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/PropertyBag.java): `src/main/java/microsoft/exchange/webservices/data/core/PropertyBag.java`
- [Object schemas](https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/core/service/schema/ServiceObjectSchema.java): `src/main/java/microsoft/exchange/webservices/data/core/service/schema/ServiceObjectSchema.java`
- [Property definitions](https://github.com/officedev/ews-java-api/blob/master/src/main/java/microsoft/exchange/webservices/data/property/definition/PropertyDefinitionBase.java): `src/main/java/microsoft/exchange/webservices/data/property/definition/PropertyDefinitionBase.java`

### Mailbox capabilities

- [Items and folders](https://github.com/officedev/ews-java-api/tree/master/src/main/java/microsoft/exchange/webservices/data/core/service): `src/main/java/microsoft/exchange/webservices/data/core/service`
- [Search and filters](https://github.com/officedev/ews-java-api/tree/master/src/main/java/microsoft/exchange/webservices/data/search): `src/main/java/microsoft/exchange/webservices/data/search`
- [Availability](https://github.com/officedev/ews-java-api/tree/master/src/main/java/microsoft/exchange/webservices/data/misc/availability): `src/main/java/microsoft/exchange/webservices/data/misc/availability`
- [Mailbox synchronization](https://github.com/officedev/ews-java-api/tree/master/src/main/java/microsoft/exchange/webservices/data/sync): `src/main/java/microsoft/exchange/webservices/data/sync`
- [Notifications](https://github.com/officedev/ews-java-api/tree/master/src/main/java/microsoft/exchange/webservices/data/notification): `src/main/java/microsoft/exchange/webservices/data/notification`

### Other components

- **Java application**
- **Exchange server**

## Connections

- Java application → Exchange service: uses
- Exchange service → Autodiscover: discovers settings (evidence: `src/main/java/microsoft/exchange/webservices/data/core/ExchangeService.java`)
- Exchange service → Operation requests: creates requests (evidence: `src/main/java/microsoft/exchange/webservices/data/core/ExchangeService.java`)
- Operation requests → Request execution: executes via (evidence: `src/main/java/microsoft/exchange/webservices/data/core/request/HangingServiceRequestBase.java`)
- Request execution → Exchange service: uses service (evidence: `src/main/java/microsoft/exchange/webservices/data/core/request/ServiceRequestBase.java`)
- Request execution → XML reader: reads XML (evidence: `src/main/java/microsoft/exchange/webservices/data/core/request/ServiceRequestBase.java`)
- Request execution → XML writer: writes XML (evidence: `src/main/java/microsoft/exchange/webservices/data/core/request/ServiceRequestBase.java`)
- Request execution → Service responses: parses response (evidence: `src/main/java/microsoft/exchange/webservices/data/core/request/ServiceRequestBase.java`)
- Exchange server → Request execution: exchanges SOAP
- XML reader → Service objects: loads objects (evidence: `src/main/java/microsoft/exchange/webservices/data/core/EwsServiceXmlReader.java`)
- Service objects → Property storage: stores properties (evidence: `src/main/java/microsoft/exchange/webservices/data/core/service/ServiceObject.java`)
- Service objects → Object schemas: gets schema (evidence: `src/main/java/microsoft/exchange/webservices/data/core/service/ServiceObject.java`)
- Object schemas → Property definitions: registers properties (evidence: `src/main/java/microsoft/exchange/webservices/data/core/service/schema/ServiceObjectSchema.java`)
- Property definitions → XML writer: writes XML (evidence: `src/main/java/microsoft/exchange/webservices/data/property/definition/PropertyDefinitionBase.java`)
- Exchange service → Items and folders: offers operations (evidence: `src/main/java/microsoft/exchange/webservices/data/core/service/ServiceObject.java`)
- Exchange service → Search and filters: offers search
- Exchange service → Availability: offers availability
- Exchange service → Mailbox synchronization: offers synchronization
- Exchange service → Notifications: offers notifications
