Documentation – Работа с Microsoft Graph клиент

Java: Настройка на Azure AD & удостоверяване за Microsoft Graph - Aspose.Email за Java

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for Java предлага пълна интеграция с Microsoft Graph, позволявайки на разработчиците да управляват съобщения, контакти, календари и задачи от акаунти Microsoft 365. Това ръководство ви води през създаването на Azure AD приложение и конфигурирането на удостоверяване, за да започнете програмиране с Aspose.Email GraphClient.

Преди да използвате Microsoft Graph API с Aspose.Email, трябва да регистрирате приложение в Azure Active Directory (Azure AD) и да конфигурирате удостоверяване. Тази страница обхваща:

Създаване на Azure AD приложение (проект).
Назначаване на необходимите разрешения за Microsoft Graph.
Генериране на данни за достъп (client ID, client secret, tenant ID).
Удостоверяване в Java с помощта на доставчиците на токени на Aspose.Email.

След като завършите, ще сте готови да взаимодействате с Microsoft Graph от вашето Java приложение.

1. Създаване на Azure AD приложение

Следвайте тези стъпки, за да регистрирате вашето приложение в Azure портала:

Влезте в Azure портал.
Отидете на Azure Active Directory → App Registrations → New Registration.

Въведете Name за вашето приложение (например, AsposeEmailGraphApp).
Изберете поддържани типове акаунти:
- Единствено-тенант (ако само вашата организация ще я използва)
- Мултитенант (ако множество организации се нуждаят от достъп)
По желание задайте Redirect URI (необходимо за интерактивно или уеб удостоверяване).
Кликнете Register.

2. Създаване на клиентска тайна

След регистрацията, отидете на Certificates & Secrets → New Client Secret.
Добавете описание и период на валидност.

Копирайте генерираната стойност на тайния ключ – повече няма да я видите.

Поддържайте client secret в безопасност; той е необходим за удостоверяване на поверителен клиент.

Трябва да видите панела с ново регистрираните приложения.

3. Конфигуриране на разрешения за Microsoft Graph

Отидете на API Permissions → Add a Permission → Microsoft Graph.
Изберете тип разрешения: Delegated или Application, в зависимост от вашия сценарий.
Добавете разрешения, необходими за операциите на Aspose.Email:
- Contacts.ReadWrite – за управление на контакти
- Calendars.ReadWrite – за управление на календари
- Mail.ReadWrite – за четене и изпращане на съобщения
- Tasks.ReadWrite – за управление на задачи
Кликнете Grant Admin Consent, ако е необходимо.

4. Позволяване на потоци за публичен клиент

Укажете дали приложението е публичен клиент. Подходящо за приложения, използващи потоци за предоставяне на токени, които не използват пренасочващ URI.

5. Удостоверяване в Microsoft Graph

Поддържани методи за удостоверяване в Aspose.Email

Удостоверяване чрез поверителен клиент

Използвайте AzureConfidentialTokenProvider за удостоверяване, когато имате client ID, client secret и tenant ID:

AzureConfidentialTokenProvider provider = new AzureConfidentialTokenProvider(
    tenantId,
    clientId,
    clientSecret
);

IGraphClient client = GraphClient.getClient(provider, tenantId);
client.setResource(ResourceType.Users);
client.setResourceId(username);
client.setEndpoint("https://graph.microsoft.com");

Това настройва напълно удостоверен IGraphClient, готов за взаимодействие с Microsoft Graph.

Удостоверяване чрез ROPC (потребителско име & парола)

За сценарии, при които разполагате с потребителско име и парола, използвайте AzureROPCConfiguration:

AzureROPCConfiguration ropcConfig = new AzureROPCConfiguration(
    tenantId,
    clientId,
    clientSecret,
    username,
    password
);

IGraphClient client = GraphClient.getClient(ropcConfig, tenantId);
client.setResource(ResourceType.Users);
client.setResourceId(username);
client.setEndpoint("https://graph.microsoft.com");

Персонализирани доставчици на токени за Microsoft Graph

Aspose.Email for Java се интегрира с Microsoft Graph чрез IGraphClient интерфейс. За удостоверяване на заявките се изисква имплементация на ITokenProvider е задължително. Въпреки че повечето разработчици използват вградени доставчици за удостоверяване, има сценарии, при които може да искате да създадете свой собствен доставчик, например при работа с потока Resource Owner Password Credentials (ROPC).

1. Имплементиране на ITokenProvider чрез AzureROPCTokenProvider

Този клас предоставя имплементация на ITokenProvider чрез потока Azure Resource Owner Password Credentials (ROPC). Следният пример е само за демонстрационни цели. В продукция препоръчваме използването на по-сигурни потоци като удостоверения за клиент или код за упълномощаване с PKCE.

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLDecoder;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

/**
 * <p>
 * Azure resource owner password credential (ROPC) token provider
 * https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
 * https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth
 * https://portal.azure.com
 * https://developer.microsoft.com/en-us/graph/graph-explorer/#
 * token parser https://jwt.io
 * </p>
 */
class AzureROPCTokenProvider implements ITokenProvider {

    private static final String GRANT_TYPE = "password";

    private final String clientId;
    private final String clientSecret;
    private final String userName;
    private final String password;
    private final String tenant;
    private final String scope;

    private OAuthToken token;

    public AzureROPCTokenProvider(String tenant, String clientId, String clientSecret,
                                  String userName, String password, String[] scopeAr) {
        this.tenant = tenant;
        this.clientId = clientId;
        this.clientSecret = clientSecret;
        this.userName = userName;
        this.password = password;
        this.scope = joinToStr(scopeAr, " ");
    }

    public synchronized OAuthToken getAccessToken(boolean ignoreExistingToken) {
        if (this.token != null && !this.token.getExpired() && !ignoreExistingToken)
            return this.token;
        token = null;

        Map<String, String> tokenArgs = getToken();

        java.util.Calendar c = java.util.Calendar.getInstance();
        c.add(java.util.Calendar.SECOND, Integer.parseInt(tokenArgs.get("expires_in")));
        token = new OAuthToken(tokenArgs.get("access_token"), TokenType.AccessToken, c.getTime());
        return token;
    }

    public final OAuthToken getAccessToken() {
        return getAccessToken(false);
    }

    public void dispose() {
    }

    private String getEncodedParameters() {
        return "client_id=" + urlEncode(clientId) + "&scope=" + urlEncode(scope) + "&username=" + urlEncode(userName)
                + "&password=" + urlEncode(password) + "&grant_type="
                + urlEncode(GRANT_TYPE);
    }

    private String getUri() {
        if (tenant == null || tenant.trim().isEmpty())
            return "https://login.microsoftonline.com/common/oauth2/v2.0/token";
        else
            return "https://login.microsoftonline.com/" + tenant + "/oauth2/v2.0/token";
    }

    private Map<String, String> getToken() {
        try {
            HttpURLConnection connection = (HttpURLConnection) new URL(getUri()).openConnection();
            connection.setRequestMethod("POST");

            byte[] requestData = getEncodedParameters().getBytes(StandardCharsets.UTF_8);

            connection.setUseCaches(false);
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            connection.setRequestProperty("Content-Length", "" + requestData.length);

            final OutputStream st = connection.getOutputStream();
            try {
                st.write(requestData, 0, requestData.length);
            } finally {
                st.flush();
                st.close();
            }

            connection.connect();

            if (connection.getResponseCode() >= HttpURLConnection.HTTP_BAD_REQUEST) {
                throw new IllegalAccessError("Operation failed: " + connection.getResponseCode() + "/" +
                        connection.getResponseMessage() + "\r\nDetails:\r\n{2}"
                        + readInputStream(connection.getErrorStream()));
            }

            String responseText = readInputStream(connection.getInputStream());

            Map<String, String> result = new HashMap<>();
            String[] fromJsonToKeyValue = responseText.replace("{", "").replace("}", "")
                    .replace("\"", "").replace("\r", "")
                    .replace("\n", "").split(",");
            for (String keyValue : fromJsonToKeyValue) {
                String[] pair = keyValue.split(":");
                String name = pair[0].trim().toLowerCase();
                String value = urlDecode(pair[1].trim());
                result.put(name, value);
            }

            return result;
        } catch (IOException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlEncode(String value) {
        try {
            return URLEncoder.encode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlDecode(String value) {
        try {
            return URLDecoder.decode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String readInputStream(InputStream is) {
        if (is == null)
            return "";

        BufferedReader reader = new BufferedReader(new InputStreamReader(is));
        StringBuilder result = new StringBuilder();
        String line;
        try {
            while ((line = reader.readLine()) != null) {
                result.append(line);
            }
        } catch (IOException e) {
            // ignore
        }
        return result.toString();
    }

    static String joinToStr(String[] arr, String sep) {
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < arr.length; i++) {
            if (i > 0)
                sb.append(sep);
            sb.append(arr[i]);
        }
        return sb.toString();
    }
}

2. Създаване на обект ITokenProvider

Този IGraphClient интерфейсът е отговорен за създаване на заявки, изпращането им към Microsoft Graph и обработката на отговорите. За да създадете инстанция на IGraphClient, трябва да предоставите имплементация на ITokenProvider. Доставчикът на токени удостоверява заявките, като предоставя валиден OAuth токен за достъп.

Следният пример с код демонстрира как да създадете базова вграденa имплементация на ITokenProvider интерфейс, който е необходим за удостоверяване на заявки към Microsoft Graph:

ITokenProvider tokenProvider = new ITokenProvider() {
    Date expirationDate = null;

    @Override
    public void dispose() {
        // Clean up resources if necessary
    }

    @Override
    public OAuthToken getAccessToken(boolean ignoreExistingToken) {
        // Retrieve an OAuth access token.
        // If ignoreExistingToken is true, always request a new token.
        // Otherwise, return the existing token if it is valid, or request a new one.
        return null;
    }

    @Override
    public OAuthToken getAccessToken() {
        // Return a valid OAuth token.
        // If no valid token exists, request a new one.
        return new OAuthToken("token", expirationDate);
    }
};

3. Използване на персонализирания доставчик на токени

След като ITokenProvider е настроен, можете да създадете GraphClient инстанция. Този клиент ще използва предоставения доставчик на токени за удостоверяване при извикване на Microsoft Graph.

ITokenProvider provider = new AzureROPCTokenProvider(
        tenantId,
        clientId,
        clientSecret,
        userName,
        password,
        new String[] {"https://graph.microsoft.com/.default"}
);

IGraphClient client = GraphClient.getClient(provider, tenantId);
client.setResource(ResourceType.Users);
client.setResourceId(userName);
client.setEndpoint("https://graph.microsoft.com");

// Now you can call Microsoft Graph APIs
var folders = client.listFolders(null);
for (GraphFolderInfo folder : folders) {
    System.out.println(folder.getDisplayName());
}

След като клиентът е създаден и удостоверен, можете да започнете да изпращате заявки към Microsoft Graph услуги.

Java: Работа с Microsoft Graph в Aspose.Email for Java

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for Java предоставя надеждна интеграция с Microsoft Graph, позволявайки на разработчиците да достъпват и управляват данни от пощенски кутии като съобщения, папки, контакти, календари и задачи. Използвайки IGraphClient Чрез API можете да се удостоверявате, задавате заявки и извършвате операции върху акаунти в Microsoft 365 директно от вашите Java приложения.

Следващите раздели обхващат различни аспекти на работа с Microsoft Graph в Aspose.Email for Java:

Удостоверяване с Microsoft Graph

Използване на OData заявки в Microsoft Graph

Управление на контакти в Microsoft Graph

Управление на календари в Microsoft Graph

Управление на задачи в Microsoft Graph

Всяка страница съдържа подробни обяснения, налични API методи и примерен код.

Java: Функции за ползване на Microsoft Graph

Mon, 01 Jan 0001 00:00:00 +0000

Създаване на проект в администраторския център на Azure Active Directory

Проект трябва да се създаде в администраторския център на Azure Active Directory за потребител с акаунт в MS Office.

Стъпки за създаване на проект в администраторския център на Azure Active Directory

По-долу е стъпка по стъпка ръководство за създаване на проект в администраторския център на Azure Active Directory.

1. Отидете в Azure Active Directory и влезте с вашите MS Office идентификационни данни.

Azure Active Directory Връзка - https://aad.portal.azure.com/

2. Създаване на Azure AD приложение във вашия тенант.

В лявото меню кликнете етикета Azure Active Directory. Това ще отвори панела за Azure Active Directory. На този екран ще видите етикета App registrations. Това е отправната точка за регистриране на Azure AD приложение. Този панел ще ви позволи да създадете ново приложение за Azure AD.

Кликнете върху бутона New registration, за да създадете ново приложение.

3. Сега ще видите новия панел за регистрация на приложение.

Name Това ще бъде името на вашето приложение.
Supported account types Този раздел ще ограничи достъпа.

Кликнете бутона Register.

4. Трябва да видите панела с ново регистрираните приложения.

Application (client) ID ID на вашето приложение.
Directory (tenant) ID ID на Azure AD тенанта.

5. Позволяване на разрешения за Microsoft Graph API.

Кликнете върху етикета API permissions.

Azure вече ви е предоставил делегирано разрешение User.Read за вашето приложение. Това разрешение ще ни позволи да четем информация за потребителя, който е влязъл. Това са разрешения за Microsoft Graph API, които можем да наричаме Scopes.

Пълният списък със обхвати (scopes) за Microsoft Graph API - https://docs.microsoft.com/en-us/graph/permissions-reference.

Кликнете бутона + Add a permission и изберете Microsoft Graph.

Кликнете върху Delegated permissions. Сега виждате списък с разрешения, достъпни за Microsoft Graph API.

Изберете необходимите разрешения, кликнете бутона Add permissions.

Кликнете бутона Grant admin consent.

6. Позволяване на потоци за публичен клиент.

Посочва дали приложението е публичен клиент. Подходящо за приложения, използващи потоци за предоставяне на токени, които не използват пренасочващ URI.

7. Създаване на ключ за приложението

Помощни класове

Следните помощни класове са необходими за изпълнението на кода в този раздел. Тези класове служат само за опростяване на демонстрацията.

Клас AzureROPCTokenProvider

Инстанция на IGraphClient класът обработва създаването на заявки, изпращането им към Microsoft Graph API и обработката на отговорите. За да създадете нова инстанция на този клас, трябва да предоставите инстанция на ITokenProvider, който може да удостоверява заявки към Microsoft Graph.

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLDecoder;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

/**
 * <p>
 * Azure resource owner password credential (ROPC) token provider
 * https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
 * https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth
 * https://portal.azure.com
 * https://developer.microsoft.com/en-us/graph/graph-explorer/#
 * token parser https://jwt.io
 * </p>
 */
class AzureROPCTokenProvider implements ITokenProvider {

    private static final String GRANT_TYPE = "password";

    private final String clientId;
    private final String clientSecret;
    private final String userName;
    private final String password;
    private final String tenant;
    private final String scope;

    private OAuthToken token;

    public AzureROPCTokenProvider(String tenant, String clientId, String clientSecret,
                                  String userName, String password, String[] scopeAr) {
        this.tenant = tenant;
        this.clientId = clientId;
        this.clientSecret = clientSecret;
        this.userName = userName;
        this.password = password;
        this.scope = joinToStr(scopeAr, " ");
    }

    public synchronized OAuthToken getAccessToken(boolean ignoreExistingToken) {
        if (this.token != null && !this.token.getExpired() && !ignoreExistingToken)
            return this.token;
        token = null;

        Map<String, String> tokenArgs = geToken();

        java.util.Calendar c = java.util.Calendar.getInstance();
        c.add(java.util.Calendar.SECOND, Integer.parseInt(tokenArgs.get("expires_in")));
        token = new OAuthToken(tokenArgs.get("access_token"), TokenType.AccessToken, c.getTime());
        return token;
    }

    public final OAuthToken getAccessToken() {
        return getAccessToken(false);
    }

    public void dispose() {
    }

    private String getEncodedParameters() {
        return "client_id=" + urlEncode(clientId) + "&scope=" + urlEncode(scope) + "&username=" + urlEncode(userName)
                + "&password=" + urlEncode(password) + "&grant_type="
                + urlEncode(GRANT_TYPE);
    }

    private String getUri() {
        if (tenant == null || tenant.trim().isEmpty())
            return "https://login.microsoftonline.com/common/oauth2/v2.0/token";
        else
            return "https://login.microsoftonline.com/" + tenant + "/oauth2/v2.0/token";
    }

    private Map<String, String> geToken() {
        try {
            HttpURLConnection connection = (HttpURLConnection) new URL(getUri()).openConnection();
            connection.setRequestMethod("POST");

            byte[] requestData = getEncodedParameters().getBytes(StandardCharsets.UTF_8);

            connection.setUseCaches(false);
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            connection.setRequestProperty("Content-Length", "" + requestData.length);

            final OutputStream st = connection.getOutputStream();
            try {
                st.write(requestData, 0, requestData.length);
            } finally {
                st.flush();
                st.close();
            }

            connection.connect();

            if (connection.getResponseCode() >= HttpURLConnection.HTTP_BAD_REQUEST) {
                throw new IllegalAccessError("Operation failed: " + connection.getResponseCode() + "/" +
                        connection.getResponseMessage() + "\r\nDetails:\r\n{2}"
                        + readInputStream(connection.getErrorStream()));
            }

            String responseText = readInputStream(connection.getInputStream());

            Map<String, String> result = new HashMap<>();
            String[] fromJsonToKeyValue = responseText.replace("{", "").replace("}", "")
                    .replace("\"", "").replace("\r", "")
                    .replace("\n", "").split(",");
            for (String keyValue : fromJsonToKeyValue) {
                String[] pair = keyValue.split(":");
                String name = pair[0].trim().toLowerCase();
                String value = urlDecode(pair[1].trim());
                result.put(name, value);
            }

            return result;
        } catch (IOException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlEncode(String value) {
        try {
            return URLEncoder.encode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlDecode(String value) {
        try {
            return URLDecoder.decode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String readInputStream(InputStream is) {
        if (is == null)
            return "";

        BufferedReader reader = new BufferedReader(new InputStreamReader(is));
        StringBuilder result = new StringBuilder();
        String line;
        try {
            while ((line = reader.readLine()) != null) {
                result.append(line);
            }
        } catch (IOException e) {
            // ignore
        }
        return result.toString();
    }

    static String joinToStr(String[] arr, String sep) {
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < arr.length; i++) {
            if (i > 0)
                sb.append(sep);
            sb.append(arr[i]);
        }
        return sb.toString();
    }
}

Java: Как да използваме GraphClient за Microsoft Graph

Mon, 01 Jan 0001 00:00:00 +0000

Работа с GraphClient

Инстанция на IGraphClient класът се грижи за изграждане на заявки, изпращането им към Microsoft Graph API и обработката на отговорите.

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

За да създадете нов екземпляр на IGraphClient клас, трябва да предоставите екземпляр на ITokenProvider, който може да удостоверява заявки към Microsoft Graph.

ITokenProvider tokenProvider = new ITokenProvider() {
    Date expirationDate = null;

    @Override
    public void dispose() {
    }

    @Override
    public OAuthToken getAccessToken(boolean ignoreExistingToken) {
        // Gets oAuth access token.
        // If ignoreExistingToken is true, requests new token from a server. Otherwise behavior is depended on whether token exists or not.
        // If token exists and its expiration date is not expired returns current token, otherwise requests new token from a server.
        return null;
    }

    @Override
    public OAuthToken getAccessToken() {
        // Gets oAuth access token.
        // If token exists and its expiration date is not expired returns current token, otherwise requests new token from a server.
        return new OAuthToken("token", expirationDate);
    }
};

Получаване на обект GraphClient

След като зададете TokenProvider, трябва да получите IGraphClient обект за правене на заявки към услугата. След като имате IGraphClient след като се удостоверите, можете да започнете да правите повиквания към услугата.

IGraphClient client = GraphClient.getClient(tokenProvider);

Работа с папки чрез Microsoft Graph

List Folders

GraphFolderInfoCollection folders = client.listFolders();
for (GraphFolderInfo folderInfo : folders) {
    System.out.println(folderInfo.getDisplayName());
    for (KeyValuePair<Long, MapiProperty> prop : folderInfo.getProperties()) {
        System.out.println(prop.getValue().getDescriptor().toString() + " " + prop.getValue().getString());
    }
}

List Subfolders from Inbox Folder

GraphFolderInfoCollection inboxFolders = client.listFolders(GraphKnownFolders.Inbox);

Създаване на коренова папка

GraphFolderInfo newFolder = client.createFolder("TEST_FOLDER");

Създаване на подпапка

GraphFolderInfo inboxTestSubFolder1 = client.createFolder(GraphKnownFolders.Inbox, "TEST_SUBFOLDER_1");
GraphFolderInfo inboxTestSubFolder2 = client.createFolder(newFolder.getItemId(), "TEST_SUBFOLDER_2");

Get Folder

GraphFolderInfo sentItemsFolder = client.getFolder(GraphKnownFolders.SentItems);

Update Folder

GraphFolderInfo originalFolder = client.createFolder("TEST_FOLDER");
originalFolder.setDisplayName("NEW_TEST_FOLDER");
GraphFolderInfo updatedFolder = client.updateFolder(originalFolder);

Копиране на папка и съдържание

GraphFolderInfo parentFolder = client.createFolder("PARENT_FOLDER");
GraphFolderInfo testFolder = client.createFolder("TEST_FOLDER");
GraphFolderInfo testSubFolder = client.createFolder(testFolder.getItemId(), "TEST_SUBFOLDER");

MapiMessage message = new MapiMessage();
message.setSubject("Test subject");
message.setBody("Test body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");
MapiMessage createdMessage = client.createMessage(testSubFolder.getItemId(), message);

GraphFolderInfo folderCopy = client.copyFolder(parentFolder.getItemId(), testFolder.getItemId());

GraphFolderInfoCollection folderColl = client.listFolders(parentFolder.getItemId());
// TEST_FOLDER
System.out.println(folderColl.get(0).getDisplayName());

folderColl = client.listFolders(folderColl.get(0).getItemId());
// TEST_SUBFOLDER
System.out.println(folderColl.get(0).getDisplayName());

GraphMessageInfoCollection listMessages = client.listMessages(folderColl.get(0).getItemId());
// Test subject
System.out.println(listMessages.get(0).getSubject());

Преместване на папка и съдържание

GraphFolderInfo folder = client.moveFolder(parentFolder.getItemId(), testFolder.getItemId());

Delete Folder

client.delete(testFolder.getItemId());

Списък на съобщения чрез Microsoft Graph

GraphMessageInfoCollection messageInfoColl = client.listMessages(GraphKnownFolders.Inbox);
for (GraphMessageInfo messageInfo : messageInfoColl) {
    MapiMessage message = client.fetchMessage(messageInfo.getItemId());
}

Списък на съобщенията по дата на изпращане

Този OrderBy функцията се използва, за да покаже, че съобщенията трябва да бъдат подредени във възходящ ред по дата на изпращане. Това позволява на клиента да извлече списъка със съобщения от GraphKnownFolders.Inbox папка в специфичен ред, в този случай, според датата на изпращане.

Следният пример с код демонстрира как да се създаде заявка, която определя подреждане на съобщенията по дата на изпращане, и след това да се използва тази заявка за извличане на страница от съобщения от папката „Входящи“ чрез Graph API:

// create orderby messages query 'ASC'
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.getSentDate().orderBy(true);
MailQuery query = builder.getQuery();

GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(10), query);

Извличане на съобщение

GraphMessageInfo messageInfo = messageInfoColl.get(0);
MapiMessage fetchedMessage = client.fetchMessage(messageInfo.getItemId());

Страниране при изброяване на съобщения

API‑то предоставя поддръжка за странициране и филтриране при изброяване на съобщения. Това е много полезно, когато пощенската кутия съдържа голям брой съобщения и изисква много време за извличане на обобщена информация за тях. Примерният код по-долу ще ви покаже как да използвате странициране за големи набори от съобщения при изброяване на съобщения от Exchange Server чрез IGraphClient:

// send ping test messages
for (int i = 0; i < 5; i++) {
    MailMessage eml = new MailMessage(user.EMail, user.EMail, "ping" + i, "test body");
    client.send(MapiMessage.fromMailMessage(eml));
}
// waiting for inbox
Thread.sleep(10000);

// paging option
int itemsPerPage = 2;
// create unread messages filter
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.isRead().equals(false);
MailQuery query = builder.getQuery();

// list messages
GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(itemsPerPage), query);
GraphMessageInfoCollection messages = pageInfo.getItems();
while (!pageInfo.getLastPage())
{
    pageInfo = client.listMessages(GraphKnownFolders.Inbox, pageInfo.getNextPage(), query);
    // add next page items to common collection
    messages.addRange(pageInfo.getItems());
}

// set messages state as read
for (GraphMessageInfo message : messages) {
    client.setRead(message.getItemId());
}

Създаване на съобщение

MapiMessage message = new MapiMessage();
message.setSubject("Subject");
message.setBody("Body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");

MapiMessage createdMessage = client.createMessage(GraphKnownFolders.Inbox, message);

Актуализиране на съобщение

fetchedMessage.setSubject("Update message");
MapiMessage updatedMessage = client.updateMessage(fetchedMessage);

Изпращане на съобщение

client.send(message);

Изпращане на чернова

MapiMessage draftMessage = client.createMessage(GraphKnownFolders.Drafts, message);
client.send(draftMessage.getItemId());

Копиране на съобщение

MapiMessage copiedMessage = client.copyMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());

Преместване на съобщение

MapiMessage movedMessage = client.moveMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());

Прикачени файлове към съобщение

MapiAttachmentCollection attachments = client.listAttachments(fetchedMessage.getItemId());
for (MapiAttachment att : attachments) {
    client.deleteAttachment(att.getItemId());
}

Изтриване на съобщение

client.delete(message.getItemId());

Categories API

String categoryName = "Test Category";
int preset = CategoryPreset.Preset10;
OutlookCategory category = client.createCategory(categoryName, preset);
OutlookCategory fetchedCategory = client.fetchCategory(category.getId());

List<OutlookCategory> categories = client.listCategories();

fetchedCategory.setDisplayName("Update Category");
fetchedCategory.setPreset(CategoryPreset.Preset11);
OutlookCategory updatedCategory = client.updateCategory(fetchedCategory);

client.delete(category.getId());

Overrides API

int focusedType = ClassificationType.Focused;
ClassificationOverride override = client.createOrUpdateOverride(new MailAddress("testUser@host.com", "testUser"), focusedType);

List<ClassificationOverride> list = client.listOverrides();
for (ClassificationOverride item : list)
    System.out.println(item.getSender().getAddress());

ClassificationOverride fetchedOverride = list.get(0);
fetchedOverride.setClassifyAs(ClassificationType.Other);
fetchedOverride.getSender().setDisplayName("testUser_1");

ClassificationOverride updatedOverride = client.createOrUpdateOverride(fetchedOverride);

fetchedOverride.setClassifyAs(ClassificationType.Focused);
updatedOverride = client.updateOverride(fetchedOverride);

client.delete(updatedOverride.getId());

Rules API

InboxRule rule = new InboxRule();
rule.setDisplayName("Test rule");
rule.setPriority(1);
rule.setEnabled(true);
rule.setConditions(new RulePredicates());
rule.getConditions().containsSenderStrings(new StringCollection());
rule.getConditions().containsSenderStrings().addItem("testUser");
rule.setActions(new RuleActions());
rule.getActions().setForwardToRecipients(new MailAddressCollection());
rule.getActions().getForwardToRecipients().addMailAddress(new MailAddress("testUser@host.com", "testUser", true));
rule.getActions().setStopProcessingRules(true);

InboxRule createdRule = client.createRule(rule);

List<InboxRule> listedRules = client.listRules();
for (InboxRule item : listedRules)
    System.out.println(item.getDisplayName());

InboxRule fetchedRule = client.fetchRule(createdRule.getRuleId());

createdRule.setDisplayName("Test rule 1");
createdRule.setEnabled(false);
InboxRule updatedRule = client.updateRule(createdRule);

client.delete(createdRule.getRuleId());

Използване на ресурс за поддръжка на множество пощенски кутии

сlient.setResource(ResourceType.Users);
сlient.setResourceId("mailbox");
сlient.listMessages("mailfolder")
// back to the current mailbox
сlient.setResource(ResourceType.Me);

Java: Работа с папки, използвайки Microsoft Graph

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email за Java ви позволява да изпълнявате различни операции с папки в Microsoft Graph, като изброяване, създаване, актуализиране, копиране, преместване и изтриване на папки. По-долу са примери за често срещани сценарии.

List Folders

Следният пример извлича всички папки и отпечатва техните показвани имена заедно със свойствата им:

GraphFolderInfoCollection folders = client.listFolders();
for (GraphFolderInfo folderInfo : folders) {
    System.out.println(folderInfo.getDisplayName());
    for (KeyValuePair<Long, MapiProperty> prop : folderInfo.getProperties()) {
        System.out.println(prop.getValue().getDescriptor().toString() + " " + prop.getValue().getString());
    }
}

List Subfolders from Inbox Folder

Можете също така да изброите подпапки под конкретна папка, като Входящи:

GraphFolderInfoCollection inboxFolders = client.listFolders(GraphKnownFolders.Inbox);

Create Folders

Можете да създавате както папки от ниво корен, така и подпапки.

Create a Root Folder

GraphFolderInfo newFolder = client.createFolder("TEST_FOLDER");

Create Subfolders

Следният примерен код показва как да създадете подпапка под папката Входящи:

GraphFolderInfo inboxTestSubFolder1 = client.createFolder(GraphKnownFolders.Inbox, "TEST_SUBFOLDER_1");
GraphFolderInfo inboxTestSubFolder2 = client.createFolder(newFolder.getItemId(), "TEST_SUBFOLDER_2");

Get Folder

Следният примерен код демонстрира как да извлечете конкретна папка, например Изпратени елементи:

GraphFolderInfo sentItemsFolder = client.getFolder(GraphKnownFolders.SentItems);

Update Folder

Можете да актуализирате свойства на папка, например, показваното име:

GraphFolderInfo originalFolder = client.createFolder("TEST_FOLDER");
originalFolder.setDisplayName("NEW_TEST_FOLDER");
GraphFolderInfo updatedFolder = client.updateFolder(originalFolder);

Copy Folder and Its Content

Следният пример показва как да копирате папка заедно с нейни подпапки и съобщения:

GraphFolderInfo parentFolder = client.createFolder("PARENT_FOLDER");
GraphFolderInfo testFolder = client.createFolder("TEST_FOLDER");
GraphFolderInfo testSubFolder = client.createFolder(testFolder.getItemId(), "TEST_SUBFOLDER");

MapiMessage message = new MapiMessage();
message.setSubject("Test subject");
message.setBody("Test body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");
MapiMessage createdMessage = client.createMessage(testSubFolder.getItemId(), message);

GraphFolderInfo folderCopy = client.copyFolder(parentFolder.getItemId(), testFolder.getItemId());

GraphFolderInfoCollection folderColl = client.listFolders(parentFolder.getItemId());
// TEST_FOLDER
System.out.println(folderColl.get(0).getDisplayName());

folderColl = client.listFolders(folderColl.get(0).getItemId());
// TEST_SUBFOLDER
System.out.println(folderColl.get(0).getDisplayName());

GraphMessageInfoCollection listMessages = client.listMessages(folderColl.get(0).getItemId());
// Test subject
System.out.println(listMessages.get(0).getSubject());

Move Folder and Its Content

Можете също така да преместите папка със цялото й съдържание на друго място:

GraphFolderInfo folder = client.moveFolder(parentFolder.getItemId(), testFolder.getItemId());

Delete Folder

Използвайте следния примерен код, за да премахнете папка окончателно:

client.delete(testFolder.getItemId());

Java: Работа със съобщения чрез Microsoft Graph

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for Java предоставя богата гама от API за управление на съобщения чрез Microsoft Graph. Можете да изброявате, извличате, създавате, актуализирате, преместите, копирате и изтривате съобщения, както и да обработвате странициране и прикачени файлове. Примерните кодове по-долу са примери за най-често изпълняваните операции.

Списък на съобщения

Можете да извличате съобщения от конкретна папка, като входящи, и да извлечете пълното им съдържание:

GraphMessageInfoCollection messageInfoColl = client.listMessages(GraphKnownFolders.Inbox);
for (GraphMessageInfo messageInfo : messageInfoColl) {
    MapiMessage message = client.fetchMessage(messageInfo.getItemId());
}

Списък на съобщенията по дата на изпращане

За да сортирате съобщенията по дата на изпращане във възходящ ред, можете да използвате OrderBy функция на GraphQueryBuilder:

// create orderby messages query 'ASC'
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.getSentDate().orderBy(true);
MailQuery query = builder.getQuery();

GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(10), query);

Извличане на съобщение

След като имате референция към съобщение, можете да извлечете цялото му съдържание:

GraphMessageInfo messageInfo = messageInfoColl.get(0);
MapiMessage fetchedMessage = client.fetchMessage(messageInfo.getItemId());

Актуализиране на съобщение

След извличане на съобщение, можете да промените съдържанието му и да го актуализирате на сървъра:

fetchedMessage.setSubject("Update message");
MapiMessage updatedMessage = client.updateMessage(fetchedMessage);

Страниране при изброяване на съобщения

Когато работите с големи пощи, можете да използвате странициране, за да извличате съобщения на парчета. Примерът по-долу демонстрира изброяване на непрочетени съобщения в страници по два елемента всяка:

// send ping test messages
for (int i = 0; i < 5; i++) {
    MailMessage eml = new MailMessage(user.EMail, user.EMail, "ping" + i, "test body");
    client.send(MapiMessage.fromMailMessage(eml));
}
// waiting for inbox
Thread.sleep(10000);

// paging option
int itemsPerPage = 2;
// create unread messages filter
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.isRead().equals(false);
MailQuery query = builder.getQuery();

// list messages
GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(itemsPerPage), query);
GraphMessageInfoCollection messages = pageInfo.getItems();
while (!pageInfo.getLastPage())
{
    pageInfo = client.listMessages(GraphKnownFolders.Inbox, pageInfo.getNextPage(), query);
    // add next page items to common collection
    messages.addRange(pageInfo.getItems());
}

// set messages state as read
for (GraphMessageInfo message : messages) {
    client.setRead(message.getItemId());
}

Създаване на съобщение

Можете да създавате нови съобщения със заглавие, тяло и свойства:

MapiMessage message = new MapiMessage();
message.setSubject("Subject");
message.setBody("Body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");

MapiMessage createdMessage = client.createMessage(GraphKnownFolders.Inbox, message);

Изпращане на съобщение

Можете да изпратите съобщение директно:

client.send(message);

Или изпратете чернова след като я създадете в папка „Чернови“:

MapiMessage draftMessage = client.createMessage(GraphKnownFolders.Drafts, message);
client.send(draftMessage.getItemId());

Копиране и местене на съобщения

Съобщенията могат да се копират или преместват между папки:

MapiMessage copiedMessage = client.copyMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());
MapiMessage movedMessage = client.moveMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());

Управление на прикачени файлове

За изброяване и премахване на прикачени файлове от съобщение, използвайте следния пример с код:

MapiAttachmentCollection attachments = client.listAttachments(fetchedMessage.getItemId());
for (MapiAttachment att : attachments) {
    client.deleteAttachment(att.getItemId());
}

Изтриване на съобщение

Накрая, можете да изтриете съобщение окончателно:

client.delete(message.getItemId());

Java: Управление на задачи в Microsoft Graph с Aspose.Email for Java

Mon, 01 Jan 0001 00:00:00 +0000

Вижте Настройка на Azure AD и удостоверяване за Microsoft Graph статия, за да научите как да интегрирате вашето приложение с Microsoft Graph.

Aspose.Email for Java предоставя поддръжка за управление на задачи чрез Microsoft Graph. Можете да изброявате списъци със задачи, да ги създавате или изтривате и да управлявате задачи с гъвкави опции за актуализиране.

Примерният код по-долу демонстрира как да управлявате списъци със задачи и задачи, използвайки следните методи на GraphClient клас:

listTaskLists() — Извлича всички списъци със задачи.
getTaskList(String id) — Извлича конкретен списък със задачи.
deleteTaskList(String id) — Изтрива списък със задачи.
listTasks(String id) — Извлича задачи за даден списък със задачи.
fetchTask(String id) — Извлича задача по нейното ID.
createTask(MapiTask task, String taskListUri) — Създава задача в конкретен списък със задачи.
updateTask(MapiTask task) — Актуализира съществуваща задача.
updateTask(MapiTask task, UpdateSettings updateSettings) — Актуализира задача със специфични настройки за актуализиране.

// List Task Lists
GraphTaskListInfoCollection taskLists = graphClient.listTaskLists();
for (GraphTaskListInfo tList : taskLists) {
    System.out.println("Task List: " + tList.getDisplayName());
}

// Get Task List
GraphTaskListInfo taskList = graphClient.getTaskList("taskListId");

// Delete Task List
graphClient.deleteTaskList("taskListId");

// List Tasks in a Task List
MapiTaskCollection tasks = graphClient.listTasks("taskListId");

// Fetch Task
MapiTask task = graphClient.fetchTask("taskId");

// Create Task
MapiTask newTask = new MapiTask();
newTask.setSubject("New Task");
newTask.setDueDate(new Date());
newTask.setStatus(MapiTaskStatus.NotStarted);

MapiTask createdTask = graphClient.createTask(newTask, "taskListUri");

// Update Task
createdTask.setSubject("Updated Task Subject");
MapiTask updatedTask = graphClient.updateTask(createdTask);

// Update Task with UpdateSettings
UpdateSettings updateSettings = new UpdateSettings();
updateSettings.setSkipAttachments(true);
MapiTask updatedTaskWithSettings = graphClient.updateTask(createdTask, updateSettings);

Java: Управление на календарни елементи в Microsoft Graph

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for Java предоставя поддръжка за управление на календарни елементи чрез Microsoft Graph. Можете да изброявате календари, да работите със събития в календара и да актуализирате елементи с или без настройки за актуализиране.

Примерният код по-долу демонстрира как да управлявате календарни елементи, използвайки следните методи на GraphClient клас:

listCalendars() — Извлича колекция от налични календари.
listCalendarItems(String id) — Извлича елементи от календар за конкретен календар.
fetchCalendarItem(String id) — Извлича календарен елемент по неговото ID.
createCalendarItem(String calId, MapiCalendar mapiCalendar) — Създва нов календарен елемент.
updateCalendarItem(MapiCalendar mapiCalendar) — Актуализира съществуващ календарен елемент.
updateCalendarItem(MapiCalendar mapiCalendar, UpdateSettings updateSettings) — Актуализира календарен елемент със специални настройки за актуализиране.

// List Calendars
GraphCalendarInfoCollection calendars = graphClient.listCalendars();

// List Calendar Items
MapiCalendarCollection calendarItems = graphClient.listCalendarItems("calendarId");

// Fetch Calendar Item
MapiCalendar calendarItem = graphClient.fetchCalendarItem("calendarItemId");

// Create Calendar Item
MapiCalendar newCalendarItem = new MapiCalendar();
newCalendarItem.setLocation("Conference Room");
newCalendarItem.setSubject("Team Meeting");
newCalendarItem.setBody("Discuss project status and updates.");
newCalendarItem.setStartDate(startDate);
newCalendarItem.setEndDate(endDate);

MapiCalendar createdCalendarItem = graphClient.createCalendarItem("calendarId", newCalendarItem);

// Update Calendar Item
createdCalendarItem.setLocation("Zoom Meeting");
MapiCalendar updatedCalendarItem = graphClient.updateCalendarItem(createdCalendarItem);

Java: Управление на контакти в Microsoft Graph с Aspose.Email for Java

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for Java предоставя поддръжка за управление на контакти чрез Microsoft Graph. Можете директно от папките с контакти да изброявате, извличате, създавате и актуализирате контакти.

Примерният код по-долу демонстрира как да управлявате контакти, използвайки следните методи на библиотеката:

listContacts(String id) — Извлича колекция от контакти от указаната папка.
fetchContact(String id) — Извлича контакт по неговото ID.
createContact(String folderId, MapiContact contact) — Създава нов контакт в папка.
updateContact(MapiContact contact) — Актуализира съществуващ контакт.

IGraphClient graphClient = null;

// List Contacts
MapiContactCollection contacts = graphClient.listContacts("contactFolderId");

// Fetch Contact
MapiContact contact = graphClient.fetchContact("contactId");

// Create Contact
MapiContact newContact = new MapiContact("Jane Smith", "jane.smith@example.com", "XYZ Corporation", "777-888-999");
MapiContact createdContact = graphClient.createContact("contactFolderId", newContact);

// Update Contact
createdContact.getTelephones().setPrimaryTelephoneNumber("888-888-999");
MapiContact updatedContact = graphClient.updateContact(createdContact);

Java: Управление на пощенска кутия с Microsoft Graph

Mon, 01 Jan 0001 00:00:00 +0000

В допълнение към работа с съобщения, папки и прикачени файлове, Aspose.Email for Java също така позволява да управлявате функции на ниво пощенска кутия, като категории, overrides за фокусирана пощенска кутия и правила. Можете също да работите с множество пощенски кутии, като превключвате контекста на ресурса. Тези операции са достъпни чрез интеграцията с Graph API.

Как да работим с категории в Outlook

Категориите в Outlook ви позволяват да групирате и маркирате съобщения за по-лесна организация. С Aspose.Email можете програмено да създавате, извличате, актуализирате, изброявате и изтривате категории.

String categoryName = "Test Category";
int preset = CategoryPreset.Preset10;

// create a new category
OutlookCategory category = client.createCategory(categoryName, preset);

// fetch a category
OutlookCategory fetchedCategory = client.fetchCategory(category.getId());

// list categories
List<OutlookCategory> categories = client.listCategories();

// update a category
fetchedCategory.setDisplayName("Update Category");
fetchedCategory.setPreset(CategoryPreset.Preset11);
OutlookCategory updatedCategory = client.updateCategory(fetchedCategory);

// delete a category
client.delete(category.getId());

Как да работим с Overrides

Overrides определя как съобщенията от определени податели се третират в Фокусираната пощенска кутия. Например, можете да принудите съобщения от конкретен подател да се появяват винаги в фокусиран изглед.

int focusedType = ClassificationType.Focused;

// create or update an override for a sender
ClassificationOverride override = client.createOrUpdateOverride(
    new MailAddress("testUser@host.com", "testUser"), focusedType
);

// list overrides
List<ClassificationOverride> list = client.listOverrides();
for (ClassificationOverride item : list)
    System.out.println(item.getSender().getAddress());

// update override classification
ClassificationOverride fetchedOverride = list.get(0);
fetchedOverride.setClassifyAs(ClassificationType.Other);
fetchedOverride.getSender().setDisplayName("testUser_1");
ClassificationOverride updatedOverride = client.createOrUpdateOverride(fetchedOverride);

// reset classification
fetchedOverride.setClassifyAs(ClassificationType.Focused);
updatedOverride = client.updateOverride(fetchedOverride);

// delete override
client.delete(updatedOverride.getId());

Как да работим с правила в Outlook

Правилата за пощенска кутия ви позволяват да автоматизирате действия като препращане на съобщения или филтриране въз основа на условия. Graph API позволява създаване, извличане, актуализиране, изброяване и изтриване на правила за входящи съобщения.

// create a new rule
InboxRule rule = new InboxRule();
rule.setDisplayName("Test rule");
rule.setPriority(1);
rule.setEnabled(true);
rule.setConditions(new RulePredicates());
rule.getConditions().containsSenderStrings(new StringCollection());
rule.getConditions().containsSenderStrings().addItem("testUser");

// define actions
rule.setActions(new RuleActions());
rule.getActions().setForwardToRecipients(new MailAddressCollection());
rule.getActions().getForwardToRecipients()
    .addMailAddress(new MailAddress("testUser@host.com", "testUser", true));
rule.getActions().setStopProcessingRules(true);

InboxRule createdRule = client.createRule(rule);

// list rules
List<InboxRule> listedRules = client.listRules();
for (InboxRule item : listedRules)
    System.out.println(item.getDisplayName());

// fetch and update a rule
InboxRule fetchedRule = client.fetchRule(createdRule.getRuleId());
createdRule.setDisplayName("Test rule 1");
createdRule.setEnabled(false);
InboxRule updatedRule = client.updateRule(createdRule);

// delete rule
client.delete(createdRule.getRuleId());

Работа с множество пощенски кутии – Превключване на контекст на кутия

По подразбиране операциите се изпълняват върху пощенската кутия на текущия потребител. Можете да превключите контекста към друга пощенска кутия (например, за да изброите съобщения от споделена кутия), като зададете типа на ресурса и неговото ID.

// switch to another mailbox
client.setResource(ResourceType.Users);
client.setResourceId("mailbox");
client.listMessages("mailfolder");

// switch back to the current user mailbox
client.setResource(ResourceType.Me);

OData заявки с Microsoft Graph

Aspose.Email for Java предоставя поддръжка за OData заявки при работа с Microsoft Graph. Това ви позволява да извършвате разширено филтриране, сортиране, избиране, странициране и разширяване при извличане на ресурси като папки, съобщения, контакти и календарни елементи. ODataQueryBuilder класът ви позволява да конструирате параметри за OData заявки по структуриран и многократен начин вместо ръчно създаване на низове за заявки. Следните методи могат да се приложат за броене и търсене в големи набори от данни:

Select за извличане само на необходимите свойства.
Filter за прилагане на филтри.
OrderBy за сортиране на резултатите.
Top и Skip за странициране.
Expand за разширяване на свързани обекти в една заявка.

Няколко GraphClient методите приемат незадължителен ODataQueryBuilder параметър за прилагане на OData заявки, включително:

listFolders
listMessages
listContacts
listCalendarItems
listAttachments
listCategories
listOverrides
listRules
listTaskLists
listTasks
listNotebooks

Следният пример с код показва как да се използва ODataQueryBuilder за заявка към папки и извличане на съобщения с разширени филтри и странициране:

IGraphClient client = GraphClient.GetClient();

client.setResource(ResourceType.Users);
client.setResourceId(username);
client.setEndpoint("https://graph.microsoft.com");

// Example 1: List folders ordered by name
ODataQueryBuilder builder = new ODataQueryBuilder();
builder.setOrderBy("name asc");

GraphFolderInfoCollection folders = client.listFolders(builder);
for (GraphFolderInfo folder : folders) {
    System.out.println(folder.getDisplayName());
}

String folderId = folders.get(0).getItemId();

// Example 2: Retrieve filtered and paged messages
builder = new ODataQueryBuilder();
{
    builder.setFilter("startswith(name,'A')");
    builder.setOrderBy("name asc");
    builder.setTop(10);
    builder.setSkip(5);
    builder.setSelect(new String[]{"name", "age"});
    builder.setExpand(new String[]{"children", "parents"});
    builder.setCount(true);
    builder.setSearch("\"John Doe\"");
    builder.setFormat("json");
};

GraphMessageInfoCollection msgs = client.listMessages(folderId, builder);
for (GraphMessageInfo msg : msgs) {
    System.out.println(msg.getSubject());
}