ہائپر ٹیکسٹ مارک اپ لینگویج (HTML) ویب صفحہ بنانے کے لیے ایک معیاری مارک اپ لینگوئج ہے۔ یہ HTML عناصر/ٹیگز کا استعمال کرتے ہوئے حصوں، پیراگراف اور لنکس کی تخلیق اور ساخت کی اجازت دیتا ہے۔ اور اگر ایچ ٹی ایم ایل فائل میں کچھ حسب ضرورت فونٹس استعمال کیے جاتے ہیں یا کسی ڈائنامک آبجیکٹ کا حوالہ دیا جاتا ہے جس کے لیے سورس مشین/سرور سے ایک فعال کنکشن درکار ہوتا ہے، تو دستاویز کی وفاداری پر سمجھوتہ کرنے کے امکانات ہوتے ہیں۔ دوسری طرف، XML Paper Specification (XPS) میں، صفحہ کے عناصر کو کسی خاص آپریٹنگ سسٹم، پرنٹر، یا دیکھنے کی ایپلی کیشن سے آزادانہ طور پر بیان کیا جاتا ہے۔ لہذا ایک ذہین نقطہ نظر HTML کو XPS فارمیٹ میں تبدیل کرنا ہے۔
- HTML کنورژن API
- جاوا میں HTML کو XPS میں تبدیل کریں۔
- cURL کمانڈز کا استعمال کرتے ہوئے HTML سے XPS تک
HTML کنورژن API
جاوا کے لیے Aspose.HTML کلاؤڈ SDK ایک ہلکا پھلکا REST فن تعمیر پر مبنی API ہے جو HTML فائلوں کو PDF، DOCX، TIFF، JPEG میں بنانے، جوڑ توڑ اور تبدیل کرنے کی صلاحیتیں فراہم کرتا ہے۔ ، وغیرہ۔ یہ HTML کو XPS میں تبدیل کرنے کی بھی حمایت کرتا ہے۔ لہذا، پہلے، ہمیں اپنے جاوا پروجیکٹ میں SDK کو شامل کرنے کے لیے Maven بلڈ ٹائپ پروجیکٹ کے pom.xml میں درج ذیل تفصیلات شامل کرنے کی ضرورت ہے۔
<repositories>
<repository>
<id>aspose-cloud</id>
<name>artifact.aspose-cloud-releases</name>
<url>http://artifact.aspose.cloud/repo</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-html-cloud</artifactId>
<version>20.7.0</version>
<scope>compile</scope>
</dependency>
</dependencies>
انسٹالیشن کے بعد، اگلا مرحلہ ہماری کلاؤڈ سروسز کی مفت سبسکرپشن ہے [Aspose.Cloud ڈیش بورڈ] کے ذریعے 7 GitHub یا Google اکاؤنٹ کا استعمال کرتے ہوئے۔ یا، صرف ایک نیا اکاؤنٹ بنائیں اور اپنے کلائنٹ کی اسناد کی تفصیلات حاصل کریں۔
جاوا میں HTML کو XPS میں تبدیل کریں۔
HTML سے XPS کنورٹر تیار کرنے کے لیے براہ کرم نیچے دی گئی ہدایات پر عمل کریں۔
- سب سے پہلے، ہمیں Configuration.setAPPSID اور Configuration.setAPIKEY طریقوں کے خلاف تفصیلات بتانے کی ضرورت ہے۔
- دوم، ہم setBasePath(..)، setAuthPath(..) کے لیے تفصیلات مرتب کرتے ہیں اور setUserAgent(…) کو بطور WebKit متعین کرتے ہیں۔
- تیسرا، اپنی مدد کے لیے، ہم setDebug(..) کو سچ کے طور پر سیٹ کرنے جا رہے ہیں۔
- اب ConversionApi کلاس کا ایک آبجیکٹ بنائیں
- نتیجہ خیز فائل کے لیے معلومات کے لیے مارجن کی تفصیلات اور نام کی وضاحت کریں۔
- آخر میں، GetConvertDocumentToXps(…) طریقہ کو کال کریں جس میں HTML نام، طول و عرض اور مارجن کی تفصیلات بطور دلیل درکار ہوتی ہیں۔
// مزید مثالوں کے لیے، براہ کرم ملاحظہ کریں https://github.com/aspose-html-cloud/aspose-html-cloud-java
try
{
// https://dashboard.aspose.cloud/ سے ClientID اور ClientSecret حاصل کریں
String clientId = "bbf94a2c-6d7e-4020-b4d2-b9809741374e";
String clientSecret = "1c9379bb7d701c26cc87e741a29987bb";
// اے پی آئی کی درخواست کی تفصیلات
com.aspose.html.Configuration.setAPP_SID(clientId);
com.aspose.html.Configuration.setAPI_KEY(clientSecret);
com.aspose.html.Configuration.setBasePath("https://api.aspose.cloud/v3.0");
com.aspose.html.Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
com.aspose.html.Configuration.setUserAgent("WebKit");
com.aspose.html.Configuration.setDebug(true);
// Aspose.HTML Cloud API کا ایک آبجیکٹ بنائیں
com.aspose.html.api.ConversionApi htmlApi = new ApiClient().createService(ConversionApi.class);
// کلاؤڈ اسٹوریج سے HTML دستاویز
String name = "list.html";
// نتیجہ خیز تصویر کی شکل
String outFormat = "PNG";
Integer width = 800; // Resulting image width.
Integer height = 1000; // Resulting image height.
Integer leftMargin = 10; // Left resulting image margin.
Integer rightMargin = 10; // Right resulting image margin.
Integer topMargin = 10; // Top resulting image margin.
Integer bottomMargin = 10; // Bottom resulting image margin.
Integer resolution = 300; // Resolution of resulting image.
String folder = null; // The folder in the storage. Should exist.
String storage = "Internal"; // Name of the storage. null
// HTML سے XPS کی تبدیلی کے لیے API کو طلب کریں۔
retrofit2.Call<okhttp3.ResponseBody> call = htmlApi.GetConvertDocumentToXps(name, width, height, leftMargin, rightMargin, topMargin, bottomMargin, folder, storage);
System.out.println("HTML to XPS conversion sucessfull !");
}catch(Exception ex)
{
System.out.println(ex);
}
مندرجہ بالا کوڈ ردعمل کے سلسلے میں نتیجہ واپس کرتا ہے، لہذا، مقامی ڈرائیو پر آؤٹ پٹ کو بچانے کے لیے، ہم درج ذیل کسٹم طریقہ استعمال کرنے پر غور کر سکتے ہیں۔
/*
* ResponseBody اور نتیجے میں فائل کا نام بطور دلیل لینے کا طریقہ
*/
public static void checkAndSave(retrofit2.Call<okhttp3.ResponseBody> call, String fileName) throws IOException
{
// مطابقت پذیری سے درخواست بھیجیں اور اس کا جواب واپس کریں۔
retrofit2.Response<okhttp3.ResponseBody> res = call.execute();
// ایک کامیاب جواب کا ڈی سیریلائزڈ رسپانس باڈی
okhttp3.ResponseBody answer = res.body();
//ٹیسٹ ڈائرکٹری میں محفوظ کریں۔
boolean result = saveToDisc(answer, fileName);
// تصدیق کریں کہ نتیجہ کی قیمت درست ہے (اختیاری مرحلہ)
Assert.assertTrue(result);
}
/*
*
* ریسپانس مواد کو لوکل ڈرائیو پر فائل کے طور پر محفوظ کرنے کے لیے اس طریقہ کو کال کریں۔
*
*/
public static boolean saveToDisc(okhttp3.ResponseBody body, String fileName)
{
// نتیجہ خیز فائل کے لئے مقام کی نشاندہی کرنے والی فائل آبجیکٹ بنائیں
File savedFile = new File("c:\\Downloads\\"+fileName);
try (InputStream inputStream = body.byteStream();
OutputStream outputStream = new FileOutputStream(savedFile))
{
byte[] fileReader = new byte[4096];
long fileSizeDownloaded = 0;
while (true) {
int read = inputStream.read(fileReader);
if (read == -1) break;
// فائل اسٹریم کو لوکل ڈرائیو میں محفوظ کریں۔
outputStream.write(fileReader, 0, read);
fileSizeDownloaded += read;
}
// آؤٹ پٹ اسٹریم مثال کو صاف کریں۔
outputStream.flush();
// فائل کو کامیابی کے ساتھ محفوظ کرتے ہوئے سچ کو واپس کریں۔
return true;
} catch (Exception e) {
e.printStackTrace();
return false;
}
} // saveToDisc ends here
مندرجہ بالا مثال میں استعمال ہونے والی نمونہ فائلوں کو list.html اور resultantFile.xps سے ڈاؤن لوڈ کیا جا سکتا ہے۔
cURL کمانڈز کا استعمال کرتے ہوئے HTML سے XPS تک
REST APIs تک cURL کمانڈز کے ذریعے بھی رسائی حاصل کی جا سکتی ہے اس لیے اس سیکشن میں، ہم cURL کمانڈ کا استعمال کرتے ہوئے HTML سے XPS کی تبدیلی کو انجام دینے کے طریقے سیکھنے جا رہے ہیں۔ اب پیشگی شرط کے طور پر، ہمیں آپ کے انفرادی کلائنٹ کی اسناد کی بنیاد پر سب سے پہلے JSON ویب ٹوکن (JWT) بنانے کی ضرورت ہے۔ براہ کرم JWT ٹوکن بنانے کے لیے درج ذیل کمانڈ پر عمل کریں۔
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bbf94a2c-6d7e-4020-b4d2-b9809741374e&client_secret=1c9379bb7d701c26cc87e741a29987bb" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
اب جب کہ ہمارے پاس JWT ٹوکن ہے، براہ کرم HTML سے XPS کی تبدیلی کو انجام دینے کے لیے ٹرمینل پر درج ذیل کمانڈ پر عمل کریں۔
curl -v -X GET "https://api.aspose.cloud/html/list.html/convert/xps" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <JWT Token>" \
-o final.xps
نتیجہ
اس مضمون میں REST API کا استعمال کرتے ہوئے HTML کو XPS میں تبدیل کرنے کی تفصیلات بیان کی گئی ہیں۔ ہم نے جاوا کوڈ کے ٹکڑوں کے ساتھ ساتھ cURL کمانڈز کے ذریعے HTML کو XPS میں تبدیل کرنے کے اقدامات سیکھے ہیں۔ مزید برآں، براہ کرم نوٹ کریں کہ پروڈکٹ دستاویزات API کی طرف سے پیش کی جانے والی حیرت انگیز صلاحیتوں کو سیکھنے کا ایک بہترین ذریعہ ہے۔ مزید برآں، اگر آپ کو API استعمال کرتے وقت کسی قسم کی پریشانی کا سامنا کرنا پڑتا ہے، تو براہ کرم بلا جھجک [مفت پروڈکٹ سپورٹ فورم] سے رابطہ کریں۔
متعلقہ مضامین
اس حوالے سے مزید تفصیلات کے لیے ہم درج ذیل بلاگز پر جانے کی بھی سفارش کرتے ہیں: