当前最新版本：1.1.28
首先你需要在项目的build.gradle中配置以下代码：
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }//加上这句即可
}
}
然后你在要使用该库的module中添加以下依赖:
implementation 'com.github.Ellen2018:DhcSQLite:x.y.z'
x,y,z是笔者库的版本值，例如：1.0.0
DhcSQLite是一款基于注解加反射的第三方SQLite库，基于SQLite进行的封装。您可以轻轻松松管理您的数据库，框架内部使用到了反射，注解，动态代理等技术，最最主要的是您要是觉得SQL语句写起来太麻烦，笔者提供给您另外一个SQL语句构建库ZxySQLiteCreate，整个框架内部也有使用到它。
例子：学生成绩管理系统,学生属性包括：姓名(name),学号(sid),年龄(age),科目以及成绩(Map<Subject,Integer>),父亲(Father(有姓名以及联系方式属性))等等。业务包括：查看总分排名，根据学号查询学生所有信息，查看姓名里带"李"的学生等等。
Student类代码:
public class Student {
/**
* 学号
*/
@MajorKey(isAutoIncrement = true)//主键 & isAutoIncrement = true表示自增
private int sid;
/**
* 姓名
*/
private String name;
/**
* 年龄
*/
private int age;
/**
* 科目以及成绩
*/
@DataStructure //声明它是属于数据结构的属性
private Map<String,Integer> subjectMap;
/**
* 总分
*/
private int allGrade;
/**
* 是否为男生
*/
private boolean isMan;
@SqlType(sqlFiledType = SQLFieldTypeEnum.TEXT)//映射为TEXT类型，不限制长度
@Operate(operate = OperateEnum.JSON)//映射成Json
private Father father;
......
}
public interface StudentOperate extends AutoDesignOperate {
/**
* 通过sid删除指定数据
* @param sid
*/
@Delete("sid = @sid")
void deleteBySid(@Value("sid") int sid);
/**
* 更新名字通过sid(学号)
*
* @param sid
* @param newName
*/
@Update(valueSql = "name = '@newName'", whereSql = "sid = @sid")
void updateStudentNameById(@Value("sid") int sid, @Value("newName") String newName);
/**
* 查询名字中带有str的数据，结果按照sid进行排序
*
* @param str
* @return
*/
@Search(whereSql = "name like '%@str%'", orderSql = "sid ASC")
List<Student> searchByLikeName(@Value("str") String str);
}
public class AppLibrary extends ZxyLibrary {
public AppLibrary(Context context, String name, int version) {
super(context, name, version);
}
public AppLibrary(Context context, String libraryPath, String name, int version) {
super(context, libraryPath, name, version);
}
@Override
public void onZxySQLiteCreate(SQLiteDatabase db) {
}
@Override
public void onZxySQLiteUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
}
}
public class StudentTable extends ZxyTable<Student,MyAutoDesignOperate> {
private SQLiteDatabase db;
public StudentTable(SQLiteDatabase db, String tableName, Class<Student> dataClass, Class<MyAutoDesignOperate> autoClass) {
super(db, tableName, dataClass, autoClass);
}
public StudentTable(SQLiteDatabase db, Class<Student> dataClass, Class<MyAutoDesignOperate> autoClass) {
super(db, dataClass, autoClass);
}
public StudentTable(ZxyLibrary zxyLibrary, String tableName, Class<Student> dataClass, Class<MyAutoDesignOperate> autoClass) {
super(zxyLibrary, tableName, dataClass, autoClass);
}
public StudentTable(ZxyLibrary zxyLibrary, Class<Student> dataClass, Class<MyAutoDesignOperate> autoClass) {
super(zxyLibrary, dataClass, autoClass);
}
@Override
protected Object resumeDataStructure(String classFieldName, Class fieldClass, String json) {
if(classFieldName.equals("fathers")){
Type founderSetType = new TypeToken<Father[]>() {}.getType();
Father[] fathers = new Gson().fromJson(json, founderSetType);
return fathers;
}
return null;
}
/**
* 库内部公共设置
* @param commonSetting
*/
@Override
protected void setting(CommonSetting commonSetting) {
super.setting(commonSetting);
//是否设置为多线程模式
//true:设置为多线程模式，false：设置为非多线程模式
commonSetting.setMultiThreadSafety(true);
//设置库内部的Json解析器为Gson
commonSetting.setJsonLibraryType(JsonLibraryType.Gson);
//设置库内部的Json解析器为FastJson
commonSetting.setJsonLibraryType(JsonLibraryType.FastJson);
//设置库内部的Json解析为自定义的MyJsonFormat
commonSetting.setJxFormat(new MyJxFormat());
}
}
DhcSqlite里面有4个比较重要的角色:
-
ZxySQLiteCreate(SQL语句制作者)
这个笔者已经提到了，它是用来帮助您完成各种Sql语句构建的，如果您想要完整看此框架的用法，请移步到基于Android SQLite语句构建库的轮子,一定要注意的是此框架DhcSqlite已经内部集成了，您无须单独集成，整个项目任何位置均可使用。 -
ZxyLibrary(数据库管理者)
这个是用来对数据库进行一系列操作的，您可以通过此类对库的名字，存储地址进行定义，它还包括对表的删除，重命名，清空等等操作，反是对表操作的都在里面已经封装好了，一个对象对应一个库。
详细用法请查看ZxyLibrary
- ZxyTable(数据库中表的管理者)
这个是用来对数据库中表进行一系列操作的，例如：增删改查，清空等等操作，它是一个泛型类，就是说泛型的参数指定的是关联的映射类， 此外还提供了好几个注解给您的bean类提供方便的数据库映射逻辑，例如:@MajorKey是用来bean类中指定主键的注解,@Ignore是用来bean类中不想该属性映射到数据库中的注解，还有很多其他的注解。
详细用法请查看ZxyTable
- AutoDesignOperate(自定义元操作者)
这个是一个接口，它是用来具体定义您项目中具体业务逻辑的接口，以动态代理的方式为您完成各种骚操作，您只需要在实现AutoDesignOperate里面声明方法，方法中使用@Search,@Update,@Value等注解帮您自动操作数据库，好处就是你不需要自动手动写代码，您只需要注意sql语句的填写即可。
详细用法请查看AutoDesignOperate