xUtils3.0框架源码粗浅讲解

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface ViewInject {
    int value();
}

/**
 * 根据类来查找ContentView的注解类，当前类如果没有，则递归查找其父类
 */
private static ContentView findContentView(Class<?> thisCls) {
    if (thisCls == null || IGNORED.contains(thisCls)) {
        return null;
    }
    ContentView contentView = thisCls.getAnnotation(ContentView.class);
    if (contentView == null) {
        return findContentView(thisCls.getSuperclass());//如果当前类没有，递归查找其父类
    }
    return contentView;
}

ContentView contentView = findContentView(handlerType);
if (contentView != null) {
    int viewId = contentView.value();
    if (viewId > 0) {
        Method setContentViewMethod = handlerType.getMethod("setContentView", int.class);//反射Activity的setContentView方法
        setContentViewMethod.invoke(activity, viewId);
    }
}

ContentView contentView = findContentView(handlerType);
if (contentView != null) {
    int viewId = contentView.value();
    if (viewId > 0) {
        Method setContentViewMethod = handlerType.getMethod("setContentView", int.class);//反射Activity的setContentView方法
        setContentViewMethod.invoke(activity, viewId);
    }
}

// inject view
Field[] fields = handlerType.getDeclaredFields();
if (fields != null && fields.length > 0) {
    for (Field field : fields) {

        Class<?> fieldType = field.getType();
        if (
        /* 不注入静态字段 */     Modifier.isStatic(field.getModifiers()) ||
        /* 不注入final字段 */    Modifier.isFinal(field.getModifiers()) ||
        /* 不注入基本类型字段 */  fieldType.isPrimitive() ||
        /* 不注入数组类型字段 */  fieldType.isArray()) {
            continue;
        }

        ViewInject viewInject = field.getAnnotation(ViewInject.class);
        if (viewInject != null) {
            try {
                View view = finder.findViewById(viewInject.value(), viewInject.parentId());
                if (view != null) {
                    field.setAccessible(true);//重要！设置为可访问的
                    field.set(handler, view);
                } else {
                    throw new RuntimeException("Invalid @ViewInject for "
                            + handlerType.getSimpleName() + "." + field.getName());
                }
            } catch (Throwable ex) {
                LogUtil.e(ex.getMessage(), ex);
            }
        }
    }
} // end inject view

           //省略代码......

            /*
                根据View的ID和当前的接口类型获取已经缓存的接口实例对象，
                比如根据View.id和View.OnClickListener.class两个键获取这个View的OnClickListener对象
             */
            Object listener = listenerCache.get(info, listenerType);
            DynamicHandler dynamicHandler = null;
            /*
              如果接口实例对象不为空
                获取接口对象对应的动态代理对象
                如果动态代理对象的handler和当前handler相同
                则为动态代理对象添加代理方法
             */
            if (listener != null) {
                dynamicHandler = (DynamicHandler) Proxy.getInvocationHandler(listener);
                addNewMethod = handler.equals(dynamicHandler.getHandler());
                if (addNewMethod) {
                    dynamicHandler.addMethod(methodName, method);
                }
            }

            // 如果还没有注册此代理
            if (!addNewMethod) {

                dynamicHandler = new DynamicHandler(handler);

                dynamicHandler.addMethod(methodName, method);

                // 生成的代理对象实例，比如View.OnClickListener的实例对象
                listener = Proxy.newProxyInstance(
                        listenerType.getClassLoader(),
                        new Class<?>[]{listenerType},
                        dynamicHandler);

                listenerCache.put(info, listenerType, listener);
            }

            Method setEventListenerMethod = view.getClass().getMethod(listenerSetter, listenerType);
            setEventListenerMethod.invoke(view, listener);
        
        //省略代码......

//省略代码....
public DynamicHandler(Object handler) {
    this.handlerRef = new WeakReference<Object>(handler);//使用弱引用存放事件
}
//省略代码...

//省略代码...
if (AVOID_QUICK_EVENT_SET.contains(eventMethod)) {
    long timeSpan = System.currentTimeMillis() - lastClickTime;
    if (timeSpan < QUICK_EVENT_TIME_SPAN) {//判断两次事件invoke的事件间隔
        LogUtil.d("onClick cancelled: " + timeSpan);
        return null;
    }
    lastClickTime = System.currentTimeMillis();
}
//省略代码...

@Override
public <T> Callback.Cancelable request(HttpMethod method, RequestParams entity, Callback.CommonCallback<T> callback) {
    //设置请求方式
    entity.setMethod(method);
    Callback.Cancelable cancelable = null;
    if (callback instanceof Callback.Cancelable) {
        cancelable = (Callback.Cancelable) callback;
    }
    //创建一次请求任务
    HttpTask<T> task = new HttpTask<T>(entity, cancelable, callback);
    return x.task().start(task);
}

//省略代码.....
void bind(ImageView view, String url, ImageOptions options);

void bind(ImageView view, String url, Callback.CommonCallback<Drawable> callback);

void bind(ImageView view, String url, ImageOptions options, Callback.CommonCallback<Drawable> callback);

static Cancelable doBind(final ImageView view,
                         final String url,
                         final ImageOptions options,
                         final Callback.CommonCallback<Drawable> callback) {

    //省略代码....
    // 从内存中加载图片
    Drawable memDrawable = null;
    if (localOptions.isUseMemCache()) {
        memDrawable = MEM_CACHE.get(key);
        if (memDrawable instanceof BitmapDrawable) {
            Bitmap bitmap = ((BitmapDrawable) memDrawable).getBitmap();
            if (bitmap == null || bitmap.isRecycled()) {
                memDrawable = null;
            }
        }
    }
    //省略代码....
}

// 尝试从缓存获取结果, 并为请求头加入缓存控制参数.
try {
    clearRawResult();
    LogUtil.d("load cache: " + this.request.getRequestUri());
    rawResult = this.request.loadResultFromCache();
} catch (Throwable ex) {
    LogUtil.w("load disk cache error", ex);
}

@Override
public Object loadResultFromCache() throws Throwable {
    isLoading = true;
    DiskCacheEntity cacheEntity = LruDiskCache.getDiskCache(params.getCacheDirName())
            .setMaxSize(params.getCacheSize())
            .get(this.getCacheKey());

    if (cacheEntity != null) {
        if (HttpMethod.permitsCache(params.getMethod())) {
            Date lastModified = cacheEntity.getLastModify();
            if (lastModified.getTime() > 0) {
                params.setHeader("If-Modified-Since", toGMTString(lastModified));
            }
            String eTag = cacheEntity.getEtag();
            if (!TextUtils.isEmpty(eTag)) {
                params.setHeader("If-None-Match", eTag);
            }
        }
        return loader.loadFromCache(cacheEntity);//对应自定义的loader去解析，如org.xutils.http.loader.JSONObjectLoader
    } else {
        return null;
    }
}

/**
 * 判断是否gif图片
 * @param file
 * @return
 */
public static boolean isGif(File file) {
    FileInputStream in = null;
    try {
        in = new FileInputStream(file);
        byte[] header = IOUtil.readBytes(in, 0, 3);
        return Arrays.equals(GIF_HEADER, header);
    } catch (Throwable ex) {
        LogUtil.e(ex.getMessage(), ex);
    } finally {
        IOUtil.closeQuietly(in);
    }

    return false;
}

/**
 * 判断是否webp图片
 * @param file
 * @return
 */
public static boolean isWebP(File file) {
    FileInputStream in = null;
    try {
        in = new FileInputStream(file);
        byte[] header = IOUtil.readBytes(in, 8, 4);
        return Arrays.equals(WEBP_HEADER, header);
    } catch (Throwable ex) {
        LogUtil.e(ex.getMessage(), ex);
    } finally {
        IOUtil.closeQuietly(in);
    }

    return false;
}

static Drawable decodeFileWithLock(final File file,
                                   final ImageOptions options,
                                   final Callback.Cancelable cancelable) throws IOException {
    //省略代码....
    Drawable result = null;
    if (!options.isIgnoreGif() && isGif(file)) {
        Movie movie = null;
        synchronized (gifDecodeLock) { // decode with lock
            movie = decodeGif(file, options, cancelable);
        }
        if (movie != null) {
            result = new GifDrawable(movie, (int) file.length());
        }
     //省略代码....  
}

/**
 * 转换文件为Movie, 可用于创建GifDrawable.
 */
public static Movie decodeGif(File file, ImageOptions options, Callback.Cancelable cancelable) throws IOException {
   //省略代码....
    InputStream in = null;
    //省略代码....
    Movie movie = Movie.decodeStream(in);
    //省略代码.... 
}

// decode file
Bitmap bitmap = null;
if (isWebP(file)) {
    bitmap = WebPFactory.decodeFile(file.getAbsolutePath(), bitmapOps);
}

DbManager.DaoConfig daoConfig = new DbManager.DaoConfig()
        .setDbName("test.db")//数据库名称
        // 不设置dbDir时, 默认存储在app的私有目录.
        .setDbDir(new File("/sdcard")) // "sdcard"的写法并非最佳实践, 这里为了简单, 先这样写了.
        .setDbVersion(2)
        .setDbOpenListener(new DbManager.DbOpenListener() {
            @TargetApi(Build.VERSION_CODES.HONEYCOMB)
            @Override
            public void onDbOpened(DbManager db) {
                // 开启WAL, 对写入加速提升巨大
                db.getDatabase().enableWriteAheadLogging();
            }
        })
        .setDbUpgradeListener(new DbManager.DbUpgradeListener() {
            @Override
            public void onUpgrade(DbManager db, int oldVersion, int newVersion) {
                // TODO: ...
                // db.addColumn(...);
                // db.dropTable(...);
                // ...
                // or
                // db.dropDb();
            }
        });

private DbManagerImpl(DaoConfig config) {
    if (config == null) {
        throw new IllegalArgumentException("daoConfig may not be null");
    }
    this.daoConfig = config;
    this.allowTransaction = config.isAllowTransaction();
    this.database = openOrCreateDatabase(config);
    DbOpenListener dbOpenListener = config.getDbOpenListener();
    if (dbOpenListener != null) {
        dbOpenListener.onDbOpened(this);
    }
}

@Override
public void save(Object entity) throws DbException {
    try {
        //开启事务
        beginTransaction();

        //批量保存
        if (entity instanceof List) {
            List<?> entities = (List<?>) entity;
            if (entities.isEmpty()) return;
            //1.从Java实体到关联数据库表对象的转换
            TableEntity<?> table = this.getTable(entities.get(0).getClass());
            //2.检查表是否存在
            createTableIfNotExist(table);
            for (Object item : entities) {
                //3.创建相应的sql语句并执行
                execNonQuery(SqlInfoBuilder.buildInsertSqlInfo(table, item));
            }
        } else {//单条记录保存
            TableEntity<?> table = this.getTable(entity.getClass());
            createTableIfNotExist(table);
            execNonQuery(SqlInfoBuilder.buildInsertSqlInfo(table, entity));
        }

        //标识当前事务执行成功
        setTransactionSuccessful();
    } finally {
        //结束事务
        endTransaction();
    }
}

public <T> TableEntity<T> getTable(Class<T> entityType) throws DbException {
          //省略代码....
          table = new TableEntity<T>(this, entityType);
          //省略代码....
}

/*package*/ TableEntity(DbManager db, Class<T> entityType) throws Throwable {
    //省略.....
    //获取注解定义的表名
    Table table = entityType.getAnnotation(Table.class);
    this.name = table.name();
    this.onCreated = table.onCreated();
    //查找Java实体定义的表字段
    this.columnMap = TableUtils.findColumnMap(entityType);
    //省略.....
}

/* package */
static synchronized LinkedHashMap<String, ColumnEntity> findColumnMap(Class<?> entityType) {
    LinkedHashMap<String, ColumnEntity> columnMap = new LinkedHashMap<String, ColumnEntity>();
    addColumns2Map(entityType, columnMap);
    return columnMap;
}

private static void addColumns2Map(Class<?> entityType, HashMap<String, ColumnEntity> columnMap) {
    if (Object.class.equals(entityType)) return;

    try {
        Field[] fields = entityType.getDeclaredFields();
        for (Field field : fields) {
            int modify = field.getModifiers();
            if (Modifier.isStatic(modify) || Modifier.isTransient(modify)) {
                continue;
            }
            Column columnAnn = field.getAnnotation(Column.class);
            if (columnAnn != null) {
                if (ColumnConverterFactory.isSupportColumnConverter(field.getType())) {
                    ColumnEntity column = new ColumnEntity(entityType, field, columnAnn);
                    if (!columnMap.containsKey(column.getName())) {
                        columnMap.put(column.getName(), column);
                    }
                }
            }
        }

        addColumns2Map(entityType.getSuperclass(), columnMap);
    } catch (Throwable e) {
        LogUtil.e(e.getMessage(), e);
    }
}

protected void createTableIfNotExist(TableEntity<?> table) throws DbException {
    if (!table.tableIsExist()) {
        synchronized (table.getClass()) {
            if (!table.tableIsExist()) {
                SqlInfo sqlInfo = SqlInfoBuilder.buildCreateTableSqlInfo(table);//拼接sql语句
                execNonQuery(sqlInfo);//执行sql语句，物理创建Java实体对象到数据库的表结构
                String execAfterTableCreated = table.getOnCreated();
                if (!TextUtils.isEmpty(execAfterTableCreated)) {
                    execNonQuery(execAfterTableCreated);//Java实体对象oncreate存放的要是完整的sql语句，在表结构创建完成之后执行
                }
                table.setCheckedDatabase(true);
                TableCreateListener listener = this.getDaoConfig().getTableCreateListener();
                if (listener != null) {
                    listener.onTableCreated(this, table);
                }
            }
        }
    }
}

@Override
public void execNonQuery(SqlInfo sqlInfo) throws DbException {
   //省略代码...
        statement = sqlInfo.buildStatement(database);
        statement.execute();
   //省略代码...
}

//*********************************************** insert sql ***********************************************

public static SqlInfo buildInsertSqlInfo(TableEntity<?> table, Object entity) throws DbException {

    List<KeyValue> keyValueList = entity2KeyValueList(table, entity);
    if (keyValueList.size() == 0) return null;

    SqlInfo result = new SqlInfo();
    String sql = INSERT_SQL_CACHE.get(table);
    if (sql == null) {
        StringBuilder builder = new StringBuilder();
        builder.append("INSERT INTO ");
        builder.append("\"").append(table.getName()).append("\"");
        builder.append(" (");
        for (KeyValue kv : keyValueList) {
            builder.append("\"").append(kv.key).append("\"").append(',');
        }
        builder.deleteCharAt(builder.length() - 1);
        builder.append(") VALUES (");

        int length = keyValueList.size();
        for (int i = 0; i < length; i++) {
            builder.append("?,");
        }
        builder.deleteCharAt(builder.length() - 1);
        builder.append(")");

        sql = builder.toString();
        result.setSql(sql);
        result.addBindArgs(keyValueList);
        INSERT_SQL_CACHE.put(table, sql);
    } else {
        result.setSql(sql);
        result.addBindArgs(keyValueList);
    }

    return result;
}