تنفيذ خيارات Java Stamp Sign باستخدام GroupDocs.Signature للتحقق من صحة المستندات
كيفية تنفيذ خيارات Java Stamp Sign باستخدام GroupDocs.Signature لـ Java
في عصرنا الرقمي، يُعدّ ضمان صحة المستندات أمرًا بالغ الأهمية. سواء كنتَ خبيرًا في مجال الأعمال أو فردًا يرغب في التحقق من صحة العقود والاتفاقيات، فإن إضافة توقيع ختم يُضفي مصداقيةً وأمانًا على المستندات. سيرشدك هذا البرنامج التعليمي إلى كيفية إعداد خيارات توقيع الختم باستخدام GroupDocs.Signature لجافا، وهي مكتبة فعّالة مُصمّمة خصيصًا لتلبية احتياجاتك في توقيع المستندات بسهولة.
ما سوف تتعلمه:
- كيفية تكوين خيارات علامة الختم في جافا.
- إضافة خطوط داخلية وخارجية مع النص والتنسيق.
- أمثلة عملية للتطبيقات في العالم الحقيقي.
- اعتبارات الأداء الرئيسية عند العمل مع GroupDocs.Signature.
دعونا نلقي نظرة على المتطلبات الأساسية قبل أن نبدأ في تنفيذ هذه الميزات.
المتطلبات الأساسية
المكتبات والإصدارات والتبعيات المطلوبة
لاستخدام GroupDocs.Signature لـ Java، تأكد من أن لديك:
- مجموعة تطوير جافا (JDK):الإصدار 8 أو أعلى.
- مافن/جرادل لإدارة التبعيات.
بالنسبة لمشاريع Maven، قم بتضمين ما يلي في pom.xml
:
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-signature</artifactId>
<version>23.12</version>
</dependency>
بالنسبة لمشاريع Gradle، أضف هذا إلى build.gradle
:
implementation 'com.groupdocs:groupdocs-signature:23.12'
يمكنك أيضًا تنزيل الإصدار الأحدث مباشرةً من GroupDocs.Signature لإصدارات Java.
متطلبات إعداد البيئة
- تأكد من تثبيت JDK وتكوينه.
- قم بإعداد مشروع Maven أو Gradle حسب تفضيلاتك.
متطلبات المعرفة الأساسية
- فهم أساسيات برمجة جافا.
- المعرفة بكيفية التعامل مع المستندات وعمليات التوقيع.
إعداد GroupDocs.Signature لـ Java
يُسهّل GroupDocs.Signature لـ Java دمج التوقيع الرقمي في التطبيقات. إليك كيفية البدء:
- تثبيت:استخدم Maven أو Gradle كما هو موضح أعلاه، أو قم بتنزيل ملف JAR مباشرةً من صفحة الإصدارات.
- الحصول على الترخيص:
- نسخة تجريبية مجانية:قم بتنزيل النسخة التجريبية المجانية من صفحة الإصدارات.
- رخصة مؤقتة:احصل على ترخيص مؤقت للوصول إلى الميزات الكاملة عبر هذا وصلة.
- شراء:للاستخدام غير المحدود، فكر في شراء ترخيص هنا: شراء GroupDocs.
- التهيئة الأساسية:
import com.groupdocs.signature.Signature;
String filePath = "path/to/your/document";
Signature signature = new Signature(filePath);
دليل التنفيذ
إعداد خيارات علامة الطوابع
تتيح لك هذه الميزة تكوين توقيعات الطوابع وتطبيقها على المستندات، مما يعزز من صحتها.
الخطوة 1: تهيئة StampSignOptions
import com.groupdocs.signature.options.sign.StampSignOptions;
StampSignOptions signOptions = new StampSignOptions();
signOptions.setHeight(300);
signOptions.setWidth(300);
توضيح:حددنا أبعاد طابعتنا. اضبط height
و width
حسب الحاجة.
الخطوة 2: محاذاة وإضافة الحشو
import com.groupdocs.signature.domain.enums.HorizontalAlignment;
import com.groupdocs.signature.domain.enums.VerticalAlignment;
import com.groupdocs.signature.domain.Padding;
signOptions.setVerticalAlignment(VerticalAlignment.Bottom);
signOptions.setHorizontalAlignment(HorizontalAlignment.Right);
Padding padding = new Padding();
padding.setRight(10);
padding.setBottom(10);
signOptions.setMargin(padding);
توضيح:قم بمحاذاة الختم في الزاوية اليمنى السفلية مع حشو إضافي لتحسين المظهر الجمالي.
الخطوة 3: تعيين الخلفية ونوع الاقتصاص
import com.groupdocs.signature.domain.Background;
import java.awt.Color;
Background background = new Background();
background.setColor(Color.ORANGE);
signOptions.setBackground(background);
signOptions.setBackgroundColorCropType(StampBackgroundCropType.OuterArea);
توضيح:قم بتخصيص مظهر الطوابع باستخدام لون برتقالي نابض بالحياة وحدد كيفية اقتصاص الخلفية.
الخطوة 4: إضافة صورة إلى الختم
signOptions.setImageFilePath("path/to/stamp/image.jpg");
signOptions.setBackgroundImageCropType(StampBackgroundCropType.InnerArea);
signOptions.setAllPages(true);
توضيح:استخدم صورة للختم وقم بتطبيقه على جميع صفحات المستند.
إضافة خطوط الطوابع الخارجية
قم بتعزيز طابعتك باستخدام الخطوط الزخرفية والنصوص:
الخطوة 1: إنشاء خطوط خارجية
import com.groupdocs.signature.domain.stamps.StampLine;
import com.groupdocs.signature.domain.SignatureFont;
StampSignOptions signOptions = new StampSignOptions();
// الخط الخارجي الأول
StampLine outerLine1 = new StampLine();
outerLine1.setText("* European Union *");
outerLine1.setTextRepeatType(StampTextRepeatType.FullTextRepeat);
SignatureFont font1 = new SignatureFont();
font1.setSize(12);
font1.setFamilyName("Arial");
outerLine1.setFont(font1);
outerLine1.setHeight(30);
outerLine1.setTextColor(Color.WHITE);
outerLine1.setBackgroundColor(Color.BLUE);
signOptions.getOuterLines().add(outerLine1);
توضيح:أضف خطًا منسقًا بالنص الذي يتكرر بالكامل عبر الختم.
الخطوة 2: خط الفاصل
// الخط الخارجي الثاني كفاصل
StampLine outerLine2 = new StampLine();
outerLine2.setHeight(2);
outerLine2.setBackgroundColor(Color.WHITE);
signOptions.getOuterLines().add(outerLine2);
توضيح:أدرج فاصلًا بسيطًا للتمييز البصري بين الأسطر.
الخطوة 3: إضافة نص مع حدود
// الخط الخارجي الثالث مع تصميم إضافي
StampLine outerLine3 = new StampLine();
outerLine3.setText("* Entrepreneur *");
outerLine3.setTextColor(Color.BLUE);
SignatureFont font3 = new SignatureFont();
font3.setSize(15);
outerLine3.setFont(font3);
outerLine3.setHeight(30);
Border innerBorder = new Border();
innerBorder.setColor(Color.DARK_GRAY);
innerBorder.setDashStyle(DashStyle.Dot);
outerLine3.setInnerBorder(innerBorder);
Border outerBorder = new Border();
outerBorder.setColor(Color.BLUE);
outerLine3.setOuterBorder(outerBorder);
signOptions.getOuterLines().add(outerLine3);
توضيح:أضف سطر نص آخر مع حدود داخلية وخارجية لتحسين الرؤية.
إضافة خطوط الطوابع الداخلية
يمكن أن تحتوي الخطوط الداخلية على معلومات أو علامات تجارية مهمة:
الخطوة 1: إنشاء خطوط داخلية
import com.groupdocs.signature.domain.stamps.StampLine;
import com.groupdocs.signature.domain.SignatureFont;
// الخط الداخلي الأول
StampLine innerLine1 = new StampLine();
innerLine1.setText("John");
innerLine1.setTextColor(Color.RED);
SignatureFont signFont1 = new SignatureFont();
signFont1.setSize(20);
signFont1.setBold(true);
innerLine1.setFont(signFont1);
innerLine1.setHeight(40);
signOptions.getInnerLines().add(innerLine1);
توضيح:أضف خط نص غامق باللون الأحمر لعرض بارز.
الخطوة 2: معلومات إضافية
// الخطان الداخليان الثاني والثالث
StampLine innerLine2 = new StampLine();
innerLine2.setText("Smith");
innerLine2.setTextColor(Color.RED);
SignatureFont signFont2 = new SignatureFont();
signFont2.setSize(20);
signFont2.setBold(true);
innerLine2.setFont(signFont2);
innerLine2.setHeight(40);
signOptions.getInnerLines().add(innerLine2);
StampLine innerLine3 = new StampLine();
innerLine3.setText("SSN 1230242424");
innerLine3.setTextColor(Color.MAGENTA);
SignatureFont signFont3 = new SignatureFont();
signFont3.setSize(12);
signFont3.setBold(true);
innerLine3.setFont(signFont3);
innerLine3.setHeight(40);
signOptions.getInnerLines().add(innerLine3);
توضيح:أضف أسطر معلومات شخصية إضافية إلى الختم، مع التأكد من تنسيقها بشكل جيد ووضوحها.
التطبيقات العملية
- توقيع العقد:استخدم الطوابع لمزيد من الأمان في مستندات العقد.
- مصادقة الفاتورة:تطبيق الطوابع الرقمية على الفواتير للتأكد من صحتها.
- التحقق من الوثائق القانونية:تعزيز الوثائق القانونية بالتوقيعات القابلة للتحقق.
- اتفاقيات الأعمال:تأمين اتفاقيات العمل باستخدام علامات ختم مرئية واحترافية.