# white-cat/thinkandroid architecture

> Architecture diagram of the GitHub repository white-cat/thinkandroid, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/white-cat/thinkandroid
- Repository: https://github.com/white-cat/thinkandroid

## Overview

ThinkAndroid is a Java Android application framework, demonstrated by a sample app. Its principal workflow is an Activity initiating framework work and presenting results, with MVC commands available for asynchronous request/response handling. The framework also provides annotation-based UI injection, SQLite ORM, HTTP, file and image caching, downloads, configuration, logging, and network-state detection. The graph preserves these documented capabilities; some subsystem connections are documented in the README but their implementations were not sampled.

Main entry points: [`ThinkAndroidDemo/src/com/cat/activity/ThinkAndroidMainActivity.java`](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroidDemo/src/com/cat/activity/ThinkAndroidMainActivity.java) (Demo activities), [`ThinkAndroid/src/com/ta/TAActivity.java`](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/TAActivity.java) (TAActivity), [`ThinkAndroid/src/com/ta/util/http/AsyncHttpClient.java`](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/http/AsyncHttpClient.java) (Async HTTP client), [`ThinkAndroid/src/com/ta/TAApplication.java`](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/TAApplication.java) (TAApplication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and MVC"]
  node_demo["Demo activities"]
  node_activity["TAActivity<br/>[TAActivity.java]"]
  node_application["TAApplication<br/>[TAApplication.java]"]
  node_mvc["MVC commands"]
  node_request["MVC request/response<br/>[TARequest.java]"]
end

subgraph group_storage["Data and Caching"]
  node_sqlite["SQLite ORM"]
  node_dbpool["SQLite pool"]
  node_filecache["File cache<br/>[TAFileCache.java]"]
  node_imagecache["Image cache"]
end

subgraph group_network["Networking and Downloads"]
  node_http["Async HTTP client"]
  node_httprequest["HTTP request runner"]
  node_response["HTTP response handler"]
  node_filehandler["File response handler"]
  node_downloads["Download manager"]
end

subgraph group_platform["Android Utilities"]
  node_inject["Annotation injection<br/>[TAInjector.java]"]
  node_config["Configuration<br/>[TAIConfig.java]"]
  node_logger["Logging<br/>[TALogger.java]"]
  node_netstate["Network state<br/>[TANetWorkUtil.java]"]
end

node_user(("App user"))
node_server(("HTTP server"))

node_user -->|"uses"| node_demo
node_demo -->|"extends"| node_activity
node_activity -->|"gets app"| node_application
node_activity -->|"injects views"| node_inject
node_activity -->|"dispatches commands"| node_mvc
node_mvc -->|"uses request"| node_request
node_application -->|"registers commands"| node_mvc
node_application -->|"provides pool"| node_dbpool
node_dbpool -->|"pools databases"| node_sqlite
node_sqlite -.->|"persists locally"| node_server
node_demo -->|"configures cache"| node_filecache
node_imagecache -->|"uses disk cache"| node_filecache
node_demo -->|"requests data"| node_http
node_http -->|"dispatches request"| node_httprequest
node_httprequest -->|"delivers response"| node_response
node_http -->|"sends HTTP"| node_server
node_demo -->|"controls downloads"| node_downloads
node_downloads -->|"starts downloads"| node_http
node_downloads -->|"tracks files"| node_filehandler
node_filehandler -->|"extends handler"| node_response
node_demo -.->|"configures settings"| node_config
node_demo -->|"logs events"| node_logger
node_demo -->|"checks connectivity"| node_netstate

click node_demo "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroidDemo/src/com/cat/activity/ThinkAndroidMainActivity.java"
click node_activity "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/TAActivity.java"
click node_application "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/TAApplication.java"
click node_mvc "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/mvc/command/TACommandQueueManager.java"
click node_request "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/mvc/common/TARequest.java"
click node_inject "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/TAInjector.java"
click node_sqlite "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/db/TASQLiteDatabase.java"
click node_dbpool "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/db/TASQLiteDatabasePool.java"
click node_filecache "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/cache/TAFileCache.java"
click node_imagecache "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/bitmap/TADownloadBitmapHandler.java"
click node_http "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/http/AsyncHttpClient.java"
click node_httprequest "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/http/AsyncHttpRequest.java"
click node_response "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/http/AsyncHttpResponseHandler.java"
click node_filehandler "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/http/FileHttpResponseHandler.java"
click node_downloads "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/download/DownloadManager.java"
click node_config "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/config/TAIConfig.java"
click node_logger "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/TALogger.java"
click node_netstate "https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/netstate/TANetWorkUtil.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_demo,node_activity,node_application,node_mvc,node_request,node_user toneBlue
class node_sqlite,node_dbpool,node_filecache,node_imagecache toneAmber
class node_http,node_httprequest,node_response,node_filehandler,node_downloads,node_server toneMint
class node_inject,node_config,node_logger,node_netstate toneRose
```

## Components

### App and MVC

- [Demo activities](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroidDemo/src/com/cat/activity/ThinkAndroidMainActivity.java): `ThinkAndroidDemo/src/com/cat/activity/ThinkAndroidMainActivity.java`
- [TAActivity](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/TAActivity.java): `ThinkAndroid/src/com/ta/TAActivity.java`
- [TAApplication](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/TAApplication.java): `ThinkAndroid/src/com/ta/TAApplication.java`
- [MVC commands](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/mvc/command/TACommandQueueManager.java): `ThinkAndroid/src/com/ta/mvc/command/TACommandQueueManager.java`
- [MVC request/response](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/mvc/common/TARequest.java): `ThinkAndroid/src/com/ta/mvc/common/TARequest.java`

### Data and Caching

- [SQLite ORM](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/db/TASQLiteDatabase.java): `ThinkAndroid/src/com/ta/util/db/TASQLiteDatabase.java`
- [SQLite pool](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/db/TASQLiteDatabasePool.java): `ThinkAndroid/src/com/ta/util/db/TASQLiteDatabasePool.java`
- [File cache](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/cache/TAFileCache.java): `ThinkAndroid/src/com/ta/util/cache/TAFileCache.java`
- [Image cache](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/bitmap/TADownloadBitmapHandler.java): `ThinkAndroid/src/com/ta/util/bitmap/TADownloadBitmapHandler.java`

### Networking and Downloads

- [Async HTTP client](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/http/AsyncHttpClient.java): `ThinkAndroid/src/com/ta/util/http/AsyncHttpClient.java`
- [HTTP request runner](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/http/AsyncHttpRequest.java): `ThinkAndroid/src/com/ta/util/http/AsyncHttpRequest.java`
- [HTTP response handler](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/http/AsyncHttpResponseHandler.java): `ThinkAndroid/src/com/ta/util/http/AsyncHttpResponseHandler.java`
- [File response handler](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/http/FileHttpResponseHandler.java): `ThinkAndroid/src/com/ta/util/http/FileHttpResponseHandler.java`
- [Download manager](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/download/DownloadManager.java): `ThinkAndroid/src/com/ta/util/download/DownloadManager.java`

### Android Utilities

- [Annotation injection](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/TAInjector.java): `ThinkAndroid/src/com/ta/util/TAInjector.java`
- [Configuration](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/config/TAIConfig.java): `ThinkAndroid/src/com/ta/util/config/TAIConfig.java`
- [Logging](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/TALogger.java): `ThinkAndroid/src/com/ta/util/TALogger.java`
- [Network state](https://github.com/white-cat/thinkandroid/blob/master/ThinkAndroid/src/com/ta/util/netstate/TANetWorkUtil.java): `ThinkAndroid/src/com/ta/util/netstate/TANetWorkUtil.java`

### Other components

- **App user**
- **HTTP server**

## Connections

- App user → Demo activities: uses (evidence: `README.md`)
- Demo activities → TAActivity: extends
- TAActivity → TAApplication: gets app (evidence: `ThinkAndroid/src/com/ta/TAActivity.java`)
- TAActivity → Annotation injection: injects views (evidence: `ThinkAndroid/src/com/ta/TAActivity.java`)
- TAActivity → MVC commands: dispatches commands (evidence: `ThinkAndroid/src/com/ta/TAActivity.java`)
- MVC commands → MVC request/response: uses request (evidence: `README.md`)
- TAApplication → MVC commands: registers commands (evidence: `README.md`)
- TAApplication → SQLite pool: provides pool (evidence: `README.md`)
- SQLite pool → SQLite ORM: pools databases (evidence: `ThinkAndroid/src/com/ta/util/db/TASQLiteDatabasePool.java`)
- SQLite ORM → HTTP server: persists locally
- Demo activities → File cache: configures cache (evidence: `ThinkAndroidDemo/src/com/cat/activity/SplashActivity.java`)
- Image cache → File cache: uses disk cache (evidence: `ThinkAndroid/src/com/ta/util/bitmap/TADownloadBitmapHandler.java`)
- Demo activities → Async HTTP client: requests data (evidence: `README.md`)
- Async HTTP client → HTTP request runner: dispatches request (evidence: `ThinkAndroid/src/com/ta/util/http/AsyncHttpClient.java`)
- HTTP request runner → HTTP response handler: delivers response (evidence: `ThinkAndroid/src/com/ta/util/http/AsyncHttpClient.java`)
- Async HTTP client → HTTP server: sends HTTP (evidence: `README.md`)
- Demo activities → Download manager: controls downloads (evidence: `README.md`)
- Download manager → Async HTTP client: starts downloads (evidence: `ThinkAndroid/src/com/ta/util/download/DownloadManager.java`)
- Download manager → File response handler: tracks files (evidence: `ThinkAndroid/src/com/ta/util/download/DownloadManager.java`)
- File response handler → HTTP response handler: extends handler (evidence: `ThinkAndroid/src/com/ta/util/http/FileHttpResponseHandler.java`)
- Demo activities → Configuration: configures settings
- Demo activities → Logging: logs events (evidence: `README.md`)
- Demo activities → Network state: checks connectivity
