الدالة مع تعريفها |
public String getContent()
ترجع كائن يمثل إسم الكلاس الذي يجب استخدامه للتعامل مع محتوى الملف الذي يشير إليه كائن الـ URLConnection .
في حال حدث خطأ بسبب الملف يتم رمي الإستثناء IOException
و في حال كان البروتوكول المستخدم غير ملائم للتعامل مع الملف, يتم رمي الإستثناء UnknownServiceException. |
public String getContentEncoding()
ترجع نص يمثل قيمة الحقل content-encoding في حال تم تحديدها في كائن الـ URLConnection .
و ترجع null في حال كانت قيمته غير معروفة.
معلومة: هذا الحقل يحدد الطريقة التي سيتم فيها تجزيء الملف عند إرساله إلى الجهة المطلوبة, و هو عبارة عن إسم الترميز المستخدم من قبل البروتوكول المعنمد عليه للتعامل مع هذا الملف. |
public long getContentLengthLong()
ترجع نص يمثل قيمة الحقل content-encoding في حال تم تحديدها في كائن الـ URLConnection .
و ترجع 1- في حال كانت غير محددة.
معلومة: هذا الحقل يمثل حجم البيانات الأساسية المتعلقة بهذا الإتصال في حال قمت بتحديده, أي عدد الأحرف المتوقع إستقبالها.
طبعاً لا ضرورة لتحديدها لأنه سيقوم بذلك بشكل تلقائي في حال لم تفعل ذلك. |
public String getContentType()
ترجع نص يمثل قيمة الحقل Content-Type و هو عبارة نوع الملف الذي يشير إليه كائن الـ URLConnection .
و ترجع null في حال كان النوع غير معروف. |
public int getDate()
ترجع قيمة الحقل date , و هو عبارة عن رقم يمثل التاريخ و الوقت الذي قام فيه السيرفر بإرسال الملف الذي يشير إليه كائن الـ URLConnection .
الرقم الذي ترجعه عبارة عن عدد الـ milliseconds الموجودة إعتباراً من التاريخ 1/1/1970 00:00:00 GMT .
ترجع 0 في حال كان الوقت غير معروف. |
public int getLastModified()
ترجع قيمة الحقل last-modified في حال كانت مذكورة في الملف الذي يشير إليه كائن الـ URLConnection , و هو عبارة عن رقم يمثل تاريخ آخر مرة تم فيها تعديل هذا الملف.
الرقم الذي ترجعه عبارة عن عدد الـ milliseconds الموجودة إعتباراً من التاريخ 1/1/1970 00:00:00 GMT .
ترجع 0 في حال كان الوقت غير معروف. |
public long getExpiration()
ترجع قيمة الحقل expires في حال كانت مذكورة في الملف الذي يشير إليه كائن الـ URLConnection , و هو عبارة عن رقم يمثل تاريخ صلاحية الملف.
الرقم الذي ترجعه عبارة عن عدد الـ milliseconds الموجودة إعتباراً من التاريخ 1/1/1970 00:00:00 GMT .
ترجع 0 في حال كانت غير مذكورة في الملف.
معلومة: في العادة أي ملف نطلبه من موقع ما يتم إعطائه تاريخ صلاحية, هذا التاريخ يضمن لك أن زوار الموقع سيحصلون دائماً على آخر تحديث فعلته لهذا الملف.
فمثلاً, عندما تقوم بفتح أي صفحة من النت, يقوم المتصفح بحفظ هذه الصفحة على القرص الصلب, و في حال طلبت نفس الصفحة من جديد حتى و لو كان بعد سنة, سيقوم المتصفح أولاً بالبحث في الصفحات المخزنة فيه سابقاً, و في حال وجد أن هذه الصفحة أصلاً موجودة عنده, يعرضها لك بسرعة بدل أن تنتظره ليحملها لك من النت. إذاً هنا المشكلة تكون أنك ستحصل دائماً على النسخة القديمة للصفحة.
الحل لهذه المشكلة كان بإعطاء الملفات تاريخ صلاحية. فمثلاً تجعل الصفحة صالحة لمدة يوم واحد, عندها في إذا قام المستخدم بطلب نفس الصفحة التي طلبها في اليوم السابق, سيجد المتصفح أن الصفحة التي يمكلها إنتهت صلاحيتها و بالتالي سيطلبها له من السيرفر من جديد و عندها سيحصل على آخر تحديث تم إجراءه على الصفحة.
إذاً هذا الحقل مهم جداً و يجب ذكره في جميع الملفات التي ترفع في النت. |
public long getIfModifiedSince()
ترجع قيمة الحقل ifModifiedSince في حال كانت مذكورة في الملف, و هو عبارة عن رقم يمثل تاريخ آخر مرة علم فيها المستخدم أن الملف قد تم تحديثه.
الرقم الذي ترجعه عبارة عن عدد الـ milliseconds الموجودة إعتباراً من التاريخ 1/1/1970 00:00:00 GMT .
ترجع 0 في حال كان الوقت غير معروف.
معلومة: هنا مثلاً يتم تصميم البرنامج لمقارنة آخر مرة قام فيها هو بتعديل محتوى الملف مع آخر مرة قام فيها أي أحد بتعديل محتوى هذا الملف.
في حال وجد نفسه هو آخر من قام بتحديث الملف, يعلم عندها أن المعلومات المذكورة فيه لم تتغير و بالتالي يمكنه إستعمال النسخة التي يملكها من هذا الملف بدل تحميلها من النت من جديد.
لكن في حال وجد أن هذا الملف قد تم تحديثه من قبل شخص آخر, عندها سيقوم بتحميل النسخة الموجودة في السيرفر من جديد و تجاهل النسخة التي يملكها. |
public void setDoInput(boolean input)
تحدد قيمة الحقل doinput في كائن الـ URLConnection .
إذا قمت بتمرير القيمة true لها فهذا يعني أنك تنوي استخدام كائن الـ URLConnection لقراءة محتوى الملف.
ترمي الإستثناء IllegalStateException في حال كان الكائن متصلاً بالملف قبل استدعائها. |
public boolean getDoInput()
ترجع قيمة الحقل doinput في حال قمنا بتحديدها في كائن الـ URLConnection . |
public void setDoOutput(boolean output)
تحدد قيمة الحقل doinput في كائن الـ URLConnection .
إذا قمت بتمرير القيمة true لها فهذا يعني أنك تنوي استخدام كائن الـ URLConnection للكتابة في الملف.
ترمي الإستثناء IllegalStateException في حال كان الكائن متصلاً بالملف قبل استدعائها. |
public boolean getDoOutput()
ترجع قيمة الحقل dooutput في حال قمنا بتحديدها في كائن الـ URLConnection . |
public void setUseCaches(boolean usecaches)
تحدد قيمة الحقل usecaches في كائن الـ URLConnection .
إذا قمت بتمرير القيمة true لها فهذا يعني أنك تريد الإحتفاظ بنسخة من الملف في القرص الصلب.
ترمي الإستثناء IllegalStateException في حال كان الكائن متصلاً بالملف قبل استدعائها. |
public boolean getUseCaches()
ترجع قيمة الحقل usecaches في حال قمنا بتحديدها في كائن الـ URLConnection . |
public InputStream getInputStream()
ترجع كائن نوعه InputStream يستخدم للقراءة من الملف.
في حال حدث خطأ بسبب الملف يتم رمي الإستثناء IOException.
و في حال كان البروتوكول المستخدم غير ملائم للتعامل مع الملف, يتم رمي الإستثناء UnknownServiceException. |
public OutputStream getOutputStream()
ترجع كائن نوعه OutputStream يستخدم للكتابة في الملف.
في حال حدث خطأ بسبب الملف يتم رمي الإستثناء IOException.
و في حال كان البروتوكول المستخدم غير ملائم للتعامل مع الملف, يتم رمي الإستثناء UnknownServiceException. |
public String getHeaderField(String name)
ترجع قيمة أي حقل نمرر إسمه لها كنص. |
public Map<String,List<String>> getHeaderFields()
ترجع كائن نوعه Map يحتوي على جميع أسماء و قيم الحقول الموجودة في Header كائن الـ Connection بشكل key / value.
معلومة: هذه الدالة ترجع لك جميع معلومات الإتصال دفعة واحدة كجدول, و بالتالي تسهل عليك جلب جميع المعلومات المتعلقة بعملية الإتصال مع الملف. |
public URL getURL()
ترجع كائن الـ URL المستخدم من قبل كائن الـ Connection . |