Android学习——涉及意识形态的LitePal源码分析

public class Album extends DataSupport {

    private String name;

    private float price;

    private List<Song> songs = new ArrayList<Song>();

    // generated getters and setters.
    ...
}

Album album = new Album();
album.setName("album");
album.setPrice(10.99f);
album.save();

public synchronized boolean save() {   //调用了saveThrows()方法   代码上的注释是这么说的，如果这个是一条新的记录，就会在数据库中create，否则就更新现有的数据。
        try {　　　　　　　//它怎么区分这条数据是否在已经在数据库中了？答案是根据JavaBean里地id或者_id属性（必须为int类型或者long类型），这是一个约定，如果实体类
            saveThrows();　　//中有这个属性，这个id的值将会由数据库创建并在调用save方法后自动指派给它（原理我稍后看看）,并且判断这个id属性是否有值区分insert和update操作
            return true;
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
    }

public synchronized void saveThrows() {
        SQLiteDatabase db = Connector.getDatabase();　　　　　　//获取数据库
        db.beginTransaction();　　　　　　　　　　　　　　　　　　　　//这个估计是开启事务？先放着
        try {
            SaveHandler saveHandler = new SaveHandler(db);　　　　//这是关键咯
            saveHandler.onSave(this);
            clearAssociatedData();　　　　　　　　　　　　　　　　　　//不知道这个是什么鬼，清理外键数据啥的
            db.setTransactionSuccessful();
        } catch (Exception e) {
            throw new DataSupportException(e.getMessage());
        } finally {
            db.endTransaction();
        }
    }

void onSave(DataSupport baseObj) throws SecurityException, IllegalArgumentException,
            NoSuchMethodException, IllegalAccessException, InvocationTargetException {

        String className = baseObj.getClassName();　　　　　　　　　　　　　　　　　　//获取类名，例子里就是Album类名,其实调用的就是getClass().getName();
        List<Field> supportedFields = getSupportedFields(className);　　　　　　　　　　//找出这个实体类中的所有属性，但是只支持基本数据类型和String类型　
        Collection<AssociationsInfo> associationInfos = getAssociationInfo(className);　　　　　　//这里涉及到关联数据，先不理
        if (!baseObj.isSaved()) {　　　　　　　//判断模型已经创建与否，也就是说这条数据是否在数据库中了，就一行return baseObjId > 0,所以说实体类的id值不要自己手动去设
            analyzeAssociatedModels(baseObj, associationInfos);　　　　　　　　　　　　//关联数据相关，等一下再分析
            doSaveAction(baseObj, supportedFields);
            analyzeAssociatedModels(baseObj, associationInfos);　　　　　　　　　　   //关联数据相关，等一下再分析
        } else {
            analyzeAssociatedModels(baseObj, associationInfos);　　　　　　　　　　　　//关联数据相关，等一下再分析
            doUpdateAction(baseObj, supportedFields);　　　　　　　　　　　　　　　　　　//如果baseObjId不为空，更新
        }
    }

private void doSaveAction(DataSupport baseObj, List<Field> supportedFields)
            throws SecurityException, IllegalArgumentException, NoSuchMethodException,
            IllegalAccessException, InvocationTargetException {

        ContentValues values = new ContentValues();
        beforeSave(baseObj, supportedFields, values);　　　　　　　　　　//beforeSave  主要功能是通过反射把实体类的数据存入ContentValues,动态地获取数据类型，并调用相　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　//应的put方法
        long id = saving(baseObj, values);　　　　　　　　　　　　　　　　//保存数据到表中，并且返回一个long类型的id
        afterSave(baseObj, supportedFields, id);　　　　　　　　　　　　　//afterSave
}

public long insert(String table, String nullColumnHack, ContentValues values) 

private void afterSave(DataSupport baseObj, List<Field> supportedFields, long id) {
        throwIfSaveFailed(id);　　　　　　　　　　　　　　　　　　　　//如果id为-1，抛出异常，插入数据失败
        assignIdValue(baseObj, getIdField(supportedFields), id);　　　　//指派id给JavaBean，就是那个Album对象
        updateAssociatedTableWithFK(baseObj);　　　　　　　　　　　　　　　//更新关联的表，先不要理，关联那块另外说
        insertIntermediateJoinTableValue(baseObj, false);　　　　　　　　//这个也涉及到关联数据，多对多关系下的中间表操作，先放着
}