Der er ikke et enkelt versionsnummer, i stedet kan versionsnummer være flere værdier.
Ved et gæt taler du om user_version som Android SDK SQLiteOpenHelper bruger.
Der er også application_id , der ligesom user_version kan bruges som en brugervariabel.
Du har allerede stødt på SQLite_Version, så det kan rabateres.
Der er også data_versionen, det er usandsynligt, at det er versionsnummeret, da det er beregnet til at blive brugt som en indikation om databasefilen er blevet ændret i realtid.
Der er også schema_versionen, du vil sandsynligvis IKKE bruge denne som Advarsel:Misbrug af denne pragma kan resultere i databasekorruption.
user_version
Som tidligere sagt taler du sandsynligvis om user_versionen . Den første ting at bemærke er, at det er en brugerstyret variabel/felt, der er tilgængeligt til brugerdefineret brug. SQlite bruger eller ændrer ikke user_version men tillader det at blive ændret og brugt.
Desuden vil SQLite Managers (såsom DB Browser, Navicat osv.) ikke automatisk ændre versionsnummeret. Som sådan skal du med vilje ændre bruger_versionen, for at den er tilgængelig, før du kopierer databasefilen til aktivmappen (bemærk, at hvis du gør det, og du bruger en underklasse af SQLiteOpenHelper at onUpgrade og onDowngrade metoder kan kaldes).
Hvis user_versionen ikke er specifikt ændret, og databasen kun blev tilgået af SQLite Manager-værktøjet, vil dens user_version være 0. Hvis databasefilen blev åbnet ved at kopiere databasefilen fra en Android-app, der bruger en underklasse af SQLiteOpenHelper, vil den have en user_version på 1 eller mere (afhængigt af den sidste værdi, der blev brugt som den 4. parameter til SQLiteOpenHelper's constrcutor). Hvis user_versionen ændres programmatisk, vil en sådan ændring selvfølgelig også afspejle sig, hvis filen blev kopieret til et SQlite Manager-værktøj.
Før du kopierer filen, vil user_versionen typisk blive ændret i SQlite Manager-værktøjet til en passende værdi.
Du kan ændre user_version ved hjælp af SQL PRAGMA user_version = 5; Du kan hente user_version ved at bruge enten PRAGMA user_version eller SELECT * FROM pragma_user_version;
Hvis du har brug for at tjekke versionen, før du åbner databasen, kan du læse de 4 bytes ved offset 60 og konvertere de 4 bytes til et heltal, for at kontrollere user_version mod en anden værdi. Ellers ville du sandsynligvis skulle kopiere filen, sandsynligvis med et andet navn, fra aktivemappen, åbne den som en SQLiteDatabase og hente user_versionen ved hjælp af SQL-en ovenfor og derefter kontrollere den mod den anden værdi, lukke databasefilen. Sletning af filen, hvis det ikke er nødvendigt, ellers sletning af den tidligere databasefil og derefter omdøbning af den kopierede fil.
Eksempel
Følgende er et fungerende eksempel (bemærk, at jeg sjældent bruger Kotlin, og dette er blevet konverteret ved hjælp af AS studio fra java).
Dette bruger en klasse, nemlig SQLAssetVersionCheck der udtrækker versionsnummeret fra filen i stedet for at åbne filen som en SQLiteDatabase.
SQLAssetVersionCheck.kt :-
class SQLAssetVersionCheck
/**
* Full SQLAssetVersionCheck Constructor - sub directories can be specified
* @param context Assets are part of package so use the context to get the asset file
* @param dbName The database name (i.e. the file name)
* @param subDirectories The sub-directories as per the heirarchial order
* @param dbVersion The database version to check against
*/
(context: Context, val databaseName: String, subDirectories: Array<String>?, dbVersion: Int) {
val assetPath: String
var databaseVersion: Int = 0
private set
var result: Int = 0
private set
init {
assetPath = applySubDirectories(databaseName, subDirectories)
Log.d("SQLAVC", "Looking for Asset $assetPath")
var stage = 0
try {
val `is` = context.assets.open(assetPath)
stage++
// Get the first 64 bytes of the header
val v = ByteArray(64)
`is`.read(v, 0, 64)
// only interested in the 4 bytes from offset 60 so get them
val v2 = ByteArray(4)
for (i in 60..63) {
v2[i - 60] = v[i]
}
stage++
// Done with the InputStream so close it
`is`.close()
// Extarct the stored DBVersion
databaseVersion = ByteBuffer.wrap(v2).int
if (databaseVersion < dbVersion) {
result = ASSETVERSIONLOW
}
if (databaseVersion > dbVersion) {
result = ASSETVERSIONHIGH
}
if (databaseVersion == dbVersion) {
result = ASSETVERSIONMATCH
}
} catch (e: IOException) {
e.printStackTrace()
when (stage) {
0 -> result = ASSETNOTFOUND
1 -> result = ASSETIOERROR
}
}
}
constructor(context: Context, dbName: String, dbVersion: Int) : this(context, dbName, null, dbVersion) {}
private fun applySubDirectories(dbname: String, subDirectories: Array<String>?): String {
val base = StringBuffer("")
var firstdirectory = true
if (subDirectories != null) {
for (d in subDirectories) {
if (!firstdirectory) {
base.append(File.separatorChar)
}
firstdirectory = false
base.append(d)
}
}
if (base.length > 0) {
base.append(File.separatorChar)
}
base.append(dbname)
return base.toString()
}
companion object {
val ASSETNOTFOUND = -2
val ASSETIOERROR = -3
val ASSETVERSIONMATCH = 0
val ASSETVERSIONHIGH = 1
val ASSETVERSIONLOW = -1
}
}
Og her er en aktivitet, der bruger ovenstående klasse to gange til at prøve at tjekke versionen i testdb fil.
-
Den første brug finder ikke databasefilen testdb som den ser i aktiver mappe (ikke databasens undermappe).
-
Den anden brug finder testdb fil som underbiblioteket databaser er specificeret (3. parameter af den fulde konstruktør), der findes i aktiver/databaser/ mappe, dvs. assets/databases/testdb :-
MainActivity.kt :-
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val db_version_to_check_against = 100
var mAVC1 = SQLAssetVersionCheck(this, "testdb", 100)
var result = ""
when (mAVC1.result) {
SQLAssetVersionCheck.ASSETIOERROR -> result = "IO ERROR detected - check the Log"
SQLAssetVersionCheck.ASSETNOTFOUND -> result = "The Asset, for Database " + mAVC1.databaseName + " was not located at " + mAVC1.assetPath
SQLAssetVersionCheck.ASSETVERSIONHIGH -> result = "The Asset was located and the version number being " +
mAVC1.databaseVersion.toString() +
" was higher than the version to be checked which was " +
db_version_to_check_against.toString()
SQLAssetVersionCheck.ASSETVERSIONLOW -> result = "The Asset was located and the version number being " +
mAVC1.databaseVersion.toString() +
" was lower than the version to be checked which was " +
db_version_to_check_against.toString()
SQLAssetVersionCheck.ASSETVERSIONMATCH -> result = "The Asset version and the version to be check ed are the same."
}
Log.d("ASSETVERSIONCHECK", "The result of the version check was - $result")
var mAVC2 = SQLAssetVersionCheck(this, "testdb", arrayOf("databases"), db_version_to_check_against)
result = ""
when (mAVC2.result) {
SQLAssetVersionCheck.ASSETIOERROR -> result = "IO ERROR detected - check the Log"
SQLAssetVersionCheck.ASSETNOTFOUND -> result = "The Asset, for Database " + mAVC2.databaseName + " was not located at " + mAVC2.assetPath
SQLAssetVersionCheck.ASSETVERSIONHIGH -> result = "The Asset was located and the version number being " +
mAVC2.databaseVersion.toString() +
" was higher than the version to be checked which was " +
db_version_to_check_against.toString()
SQLAssetVersionCheck.ASSETVERSIONLOW -> result = "The Asset was located and the version number being " +
mAVC2.databaseVersion.toString() +
" was lower than the version to be checked which was " +
db_version_to_check_against.toString()
SQLAssetVersionCheck.ASSETVERSIONMATCH -> result = "The Asset version and the version to be check ed are the same."
}
Log.d("ASSETVERSIONCHECK", "The result of the version check was - $result")
}
}
Resultat (log) :-
2019-02-19 13:11:34.473 19058-19058/com.example.so54741423assetdbversioning D/SQLAVC: Looking for Asset testdb
2019-02-19 13:11:34.473 19058-19058/com.example.so54741423assetdbversioning W/System.err: java.io.FileNotFoundException: testdb
2019-02-19 13:11:34.474 19058-19058/com.example.so54741423assetdbversioning W/System.err: at android.content.res.AssetManager.nativeOpenAsset(Native Method)
2019-02-19 13:11:34.474 19058-19058/com.example.so54741423assetdbversioning W/System.err: at android.content.res.AssetManager.open(AssetManager.java:744)
2019-02-19 13:11:34.474 19058-19058/com.example.so54741423assetdbversioning W/System.err: at android.content.res.AssetManager.open(AssetManager.java:721)
2019-02-19 13:11:34.474 19058-19058/com.example.so54741423assetdbversioning W/System.err: at com.example.so54741423assetdbversioning.SQLAssetVersionCheck.<init>(SQLAssetVersionCheck.kt:31)
2019-02-19 13:11:34.474 19058-19058/com.example.so54741423assetdbversioning W/System.err: at com.example.so54741423assetdbversioning.SQLAssetVersionCheck.<init>(SQLAssetVersionCheck.kt:67)
2019-02-19 13:11:34.474 19058-19058/com.example.so54741423assetdbversioning W/System.err: at com.example.so54741423assetdbversioning.MainActivity.onCreate(MainActivity.kt:17)
2019-02-19 13:11:34.474 19058-19058/com.example.so54741423assetdbversioning W/System.err: at android.app.Activity.performCreate(Activity.java:7136)
2019-02-19 13:11:34.475 19058-19058/com.example.so54741423assetdbversioning W/System.err: at android.app.Activity.performCreate(Activity.java:7127)
2019-02-19 13:11:34.475 19058-19058/com.example.so54741423assetdbversioning W/System.err: at android.app.Instrumentation.callActivityOnCreate(Instrumentation.java:1271)
2019-02-19 13:11:34.475 19058-19058/com.example.so54741423assetdbversioning W/System.err: at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2893)
2019-02-19 13:11:34.475 19058-19058/com.example.so54741423assetdbversioning W/System.err: at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:3048)
2019-02-19 13:11:34.475 19058-19058/com.example.so54741423assetdbversioning W/System.err: at android.app.servertransaction.LaunchActivityItem.execute(LaunchActivityItem.java:78)
2019-02-19 13:11:34.475 19058-19058/com.example.so54741423assetdbversioning W/System.err: at android.app.servertransaction.TransactionExecutor.executeCallbacks(TransactionExecutor.java:108)
2019-02-19 13:11:34.475 19058-19058/com.example.so54741423assetdbversioning W/System.err: at android.app.servertransaction.TransactionExecutor.execute(TransactionExecutor.java:68)
2019-02-19 13:11:34.475 19058-19058/com.example.so54741423assetdbversioning W/System.err: at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1808)
2019-02-19 13:11:34.475 19058-19058/com.example.so54741423assetdbversioning W/System.err: at android.os.Handler.dispatchMessage(Handler.java:106)
2019-02-19 13:11:34.475 19058-19058/com.example.so54741423assetdbversioning W/System.err: at android.os.Looper.loop(Looper.java:193)
2019-02-19 13:11:34.476 19058-19058/com.example.so54741423assetdbversioning W/System.err: at android.app.ActivityThread.main(ActivityThread.java:6669)
2019-02-19 13:11:34.476 19058-19058/com.example.so54741423assetdbversioning W/System.err: at java.lang.reflect.Method.invoke(Native Method)
2019-02-19 13:11:34.476 19058-19058/com.example.so54741423assetdbversioning W/System.err: at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:493)
2019-02-19 13:11:34.476 19058-19058/com.example.so54741423assetdbversioning W/System.err: at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:858)
2019-02-19 13:11:34.476 19058-19058/com.example.so54741423assetdbversioning D/ASSETVERSIONCHECK: The result of the version check was - The Asset, for Database testdb was not located at testdb
2019-02-19 13:11:34.476 19058-19058/com.example.so54741423assetdbversioning D/SQLAVC: Looking for Asset databases/testdb
2019-02-19 13:11:34.477 19058-19058/com.example.so54741423assetdbversioning D/ASSETVERSIONCHECK: The result of the version check was - The Asset was located and the version number being 5 was lower than the version to be checked which was 100
-
Det første forsøg finder ikke filen (den undtagelse, der blev fanget, vises) og viser linjen Resultatet af versionskontrollen var - Aktivet til databasen testdb var ikke placeret på testdb skal vises.
-
Det andet forsøg virker og resulterer i Resultatet af versionskontrollen var - Aktivet blev fundet, og versionsnummeret 5 var lavere end den version, der skulle kontrolleres, som var 100
-
Mellemrummet mellem tomme linjer blev tilføjet for at opdele det andet forsøg fra det første.
Yderligere
Efter brug af SQLite Manager-værktøjet (Navicat) og brug af :-
PRAGMA user_version = 101;
Kopier derefter filen (efter at have lukket forbindelsen i Navicat) til assets mappen (så jeg har to testdb filer) så er resultatet :-
2019-02-19 13:50:09.874 19253-19253/com.example.so54741423assetdbversioning D/SQLAVC: Looking for Asset testdb
2019-02-19 13:50:09.874 19253-19253/com.example.so54741423assetdbversioning D/ASSETVERSIONCHECK: The result of the version check was - The Asset was located and the version number being 101 was higher than the version to be checked which was 100
2019-02-19 13:50:09.874 19253-19253/com.example.so54741423assetdbversioning D/SQLAVC: Looking for Asset databases/testdb
2019-02-19 13:50:09.874 19253-19253/com.example.so54741423assetdbversioning D/ASSETVERSIONCHECK: The result of the version check was - The Asset was located and the version number being 5 was lower than the version to be checked which was 100
- dvs. den nye fil har user_version som 101, så den første finder filen, den anden finder filen (user_version 5) som før.