Merge pull request #15 from aspose-email-cloud/develop

Develop

Author: Marat-Gumerov

README.md

@@ -1,52 +1,47 @@
-# Aspose.Email Cloud SDK for Java
+# Manage Emails in Cloud via Java REST SDK
 [![Maven](https://img.shields.io/maven-metadata/v?metadataUrl=https%3A%2F%2Frepository.aspose.cloud%2Frepo%2Fcom%2Faspose%2Faspose-email-cloud%2Fmaven-metadata.xml)](https://repository.aspose.cloud/repo/com/aspose/aspose-email-cloud/) [![License](https://img.shields.io/github/license/aspose-email-cloud/aspose-email-cloud-java)](https://repository.aspose.cloud/repo/com/aspose/aspose-email-cloud/) ![tests](https://github.com/aspose-email-cloud/aspose-email-cloud-java/workflows/tests/badge.svg)
 
-This repository contains Aspose.Email Cloud SDK for Java source code. This SDK allows you to work with Aspose.Email Cloud REST APIs in your Java applications quickly and easily, with zero initial cost.
+[Aspose.Email Cloud SDK for Java](https://products.aspose.cloud/email/java) is a REST API SDK for creating email applications that work with standard email file formats such as Outlook MSG, EML, iCalendar files and VCard.
 
-[Aspose.Email Cloud home](https://products.aspose.cloud/email/family "Aspose.Email Cloud")  
+This SDK allows you to work with Aspose.Email Cloud REST APIs in your Java applications quickly and easily, with zero initial cost.
+
+[Aspose.Email Cloud home](https://products.aspose.cloud/email/family)  
 [API Reference](https://apireference.aspose.cloud/email/)  
 
-# Key features
+# Cloud Email Processing Features
 Aspose.Email Cloud is a REST API for creating email applications that work with standard email file formats. This SDK:
-- Lets developers manipulate different emails’ formats such as Outlook MSG, EML, VCard, and iCalendar files
-- Lets developers manipulate different emails' formats such as Outlook MSG, EML, VCard, and iCalendar files
+- Lets developers manipulate different emails' formats such as Outlook MSG, EML, VCard, and iCalendar files.
 - Supports AI functions:
-    - The Business card recognition
-    - The Name API for parsing and handling personal names
+    - The Business card recognition.
+    - The Name API for parsing and handling personal names.
 - Has a built-in email client. This client provides:
-    - Unified REST API for different email protocols: IMAP, POP3, SMTP, EWS, WebDav
-    - Virtual multi-account
-    - Message threads (POP3 accounts are also supported)
-- Email configuration discovery
-- Disposable email address detection
+    - Unified REST API for different email protocols: IMAP, POP3, SMTP, EWS, WebDav.
+    - Virtual multi-account.
+    - Message threads (POP3 accounts are also supported).
+- Email configuration discovery.
+- Disposable email address detection.
+
+## New features in version 20.9
+
+Aspose.Email Cloud SDK 20.9.0 is based on a new v4.0 REST API.
 
-## New features in version 20.7
-- New MAPI message files API with models:
-    - `MapiMessageDto` - represents the Microsoft Outlook message.
-    - `MapiCalendarDto` - represents the Microsoft Outlook calendar object.
-    - `MapiContactDto` - represents the Microsoft Outlook contact information. 
-- Improved Recurrence pattern support for CalendarDto.
+- All SDK functions are divided into groups (Email, Calendar, Contact, Client, Ai, Mapi, etc.).
+- Unified file API provided for supported file types (Save, Get, Convert, AsFile, FromFile, AsMapi/AsDto).
+- HierarchicalObject based API is removed.
+- All models are stored in one folder/namespace.
+- The request models are simplified.
 
-See [Release notes](https://docs.aspose.cloud/display/emailcloud/Aspose.Email+Cloud+20.7+Release+Notes)
+See [Release notes](https://docs.aspose.cloud/display/emailcloud/Aspose.Email+Cloud+20.9+Release+Notes).
 
 ## How to use the SDK?
-The complete source code is available in the GIT repository.
+The complete source code is available in the [GIT repository](https://github.com/aspose-email-cloud/aspose-email-cloud-java/tree/master/src/main/java/com/aspose/email/cloud/sdk).
 
-Use [SDK tutorials](https://docs.aspose.cloud/display/emailcloud/SDK+Tutorials):
-- [SDK setup](https://docs.aspose.cloud/display/emailcloud/SDK+setup) - installation, account setup, first API calls
-- [Business Cards Recognition API](https://docs.aspose.cloud/display/emailcloud/Business+Cards+Recognition+API) - convert captured business cards and name card images, into a vCard format
-- [Working with Name API](https://docs.aspose.cloud/display/emailcloud/Working+with+Name+API) - format, genderize, compare, parse, autocomplete names
-- [Email Message Files](https://docs.aspose.cloud/display/emailcloud/Email+Message+Files) - Convert EML to MSG and back, edit EML files, etc.
-- [Quick Start With iCalendar API](https://docs.aspose.cloud/display/emailcloud/Quick+Start+With+iCalendar+API) - Crate and edit iCalendar files
-- [Quick Start With VCard API](https://docs.aspose.cloud/display/emailcloud/Quick+Start+With+VCard+API) - Create and edit VCard files, business card recognition
-- [Quick Start With Email Client](https://docs.aspose.cloud/display/emailcloud/Quick+Start+With+Email+Client) - Setup builtin email client, search/fetch/send/move/delete messages
-- [Email Client Threads](https://docs.aspose.cloud/display/emailcloud/Email+Client+Threads) - Fetch/Move/Delete email message threads using builtin email client
-- [File converters](https://docs.aspose.cloud/display/emailcloud/Convert+Email%2C+Calendar+and+Contact+Files)
+Use [SDK tutorials](https://docs.aspose.cloud/display/emailcloud/SDK+Tutorials).
 
-SDK reference documentation is available in [this README](https://github.com/aspose-email-cloud/aspose-email-cloud-java/blob/master/docs/README.md)
+SDK reference documentation is available in [this README](https://github.com/aspose-email-cloud/aspose-email-cloud-java/blob/master/docs/README.md).
 
 ### Prerequisites
-To use these SDK, you need an App SID and an App Key; they can be looked up at [Aspose Cloud Dashboard](https://dashboard.aspose.cloud/#/apps) (it requires free registration in Aspose Cloud for this).
+To use this SDK, you need an App SID and an App Key; they can be looked up at [Aspose Cloud Dashboard](https://dashboard.aspose.cloud/#/apps) (it requires free registration in Aspose Cloud for this).
 
 ### Installation
 You can either directly use it in your project via jar file or add it as Maven dependency ([see repo](https://repository.aspose.cloud/repo/com/aspose/aspose-email-cloud/)):
@@ -67,42 +62,23 @@ Then, add a dependency:
 </dependency>
 ```
 
-See more details about SDK installation in this tutorial: [SDK setup](https://docs.aspose.cloud/display/emailcloud/SDK+setup)
+See more details about SDK installation in this tutorial: [SDK setup](https://docs.aspose.cloud/display/emailcloud/SDK+setup).
 
 ### Usage examples
-To use the API, you should create an EmailApi object:
+To use the API, you should create an EmailCloud object:
 ```java
-EmailApi api = new EmailApi("Your App Key", "Your App SID");
+EmailCloud api = new EmailCloud("Your App Key", "Your App SID");
 ```
 
 #### Business cards recognition API
-Use `AiBcrParseModel` method to parse business card image to VCard DTO:
+Use `AiBcrApi.parse` method to parse business card image to VCard DTO:
 
 ```java
 byte[] fileBytes = IOUtils.toByteArray(new FileInputStream("/tmp/alex.png"));
-String fileBase64 = Base64.encodeToString(fileBytes, false);
-ListResponseOfContactDto result = api.aiBcrParseModel(new AiBcrParseModelRequestData(
-    new AiBcrBase64Rq(null, Arrays.asList(new AiBcrBase64Image(true, fileBase64)))));
+ContactList result = api.ai().bcr().parse(new AiBcrParseRequest(
+    fileBytes, null, null, true));
 ContactDto contact = result.getValue().get(0);
+assert contact.getDisplayName().contains("Parsed Display Name");
 ```
 
-See more details [here](https://docs.aspose.cloud/display/emailcloud/Parse+Image+To+VCard+File) and [here](https://docs.aspose.cloud/display/emailcloud/Business+Cards+Recognition+API)
-
-# Licensing
-All Aspose.Email for Cloud SDKs, helper scripts and templates are licensed under [MIT License](LICENSE).
-
-# Resources
-+ [**SDK Reference documentation**](docs/README.md)
-+ [**Website**](https://www.aspose.cloud)
-+ [**Product Home**](https://products.aspose.cloud/Email/cloud)
-+ [**Documentation**](https://docs.aspose.cloud/display/Emailcloud/Home)
-+ [**API Reference**](https://apireference.aspose.cloud/email/)
-+ [**Free Support Forum**](https://forum.aspose.cloud/c/email)
-+ [**Paid Support Helpdesk**](https://helpdesk.aspose.cloud/)
-+ [**Blog**](https://blog.aspose.cloud/category/aspose-products/aspose-email-cloud/)
-+ [**Git repository: Aspose.Email Cloud SDK for .Net**](https://github.com/aspose-email-cloud/aspose-email-cloud-dotnet)
-+ [**Git repository: Aspose.Email Cloud SDK for Ruby**](https://github.com/aspose-email-cloud/aspose-email-cloud-ruby)
-+ [**Git repository: Aspose.Email Cloud SDK for Python**](https://github.com/aspose-email-cloud/aspose-email-cloud-python)
-+ [**Git repository: Aspose.Email Cloud SDK for PHP**](https://github.com/aspose-email-cloud/aspose-email-cloud-php)
-+ [**Git repository: Aspose.Email Cloud SDK for Typescript**](https://github.com/aspose-email-cloud/aspose-email-cloud-node)
-+ [**Git repository: Aspose.Email Cloud SDK for Java**](https://github.com/aspose-email-cloud/aspose-email-cloud-java)
+[Product Page](https://products.aspose.cloud/email/java) | [Documentation](https://docs.aspose.cloud/display/Emailcloud/Home) | [Demo](https://products.aspose.app/email/family) | [API Reference](https://apireference.aspose.cloud/email/) | [Blog](https://blog.aspose.cloud/category/email/) | [Free support](https://forum.aspose.cloud/c/email) | [Free trial](https://dashboard.aspose.cloud/#/apps)

docs/AccountBaseRequest.md

@@ -0,0 +1,47 @@
+# AiBcrApi
+
+            
+<a name="parse"></a>
+# **parse**
+> [ContactList](ContactList.md) parse(AiBcrParseRequest request)
+
+Parse images to vCard document models             
+
+### **AiBcrParseRequest** Parameters
+```java
+public AiBcrParseRequest(
+    byte[] file, 
+    String countries, 
+    String languages, 
+    Boolean isSingle)
+```
+
+Name | Type | Description | Notes
+---- | ---- | ----------- | -----
+ **file** | **byte[]**| File to parse |
+ **countries** | **String**| Comma-separated codes of countries. | [optional] [default to ]
+ **languages** | **String**| Comma-separated ISO-639 codes of languages (either 639-1 or 639-3; i.e. \&quot;it\&quot; or \&quot;ita\&quot; for Italian); it&#39;s \&quot;\&quot; by default.              | [optional] [default to ]
+ **isSingle** | **Boolean**| Determines that image contains single VCard or more. | [optional] [default to true]
+
+### Return type
+
+[**ContactList**](ContactList.md)
+
+[[Back to top]](#) [[Back to Model list]](Models.md) [[Back to API README]](README.md)
+
+            
+<a name="parseStorage"></a>
+# parseStorage
+> [StorageFileLocationList](StorageFileLocationList.md) parseStorage([AiBcrParseStorageRequest](AiBcrParseStorageRequest.md) request)
+
+Parse images from storage to vCard files             
+
+### request Parameter
+
+See parameter model documentation at [AiBcrParseStorageRequest](AiBcrParseStorageRequest.md)
+
+### Return type
+
+[**StorageFileLocationList**](StorageFileLocationList.md)
+
+[[Back to top]](#) [[Back to Model list]](Models.md) [[Back to API README]](README.md)

docs/AddAttachmentRequest.md

@@ -0,0 +1,12 @@
+
+## Documentation for AiBcrApi
+
+All URIs are relative to *https://api.aspose.cloud/v4.0*
+
+Method | HTTP request | Description
+------ | ------------ | -----------
+ [**parse**](AiBcrApi.md#parse) | **PUT** /email/AiBcr/parse | Parse images to vCard document models             
+ [**parseStorage**](AiBcrApi.md#parseStorage) | **PUT** /email/AiBcr/parse-storage | Parse images from storage to vCard files             
+
+
+    

docs/AiBcrApi.md

@@ -1,11 +1,12 @@
 
-# com.aspose.email.cloud.sdk.model.AiBcrImage
-
+# AiBcrImage
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**isSingle** | **Boolean** | Determines that image contains single VCard or more. Ignored in current version. Multiple cards on image support will be added soon              | 
+**isSingle** | **Boolean** | Determines that image contains single VCard or more.              | 
+
+
 
 
-[[Back to Model list]](README.md#documentation-for-models) [[Back to API list]](README.md#documentation-for-api-endpoints) [[Back to API README]](README.md)
+[[Back to Model list]](Models.md) [[Back to API README]](README.md)
 

docs/AiBcrApi_list.md

@@ -1,11 +1,14 @@
 
-# com.aspose.email.cloud.sdk.model.AiBcrImageStorageFile
-
+# AiBcrImageStorageFile
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**file** | [**StorageFileLocation**](StorageFileLocation.md) | Image location              |  [optional]
+**file** | [**StorageFileLocation**](StorageFileLocation.md) | Image location              | 
+
+
+## Parent class
 
+See: [AiBcrImage](AiBcrImage.md)
 
-[[Back to Model list]](README.md#documentation-for-models) [[Back to API list]](README.md#documentation-for-api-endpoints) [[Back to API README]](README.md)
+[[Back to Model list]](Models.md) [[Back to API README]](README.md)