ThinkAndroid帮助文档

#  ThinkAndroid简介 

ThinkAndroid是一个免费的开源的、简易的、遵循Apache2开源协议发布的Android开发框架，其开发宗旨是简单、快速的进行

Android应用程序的开发，包含Android mvc、简易sqlite orm、ioc模块、封装Android httpclitent的http模块,

具有快速构建文件缓存功能，无需考虑缓存文件的格式，都可以非常轻松的实现缓存，它还基于文件缓存模块实现了图片缓存功能，

在android中加载的图片的时候，对oom的问题，和对加载图片错位的问题都轻易解决。他还包括了一个手机开发中经常应用的实用工具类，

如日志管理，配置文件管理，android下载器模块，网络切换检测等等工具。

 

 

##目前ThinkAndroid主要有以下模块：

 

* MVC模块：实现视图与模型的分离。

 

* ioc模块：android中的ioc模块，完全注解方式就可以进行UI绑定、res中的资源的读取、以及对象的初始化。

 

* 数据库模块：android中的orm框架，使用了线程池对sqlite进行操作。

* 

* http模块：通过httpclient进行封装http数据请求，支持异步及同步方式加载。

 

* 缓存模块：通过简单的配置及设计可以很好的实现缓存，对缓存可以随意的配置

 

* 图片缓存模块：imageview加载图片的时候无需考虑图片加载过程中出现的oom和android容器快速滑动时候出现的图片错位等现象。

 

* 配置器模块：可以对简易的实现配对配置的操作，目前配置文件可以支持Preference、Properties对配置进行存取。

 

* 日志打印模块：可以较快的轻易的是实现日志打印，支持日志打印的扩展，目前支持对sdcard写入本地打印、以及控制台打印

 

* 下载器模块:可以简单的实现多线程下载、后台下载、断点续传、对下载进行控制、如开始、暂停、删除等等。

 

* 网络状态检测模块：当网络状态改变时，对其进行检测。

 

 

---

## 使用ThinkAndroid快速开发框架需要有以下权限：

 

```xml

<!-- 访问互联网权限 根据需要添加-->

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

<!-- SDCARD读写权限 根据需要添加 -->

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

<!-- 网络状态检测权限  根据需要添加-->

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

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

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

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

     配置：

     <receiver android:name="com.ta.util.netstate.TANetworkStateReceiver" >

            <intent-filter>

                <action android:name="android.net.conn.CONNECTIVITY_CHANGE" />

            </intent-filter>

        </receiver>

 <application

        android:name="com.ta.TAApplication" >

      application必须配置以上格式

```

Activity必须继承TAActivity

----

##ThinkAndroid使用方法：

关于ThinkAndroid的更多介绍，请点击[这里](http://www.thinkandroid.cn/forum.php?mod=forumdisplay&fid=36)

##MVC模块

* MVC模块：实现视图与模型的分离。

 

```java

  getTAApplication().registerCommand(R.string.comand,

        TAIdentityCommand.class);

getTAApplication().registerCommand(R.string.comand,

TAIdentityCommand.class);

TALogger.addLogger(new TAPrintToFileLogger());

TARequest request = new TARequest();

doCommand(R.string.comand, request, new TAIResponseListener()

{

 

@Override

public void onStart(TAResponse response)

{

// TODO Auto-generated method stub

 

}

 

@Override

public void onSuccess(TAResponse response)

{

// TODO Auto-generated method stub

 

}

 

@Override

public void onRuning(TAResponse response)

{

// TODO Auto-generated method stub

 

}

 

@Override

public void onFailure(TAResponse response)

{

// TODO Auto-generated method stub

 

}

 

}, false, true, true);

    

    

    

  

package com.ta.mvc.command;

 

import com.ta.mvc.common.TAIResponseListener;

import com.ta.mvc.common.TARequest;

import com.ta.mvc.common.TAResponse;

 

public class TAIdentityCommand extends TACommand

{

  @Override

protected void executeCommand()

{

// TODO Auto-generated method stub

TARequest request = getRequest();

TAResponse response = new TAResponse();

response.setTag(request.getTag());

response.setData(request.getData());

response.setActivityKey((String) request.getActivityKey());

response.setActivityKeyResID(request.getActivityKeyResID());

setResponse(response);

notifyListener(true);

}

 

protected void notifyListener(boolean success)

{

TAIResponseListener responseListener = getResponseListener();

if (responseListener != null)

{

onComandUpdate(command_success);

}

}

}

 

```

 

----

 

##ioc模块使用方法：

* 完全注解方式就可以进行UI绑定、res中的资源的读取、以及对象的初始化。

 

```java

public class ThinkAndroidDemoActivity extends TAActivity {

 

     

@TAInject 

Entity entity; //目前只能对无参构造函数进行初始化

@@TAInject(id=R.string.app_name)

String appNameString;

@TAInjectResource(id=R.attr.test)

int[] test; 

@TAInjectView(id=R.id.add);

Button addButton;

}

 

```

 

##数据库模块

* android中的orm框架，使用了线程池对sqlite进行操作。

 

```java

public class ThinkAndroidDemoActivity extends TAActivity {

 

   TASQLiteDatabasePool sqlitePool = getTAApplication()

.getSQLiteDatabasePool();

TASQLiteDatabase sqliteDatabase=sqlitePool.getSQLiteDatabase();

//使用中

sqliteDatabase.insert(entity);

sqlitePool.returnSQLiteDatabase(sqliteDatabase); 

 

}

```

 

##Http模块使用方法：

###异步get方法

```java

  AsyncHttpClient client = new AsyncHttpClient();

client.get("http://www.thinkandroid.cn/", new AsyncHttpResponseHandler()

{

@Override

public void onSuccess(String content)

{

// TODO Auto-generated method stub

super.onSuccess(content);

TALogger.d(LoginActivity.this, content);

}

@Override

public void onStart()

{

// TODO Auto-generated method stub

super.onStart();

}

@Override

public void onFailure(Throwable error)

{

// TODO Auto-generated method stub

super.onFailure(error);

}

@Override

public void onFinish()

{

// TODO Auto-generated method stub

super.onFinish();

}

 

});

```

##Http模块使用方法：

###同步get方法

 

```java

  TASyncHttpClient client = new TASyncHttpClient();

  client.get("http://www.thinkandroid.cn/", new AsyncHttpResponseHandler()

{

@Override

public void onSuccess(String content)

{

// TODO Auto-generated method stub

super.onSuccess(content);

TALogger.d(LoginActivity.this, content);

}

@Override

public void onStart()

{

// TODO Auto-generated method stub

super.onStart();

}

@Override

public void onFailure(Throwable error)

{

// TODO Auto-generated method stub

super.onFailure(error);

}

@Override

public void onFinish()

{

// TODO Auto-generated method stub

super.onFinish();

}

 

});

```

### 使用http模块上传文件 或者 提交数据 到服务器（post方法）

 

```java

RequestParams params = new RequestParams();

    params.put("username", "white_cat");

  params.put("password", "123456");

  params.put("email", "2640017581@qq.com");

  params.put("profile_picture", new File("/mnt/sdcard/testpic.jpg")); // 上传文件

  params.put("profile_picture2", inputStream); // 上传数据流

  params.put("profile_picture3", new ByteArrayInputStream(bytes)); // 提交字节流

client.post("http://www.thinkandroid.cn/", new AsyncHttpResponseHandler()

{

@Override

public void onSuccess(String content)

{

// TODO Auto-generated method stub

super.onSuccess(content);

TALogger.d(LoginActivity.this, content);

}

@Override

public void onStart()

{

// TODO Auto-generated method stub

super.onStart();

}

@Override

public void onFailure(Throwable error)

{

// TODO Auto-generated method stub

super.onFailure(error);

}

@Override

public void onFinish()

{

// TODO Auto-generated method stub

super.onFinish();

}

 

});

}

```

 

 

----

 

###使用http下载文件：

* 支持断点续传，随时停止下载任务 或者 开始任务

 

```java

    AsyncHttpClient syncHttpClient = new AsyncHttpClient();

     FileHttpResponseHandler fHandler = new FileHttpResponseHandler(

TAExternalOverFroyoUtils.getDiskCacheDir(TestActivity.this,

 "sdfsdfsdf").getAbsolutePath())

   {

         

 @Override 

 public void onProgress(String speed, String progress) {

 //TODO Auto-generated method stub 

 super.onProgress(speed, progress);

 TALogger.v(TestActivity.this, progress + "--------" + speed); }

 

 @Override 

 public void onFailure(Throwable error) { 

 // TODOAuto-generated method stub 

 super.onFailure(error); }

 

 @Override

 public void onSuccess(byte[] binaryData) { 

 // TODOAuto-generated method stub 

 super.onSuccess(binaryData);

 TALogger.d(TestActivity.this, "kaishi8了"); } };

 syncHttpClient .download(

"http://static.qiyi.com/ext/common/iQIYI/QIYImedia_4_01.exe",

 fHandler);

         //停止

        fHandler.setInterrupt(interrupt);

        

```

 

 

##图片模块 方法 

* imageview加载图片的时候无需考虑图片加载过程中出现的oom和android容器快速滑动时候出现的图片错位等现象。

 

```java

package com.test;

import com.ta.TAApplication;

import com.ta.util.bitmap.TABitmapCacheWork;

import com.ta.util.bitmap.TADownloadBitmapHandler;

 

import android.content.Context;

import android.view.LayoutInflater;

import android.view.View;

import android.view.ViewGroup;

import android.widget.BaseAdapter;

import android.widget.ImageView;

 

public class Adapter extends BaseAdapter

{

  TABitmapCacheWork imageFetcher;

Context mContext;

 

public Adapter(Context context, TAApplication application)

{

TADownloadBitmapHandler downloadBitmapFetcher = new TADownloadBitmapHandler(

context, 100);

imageFetcher = new TABitmapCacheWork(context);

imageFetcher.setProcessDataHandler(downloadBitmapFetcher);

imageFetcher.setFileCache(application.getFileCache());

this.mContext = context;

}

 

@Override

public int getCount()

{

// TODO Auto-generated method stub

return Images.imageThumbUrls.length;

}

 

@Override

public Object getItem(int position)

{

// TODO Auto-generated method stub

return Images.imageThumbUrls[position];

}

 

@Override

public long getItemId(int position)

{

// TODO Auto-generated method stub

return position;

}

 

@Override

public View getView(int position, View convertView, ViewGroup parent)

{

// TODO Auto-generated method stub

LayoutInflater inflater = (LayoutInflater) mContext

.getSystemService(Context.LAYOUT_INFLATER_SERVICE);

View baseView = inflater.inflate(R.layout.login_adapter, null);

final ImageView imageView = (ImageView) baseView

.findViewById(R.id.imageView);

     //加载图片

imageFetcher.loadFormCache(getItem(position), imageView);

return baseView;

}

}

 

 

 

使用 

  @TAInjectView(id = R.id.gridView)

GridView  gridView;

Adapter adapter = new Adapter(this, getTAApplication());

gridView.setAdapter(adapter);

```

 

##缓存模块 方法 

* 很简单的实现缓存，以一个简单的文件缓存为例

* 下载处理类

 

```java

package com.test.file;

 

import com.ta.util.cache.TAProcessDataHandler;

//下载处理类

public class TAProcessStringHandler extends TAProcessDataHandler

{

  @Override

public byte[] processData(Object data)

{

// TODO Auto-generated method stub

String mynameString="white_cat";

//这里对数据进行处理，如下载东西等等，转换为byte[]以供缓存存储使用

return mynameString.getBytes();

}

}

```

 

* 缓存结果返回操作类

 

```java

package com.test.file;

 

import android.widget.TextView;

 

import com.ta.util.cache.TACallBackHandler;

 

public class TAStringCallBackHandler extends TACallBackHandler<TextView>

{

  @Override

public void onStart(TextView t, Object data)

{

// TODO Auto-generated method stub

super.onStart(t, data);

}

 

@Override

public void onSuccess(TextView t, Object data, byte[] buffer)

{

// TODO Auto-generated method stub

super.onSuccess(t, data, buffer);

}

 

@Override

public void onFailure(TextView t, Object data)

{

// TODO Auto-generated method stub

super.onFailure(t, data);

}

}

```

* 程序调用

 

```java

TAFileCacheWork<TextView> taFileCacheWork=new TAFileCacheWork<TextView>();

  taFileCacheWork.setFileCache(getTAApplication().getFileCache());

taFileCacheWork.setCallBackHandler(new TAStringCallBackHandler());

taFileCacheWork.setProcessDataHandler(new TAProcessStringHandler());

taFileCacheWork.loadFormCache("http://www.baidu.com", textView);

```

 

##打印模块使用方法

可以较快的轻易的是实现日志打印，支持日志打印的扩展，目前支持对sdcard写入本地打印、以及控制台打印

添加打印器

TALogger.addLogger(new TAPrintToFileLogger());

调用打印

TALogger.addLogger(new TAPrintToFileLogger());

TALogger.d(TestActivity.this, "test");

 

 

 

##下载器模块

可以简单的实现多线程下载、后台下载、断点续传、对下载进行控制、如开始、暂停、删除等等。

```java

private DownloadManager downloadManager;

downloadManager = DownloadManager.getDownloadManager();

downloadManager.setDownLoadCallback(new DownLoadCallback()

{

@Override

public void onSuccess(String url)

{

}

 

@Override

public void onLoading(String url, String speed, String progress)

{

// TODO Auto-generated method stub

 

}

});

//添加

downloadManager.addHandler(url);

//继续

downloadManager.continueHandler(url);

//暂停

downloadManager.pauseHandler(url);

//删除

downloadManager.deleteHandler(url);

//

```

 

 

* 后台下载

 

```java

private IDownloadService downloadService;

ServiceConnection serviceConnection=new ServiceConnection()

{

@Override

public void onServiceDisconnected(ComponentName name)

{

// TODO Auto-generated method stub

}

@Override

public void onServiceConnected(ComponentName name, IBinder service)

{

// TODO Auto-generated method stub

downloadService=(IDownloadService)service;

}

};

//添加任务

downloadService.addTask(url)

//暂停任务

 downloadService.pauseTask(url)

 //继续任务

 downloadService.continueTask(url)

 //删除任务

downloadService.deleteTask(url)

```

 

 

## 配置器模

可以对简易的实现配对配置的操作，目前配置文件可以支持Preference、Properties对配置进行存取

 

```java

TAIConfig config = application

.getConfig(TAApplication.PROPERTIESCONFIG);

Entity entity = new Entity();

entity.setB(false);

entity.setD(10);

entity.setI(1);

entity.setF(1f);

config.setConfig(entity);

Entity cEntity = config.getConfig(Entity.class);

textView.setText(cEntity.toString());

```

 

 

## 网络状态监测模块

当网络状态改变时，对其进行监测。

 

```java

 TANetworkStateReceiver.registerObserver(new TANetChangeObserver()

{

@Override

public void onConnect(netType type)

{

super.onConnect(type);

Toast.makeText(TestActivity.this, "onConnect",Toast.LENGTH_SHORT).show();

}

 

@Override

public void onDisConnect()

{

super.onDisConnect();

Toast.makeText(TestActivity.this, "onDisConnect",Toast.LENGTH_SHORT).show();

}

});

需要开启权限

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

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

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

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

    

    配置：

     <receiver android:name="com.ta.util.netstate.TANetworkStateReceiver" >

            <intent-filter>

                <action android:name="android.net.conn.CONNECTIVITY_CHANGE" />

            </intent-filter>

        </receiver>