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

Develop

Author: Marat-Gumerov

README.md

@@ -23,12 +23,12 @@ Aspose.Email Cloud is a REST API for creating email applications that work with
 - Email configuration discovery.
 - Disposable email address detection.
 
-## Enhancements in Version 21.3
+## Enhancements in Version 21.4
 
 - IMAP native threads support added to the built-in Email client.
 - New field ClientThreadMoveRequest.SourceFolder added to specify a folder to move a thread from.
 
-See [Release notes](https://docs.aspose.cloud/email/aspose-email-cloud-21-3-release-notes/).
+See [Release notes](https://docs.aspose.cloud/email/aspose-email-cloud-21-4-release-notes/).
 
 ## How to use the SDK?
 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).
@@ -64,22 +64,25 @@ To use the API, you should create an EmailCloud object:
 ```java
 EmailCloud api = new EmailCloud("Your Client secret", "Your Client id");
 ```
-## Parse Business Card Image to VCard in Java
 
-```java
-	// Get your ClientId and ClientSecret from https://dashboard.aspose.cloud (free registration required).
-	EmailCloud emailApi = new EmailCloud("MY_CLIENT_SECRET", "MY_CLIENT_ID");
+#### Business cards recognition API
+Use `AiBcrApi.parse` method to parse business card image to VCard DTO:
 
-	byte[] fileBytes = IOUtils.toByteArray(new FileInputStream("D:/alex.png"));
-	ContactList result = emailApi.ai().bcr().parse(new AiBcrParseRequest(fileBytes, null, null, true));
-	ContactDto contact = result.getValue().get(0);
+```java
+byte[] fileBytes = IOUtils.toByteArray(new FileInputStream("/tmp/alex.png"));
+ContactList result = api.ai().bcr().parse(Models.aiBcrParseRequest()
+    .file(fileBytes)
+    .isSingle(true)
+    .build());
+ContactDto contact = result.getValue().get(0);
+assert contact.getDisplayName().contains("Parsed Display Name");
 ```
 
 ## Aspose.Email Cloud SDKs in Popular Languages
 
 | .NET | Java | PHP | Python | Ruby | Node.js |
-|---|---|---|---|---|---|
+|------|------|-----|--------|------|---------|
 | [GitHub](https://github.com/aspose-email-cloud/aspose-email-cloud-dotnet) | [GitHub](https://github.com/aspose-email-cloud/aspose-email-cloud-java) | [GitHub](https://github.com/aspose-email-cloud/aspose-email-cloud-php) | [GitHub](https://github.com/aspose-email-cloud/aspose-email-cloud-python) | [GitHub](https://github.com/aspose-email-cloud/aspose-email-cloud-ruby)  | [GitHub](https://github.com/aspose-email-cloud/aspose-email-cloud-node) | [GitHub](https://github.com/aspose-email-cloud/aspose-email-cloud-android) | [GitHub](https://github.com/aspose-email-cloud/aspose-email-cloud-swift)|[GitHub](https://github.com/aspose-email-cloud/aspose-email-cloud-dart) |[GitHub](https://github.com/aspose-email-cloud/aspose-email-cloud-go) |
 | [NuGet](https://www.nuget.org/packages/Aspose.Email-Cloud/) | [Maven](https://repository.aspose.cloud/webapp/#/artifacts/browse/tree/General/repo/com/aspose/aspose-email-cloud) | [Composer](https://packagist.org/packages/aspose/aspose-email-cloud) | [PIP](https://pypi.org/project/aspose.email-cloud/) | [GEM](https://rubygems.org/gems/aspose_email_cloud)  | [NPM](https://www.npmjs.com/package/@asposecloud/aspose-email-cloud) |
 
-[Product Page](https://products.aspose.cloud/email/java) | [Documentation](https://docs.aspose.cloud/email/) | [Demo](https://products.aspose.app/email/family) | [Swagger UI](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) | [SDK reference documentation](https://docs.aspose.cloud/email/reference-api)
+[Product Page](https://products.aspose.cloud/email/java) | [Documentation](https://docs.aspose.cloud/email/) | [Demo](https://products.aspose.app/email/family) | [Swagger UI](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) | [SDK reference documentation](https://docs.aspose.cloud/email/reference-api)

docs/ClientAccountApi.md

@@ -55,6 +55,11 @@ result = Models.emailClientAccount()
         .refreshToken("refreshToken")
         .login("example@example.com")
         .build())
+    .cacheFile(Models.storageFileLocation()
+        .fileName("account.cache")
+        .storage("First Storage")
+        .folderPath("file/location/folder/on/storage")
+        .build())
     .build();
 ```
 </details>
@@ -89,6 +94,11 @@ result = Models.emailClientAccount()
         .refreshToken("refreshToken")
         .login("example@example.com")
         .build())
+    .cacheFile(Models.storageFileLocation()
+        .fileName("account.cache")
+        .storage("First Storage")
+        .folderPath("file/location/folder/on/storage")
+        .build())
     .build();
 
 ```
@@ -272,6 +282,11 @@ ClientAccountSaveRequest request = Models.clientAccountSaveRequest()
             .refreshToken("refreshToken")
             .login("example@example.com")
             .build())
+        .cacheFile(Models.storageFileLocation()
+            .fileName("account.cache")
+            .storage("First Storage")
+            .folderPath("file/location/folder/on/storage")
+            .build())
         .build())
     .build();
 ```
@@ -309,6 +324,11 @@ ClientAccountSaveRequest request = Models.clientAccountSaveRequest()
             .refreshToken("refreshToken")
             .login("example@example.com")
             .build())
+        .cacheFile(Models.storageFileLocation()
+            .fileName("account.cache")
+            .storage("First Storage")
+            .folderPath("file/location/folder/on/storage")
+            .build())
         .build())
     .build();
 

docs/ClientAccountSaveRequest.md

@@ -29,6 +29,11 @@ ClientAccountSaveRequest clientAccountSaveRequest = Models.clientAccountSaveRequ
             .refreshToken("refreshToken")
             .login("example@example.com")
             .build())
+        .cacheFile(Models.storageFileLocation()
+            .fileName("account.cache")
+            .storage("First Storage")
+            .folderPath("file/location/folder/on/storage")
+            .build())
         .build())
     .build();
 ```

docs/ClientMessageApi.md

@@ -436,7 +436,7 @@ byte[] result = api.client().message().fetchFile(request);
 
 Description: Get messages from folder, filtered by query             
 
-The query string should have the following view.      The example of a simple expression:       '<Field name>' <Comparison operator> '<Field value>',  where <Field Name> - the name of a message field through which filtering is made, <Comparison operator> - comparison operators, as their name implies, allow to compare message field and specified value, <Field value> - value to be compared with a message field.      The number of simple expressions can make a compound one, ex.:     (<Simple expression 1> & <Simple expression 2>) | <Simple expression 3     >,  where \"&\" - logical-AND operator, \"|\" - logical-OR operator      At present the following values are allowed as a field name (<Field name>):  \"To\" - represents a TO field of message, \"Text\" - represents string in the header or body of the message, \"Bcc\" - represents a BCC field of message, \"Body\" - represents a string in the body of message, \"Cc\" - represents a CC field of message, \"From\" - represents a From field of message, \"Subject\" - represents a string in the subject of message, \"InternalDate\" - represents an internal date of message, \"SentDate\" - represents a sent date of message      Additionally, the following field names are allowed for IMAP-protocol:  \"Answered\" - represents an /Answered flag of message \"Seen\" - represents a /Seen flag of message \"Flagged\" - represents a /Flagged flag of message \"Draft\" - represents a /Draft flag of message \"Deleted\" - represents a Deleted/ flag of message \"Recent\" - represents a Deleted/ flag of message \"MessageSize\" - represents a size (in bytes) of message      Additionally, the following field names are allowed for Exchange:  \"IsRead\" - Indicates whether the message has been read \"HasAttachment\" - Indicates whether or not the message has attachments \"IsSubmitted\" - Indicates whether the message has been submitted to the Outbox \"ContentClass\" - represents a content class of item      Additionally, the following field names are allowed for pst/ost files:  \"MessageClass\" - Represents a message class \"ContainerClass\" - Represents a folder container class \"Importance\" - Represents a message importance \"MessageSize\" - represents a size (in bytes) of message \"FolderName\" - represents a folder name \"ContentsCount\" - represents a total number of items in the folder \"UnreadContentsCount\" - represents the number of unread items in the folder. \"Subfolders\" - Indicates whether or not the folder has subfolders \"Read\" - the message is marked as having been read \"HasAttachment\" - the message has at least one attachment \"Unsent\" - the message is still being composed \"Unmodified\" - the message has not been modified since it was first saved (if unsent) or it was delivered (if sent) \"FromMe\" - the user receiving the message was also the user who sent the message \"Resend\" - the message includes a request for a resend operation with a non-delivery report \"NotifyRead\" - the user who sent the message has requested notification when a recipient first reads it \"NotifyUnread\" - the user who sent the message has requested notification when a recipient deletes it before reading or the Message object expires \"EverRead\" - the message has been read at least once      The field value (<Field value>) can take the following values:     For text fields - any string,     For date type fields - the string of \"d-MMM-yyy\" format, ex. \"10-Feb-2009\",     For flags (fields of boolean type) - either \"True\", or \"False\"              
+The query string should have the following view.      The example of a simple expression:       '<Field name>' <Comparison operator> '<Field value>',  where <Field Name> - the name of a message field through which filtering is made, <Comparison operator> - comparison operators, as their name implies, allow to compare message field and specified value, <Field value> - value to be compared with a message field.      The number of simple expressions can make a compound one, ex.:     (<Simple expression 1> & <Simple expression 2>) | <Simple expression 3     >,  where \"&\" - logical-AND operator, \"|\" - logical-OR operator      At present the following values are allowed as a field name (<Field name>):  \"To\" - represents a TO field of message, \"Text\" - represents string in the header or body of the message, \"Bcc\" - represents a BCC field of message, \"Body\" - represents a string in the body of message, \"Cc\" - represents a CC field of message, \"From\" - represents a From field of message, \"Subject\" - represents a string in the subject of message, \"InternalDate\" - represents an internal date of message, \"SentDate\" - represents a sent date of message      Additionally, the following field names are allowed for IMAP-protocol:  \"Answered\" - represents an /Answered flag of message \"Seen\" - represents a /Seen flag of message \"Flagged\" - represents a /Flagged flag of message \"Draft\" - represents a /Draft flag of message \"Deleted\" - represents a Deleted/ flag of message \"Recent\" - represents a Deleted/ flag of message \"MessageSize\" - represents a size (in bytes) of message      Additionally, the following field names are allowed for Exchange:  \"IsRead\" - Indicates whether the message has been read \"HasAttachment\" - Indicates whether or not the message has attachments \"IsSubmitted\" - Indicates whether the message has been submitted to the Outbox \"ContentClass\" - represents a content class of item      The field value (<Field value>) can take the following values:     For text fields - any string,     For date type fields - the string of \"d-MMM-yyy\" format, ex. \"10-Feb-2009\",     For flags (fields of boolean type) - either \"True\", or \"False\"              
 
 Returns: List of MailMessageBase objects that represent fetched message in requested format.
 

docs/EmailClientAccount.md

@@ -27,6 +27,11 @@ EmailClientAccount emailClientAccount = Models.emailClientAccount()
         .refreshToken("refreshToken")
         .login("example@example.com")
         .build())
+    .cacheFile(Models.storageFileLocation()
+        .fileName("account.cache")
+        .storage("First Storage")
+        .folderPath("file/location/folder/on/storage")
+        .build())
     .build();
 ```
 

pom.xml

@@ -4,7 +4,7 @@
   <artifactId>aspose-email-cloud</artifactId>
   <packaging>jar</packaging>
   <name>aspose-email-cloud</name>
-  <version>21.3.0.132</version>
+  <version>21.4.0.140</version>
   <url>https://github.com/aspose-email-cloud/aspose-email-cloud-java</url>
   <description>Aspose.Email Cloud SDK</description>
   <licenses>
@@ -43,7 +43,7 @@
           </execution>
         </executions>
       </plugin>
-      <plugin>  
+      <plugin>
         <artifactId>maven-dependency-plugin</artifactId>
         <executions>
           <execution>