طریقه استفاده در اندروید استودیو

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        
        //خط زیر اضافه شود  :
        maven { url 'https://ariadb.ir/lib' }
    }
}
            

dependencies {
    implementation 'ir.ariadb:ariadatabase:1.0.0'
}
            

systemProp.http.nonProxyHosts=ariadb.ir
systemProp.https.nonProxyHosts=ariadb.ir
            

روش دستی

کتابخانه را از اینجا دانلود کرده طبق روش زیر به برنامه اضافه کنید

1. به قسمت Project برنامه بروید

2. کتابخانه را کپی کرده و در پوشه libs کپی کنید

* اگر پوشه libs وجود نداشت طبق عکس زیر آن را در پوشه apps ایجاد کنید

سپس به قسمت Android پروژه برگردید

سپس طبق عکس زیر در فایل build.gradle کد زیر را ضافه کنید

*** توجه کنید که دو فایل build.gradle وجود دارد و باید گزینه مربوط به ماژول را انتخاب کنید

implementation files('libs/AriaDatabase.jar')
            

سپس به منیفست برنامه رفته و کد زیر را تگ Application کپی کنید و کد دسترسی خود را که از پنل اصلی دریافت کردید جایگذاری کنید

اگر دسترسی به اینترنت را قبلا اضافه نکرده اید آنرا هم اضافه کنید:

<uses-permission android:name="android.permission.INTERNET"/>


<meta-data
android:name="aria.database.ACCESS_KEY"
android:value="COPY_YOUR_ACCESS_CODE_HERE"/>
            

برای شروع یک متغیر AriaDabase برای اجرای درخواست ها ایجاد کنید

AriaDatabase ariaDatabase = new AriaDatabase(getApplicationContext());
            

چند نمونه کد برای دریافت اطلاعات از تیبل فرضی members

AriaRequest selectRequest = AriaRequest.select("members");
AriaRequest selectRequest = AriaRequest.select("members").where("id=5");
AriaRequest selectRequest = AriaRequest.select("members").limit(5).offset(1);

ariaDatabase.Run(selectRequest, new AriaDatabase.Response() {
    @Override
    public void done(AriaDatabase.AriaResponse ariaResponse) {
        Log.v("AriaDB", ariaResponse.getStringResponse());
    }
});    
            

نمونه کد برای تجزیه کردن اطلاعات دریافت شده توسط JSON و نمایش در لاگ

AriaRequest selectRequest = AriaRequest.select("members");
            
ariaDatabase.Run(selectRequest, new AriaDatabase.Response() {
    @Override
    public void done(AriaDatabase.AriaResponse ariaResponse) {
        //agar error nadasht va Json bud
        if (!ariaResponse.hasError() && ariaResponse.isJson()){
            try {
                for (int i = 0; i < ariaResponse.getJsonArrayResponse().length(); i++) {
                    JSONObject jsonObject = ariaResponse.getJsonArrayResponse().getJSONObject(i);
                    String name = jsonObject.getString("name");
                    String email = jsonObject.getString("email");
                }
            }catch (Exception e){
                e.printStackTrace(); 
            }
        }
    }
});

نمونه کد برای اضافه کردن یک ردیف جدید در دیتابیس

//nemune 1
AriaRequest request = AriaRequest.insert("members")
        .insert("name","amin")
        .insert("email","rogueok@gmail.com")
        .build();

//nemune 2
AriaRequest request1 = AriaRequest.insert("members")
        .insertAndBuild("amin", "email");

ariaDatabase.Run(request, new AriaDatabase.Response() {
    @Override
    public void done(AriaDatabase.AriaResponse ariaResponse) {
        if (!ariaResponse.hasError()){
            if (ariaResponse.getStringResponse().contains("done")) {
                Toast.makeText(getApplicationContext(), "Anjam shod!", Toast.LENGTH_SHORT).show();
            }
        }
    }
});

نمونه کد برای حذف یک یا چند ردیف خاص

//nemune 1
AriaRequest request =  AriaRequest.delete("members").where("name='amin'");

//nemune 2
AriaRequest request1 =  AriaRequest.delete("members").where("id between 163 and 265");

//nemune 3
AriaRequest request2 =  AriaRequest.delete("members").where("id=2");

ariaDatabase.Run(request, new AriaDatabase.Response() {
    @Override
    public void done(AriaDatabase.AriaResponse ariaResponse) {
        if (!ariaResponse.hasError()){
            if (ariaResponse.getStringResponse().contains("done")) {
                Toast.makeText(getApplicationContext(), "Anjam shod!", Toast.LENGTH_SHORT).show();
            }
        }
    }
});    

نمونه کد برای ویرایش یک یا چند ردیف خاص

AriaRequest request = AriaRequest.update("members")
                    .set("name","amin")
                    .set("email","rogueok@gmail.com")
                    .where("id=1");

ariaDatabase.Run(request, new AriaDatabase.Response() {
    @Override
    public void done(AriaDatabase.AriaResponse ariaResponse) {
        if (!ariaResponse.hasError()){
            if (ariaResponse.getStringResponse().contains("done")) {
                Toast.makeText(getApplicationContext(), "Anjam shod!", Toast.LENGTH_SHORT).show();
            }
        }
    }
});    

چند نمونه کد کاستوم که توسط سرور ساپورت میشه

1.گرفتن تعداد ردیف های یک تیبل

//estefade az kalame "rowcount" dar method Where baraye gereftane tedade radifhae table
AriaRequest selectRequest = AriaRequest.select("Kala").where("rowcount");

//gereftane tedade radifhae table hamrah ba shart , bad az kalame RowCount az alamat | baraye joda kardan estefade konid
//va shart morede nazar ro estefade konid
AriaRequest selectRequest = AriaRequest.select("Kala").where("rowcount|price > 3000");
AriaRequest selectRequest = AriaRequest.select("Kala").where("rowcount|'name' = 'ali'");
AriaRequest selectRequest = AriaRequest.select("Kala").where("rowcount|price > 3000 AND 'kala' = 'behdashti'");

ariaDatabase.Run(selectRequest, new AriaDatabase.Response() {
@Override
Public void done(AriaDatabase.AriaResponse ariaResponse) {
	If (!ariaResponse.hasError()){
		Toast.makeText(getApplicationContext(),ariaResponse.getStringResponse(), Toast.LENGTH_SHORT).show();
    }
}
}); 

//emkan estefade az tamami function hae adadi dar method Where
//Min Max Mod AVG SUM  va ....

//radifi ke darayae bishtarin meghdare yek sotun ast
//mesal :
//peida kardane gerantarin kala tebghe gheymat :
AriaRequest selectRequest = AriaRequest.select("Kala").where("MAX(Price)");

//peida kardane gerantarin kala tebghe gheymat dar shahr tehran (hamrah ba shart) :
AriaRequest selectRequest = AriaRequest.select("Kala").where("MAX(Price)|'city' = 'Tehran'");

ariaDatabase.Run(request, new AriaDatabase.Response() {
@Override
Public void done(AriaDatabase.AriaResponse ariaResponse) {
	If (!ariaResponse.hasError()){
		Toast.makeText(getApplicationContext(),ariaResponse.getStringResponse(), Toast.LENGTH_SHORT).show();
    }
}
});

نمایش 20 کوئری آخر در پنل برای دیباگ

برای دیدن کوئری ها واژه (DEBUG) را به یکی از متد های select یا where اضافه کنید

* نکته 1 :حتما با حروف بزرگ و داخل پرانتر قرار دهید

* نکته 2 :قبل از ریلیز کردن برنامه حتما حالت دیباگ را غیر فعال کنید در غیر این صورت باعث کندی انجام درخواست ها میشود

* نکته 3 :اضافه کردن دیباگ تاثیری در روند انجام درخواست ندارد و مانند حالت عادی درخواست انجام میشود

//aval ya akhar budane vazhe (DEBUG) tasiri dar karayi nadarad :

AriaRequest selectRequest = AriaRequest.select("Kala(DEBUG)")
AriaRequest selectRequest = AriaRequest.select("(DEBUG)Kala")

AriaRequest selectRequest = AriaRequest.select("Kala").where("id=1 AND name LIKE 'laptop'(DEBUG)");
AriaRequest selectRequest = AriaRequest.select("Kala").where("(DEBUG)id=1");