Добавление возможностей электронной почты в приложения Java с помощью Microsoft Graph

В этой статье описано, как расширить приложение, созданное в разделе Сборка приложений Java, с помощью Microsoft Graph с помощью API почты Microsoft Graph. Вы используете Microsoft Graph для вывода списка папки "Входящие" пользователя и отправки сообщения электронной почты.

Перечисление папки "Входящие" пользователя

Начните с перечисления сообщений в почтовом ящике пользователя.

Откройте Graph.java и добавьте в класс следующую функцию Graph .

public static MessageCollectionResponse getInbox() throws Exception {
    // Ensure client isn't null
    if (_userClient == null) {
        throw new Exception("Graph has not been initialized for user auth");
    }

    return _userClient.me()
        .mailFolders()
        .byMailFolderId("inbox")
        .messages()
        .get(requestConfig -> {
            requestConfig.queryParameters.select = new String[] { "from", "isRead", "receivedDateTime", "subject" };
            requestConfig.queryParameters.top = 25;
            requestConfig.queryParameters.orderby = new String[] { "receivedDateTime DESC" };
        });
}

Замените пустую listInbox функцию в App.java следующей.

private static void listInbox() {
    try {
        final MessageCollectionResponse messages = Graph.getInbox();

        // Output each message's details
        for (Message message: messages.getValue()) {
            System.out.println("Message: " + message.getSubject());
            System.out.println("  From: " + message.getFrom().getEmailAddress().getName());
            System.out.println("  Status: " + (message.getIsRead() ? "Read" : "Unread"));
            System.out.println("  Received: " + message.getReceivedDateTime()
                // Values are returned in UTC, convert to local time zone
                .atZoneSameInstant(ZoneId.systemDefault()).toLocalDateTime()
                .format(DateTimeFormatter.ofLocalizedDateTime(FormatStyle.SHORT)));
        }

        final Boolean moreMessagesAvailable = messages.getOdataNextLink() != null;
        System.out.println("\nMore messages available? " + moreMessagesAvailable);
    } catch (Exception e) {
        System.out.println("Error getting inbox");
        System.out.println(e.getMessage());
    }
}

Запустите приложение, войдите в систему и выберите вариант 2, чтобы получить список папки "Входящие".

Please choose one of the following options:
0. Exit
1. Display access token
2. List my inbox
3. Send mail
4. Make a Graph call
2
Message: Updates from Ask HR and other communities
  From: Contoso Demo on Yammer
  Status: Read
  Received: 12/30/2021, 4:54:54 AM
Message: Employee Initiative Thoughts
  From: Patti Fernandez
  Status: Read
  Received: 12/28/2021, 5:01:10 PM
Message: Voice Mail (11 seconds)
  From: Alex Wilber
  Status: Unread
  Received: 12/28/2021, 5:00:46 PM
Message: Our Spring Blog Update
  From: Alex Wilber
  Status: Unread
  Received: 12/28/2021, 4:49:46 PM
Message: Atlanta Flight Reservation
  From: Alex Wilber
  Status: Unread
  Received: 12/28/2021, 4:35:42 PM
Message: Atlanta Trip Itinerary - down time
  From: Alex Wilber
  Status: Unread
  Received: 12/28/2021, 4:22:04 PM

...

More messages available? true

Описание getInbox

Рассмотрим код в getInbox функции.

Доступ к известным почтовым папкам

Функция использует построитель _userClient.me().mailFolders().byMailFolderId("inbox").messages() запросов, который создает запрос к API списка сообщений . Так как он включает построитель byMailFolderId("inbox") запросов, API возвращает только сообщения в запрошенной папке почты. В этом случае, так как папка "Входящие" является хорошо известной папкой по умолчанию в почтовом ящике пользователя, она доступна по известному имени. Доступ к папкам без изменений можно получить таким же образом, заменив известное имя свойством идентификатора почтовой папки. Дополнительные сведения о доступных известных именах папок см. в разделе Тип ресурса mailFolder.

Доступ к коллекции

getUser В отличие от функции из предыдущего раздела, которая возвращает один объект, этот метод возвращает коллекцию сообщений. Большинство API в Microsoft Graph, возвращающих коллекцию, не возвращают все доступные результаты в одном ответе. Вместо этого они используют разбиение на страницы для возврата части результатов, предоставляя метод для клиентов, чтобы запросить следующую страницу.

Размеры страниц по умолчанию

API, использующие разбиение на страницы, реализуют размер страницы по умолчанию. Для сообщений значение по умолчанию — 10. Клиенты могут запрашивать больше (или меньше) с помощью параметра запроса $top . В getInboxдобавление $top выполняется со свойством top в конфигурации запроса.

Примечание.

Значение, заданное в top , является верхней границей, а не явным числом. API возвращает количество сообщений до указанного значения.

Получение последующих страниц

Если на сервере доступно больше результатов, ответы коллекции содержат @odata.nextLink свойство с URL-адресом API для доступа к следующей странице. Клиентская библиотека Java предоставляет getOdataNextLink метод для объектов ответа коллекции. Если этот метод возвращает значение, отличное от NULL, доступны дополнительные результаты.

Сортировка коллекций

Функция использует orderBy свойство в конфигурации запроса для запроса результатов, отсортированных по времени получения сообщения (receivedDateTime свойство). Он включает в себя DESC ключевое слово, чтобы сообщения, полученные в последнее время, были перечислены первыми. Это свойство добавляет параметр запроса $orderby в вызов API.

Отправка почты

Теперь добавьте возможность отправки сообщения электронной почты в качестве пользователя, прошедшего проверку подлинности.

Откройте Graph.java и добавьте в класс следующую функцию Graph .

public static void sendMail(String subject, String body, String recipient) throws Exception {
    // Ensure client isn't null
    if (_userClient == null) {
        throw new Exception("Graph has not been initialized for user auth");
    }

    // Create a new message
    final Message message = new Message();
    message.setSubject(subject);
    final ItemBody itemBody = new ItemBody();
    itemBody.setContent(body);
    itemBody.setContentType(BodyType.Text);
    message.setBody(itemBody);

    final EmailAddress emailAddress = new EmailAddress();
    emailAddress.setAddress(recipient);
    final Recipient toRecipient = new Recipient();
    toRecipient.setEmailAddress(emailAddress);
    message.setToRecipients(List.of(toRecipient));

    final SendMailPostRequestBody postRequest = new SendMailPostRequestBody();
    postRequest.setMessage(message);

    // Send the message
    _userClient.me()
        .sendMail()
        .post(postRequest);
}

Замените пустую sendMail функцию в App.java следующей.

private static void sendMail() {
    try {
        // Send mail to the signed-in user
        // Get the user for their email address
        final User user = Graph.getUser();
        final String email = user.getMail() == null ? user.getUserPrincipalName() : user.getMail();

        Graph.sendMail("Testing Microsoft Graph", "Hello world!", email);
        System.out.println("\nMail sent.");
    } catch (Exception e) {
        System.out.println("Error sending mail");
        System.out.println(e.getMessage());
    }
}

Запустите приложение, войдите в систему и выберите вариант 3, чтобы отправить себе сообщение электронной почты.
```
Please choose one of the following options:
0. Exit
1. Display access token
2. List my inbox
3. Send mail
4. Make a Graph call
3

Mail sent.
```
Примечание.

Если вы тестируете с помощью клиента разработчика из Программы разработчика Microsoft 365, отправленное сообщение электронной почты может не быть доставлено, и вы можете получить отчет о недоставке. Если вы хотите разблокировать отправку почты из клиента, обратитесь в службу поддержки через Центр администрирования Microsoft 365.
Чтобы убедиться, что сообщение получено, выберите вариант 2, чтобы получить список папки "Входящие".

Объяснение sendMail

Рассмотрим код в sendMail функции.

Отправка почты

Функция использует построитель _userClient.me().sendMail() запросов, который создает запрос к API отправки почты . Построитель запросов принимает объект, SendMailPostRequestBody содержащий сообщение для отправки.

Создание объектов

В отличие от предыдущих вызовов Microsoft Graph, которые считывают только данные, этот вызов создает данные. Чтобы создать элементы с помощью клиентской библиотеки, создайте экземпляр класса , представляющего данные (в данном случае ) com.microsoft.graph.models.Messageс помощью new ключевое слово, задайте нужные свойства, а затем отправьте их в вызове API. Так как вызов отправляет данные, post вместо используется getметод .

Следующее действие

Добавление дополнительных API Microsoft Graph

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-06-12

Добавление возможностей электронной почты в приложения Java с помощью Microsoft Graph

Перечисление папки "Входящие" пользователя

Описание getInbox

Доступ к известным почтовым папкам

Доступ к коллекции

Размеры страниц по умолчанию

Получение последующих страниц

Сортировка коллекций

Отправка почты

Объяснение sendMail

Отправка почты

Создание объектов

Следующее действие

Обратная связь

Дополнительные ресурсы