บทเรียนนี้จะสอนเรื่องการนำไฟล์ฐานข้อมูล Sqlite ที่มีฐานข้อมูลของ​คำศัพท์จาก lexitron มาใช้ใน Xamarin

1.ก่อนอื่นให้ดาวน์โหลด​ฐานข้อมูล Lexitron ก่อนจากลิงค์นี้ /images/uploads/file/031f1c581b79e80.zip
2.ดาวน์โหลดโปรแกรม DB Browser for Sqlite มาเพื่อดูข้อมูลในฐานข้อมูล Sqlite ที่ลิงค์นี้ https://sqlitebrowser.org/dl/  หน้าตาก็จะประมาณนี้

ขั้นตอนการสร้าง Moblie App ค้นหาความหมายของคำศัพท์ภาษาอังกฤษ มีวิธีการดังนี้

ขั้นตอนที่1  สร้าง solution ใหม่ ใน visual studio ตั้งชื่อว่า SqliteProject ให้เลือกแบบ shared project

ติดตั้ง nuget package > sqlite-net-pcl

ขั้นตอนที่2  สิ่งที่จะต้องสร้างคือ

2.1 นำไฟล์ sqlite ไปไว้ใน Asset ของ Andriod Project (ในตัวอย่างไฟล์ชื่อ EVocab.sqlite)

ปล. อย่าลืม Add file ไว้ในโปรเจคด้วย

2.2 สร้างไฟล์​ FileAccessHelper.cs ใน Android Project ซึ่งมี code ดังนี้       

FileAccessHelper.cs

using System;
using System.IO;
using Android.App;

namespace SqliteProject.Droid
{
public class FileAccessHelper
{
	public static string GetLocalFilePath (string filename)
	{
		string path = Environment.GetFolderPath (Environment.SpecialFolder.Personal);
		string dbPath = Path.Combine (path, filename);

		CopyDatabaseIfNotExists (dbPath);

		return dbPath;
	}

	private static void CopyDatabaseIfNotExists (string dbPath)
	{
		if (!File.Exists (dbPath)) {
               
                using (var br = new BinaryReader (Application.Context.Assets.Open ("EVocab.sqlite"))) {
				using (var bw = new BinaryWriter (new FileStream (dbPath, FileMode.Create))) {
					byte[] buffer = new byte[2048];
					int length = 0;
					while ((length = br.Read (buffer, 0, buffer.Length)) > 0) {
						bw.Write (buffer, 0, length);
					}
				}
			}
		}
           
	}
    }
}

จากตัวอย่าง Method ชื่อ CopyDatabaseIfNotExists จะตรวจสอบว่าไฟล์ Sqlite ในที่อยู่(/data/data/com.companyname.SqliteProject/files)หรือยัง  ถ้ายังก็ให้โหลดไฟล์ Sqlite ใน Assets ไปไว้ยังที่อยู่นั้น

2.3 แก้ไข MainActivity

MainActivity.cs

using System;
using Android.App;
using Android.Content;
using Android.Content.PM;
using Android.Runtime;
using Android.Views;
using Android.Widget;
using Android.OS;

namespace SqliteProject.Droid
{
    [Activity(Label = "SqliteProject.Droid", Icon = "@drawable/icon", Theme = "@style/MyTheme", MainLauncher = true, ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation)]
    public class MainActivity : global::Xamarin.Forms.Platform.Android.FormsAppCompatActivity
    {  internal static MainActivity Instance { get; private set; }
        protected override void OnCreate(Bundle bundle)
        {
            TabLayoutResource = Resource.Layout.Tabbar;
            ToolbarResource = Resource.Layout.Toolbar;

            base.OnCreate(bundle);
            Instance = this;
            global::Xamarin.Forms.Forms.Init(this, bundle);
            string dbPath = FileAccessHelper.GetLocalFilePath("EVocab.sqlite");
           
            LoadApplication(new App(dbPath));
        }
    }
}

จากตัวอย่าง Method ของ GetLocalFilePath จะ return ค่าที่อยู่ของไฟล์ฐานข้อมูลเพื่อส่งค่าให้ class App เพื่อโหลด Application ต่อไป

2.4 แก้ไข App.xaml.cs  เนื่องจาก class App เป็นคลาสแรกที่ถูกโหลดขึ้นของ Application(จะมีการเรียก MainActivity ก่อนเพื่อเรียก App) เราจึงจะต้องใส่ค่าเริ่มต้นบางอย่างใน Contructor ของ App ดังนี้

App.xaml.cs

using System;
using System.Diagnostics;
using System.IO;
using Xamarin.Forms;
using SqliteProject.Views;
namespace SqliteProject
{
    public partial class App : Application
    {  static TodoItemDatabase database;
        public App(string dbPath)
        {  Resources = new ResourceDictionary();
            Resources.Add("primaryGreen", Color.FromHex("91CA47"));
            Resources.Add("primaryDarkGreen", Color.FromHex("6FA22E"));
            Debug.WriteLine(dbPath);
            var nav = new NavigationPage(new TodoListPage());
            nav.BarBackgroundColor = (Color)App.Current.Resources["primaryGreen"];
            nav.BarTextColor = Color.White;
            if (database == null)
            {
                database = new TodoItemDatabase(dbPath);
            }
            MainPage = nav;
       
        }
        public static TodoItemDatabase Database
        {
            get
            {
                
                return database;
            }
        }
        public int ResumeAtTodoId { get; set; }
        protected override void OnStart()
        {
            // Handle when your app starts
        }

        protected override void OnSleep()
        {
            // Handle when your app sleeps
        }

        protected override void OnResume()
        {
            // Handle when your app resumes
        }
    }
}

ตัวอย่างมีการประกาศ instance จากคลาส TodoItemDatabase แล้วใส่ dbPath มา

2.5 สร้างคลาส TodoItemDatabase ดังนี้

TodoItemDatabase.cs

using System.Collections.Generic;
using System.Threading.Tasks;
using SQLite;

namespace SqliteProject
{
	public class TodoItemDatabase
	{
		readonly SQLiteAsyncConnection database;

		public TodoItemDatabase(string dbPath)
		{
			database = new SQLiteAsyncConnection(dbPath);
            database.CreateTableAsync<EVocab>().Wait();
		}

        public Task<List<EVocab>> GetItemsAsync()
		{
            return database.Table<EVocab>().ToListAsync();
		}
        public Task<EVocab> SearchItemsAsync(string search)
              {
                 return database.Table<EVocab>().Where(y => y.Esearch == search).FirstOrDefaultAsync();
                }
        public Task<List<EVocab>> GetItemsNotDoneAsync()
		{
            return database.QueryAsync<EVocab>("SELECT * FROM [EVocab] WHERE [Done] = 0");
		}

        public Task<EVocab> GetItemAsync(int id)
		{
            return database.Table<EVocab>().Where(i => i.ID == id).FirstOrDefaultAsync();
		}

        public Task<int> SaveItemAsync(EVocab item)
		{
			if (item.ID != 0)
			{
				return database.UpdateAsync(item);
			}
			else {
				return database.InsertAsync(item);
			}
		}

        public Task<int>  DeleteItemAsync(EVocab item)
		{
			return database.DeleteAsync(item);
		}
	}
}

จากตัวอย่าง &ltEVocab> คือ คลาส  EVocab ที่เราจะต้องสร้างต่อไป

2.5 สร้างคลาส EVocab เราจะสร้าง DataModel เพื่อเก็บค่าต่างๆที่ Retrieve มาจากฐานข้อมูล เราสามารถสร้างได้ดังนี้

EVocab.cs

using System;
namespace SqliteProject
{
    public class EVocab
    {
        public int ID { get; set; }
        public string Esearch { get; set; }
        public string Eentry { get; set; }
        public string Tentry { get; set; }
        public string Ecat { get; set; }
        public string Ethai { get; set; }
        public string Esyn { get; set; }
        public string Eant{ get; set; }
    }
}

ขั้นตอนที่3 เพิ่มโค๊ดในการสร้างกล่องข้อความและปุ่มค้นหา

3.1 เพิ่มใน TodoListPage.xaml

TodoListPage.xaml

3.2 เพิ่มใน TodoListPage.xaml.cs

TodoListPage.xaml.cs

using System;
using System.Collections.Generic;
using System.Diagnostics;
using Xamarin.Forms;

namespace SqliteProject.Views
{
    public partial class TodoListPage : ContentPage
    {
        public TodoListPage()
        {
            InitializeComponent();
        }

        protected override async void OnAppearing()
        {
            base.OnAppearing();

            // Reset the 'resume' id, since we just want to re-start here
            ((App)App.Current).ResumeAtTodoId = -1;
         
        }

         async void Search_Clicked(object sender, System.EventArgs e)
        {
            var search = search_box.Text;
            Debug.WriteLine(search);
            EVocab word  = await App.Database.SearchItemsAsync(search);
            if (word != null){
                translate_box.Text = word.Ethai; 
            }

        }
    }
}

สามารถดาวน์โหลด โค๊ดตัวอย่างได้ที่ /images/uploads/file/SqliteProject.zip