
مایکروسافت Graph API را برای تعامل و کار با Office 365 و سرویسهای Microsoft Cloud فراهم میکند. این به شما امکان می دهد پوشه ها را ایجاد و مدیریت کنید، به پیام ها دسترسی داشته باشید، دسته ها را مدیریت کنید و از سایر خدمات به صورت برنامه ای استفاده کنید. در این مقاله نحوه استفاده از Microsoft Graph API برای ایجاد و به روز رسانی پوشه ها در جاوا را خواهید آموخت.
- Java Microsoft Graph API برای مدیریت پوشه ها
- با استفاده از Microsoft Graph API پوشه ایجاد کنید
- با استفاده از Microsoft Graph API یک زیر پوشه ایجاد کنید
- با استفاده از Microsoft Graph API پوشه ها را به روز کنید
Java Microsoft Graph API برای ایجاد و به روز رسانی پوشه ها
برای ایجاد و بهروزرسانی پوشهها با استفاده از Microsoft Graph API، از Aspose.Email for Java استفاده میکنیم. API کار یکپارچه با سرویسهای Office 365 را با استفاده از Microsoft Graph API بسیار آسانتر میکند. می توانید API را دانلود یا با استفاده از تنظیمات Maven زیر نصب کنید.
مخزن:
<repository>
<id>AsposeJavaAPI</id>
<name>Aspose Java API</name>
<url>http://repository.aspose.com/repo/</url>
</repository>
وابستگی:
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-email</artifactId>
<version>22.3</version>
<classifier>jdk16</classifier>
</dependency>
یک پوشه با Microsoft Graph API در جاوا ایجاد کنید
برای برقراری ارتباط با Graph API، ابتدا باید رابط ITokenProvider را برای احراز هویت درخواست ها پیاده سازی کنید. در زیر پیاده سازی اساسی ITokenProvider است.
ITokenProvider tokenProvider = new ITokenProvider() {
Date expirationDate = null;
@Override
public void dispose() {
}
@Override
public OAuthToken getAccessToken(boolean ignoreExistingToken) {
// رمز دسترسی oAuth را دریافت می کند.
// اگر ignoreExistingToken درست باشد، توکن جدید را از یک سرور درخواست می کند. در غیر این صورت رفتار بستگی به وجود یا عدم وجود نشانه دارد.
// اگر رمز وجود داشته باشد و تاریخ انقضا آن منقضی نشده باشد، رمز فعلی را برمی گرداند، در غیر این صورت توکن جدید را از یک سرور درخواست می کند.
return null;
}
@Override
public OAuthToken getAccessToken() {
// رمز دسترسی oAuth را دریافت می کند.
// اگر رمز وجود داشته باشد و تاریخ انقضا آن منقضی نشده باشد، رمز فعلی را برمی گرداند، در غیر این صورت توکن جدید را از یک سرور درخواست می کند.
return new OAuthToken("token", expirationDate);
}
};
در زیر مراحل ایجاد یک پوشه با استفاده از Microsoft Graph API در جاوا آمده است.
- ابتدا با استفاده از روش GraphClient.getClient(ITokenProvider) یک نمونه از کلاینت Microsoft Graph دریافت کنید.
- سپس، روش IGraphClient.createFolder(String) را برای ایجاد پوشه فراخوانی کنید.
نمونه کد زیر نحوه ایجاد یک پوشه با استفاده از Microsoft Graph API در جاوا را نشان می دهد.
// مشتری گراف را دریافت کنید
IGraphClient client = GraphClient.getClient(tokenProvider);
// پرونده بساز
GraphFolderInfo newFolder = client.createFolder("TEST_FOLDER");
یک زیر پوشه با استفاده از Microsoft Graph API در جاوا ایجاد کنید
همچنین می توانید یک زیر پوشه به روشی مشابه ایجاد کنید. تنها تفاوت این است که شما باید مسیر پوشه ریشه را به عنوان اولین آرگومان متد createFolder ارائه دهید. نمونه کد زیر نحوه ایجاد یک زیرپوشه با استفاده از Microsoft Graph API در جاوا را نشان می دهد.
// مشتری گراف را دریافت کنید
IGraphClient client = GraphClient.getClient(tokenProvider);
// پوشه داخل صندوق ورودی ایجاد کنید
GraphFolderInfo newFolder = client.createFolder(GraphKnownFolders.Inbox, "TEST_SUBFOLDER_1");
// زیر پوشه را در پوشه جدید ایجاد کنید
GraphFolderInfo inboxTestSubFolder2 = client.createFolder(newFolder.getItemId(), "TEST_SUBFOLDER_2");
جاوا: با استفاده از Microsoft Graph API پوشه ها را به روز کنید
همچنین می توانید با استفاده از Microsoft Graph API یک پوشه موجود را واکشی و به روز کنید. برای این کار باید لیست پوشه ها را دریافت کرده و پوشه مورد نیاز را فیلتر کنید. در زیر مراحل به روز رسانی یک پوشه با استفاده از Aspose.Email برای جاوا آمده است.
- ابتدا با استفاده از روش GraphClient.getClient(ITokenProvider) از کلاینت مایکروسافت Graph نمونه ای دریافت کنید.
- سپس با استفاده از روش IGraphClient.listFolders() فهرستی از تمام پوشه ها را دریافت کنید.
- پس از آن، تمام اشیاء GraphFolderInfo را در لیست حلقه بزنید و مورد مورد نیاز را واکشی کنید.
- سپس، از شی GraphFolderInfo برای بهروزرسانی ویژگیهای پوشه استفاده کنید.
- در نهایت، پوشه را با استفاده از روش IGraphClient.updateFolder(GraphFolderInfo) به روز کنید.
نمونه کد زیر نحوه به روز رسانی یک پوشه را با استفاده از Microsoft Graph API در جاوا نشان می دهد.
// مشتری گراف را دریافت کنید
IGraphClient client = GraphClient.getClient(tokenProvider);
// دریافت لیست پوشه ها
GraphFolderInfoCollection folders = client.listFolders();
// حلقه بین پوشه ها
for (GraphFolderInfo folderInfo : folders) {
if(folderInfo.getDisplayName()=="TEST_FOLDER")
{
folderInfo.setDisplayName("NEW_TEST_FOLDER");
// پوشه را به روز کنید
GraphFolderInfo updatedFolder = client.updateFolder(folderInfo);
}
}
Java Microsoft Graph API برای مدیریت پوشه ها - مجوز رایگان دریافت کنید
میتوانید برای ایجاد و بهروزرسانی پوشهها با Microsoft Graph API بدون محدودیت ارزیابی، مجوز موقت رایگان دریافت کنید.
نتیجه
در این مقاله نحوه کار با پوشه ها با استفاده از Microsoft Graph API از داخل برنامه های جاوا را یاد گرفتید. به ویژه، نحوه ایجاد یا به روز رسانی یک پوشه/زیر پوشه با Microsoft Graph API در جاوا را دیده اید. علاوه بر این، میتوانید سایر ویژگیهای Aspose.Email برای جاوا را با استفاده از مستندات کاوش کنید. همچنین، در صورت داشتن هر گونه سوال، می توانید به [تالار گفتمان13 ما ارسال کنید.