الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

Tinyurl

Tinyurl هو عنوان URL بسيط بناء على Java. المشروع مفتوح المصدر (ترخيص Apache ، الإصدار 2.0)

الإصدار المستقر الحالي هو 1.0.7

مستند

ملف التكوين 

 # SystemProperty / Default value
org.javastack.tinyurl.config=[classpath]/org.javastack.tinyurl.properties
ملاحظة: إذا لم يكن الملف في classpath ، فاستخدم تنسيق url مثل file:///etc/tinyurl/org.javastack.tinyurl.properties أو https://config-server/tinyurl/org.javastack.tinyurl.properties

معلمات التكوين 

 # Parameter / Default value
storage.dir=[webapp]/WEB-INF/storage/
whitelist.file=file://[storage.dir]/whitelist.conf
check.flags=WHITELIST,CONNECTION
check.cache.millis=60000
connection.timeout.millis=10000
read.timeout.millis=30000
dump.key=[random]
#
# Default KVStore Persistence
storage.class=org.javastack.tinyurl.PersistentKVStore
#
# Optional MySQL Persistence (default: not enabled)
#storage.class=org.javastack.tinyurl.jdbc.PersistentMySQL
#storage.url=jdbc:mysql://localhost:3306/tinyurl
#storage.username=tinyurl
#storage.password=secret
#
# QR Codes
#base.url=https://tiny.javastack.org/r/
#qr.size.min=50
#qr.size.max=1000
#qr.size.default=300
  • Storage.dir : حيث يتم تخزين الملفات المحلية.
  • القائمة البيضاء. file: حيث يتم تخزين ملف القائمة البيضاء.
  • check.flags : يتم إجراء عمليات التحقق من عناوين URL.
    • القائمة البيضاء: تحقق من مجال عنوان URL مقابل ملف القائمة البيضاء ، إذا لم يتم العثور عليه ، سيتم رفض المختصر.
    • SORBL: تحقق من مجال عنوان URL مقابل خدمة SORBL ، إذا وجدت ، سيتم رفض Shortener.
    • الاتصال: تحقق من عنوان URL مع اتصال HTTP (GET).
  • check.cache.millis : وقت ذاكرة التخزين المؤقت لفحوصات مجال URL (القائمة البيضاء / swbl).
  • Connection.Timeout.millis : مهلة الاتصال بالميليس.
  • read.timeout.millis : قراءة المهلة في ميليس.
  • Dump.Key : مفتاح تفريغ لتصدير جميع التخزين في CSV.
  • storage.class : فئة تستخدم للثبات:
    • org.javastack.tinyurl.PersistentKVStore : KVSTORE PROSISTENCE (افتراضي ، محمول)
    • org.javastack.tinyurl.jdbc.PersistentMySQL : MySQL Prosistence
      • Storage.url : URL لاتصال JDBC
      • التخزين. اسم المستخدم : اسم المستخدم
      • Storage.Password : كلمة المرور
      • Storage.xxx : انظر معلمات إضافية ، كلها مسبوقة بالتخزين.
  • base.url : عنوان URL الأساسي لـ Tinyurl Redirector (افتراضيًا حاول اكتشاف من الطلب) example: https://tiny.javastack.org/r/
  • qr.size.min : حجم دقيقة مسموح به في QR (بكسل ، مربع) ، افتراضي = 50
  • qr.size.max : حجم الحد الأقصى المسموح به في QR (بكسل ، مربع) ، افتراضي = 1000
  • qr.size.default : الحجم الافتراضي في QR (بكسل ، مربع) ، افتراضي = 300
المزيد من الأمثلة
  • المزيد من الأمثلة في دليل sampleconf

الجري (Tomcat)

  • تعيين CATALINA_OPTS="-Dorg.javastack.tinyurl.config=file://${CATALINA_BASE}/conf/org.javastack.tinyurl.properties" في tomcat/bin/setenv.sh (linux)
  • نسخ ملف الحرب داخل دليل WebApps مع الاسم: root.war
  • من أجل استمرار MySQL:
    • نسخ mysql-connector-java-xxxx.jar في tomcat/lib/
    • قم بإنشاء مستخدم MySQL مع: GRANT ALL ON tinyurl.* TO 'tinyurl'@'%' IDENTIFIED BY 'secret';
* ما هو إصدار MySQL-Connector/J الذي نحتاجه؟ الإصدارات

استخدام API

واجهة برمجة التطبيقات للتقصير بسيطة للغاية:

لتقصير عنوان URL: 

 # Method: POST
# Path: /tiny
# Content-Type: application/x-www-form-urlencoded
# Parameter: "url=${longURLencoded}"
# Example: curl -i -d "url=https%3A%2F%2Fgithub.com%2Fggrandes%2Ftinyurl%2F" ${BASE_URL}/tiny

أعد شيئًا كهذا: 

 HTTP/1.1 200 OK
Content-Type: application/json;charset=ISO-8859-1
Content-Length: 19
Cache-control: must-revalidate, max-age=0

{ "id": "iN8diz" }

لاسترداد صورة QR لعنوان URL القصير: 

 # Method: GET
# Path: /q/{id}
# Example: curl -i ${BASE_URL}/q/iN8diz

أعد شيئًا كهذا: 

 HTTP/1.1 200 OK
Cache-Control: public
Content-Type: image/png
Content-Length: 475

.PNG...binary-data...

لاسترداد عنوان URL الأصلي/الطويل: 

 # Method: GET
# Path: /r/{id}
# Example: curl -i ${BASE_URL}/r/iN8diz

أعد شيئًا كهذا: 

 HTTP/1.1 302 Found
Location: https://github.com/ggrandes/tinyurl/
Content-Length: 0
Cache-control: must-revalidate, max-age=0

متفرقات

القيم المتشددين الحالية:

  • ملف التكوين الافتراضي (تم البحث في classpath): org.javastack.tinyurl.properties
  • الشيكات الافتراضية لعناوين URL هي: القائمة البيضاء ، الاتصال
  • تخزين التخزين المؤقت للتحقق الافتراضي (Millis): 60000
  • مهلة الاتصال الافتراضية (Millis): 10000
  • مهلة القراءة الافتراضية (Millis): 30000
  • خوارزمية لإنشاء مفاتيح من عنوان URL: MD5
  • KEY_SPACE هو: 6 أحرف (Base64 هو 64^ks (6) = 68.719.476.736 Keys Max)
  • الواجهة الخلفية الافتراضية للتخزين هي: kvstore (محمول)

مستوحاة في goo.gl و bit.ly و cort.as ، هذا الرمز هو نسخة java-minimalistic.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل