Release 21.3 (#11)

* Release 21.3

* Use request objects

* Example in readme updated

Author: Denis-Averin

.gitignore

@@ -9,3 +9,4 @@
 **/target
 build
 aspose-barcode-cloud.iml
+!tools/*

Makefile

@@ -9,13 +9,13 @@ fix:
 
 .PHONY: format
 format: fix
-	find ./src -iname "*.java" | xargs java -jar tools/google-java-format-1.8-all-deps.jar --aosp --replace
+	find ./src -iname "*.java" | xargs java -jar tools/google-java-format-1.9-all-deps.jar --aosp --replace
 # Repeat for consistent formatting
-	find ./src -iname "*.java" | xargs java -jar tools/google-java-format-1.8-all-deps.jar --aosp --replace
+	find ./src -iname "*.java" | xargs java -jar tools/google-java-format-1.9-all-deps.jar --aosp --replace
 
 .PHONY: format_tests
 format_tests:
-	find $(SRC)/test -iname "*.java" | xargs java -jar tools/google-java-format-1.8-all-deps.jar --aosp --replace
+	find $(SRC)/test -iname "*.java" | xargs java -jar tools/google-java-format-1.9-all-deps.jar --aosp --replace
 
 .PHONY: test
 test:

README.md

@@ -1,7 +1,7 @@
 # Aspose.BarCode Cloud SDK for Java
 
 - API version: 3.0
-- SDK version: 21.2.0
+- SDK version: 21.3.0
 
 [Aspose.BarCode for Cloud](https://products.aspose.cloud/barcode/cloud) is a REST API for Linear, 2D and postal barcode generation and recognition in the cloud. API recognizes and generates barcode images in a variety of formats. Barcode REST API allows to specify barcode image attributes like image width, height, border style and output image format in order to customize the generation process. Developers can also specify the barcode type and text attributes such as text location and font styles in order to suit the application requirements.
 
@@ -56,7 +56,7 @@ Add this dependency to your project's POM:
 <dependency>
   <groupId>com.aspose</groupId>
   <artifactId>aspose-barcode-cloud</artifactId>
-  <version>21.2.0</version>
+  <version>21.3.0</version>
   <scope>compile</scope>
 </dependency>
 ```
@@ -71,41 +71,63 @@ mvn clean package
 
 Then manually install the following JARs:
 
-- `target/aspose-barcode-cloud-21.2.0.jar`
+- `target/aspose-barcode-cloud-21.3.0.jar`
 - `target/lib/*.jar`
 
 ## Getting Started
 
 Please follow the [installation](#installation) instruction and execute the following Java code:
 
 ```java
-import com.aspose.barcode.cloud.*;
-import com.aspose.barcode.cloud.auth.*;
-import com.aspose.barcode.cloud.model.*;
 import com.aspose.barcode.cloud.api.BarcodeApi;
+import com.aspose.barcode.cloud.model.BarcodeResponseList;
+import com.aspose.barcode.cloud.model.EncodeBarcodeType;
+import com.aspose.barcode.cloud.model.PresetType;
+import com.aspose.barcode.cloud.requests.GetBarcodeGenerateRequest;
+import com.aspose.barcode.cloud.requests.PostBarcodeRecognizeFromUrlOrContentRequest;
 
 import java.io.File;
-import java.util.*;
 
 public class BarcodeApiExample {
-
     public static void main(String[] args) {
         ApiClient client = new ApiClient(
             "Client Id from https://dashboard.aspose.cloud/applications",
             "Client Secret from https://dashboard.aspose.cloud/applications"
         );
-        
+        client.setReadTimeout(5 * 60 * 1000);
+
         BarcodeApi api = new BarcodeApi(client);
-        String type = "type_example"; // String | Type of barcode to generate.
-        String text = "text_example"; // String | Text to encode.
+
         try {
-            File result = api.getBarcodeGenerate(type, text);
-            System.out.println(result);
+            System.out.println("Generating barcode...");
+            File barcodeImage = generateBarcode(api);
+            System.out.println("Barcode image saved to file " + barcodeImage.getAbsolutePath());
+
+            System.out.println("Recognizing barcode on image...");
+            BarcodeResponseList recognized = recognizeBarcode(api, barcodeImage);
+            System.out.print("Barcode on image:");
+            System.out.println(recognized.toString());
         } catch (ApiException e) {
-            System.err.println("Exception when calling BarcodeApi#getBarcodeGenerate");
+            System.err.println("Error");
             e.printStackTrace();
         }
     }
+
+    private static File generateBarcode(BarcodeApi api) throws ApiException {
+        String type = EncodeBarcodeType.PDF417.toString();
+        String text = "Aspose.BarCode for Cloud Sample";
+        GetBarcodeGenerateRequest request = new GetBarcodeGenerateRequest(type, text);
+
+        return api.getBarcodeGenerate(request);
+    }
+
+    private static BarcodeResponseList recognizeBarcode(BarcodeApi api, File barcodeImage) throws ApiException {
+        PostBarcodeRecognizeFromUrlOrContentRequest recognizeRequest = new PostBarcodeRecognizeFromUrlOrContentRequest();
+        recognizeRequest.image = barcodeImage;
+        recognizeRequest.preset = PresetType.HIGHPERFORMANCE.toString();
+
+        return api.postBarcodeRecognizeFromUrlOrContent(recognizeRequest);
+    }
 }
 ```
 
@@ -168,6 +190,7 @@ Class | Method | HTTP request | Description
 - [CodabarParams](docs/CodabarParams.md)
 - [CodabarSymbol](docs/CodabarSymbol.md)
 - [CodablockParams](docs/CodablockParams.md)
+- [Code128Emulation](docs/Code128Emulation.md)
 - [Code16KParams](docs/Code16KParams.md)
 - [CodeLocation](docs/CodeLocation.md)
 - [CouponParams](docs/CouponParams.md)

docs/Code128Emulation.md

@@ -0,0 +1,16 @@
+
+# Code128Emulation
+
+## Enum
+
+
+* `NONE` (value: `"None"`)
+
+* `CODE903` (value: `"Code903"`)
+
+* `CODE904` (value: `"Code904"`)
+
+* `CODE905` (value: `"Code905"`)
+
+
+

docs/Pdf417Params.md

@@ -23,6 +23,7 @@ Name | Type | Description | Notes
 **macroFileName** | **String** | Macro Pdf417 barcode file name |  [optional]
 **macroAddressee** | **String** | Macro Pdf417 barcode addressee name |  [optional]
 **macroECIEncoding** | [**ECIEncodings**](ECIEncodings.md) | Extended Channel Interpretation Identifiers. Applies for Macro PDF417 text fields. |  [optional]
+**code128Emulation** | [**Code128Emulation**](Code128Emulation.md) | Function codeword for Code 128 emulation. Applied for MicroPDF417 only. Ignored for PDF417 and MacroPDF417 barcodes. |  [optional]
 
 
 

pom.xml

@@ -5,7 +5,7 @@
     <artifactId>aspose-barcode-cloud</artifactId>
     <packaging>jar</packaging>
     <name>aspose-barcode-cloud</name>
-    <version>21.2.0</version>
+    <version>21.3.0</version>
     <url>https://www.aspose.cloud/</url>
     <description>Aspose.BarCode Cloud SDK for Java</description>
     <scm>

scripts/extract_java_from_README.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+
+set -euo pipefail
+
+sed -n '/^```java/,/^```/ p' < README.md | sed '/^```/ d'

src/main/java/com/aspose/barcode/cloud/ApiClient.java

@@ -62,7 +62,7 @@
 public class ApiClient {
 
     public final String apiVersion = "v3.0";
-    public final String clientVersion = "21.2.0";
+    public final String clientVersion = "21.3.0";
     private String baseUrl = "https://api.aspose.cloud";
     private String clientId;
     private String clientSecret;
@@ -114,7 +114,7 @@ protected ApiClient() {
         json = new JSON();
 
         // Set default User-Agent.
-        setUserAgent("Swagger-Codegen/21.2.0/java");
+        setUserAgent("Swagger-Codegen/21.3.0/java");
 
         addDefaultHeader("x-aspose-client", "java sdk");
         addDefaultHeader("x-aspose-client-version", clientVersion);