FileControl

setup

Static Class Method

    public static void setup(Context context)

Uygulamanın Application sınıfındaki onCreate metodu içerisinde kullanılmalıdır. FileControl paketi bu işlem yapılmadan indirme yapamayacaktır.

mapFilesExist

Static Class Method

	public static boolean mapFilesExist(String dataPath)

dataPath içinde Yolbil harita verilerinin dosya bazında eksiksiz olarak var olup olmadığını kontrol eder. Sadece bilgi amaçlı kullanılır, veri güncellemesi yapmaz, dosya doğruluğunu kontrol etmez.

Örnek Kullanım:

	if(FileControl.mapFilesExist("yolbildata")){
		System.out.println("Harita Dosyaları Tam");
	}else{
		System.out.println("Harita Dosyaları Eksik");
	}

checkMapFiles

Static Class Method

	public static void checkMapFiles(Activity context, FileControlListener listener)
	public static void checkMapFiles(Activity context, String dataPath, FileControlListener listener)
	public static void checkMapFiles(Activity context, FileControlListener listener, String updateServer)
	public static void checkMapFiles(Activity context, String dataPath, FileControlListener listener, String updateServer)

Belirtilen dosya yolu içindeki tüm dosyaları kontrol eder. Kontrol işlemi esnasında bulunan hatalı dosyaları belirtilen sunucu adresinden indirir. İndirilen dosyaları ayrıca tekrar kontrol ederek indirme işleminde oluşabilecek hataların önüne geçmiş olur.

context: checkMapFiles işleminin genellikle SplashScreen üzerinde yapılması öngörülür. SplashScreen’in Activity Context’ini alır.

dataPath: Harici depolama alanı üzerinde Yolbil Harita verisinin bulunacağı klasörü temsil eder. Yolbil.initialize işleminde olduğu gibi varsayılan değer “yolbildata” olarak ayarlanmıştır. Bu da fiziksel yol olarak “/mnt/sdcard/yolbildata/” olarak düşünülebilir.

updateServer: Harita dosyalarının bulunduğu uzak sunucunun adresinin ayarlanması için kullanılır. Varsayılan değeri Başarsoft tarafından kullanılan dosya sunucusunu işaret etmektedir. Örnek kullanım şu şekilde olmalıdır: "http://www.yourwebsite.com/yourdatapath/".

listener: checkMapFiles tarafından arkaplanda yapılan işlemlerin durumlarının dinlenebileceği FileControlListener nesnesini alır. Bu yapının kullanımı FileControlListener anlatılırken detaylı olarak işlenecektir.

addHeader

Static Class Method

	public static void addHeader(String name, String value)

checkMapFiles tarafından yapılacak indirmeler için HTTP objesine Header çiftleri eklemek için kullanılır.

addHeader

Static Class Method

	public static void addHeader(String line)

checkMapFiles tarafından yapılacak indirmeler için HTTP objesine Header satırları eklemek için kullanılır.

downloadSimultaneously

Static Class Method

	public static void downloadSimultaneously(boolean simultaneously)

checkMapFiles metodunun yapacağı indirme işlemlerinin nasıl yapılacağını belirtir. simultaneously true olarak ayarlanılırsa iki ve ikiden fazla indirme işlemi yapılacak olursa bu işlemler aynı anda 3 indirme yapılacak şekilde başlatılacaktır. simultaneously false olarak ayarlanırsa yapılacak indirmelerin biri bitmeden bir diğerine başlanmayacaktır.

stop

Static Class Method

	public static void stop()

checkMapFiles tarafından başlatılan kontrol etme ve indirme işlemlerini durdurmak için kullanılır.

fileSha

Static Class Field

	public static HashMap<String, String> fileSha;

checkMapFiles ve/veya mapFilesExist metodları tarafından kullanılacak dosya listesini barındırır. FileControl tarafından kontrol edilmesi istenen dosyaları bu listeye eklenebilir. Yahut bir dosyanın kontrol edilmesi istenmiyor ise bu listeden silinebilir. İlk parametre dosyanın dataPath(örn: “yolbildata”) içindeki yolunu tutarken ikinci parametre bu yolda olması gereken dosyanın sha1 biçiminden hashini tutar. Not: Bu listenin değiştirilmesi normal şartlar altında önerilmez