Database etiketine sahip kayıtlar gösteriliyor. Tüm kayıtları göster
Database etiketine sahip kayıtlar gösteriliyor. Tüm kayıtları göster

Ders 20: Android External Database Connection

7 Mart 2012 Çarşamba
Evet,sonunda zaman buldum,yarattım. Ve kaldığımız yerden devam ediyoruz. Konumuz external database bağlantısını gerçekleştirmek.
Genel olarak önce kodları verip,daha sonra onların ne anlam ifade ettiğini açıkladım. Okurken şaşırmayın.

Öncelikli olarak SQLite Database Browser kullanarak, database içinde bulunan tabloları ve bu tabloların alanları ile verilerini (insert ile eklenen verileri) oluşturuyoruz. Bunu başka bir derste detaylı olarak anlatabilirim. Çok basit bir yapısı var bu programın. Add Table diyip yeni bir tablo oluşturabiliyorsunuz ve hiç insert cümleciği yazmadan bile veri ekleyebiliyorsunuz.

Main.xml içerisine gelip , tasarımımızı oluşturuyoruz. Ben bir listview kullanmayı uygun gördüm. Database üzerinden veri çekip bu listview’in elemanları olarak göstermek istedim. Listview’i daha önceden anlatmıştım,o yüzden onun da pek üzerinde durmuyorum. Kodları ise şöyle oluyor:


<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical" >
    <TextView
        android:layout_width="fill_parent"
       android:layout_height="wrap_content"
        android:text="@string/hello" />
  
<ListView
             android:id="@+id/contentlist"
             android:layout_width="fill_parent"
             android:layout_height="fill_parent"/>
</LinearLayout>

İsteyen buradaki TextView’i kaldırabilir tabiî ki. Ben üşendiğim için, direkt varolan main.xml içerisine ListView eklemesi yaptım.
 SQLite Database Browser ile oluşturduğumuz .db uzantılı database dosyaımızı , ilgili projemiz içindeki “Assets” klasörü altına atıyoruz.


   “src” klasörü içindeki com… adlı paketimizin altına DatabaseHelper adında bir java dosyası oluşturuyoruz.

İçini ise şöyle düzenliyoruz:

public class DatabaseHelper  extends SQLiteOpenHelper

SQLiteOpenHelper sınıfını extends ediyoruz,öncelikle. Böylece bu sınıfımızın database için kullanılacağını belirtmiş oluyoruz.


private static String DB_PATH = "/data/data/tr.edu.kelimeavcisi/databases/";
private static String DB_NAME = "tatliavcisi.db";

Path ve database adımızı belirtiyoruz. Db_Path değişkenini , database’imizin nerede olduğunu programa anlatmak için kullanıyoruz.Assets içine koyduğumuz tatliavcisi.db dosyası /data/data/packagename/databases/ dizini altında bulunduğu için,bunu kendimize göre ayarlıyoruz. Db_Name değişkenine de database dosyamızın adını yazıyoruz.


private SQLiteDatabase myDataBase;
private final Context myContext;

Şeklinde 2 değişken daha tanımlıyoruz, bunlardan myDatabase değişkenini, database üzerinde işlem yapabilmek için kullanacağız. myContext ise yine context değeri için kullanılacak.


public DatabaseHelper(Context context) {
      super(context, DB_NAME, null, 1);     
     this.myContext = context;
                                         }

Constructor metodumuzu yazıyoruz. Burada super metodu içindeki DB_NAME değişkenini yukarıda tanımlamıştık, 1 yazan değer ise bizim database’imizin sürümü.İstiyosanız 2,3 yazın,size kalmış.İlla 1 olucak diye bir kaide yok!


public void createDataBase() throws IOException{
        boolean dbExist =checkDataBase();
             if(dbExist){
             //bir şey yapma,zaten database mevcut.
              }else{
      
     this.getReadableDatabase();
             try {   
                copyDataBase();
             } catch (IOException e) {
       
            throw new Error("Error copying database");
      
     }  
   }
    }

Bu method kullanılarak default sistem pathi üzerinde boş bir database oluşturulacak, eğer bir database mevcut ise de o database bunun üzerine yazılacak. Burada Exception kullanarak, kodumuzu daha sağlıklı bir hale getirdik, eğer kopyalama (ya da siz buna üzerine yazma diyebilirsiniz) esnasında bir hata olursa,bize “Error copying database” şeklinde bir hata verecek. Buradaki checkDatabase()  ve copyDatabase() metodlarını da biz yazıyoruz. Dolayısıyla eğer şu anda bir hata mesajı alıyorsanız gayet normal. Tabiki gerekli importları da yapmadığınızı düşünürsek gene hata mesajı alabilirsiniz.


privat boolean checkDataBase(){
     SQLiteDatabase checkDB = null;
   try{
           String myPath = DB_PATH + DB_NAME;
       checkDB = SQLiteDatabase.openDatabase(myPath,null
SQLiteDatabase.OPEN_READONLY);
  
   }catch(SQLiteException e){
         //database does't exist yet.
       }
       if(checkDB != null){
             checkDB.close();
       }
       return checkDB != null ? true : false;
        }

checkDatabase() metodu sürekli olarak yeni bir database yaratılıp, onun üzerine kopyalama işleminin yapılmasını engelleyecek bir metot aslında. Daha önceden yaratılmış bir database olup olmadığına bakıyoruz ve varsa tamam, bir şey yapma diyoruz. Aslında olay bu kadar basit.

Burada /data/data/package_name/databases/database_name dizininde bir database olup olmadığına bakılıyor. Eğer sonuç olarak “null” dönerse, böyle bir database olmadığı anlaşılacak ve yeni bir database yaratılacak, eğer “null” değeri dönmezse , onun yerine bir database örneği dönerse , zaten böyle bir database’in var olduğunu anlayacağız ve yeni bir database yaratmamıza gerek kalmayacak.


private void copyDataBase() throws IOException{
   //Local database’imizi açıyoruz  
   InputStream myInput = myContext.getAssets().open(DB_NAME);
       // Yeni yaratılmış database’in pathini tam olarak algılıyoruz
   String outFileName = DB_PATH + DB_NAME;
   
   //Boş database’imizi açıyorz
      OutputStream myOutput = new FileOutputStream(outFileName);
  
   //Local database’imizi boş database üzerine kopyalıyoruz.
      byte[] buffer = new byte[1024];   
   int length;  
   while ((length =myInput.read(buffer))>0){
            myOutput.write(buffer, 0,length);  
   }  
   //Açılmış database’leri kapatıyoruz.  
   myOutput.flush();  
   myOutput.close();
  myInput.close();
    }

Sırasıyla , kod içinde de yazılan yorumlardan anlaşılacağı üzere, local database’imizi ve boş database’imizi açıp,kopyalama işlemini gerçekleştiriyoruz.Ardından da bu database’leri kapatıyoruz.


public void openDataBase() throws SQLException{   
   //Database’i Aç      
String myPath = DB_PATH + DB_NAME;  
   myDataBase = SQLiteDatabase.openDatabase(myPath,null,SQLiteDatabase.OPEN_READONLY);
  
}

Database’imize ulaşmamızı sağlayacak open metodunu yazıyoruz. Burada anlaşılmayan bir şey yok diye düşünüyorum.


@Override
       public synchronized void close() {
           if(myDataBase != null)
       myDataBase.close();  
       super.close();
       }

Aynı şekilde database üzerinde istenmeyen işlemlerin yapılmasını ya da dikkatsizlikten oluşacak hataları önlemekte kullanacağımız close metodunu da yazıyoruz. Yine burada anlaşılmayan bir şey yok diye düşünüyorum.


@Override
       public void onCreate(SQLiteDatabase db) {
       }
       @Override
       public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
       }

SQLiteOpenHelper sınıfını kullandığımızda zorunlu olarak yazmamız gereken metodları da ekliyoruz. Ama biz external bir database kullandığımız için bu metotlarla yapacağımız bir iş yok. İçlerini boş bırakıyoruz.


Cursor getAllAccounts()
         {
          this.close();
          this.openDataBase();
          SQLiteDatabase db=this.getReadableDatabase();
          Cursor cur=db.query("accounts", new String[] {"name"}, null , null , null , null , null);
          return cur;
         }


Bu illa kullanılması gereken bir metot değil. Yani kişiye,programa özel bir metot. Ben database’im içinde bulunan “accounts” tablosu içinden “name” kolonunda bulunan değerleri getirmek istediğim için , böyle bir metot oluşturdum. Burada , okunabilir bir database örneği çağırdıktan sonra query metodu ile sorgumu gerçekleştirdim. Dönen sonucu bir cursor üzerine atadım. Daha sonra activity içerisinden bunu çağırıp, istediğim gibi dönen verileri kullanacağım.



import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.util.ArrayList;
import android.content.Context;
import android.database.Cursor;
import android.database.SQLException;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteException;
import android.database.sqlite.SQLiteOpenHelper;
import android.util.Log;

Aslında tüm DatabaseHelper dosyamız bu kadar, ama hala hata alanlar varsa diye tüm importları da belirteyim istedim. Son satırdaki Log’u import etmeseniz de olabilir. Ben onu hatam nerede var, program nasıl işliyor diye görmek için LogCat üzerinde mesaj alabilmek için kullandım.


@Override
public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);     
setContentView(R.layout.main);
        //DatabaseHelper sınıfından yeni bir örnek oluşturma
       
DatabaseHelper myDbHelper = new DatabaseHelper(this);
        myDbHelper = new DatabaseHelper(this);
      
//Database yaratma
        try {
             myDbHelper.createDataBase();
       } catch (IOException ioe) {
             throw new Error("Unable to create database");
       }
      
//Database açma
       try {
             myDbHelper.openDataBase();
       }catch(SQLException sqle){
             throw sqle;
       }
ListView listContent = (ListView)findViewById(R.id.contentlist);
Cursor cursor = myDbHelper.getAllAccounts();
    startManagingCursor(cursor);
    String [] values = new String [5] ;
   int i= 0;
  
while(cursor.moveToNext())
  {
      values[i] =cursor.getString(cursor.getColumnIndex("name"));
      i++;
    }
    cursor.close();
ArrayAdapter<String> adapter = new
ArrayAdapter<String>(this,
android.R.layout.simple_list_item_1, android.R.id.text1, values);   
listContent.setAdapter(adapter);
    }           
    }


Activity dosyamız içinde yaptığımız şey, yeni bir database örneği yaratmak , bunu açmak , cursor üzerine accounts tablosundaki name kolonundaki verileri atmak ve bunları listview üzerinde göstermek. Hepsi bu.

Burada string array oluştururken boyutuna 5 verdim , çünkü geriye 5 tane verinin döneceğini biliyorum. Siz de size uygun olan bir boyutta array yaratmayı unutmayın. Yoksa hata alırsınız.

Görüntü ise şöyle oluyor. Hepsi empty olarak gözüküyor. Çünkü accounts tablomda name kolonu altında 5 tane empty yazıyor J



Sonuç olarak,Aykut Çayır’a, debug yapıp beni hatalardan kurtardığı için ve buradaki yazıyı yazana teşekkürü bir borç bilirim.

Biraz aceleye geldi yazı, eğer hatam,eksik aksağım varsa biri he desin. Ben de düzelteyim.

Ders 18: Android Veritabanı Üzerinde Çalışma Adımları

31 Ocak 2012 Salı
Veritabanı üzerinde nasıl işlem yaptığımızı, hangi sırada gittiğimizi ve neyin ne fonksiyonu olduğunu anlamak için, adım adım SQLite işlemlerine bakalım:

  •       SQLiteOpenHelper Sınıfından Üretilen Bir Sınıf Oluşturmak

public class class_adı extends SQLiteOpenHelper {}

Bu sınıfı extend etmek bize 2 metodu kullanma zorunluluğu getirecektir:
·         onCreate(SQLiteDatabase db) : Veritabanı ilk oluşturulduğunda çağrılır. Tabloları, viewları, trigger vb. yapıları bu metot içinde oluştururuz.
·         onUpgrade(SQLiteDatabase db, int eskiversiyon, int yeniversiyon):  Veritabanı üzerinde herhangi bir değişiklik olduğunda ( Tablo değişimi vb.) çağrılır.

  •         Sabitleri Tanımlamak

public class class_adı extends SQLiteOpenHelper {
               private static final String db_adi = “….” ;
               private static final int version=”…” ;
               private static final String tablo_adi=”…” ;
                //yapıcı (constructor) metot
                //onCreate(…) metodu
                //onUpgrade(..) metodu }

Burada önemli olan private değeridir. Sabitlere, sadece bu class içerisinden erişilmesine izin verilmesi açısından “private” kullanılmıştır. Aslında, sabitler başka bir dosya içerisinde de tanımlanabilir. Ancak erişilebilir olması önemlidir. Yani, sabitleri başka bir dosya içerisinde tanımladığımızda, bu classımız içinden onlara erişebilmemiz için, private yerine public değeri kullanılmalıdır.

  •         Constructor (Yapıcı) Metodu Yazmak

public class_adı (Context context ) {
        super( context, db_adi, null,version ); }


  •         onCreate() Metodunu Yazmak ve Tablo Oluşturmak
Tablo oluşturma işlemlerini onCreate() metodu içinde yapıyoruz. Bu metot  öncelikle, programı ilk çalıştırdığımızda, entegre SQLite sunucumuz içindeki “sql_master” tablosuna bir sorgu çeker. Bu sorguda “tablo_adi” diye bir tablo mevcut mu diye bakar. Eğer yoksa “tablo_adi” adında bir tablo oluşturur ve o tablo içindeki alanları doldurur.



public  void onCreate(SQLiteDatabase db) {
       db.execSQL ( “CREATE TABLE” + tablo_adi + “(“ + ….. + “)” ) ; }


  •          onUpgrade() Metodunu Yazmak
Veritabanında herhangi bir değişiklik olduğunda onUpgrade() metodu çalıştırılır. Daha sonra bunun içerisinden çağrılan onCreate() metodu da değişiklikleri hayata geçirmeye yarar.


public void onUpgrade(SQLiteDatabase db, int eskiversiyon, int yeniversion) {
           db.execSQL(“DROP TABLE IF EXISTS” + tablo_adi );
           
onCreate(db); }

  •          Veritabanı İşlemleri İçin Gereksinimler
·         close() : Veritabanını kapatır.
·         getReadableDatabase() : Okunabilir bir veritabanı sunar. Select işlemleri için uygundur.
·         getWritableDatabase() : Yazılabilir bir veritabanı sunar. Update, delete ve insert işlemleri için uygundur.

  •       Queryleri  Çalıştırmak
SQLite hem bilinen SQL cümleciklerini (rawQuery) destekler, hem de kendi içinde özelleşmiş sorgulama metotları bulunmaktadır.
db.rawQuery( String sql, String [] selectionArgs)  : Bu döndürülen sonucu Cursor tipindeki bir değişkene atar.
·         SQLite’ın Özelleşmiş Metotları:

n  query(…)
n  insert(…)
n  delete(…)
n  update(…)

  •       Cursor Kullanımı
Veritabanı nesneleri içinde; kayıtlar arasında, satır bazlı hareket etmemizi sağlayan yapıdır.


Cursor c = new Cursor();


·         startManagingCursor(c) : Cursor üzerinde işlemler yapabilmeyi sağlar.
·         getCount() : Veritabanındaki kayıt sayısını döndürür.
·         moveToFirst() : Cursor, veritabanındaki ilk kayda gider.
·         moveToNext(): Cursor, bulunduğu konumdan bir sonraki kayda geçer.
·         IsAfterLast() : Son satırdan bir önceki mi sorgulaması yapar.

Bunların dışında, getColumnNames(), getColumnIndex(), getString(), getInt() metotları da kullanılır.

Tüm adımlar bu kadar. Tahmin ediyorum ki kafanızda bişeyler oturmaya başladı ama tam net olmadı. Bir sonraki derste yapılacak örnek ile konunun tam olarak anlaşılacağını umuyorum.