├── sample
├── .gitignore
├── src
│ └── main
│ │ ├── res
│ │ ├── values
│ │ │ └── strings.xml
│ │ ├── drawable-hdpi
│ │ │ └── ic_launcher.png
│ │ ├── drawable-mdpi
│ │ │ └── ic_launcher.png
│ │ ├── drawable-xhdpi
│ │ │ └── ic_launcher.png
│ │ ├── drawable-xxhdpi
│ │ │ └── ic_launcher.png
│ │ └── layout
│ │ │ ├── city_state_row.xml
│ │ │ └── main.xml
│ │ ├── java
│ │ └── codemonkeylabs
│ │ │ └── androidzipcodelib
│ │ │ └── sample
│ │ │ ├── ZipcodeSampleApplication.java
│ │ │ └── ZipcodeSample.java
│ │ └── AndroidManifest.xml
├── build.gradle
└── proguard-rules.txt
├── library
├── .gitignore
├── src
│ ├── test
│ │ ├── resources
│ │ │ ├── empty.file
│ │ │ └── .DS_Store
│ │ └── java
│ │ │ └── codemonkeylabs
│ │ │ └── androidzipcodelib
│ │ │ └── library
│ │ │ └── ZipCodeTest.java
│ └── main
│ │ ├── res
│ │ ├── values
│ │ │ └── strings.xml
│ │ ├── raw
│ │ │ └── zipcodesdb
│ │ ├── drawable-hdpi
│ │ │ └── ic_launcher.png
│ │ ├── drawable-mdpi
│ │ │ └── ic_launcher.png
│ │ ├── drawable-xhdpi
│ │ │ └── ic_launcher.png
│ │ └── drawable-xxhdpi
│ │ │ └── ic_launcher.png
│ │ ├── java
│ │ └── codemonkeylabs
│ │ │ └── androidzipcodelib
│ │ │ └── library
│ │ │ ├── ZipcodeListener.java
│ │ │ ├── ZipResult.java
│ │ │ ├── ZipcodeDataSource.java
│ │ │ ├── ZipcodeDatabase.java
│ │ │ ├── ZipcodeUtility.java
│ │ │ ├── AppPreferences.java
│ │ │ └── ZipcodeLib.java
│ │ └── AndroidManifest.xml
├── proguard-rules.txt
└── build.gradle
├── settings.gradle
├── zipcodelibrary.aar
├── gradle
└── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── .gitignore
├── gradle.properties
├── LICENSE
├── README.md
├── gradlew.bat
└── gradlew
/sample/.gitignore:
--------------------------------------------------------------------------------
1 | /build
2 |
--------------------------------------------------------------------------------
/library/.gitignore:
--------------------------------------------------------------------------------
1 | /build
2 |
--------------------------------------------------------------------------------
/library/src/test/resources/empty.file:
--------------------------------------------------------------------------------
1 | o
2 |
--------------------------------------------------------------------------------
/settings.gradle:
--------------------------------------------------------------------------------
1 | include ':sample', ':library'
2 |
--------------------------------------------------------------------------------
/zipcodelibrary.aar:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/brianPlummer/AndroidZipcodeLib/HEAD/zipcodelibrary.aar
--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.jar:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/brianPlummer/AndroidZipcodeLib/HEAD/gradle/wrapper/gradle-wrapper.jar
--------------------------------------------------------------------------------
/library/src/main/res/values/strings.xml:
--------------------------------------------------------------------------------
1 |
2 | AndroidZipcodeLib
3 |
4 |
--------------------------------------------------------------------------------
/sample/src/main/res/values/strings.xml:
--------------------------------------------------------------------------------
1 |
2 | AndroidZipcodeLib
3 |
4 |
--------------------------------------------------------------------------------
/library/src/main/res/raw/zipcodesdb:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/brianPlummer/AndroidZipcodeLib/HEAD/library/src/main/res/raw/zipcodesdb
--------------------------------------------------------------------------------
/library/src/test/resources/.DS_Store:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/brianPlummer/AndroidZipcodeLib/HEAD/library/src/test/resources/.DS_Store
--------------------------------------------------------------------------------
/library/src/main/res/drawable-hdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/brianPlummer/AndroidZipcodeLib/HEAD/library/src/main/res/drawable-hdpi/ic_launcher.png
--------------------------------------------------------------------------------
/library/src/main/res/drawable-mdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/brianPlummer/AndroidZipcodeLib/HEAD/library/src/main/res/drawable-mdpi/ic_launcher.png
--------------------------------------------------------------------------------
/library/src/main/res/drawable-xhdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/brianPlummer/AndroidZipcodeLib/HEAD/library/src/main/res/drawable-xhdpi/ic_launcher.png
--------------------------------------------------------------------------------
/sample/src/main/res/drawable-hdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/brianPlummer/AndroidZipcodeLib/HEAD/sample/src/main/res/drawable-hdpi/ic_launcher.png
--------------------------------------------------------------------------------
/sample/src/main/res/drawable-mdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/brianPlummer/AndroidZipcodeLib/HEAD/sample/src/main/res/drawable-mdpi/ic_launcher.png
--------------------------------------------------------------------------------
/sample/src/main/res/drawable-xhdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/brianPlummer/AndroidZipcodeLib/HEAD/sample/src/main/res/drawable-xhdpi/ic_launcher.png
--------------------------------------------------------------------------------
/sample/src/main/res/drawable-xxhdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/brianPlummer/AndroidZipcodeLib/HEAD/sample/src/main/res/drawable-xxhdpi/ic_launcher.png
--------------------------------------------------------------------------------
/library/src/main/res/drawable-xxhdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/brianPlummer/AndroidZipcodeLib/HEAD/library/src/main/res/drawable-xxhdpi/ic_launcher.png
--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.properties:
--------------------------------------------------------------------------------
1 | #Sat Dec 06 23:15:06 EST 2014
2 | distributionBase=GRADLE_USER_HOME
3 | distributionPath=wrapper/dists
4 | zipStoreBase=GRADLE_USER_HOME
5 | zipStorePath=wrapper/dists
6 | distributionUrl=https\://services.gradle.org/distributions/gradle-2.2-all.zip
7 |
--------------------------------------------------------------------------------
/library/src/main/java/codemonkeylabs/androidzipcodelib/library/ZipcodeListener.java:
--------------------------------------------------------------------------------
1 | package codemonkeylabs.androidzipcodelib.library;
2 |
3 | /**
4 | * Created by brianplummer on 2/17/14.
5 | */
6 | public interface ZipcodeListener {
7 | public void getCitiesAndStateResult(ZipResult zipResult);
8 | }
9 |
--------------------------------------------------------------------------------
/library/src/main/AndroidManifest.xml:
--------------------------------------------------------------------------------
1 |
3 |
4 |
8 |
9 |
10 |
11 |
12 |
--------------------------------------------------------------------------------
/library/src/main/java/codemonkeylabs/androidzipcodelib/library/ZipResult.java:
--------------------------------------------------------------------------------
1 | package codemonkeylabs.androidzipcodelib.library;
2 |
3 | import java.util.ArrayList;
4 |
5 | /**
6 | * Created by brianplummer on 2/17/14.
7 | */
8 | public class ZipResult {
9 | public String state = "";
10 | public ArrayList cities = new ArrayList();
11 | public String zip = "";
12 | }
13 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | # built application files
2 | *.apk
3 | *.ap_
4 |
5 | # files for the dex VM
6 | *.dex
7 |
8 | # Java class files
9 | *.class
10 |
11 | # generated files
12 | bin/
13 | gen/
14 |
15 | # Local configuration file (sdk path, etc)
16 | local.properties
17 |
18 | # Eclipse project files
19 | .classpath
20 | .project
21 |
22 | # Proguard folder generated by Eclipse
23 | proguard/
24 |
25 | # Intellij project files
26 | *.iml
27 | *.ipr
28 | *.iws
29 | .idea/
30 |
--------------------------------------------------------------------------------
/sample/src/main/java/codemonkeylabs/androidzipcodelib/sample/ZipcodeSampleApplication.java:
--------------------------------------------------------------------------------
1 | package codemonkeylabs.androidzipcodelib.sample;
2 |
3 | import android.app.Application;
4 | import codemonkeylabs.androidzipcodelib.library.ZipcodeLib;
5 |
6 |
7 | /**
8 | * Created by brianplummer on 2/17/14.
9 | */
10 | public class ZipcodeSampleApplication extends Application {
11 | @Override
12 | public void onCreate() {
13 | super.onCreate();
14 | ZipcodeLib.init(getApplicationContext());
15 | }
16 | }
17 |
--------------------------------------------------------------------------------
/sample/build.gradle:
--------------------------------------------------------------------------------
1 | buildscript {
2 | repositories {
3 | jcenter()
4 | }
5 | dependencies {
6 | classpath 'com.android.tools.build:gradle:1.3.0'
7 | }
8 | }
9 | apply plugin: 'com.android.application'
10 |
11 | repositories {
12 | jcenter()
13 | }
14 |
15 | android {
16 | compileSdkVersion 23
17 | buildToolsVersion '23.0.2'
18 |
19 | defaultConfig {
20 | minSdkVersion 8
21 | targetSdkVersion 23
22 | versionCode 1
23 | versionName "1.0"
24 | }
25 | }
26 |
27 | dependencies {
28 | compile project(':library')
29 | }
30 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/city_state_row.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
7 |
8 |
9 |
15 |
16 |
--------------------------------------------------------------------------------
/library/proguard-rules.txt:
--------------------------------------------------------------------------------
1 | # Add project specific ProGuard rules here.
2 | # By default, the flags in this file are appended to flags specified
3 | # in /Applications/Android Studio.app/sdk/tools/proguard/proguard-android.txt
4 | # You can edit the include path and order by changing the ProGuard
5 | # include property in project.properties.
6 | #
7 | # For more details, see
8 | # http://developer.android.com/guide/developing/tools/proguard.html
9 |
10 | # Add any project specific keep options here:
11 |
12 | # If your project uses WebView with JS, uncomment the following
13 | # and specify the fully qualified class name to the JavaScript interface
14 | # class:
15 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview {
16 | # public *;
17 | #}
--------------------------------------------------------------------------------
/sample/proguard-rules.txt:
--------------------------------------------------------------------------------
1 | # Add project specific ProGuard rules here.
2 | # By default, the flags in this file are appended to flags specified
3 | # in /Applications/Android Studio.app/sdk/tools/proguard/proguard-android.txt
4 | # You can edit the include path and order by changing the ProGuard
5 | # include property in project.properties.
6 | #
7 | # For more details, see
8 | # http://developer.android.com/guide/developing/tools/proguard.html
9 |
10 | # Add any project specific keep options here:
11 |
12 | # If your project uses WebView with JS, uncomment the following
13 | # and specify the fully qualified class name to the JavaScript interface
14 | # class:
15 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview {
16 | # public *;
17 | #}
--------------------------------------------------------------------------------
/sample/src/main/AndroidManifest.xml:
--------------------------------------------------------------------------------
1 |
3 |
4 |
7 |
8 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
23 |
--------------------------------------------------------------------------------
/gradle.properties:
--------------------------------------------------------------------------------
1 | # Project-wide Gradle settings.
2 |
3 | # IDE (e.g. Android Studio) users:
4 | # Settings specified in this file will override any Gradle settings
5 | # configured through the IDE.
6 |
7 | # For more details on how to configure your build environment visit
8 | # http://www.gradle.org/docs/current/userguide/build_environment.html
9 |
10 | # Specifies the JVM arguments used for the daemon process.
11 | # The setting is particularly useful for tweaking memory settings.
12 | # Default value: -Xmx10248m -XX:MaxPermSize=256m
13 | # org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
14 |
15 | # When configured, Gradle will run in incubating parallel mode.
16 | # This option should only be used with decoupled projects. More details, visit
17 | # http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
18 | # org.gradle.parallel=true
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | The MIT License (MIT)
2 |
3 | Copyright (c) 2014 brianPlummer
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
--------------------------------------------------------------------------------
/library/build.gradle:
--------------------------------------------------------------------------------
1 | buildscript {
2 | repositories {
3 | mavenCentral()
4 | mavenLocal()
5 | jcenter()
6 | }
7 | dependencies {
8 | classpath 'com.android.tools.build:gradle:1.3.0'
9 | }
10 | }
11 |
12 | apply plugin: 'com.android.library'
13 |
14 | android {
15 | compileSdkVersion 23
16 | buildToolsVersion "23.0.2"
17 |
18 | defaultConfig {
19 | testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
20 | minSdkVersion 8
21 | targetSdkVersion 23
22 | versionCode 1
23 | versionName "1.0"
24 | }
25 |
26 | sourceSets {
27 | main {
28 | java.srcDir file('src/main/java')
29 | manifest.srcFile file('src/main/AndroidManifest.xml')
30 | res.srcDir file('src/main/resources')
31 | }
32 | androidTest {
33 | setRoot('src/test')
34 | }
35 | }
36 | }
37 |
38 | dependencies {
39 | testCompile 'junit:junit:4.12'
40 | testCompile 'org.apache.commons:commons-io:1.3.2'
41 | androidTestCompile('com.android.support.test:runner:0.3') {
42 | exclude group: 'com.android.support', module: 'support-annotations'
43 | }
44 | }
45 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/main.xml:
--------------------------------------------------------------------------------
1 |
2 |
6 |
7 |
8 |
20 |
21 |
22 |
30 |
31 |
32 |
33 |
34 |
--------------------------------------------------------------------------------
/library/src/main/java/codemonkeylabs/androidzipcodelib/library/ZipcodeDataSource.java:
--------------------------------------------------------------------------------
1 | package codemonkeylabs.androidzipcodelib.library;
2 |
3 | import android.database.Cursor;
4 | import android.database.sqlite.SQLiteDatabase;
5 |
6 | import java.util.ArrayList;
7 |
8 | /**
9 | * Created by brianplummer on 2/17/14.
10 | */
11 | public class ZipcodeDataSource {
12 |
13 | public static ZipResult getValue(String zip, SQLiteDatabase database) {
14 |
15 | Cursor cursor = database.rawQuery("select * from zipcodes where zipcode = \'" + zip + "\' LIMIT 1", null);
16 | boolean result = cursor.moveToFirst();
17 |
18 | if (!result) {
19 | cursor.close();
20 | return null;
21 | }
22 |
23 | String zipDB = cursor.getString(0);
24 | String state = cursor.getString(1);
25 | String primaryCity = cursor.getString(2);
26 |
27 | Cursor cities = database.rawQuery("select * from cities where parent_id = \'" + zipDB + "\'", null);
28 |
29 | ArrayList holder = new ArrayList();
30 | boolean resultCities = cities.moveToFirst();
31 |
32 | if (resultCities) {
33 | String cit = cities.getString(1);
34 | holder.add(cit);
35 | while (cities.moveToNext()) {
36 | cit = cities.getString(1);
37 | holder.add(cit);
38 | }
39 | }
40 |
41 | ZipResult ret = new ZipResult();
42 | ret.state = state;
43 | ret.zip = zip;
44 | ret.cities.add(primaryCity);
45 | for (int r = 0; r < holder.size(); r++) {
46 | ret.cities.add(holder.get(r));
47 | }
48 | cursor.close();
49 | cities.close();
50 |
51 | return ret;
52 | }
53 |
54 | }
55 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | [](https://android-arsenal.com/details/1/2820)
2 |
3 | # AndroidZipcodeLib
4 |
5 | This is a simple library that resolves U.S. postal zip codes to the appropriate City/State. This can used for onboarding and ecommerce to help improve user experience by reducing the number of fields that the user must enter. The memory footprint to include this library is around ~730KB.
6 |
7 | There is a sample application that is included that illustrates the basic use of this library.
8 |
9 | ZipcodeLib.getCitiesAndStateThenDestroy() -- returns results synchronously, don't call on UI thread
10 |
11 | ZipcodeLib.getCitiesAndStateAsyncThenDestroy() -- returns results asynchronously and returns the results via a passed in listener.
12 |
13 | ### Advanced Usage:
14 |
15 | The library contains a compressed zip code database that is extracted and queried against. The above functions getCitiesAndStateThenDestroy() and getCitiesAndStateAsyncThenDestroy() destroy the extracted database once queried. The uncompressed database is around 1.4MB and combined with the compressed version causes a footprint of around 2.1MB. The library also allows you to control this and explicitly initialize and destroy the database if you wish to query it multiple times without destroying it.
16 |
17 | ZipcodeLib.getCitiesAndState() and ZipcodeLib.getCitiesAndStateAsync() will both leave the extracted database intact after querying. If the database is not extracted then any of the above methods will do this automatically.
18 |
19 | ZipcodeLib.init() -- extract the database upfront manually
20 |
21 | ZipcodeLib.destroy() -- deletes the extracted database
22 |
23 |
--------------------------------------------------------------------------------
/library/src/main/java/codemonkeylabs/androidzipcodelib/library/ZipcodeDatabase.java:
--------------------------------------------------------------------------------
1 | package codemonkeylabs.androidzipcodelib.library;
2 |
3 | import android.content.Context;
4 | import android.database.sqlite.SQLiteDatabase;
5 | import android.database.sqlite.SQLiteOpenHelper;
6 | import android.util.Log;
7 |
8 | /**
9 | * Created by brianplummer on 2/17/14.
10 | */
11 | public class ZipcodeDatabase extends SQLiteOpenHelper {
12 | protected static final String TABLE_ZIPCODES = "zipcodes";
13 | protected static final String COLUMN_ZIP = "zipcode", COLUMN_STATE = "state", COLUMN_CITY = "city";
14 | protected static final String TABLE_CITIES = "cities", PARENT_ID = "parent_id", CITY = "CITY";
15 |
16 | private static final int DATABASE_VERSION = 1;
17 |
18 | // Database creation sql statement
19 | private static final String zip_create = "create table "
20 | + TABLE_ZIPCODES + "(" + COLUMN_ZIP
21 | + " text not null, " + COLUMN_STATE + " text not null,"+ COLUMN_CITY + " text not null); ";
22 |
23 | private static final String city_create = " create table " + TABLE_CITIES + "(" +
24 | PARENT_ID + " text not null, "
25 | + CITY + " text not null);";
26 |
27 | protected ZipcodeDatabase(Context context) {
28 | super(context, ZipcodeLib.db, null, DATABASE_VERSION);
29 | }
30 |
31 | @Override
32 | public void onCreate(SQLiteDatabase database) {
33 | database.execSQL(zip_create);
34 | database.execSQL(city_create);
35 | }
36 |
37 | @Override
38 | public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
39 | Log.w(ZipcodeDatabase.class.getName(),
40 | "Upgrading database from version " + oldVersion + " to "
41 | + newVersion + ", which will destroy all old data");
42 | db.execSQL("DROP TABLE IF EXISTS " + TABLE_ZIPCODES);
43 | onCreate(db);
44 | }
45 | }
46 |
--------------------------------------------------------------------------------
/library/src/test/java/codemonkeylabs/androidzipcodelib/library/ZipCodeTest.java:
--------------------------------------------------------------------------------
1 | package codemonkeylabs.androidzipcodelib.library;
2 |
3 | import android.database.sqlite.SQLiteDatabase;
4 |
5 | import org.junit.After;
6 | import org.junit.Before;
7 | import org.junit.Test;
8 | import org.junit.runner.RunWith;
9 |
10 | import android.support.test.InstrumentationRegistry;
11 | import android.support.test.runner.AndroidJUnit4;
12 |
13 | import java.io.File;
14 |
15 | import static junit.framework.Assert.assertTrue;
16 |
17 | /**
18 | * Created by brianplummer on 10/6/14.
19 | */
20 | @RunWith(AndroidJUnit4.class)
21 | public class ZipCodeTest
22 | {
23 |
24 | private SQLiteDatabase zipCodeDatabase;
25 | private File dbFile;
26 |
27 | @Before
28 | public void setUp() throws Exception
29 | {
30 |
31 | File dbDir = ZipcodeUtility.getAndroidDBDir(InstrumentationRegistry.getInstrumentation().getTargetContext());
32 | ZipcodeUtility.copyDatabase(InstrumentationRegistry.getInstrumentation().getTargetContext(),
33 | dbDir);
34 |
35 | this.dbFile = new File(dbDir, ZipcodeLib.db);
36 | assertTrue(dbFile.exists());
37 |
38 | this.zipCodeDatabase = SQLiteDatabase.openDatabase(this.dbFile.getPath(),
39 | null,
40 | SQLiteDatabase.OPEN_READONLY);
41 |
42 | assertTrue(zipCodeDatabase.isOpen());
43 | }
44 |
45 | @After
46 | public void tearDown()
47 | {
48 | if(this.zipCodeDatabase != null && this.zipCodeDatabase.isOpen())
49 | {
50 | this.zipCodeDatabase.close();
51 | }
52 |
53 | if(this.dbFile.exists())
54 | {
55 | this.dbFile.delete();
56 | }
57 | }
58 |
59 | @Test
60 | public void basicTest()
61 | {
62 | ZipResult zipResult = ZipcodeDataSource.getValue("30120", this.zipCodeDatabase);
63 | assertTrue(zipResult.state.equalsIgnoreCase("GA"));
64 | }
65 |
66 | }
67 |
--------------------------------------------------------------------------------
/library/src/main/java/codemonkeylabs/androidzipcodelib/library/ZipcodeUtility.java:
--------------------------------------------------------------------------------
1 | package codemonkeylabs.androidzipcodelib.library;
2 |
3 | import android.content.Context;
4 | import android.os.Environment;
5 | import android.util.Log;
6 |
7 | import java.io.File;
8 | import java.io.FileOutputStream;
9 | import java.io.IOException;
10 | import java.util.zip.GZIPInputStream;
11 |
12 | /**
13 | * Created by brianplummer on 2/17/14.
14 | */
15 | public class ZipcodeUtility {
16 |
17 | protected static final String TAG = "ZipcodeUtility";
18 |
19 | protected static boolean copyDatabase(Context context, File dbdir)
20 | {
21 | GZIPInputStream gis = null;
22 | FileOutputStream fos = null;
23 | boolean success = false;
24 | try {
25 | gis = new GZIPInputStream(context.getResources().openRawResource(R.raw.zipcodesdb));
26 |
27 | if(!dbdir.exists()){
28 | Log.e(TAG, "DB dir is false");
29 | boolean create = dbdir.mkdir();
30 | if(!create)
31 | return false;
32 | }
33 |
34 | File outputFile = new File(dbdir, ZipcodeLib.db);
35 | Log.e(TAG, "DB dir is true");
36 |
37 | fos = new FileOutputStream(outputFile);
38 | byte[] buffer = new byte[4096];
39 | int count = 0;
40 | while( (count = gis.read(buffer)) > 0)
41 | {
42 | fos.write(buffer,0,count);
43 | }
44 | fos.flush();
45 | success = true;
46 | } catch (IOException e) {
47 | Log.e(TAG, e.getMessage(), e);
48 | }finally {
49 | if(gis != null)
50 | try {
51 | gis.close();
52 | } catch (IOException e) {
53 | Log.e(TAG, e.getMessage(), e);
54 | }
55 | if(fos != null)
56 | try {
57 | fos.close();
58 | } catch (IOException e) {
59 | Log.e(TAG, e.getMessage(), e);
60 | }
61 | }
62 | return success;
63 | }
64 |
65 |
66 | protected static boolean destroyDatabase(Context context)
67 | {
68 | boolean success = false;
69 | File dbdir = getAndroidDBDir(context);
70 | File dbFile = new File(dbdir, ZipcodeLib.db);
71 | if (dbFile.exists())
72 | success = dbFile.delete();
73 | return success;
74 | }
75 |
76 | protected static File getAndroidDBDir(Context context){
77 | return new File(Environment.getDataDirectory(), "//data//" + context.getPackageName() + "//databases//");
78 | }
79 |
80 | }
81 |
--------------------------------------------------------------------------------
/gradlew.bat:
--------------------------------------------------------------------------------
1 | @if "%DEBUG%" == "" @echo off
2 | @rem ##########################################################################
3 | @rem
4 | @rem Gradle startup script for Windows
5 | @rem
6 | @rem ##########################################################################
7 |
8 | @rem Set local scope for the variables with windows NT shell
9 | if "%OS%"=="Windows_NT" setlocal
10 |
11 | @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
12 | set DEFAULT_JVM_OPTS=
13 |
14 | set DIRNAME=%~dp0
15 | if "%DIRNAME%" == "" set DIRNAME=.
16 | set APP_BASE_NAME=%~n0
17 | set APP_HOME=%DIRNAME%
18 |
19 | @rem Find java.exe
20 | if defined JAVA_HOME goto findJavaFromJavaHome
21 |
22 | set JAVA_EXE=java.exe
23 | %JAVA_EXE% -version >NUL 2>&1
24 | if "%ERRORLEVEL%" == "0" goto init
25 |
26 | echo.
27 | echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
28 | echo.
29 | echo Please set the JAVA_HOME variable in your environment to match the
30 | echo location of your Java installation.
31 |
32 | goto fail
33 |
34 | :findJavaFromJavaHome
35 | set JAVA_HOME=%JAVA_HOME:"=%
36 | set JAVA_EXE=%JAVA_HOME%/bin/java.exe
37 |
38 | if exist "%JAVA_EXE%" goto init
39 |
40 | echo.
41 | echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
42 | echo.
43 | echo Please set the JAVA_HOME variable in your environment to match the
44 | echo location of your Java installation.
45 |
46 | goto fail
47 |
48 | :init
49 | @rem Get command-line arguments, handling Windowz variants
50 |
51 | if not "%OS%" == "Windows_NT" goto win9xME_args
52 | if "%@eval[2+2]" == "4" goto 4NT_args
53 |
54 | :win9xME_args
55 | @rem Slurp the command line arguments.
56 | set CMD_LINE_ARGS=
57 | set _SKIP=2
58 |
59 | :win9xME_args_slurp
60 | if "x%~1" == "x" goto execute
61 |
62 | set CMD_LINE_ARGS=%*
63 | goto execute
64 |
65 | :4NT_args
66 | @rem Get arguments from the 4NT Shell from JP Software
67 | set CMD_LINE_ARGS=%$
68 |
69 | :execute
70 | @rem Setup the command line
71 |
72 | set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
73 |
74 | @rem Execute Gradle
75 | "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS%
76 |
77 | :end
78 | @rem End local scope for the variables with windows NT shell
79 | if "%ERRORLEVEL%"=="0" goto mainEnd
80 |
81 | :fail
82 | rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
83 | rem the _cmd.exe /c_ return code!
84 | if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
85 | exit /b 1
86 |
87 | :mainEnd
88 | if "%OS%"=="Windows_NT" endlocal
89 |
90 | :omega
91 |
--------------------------------------------------------------------------------
/library/src/main/java/codemonkeylabs/androidzipcodelib/library/AppPreferences.java:
--------------------------------------------------------------------------------
1 | package codemonkeylabs.androidzipcodelib.library;
2 |
3 | import android.annotation.SuppressLint;
4 | import android.annotation.TargetApi;
5 | import android.content.Context;
6 | import android.content.SharedPreferences;
7 | import android.os.Build;
8 | import android.preference.PreferenceManager;
9 |
10 | /**
11 | * Created by brianplummer on 2/17/14.
12 | */
13 | public class AppPreferences {
14 |
15 | private static AppPreferences INSTANCE;
16 | private final SharedPreferences mSp;
17 |
18 | protected static synchronized AppPreferences getInstance(Context context) {
19 | if(INSTANCE == null)
20 | {
21 | INSTANCE = new AppPreferences(context);
22 | }
23 | return INSTANCE;
24 | }
25 |
26 | private AppPreferences(Context context)
27 | {
28 | mSp = PreferenceManager.getDefaultSharedPreferences(context);
29 | }
30 |
31 | @SuppressLint("CommitPrefEdits")
32 | private void applyPreference(String key, float value) {
33 | SharedPreferences.Editor editor = mSp.edit();
34 | editor.putFloat(key, value);
35 | editorApply(editor);
36 | }
37 |
38 | @SuppressLint("CommitPrefEdits")
39 | private void applyPreference(String key, String value) {
40 | SharedPreferences.Editor editor = mSp.edit();
41 | editor.putString(key, value);
42 | editorApply(editor);
43 | }
44 |
45 | @SuppressLint("CommitPrefEdits")
46 | private void applyPreference(String key, boolean value) {
47 | SharedPreferences.Editor editor = mSp.edit();
48 | editor.putBoolean(key, value);
49 | editorApply(editor);
50 | }
51 |
52 | @SuppressLint("CommitPrefEdits")
53 | private void applyPreference(String key, int value) {
54 | SharedPreferences.Editor editor = mSp.edit();
55 | editor.putInt(key, value);
56 | editorApply(editor);
57 | }
58 |
59 | @SuppressLint("CommitPrefEdits")
60 | private void applyPreference(String key, long value) {
61 | SharedPreferences.Editor editor = mSp.edit();
62 | editor.putLong(key, value);
63 | editorApply(editor);
64 | }
65 |
66 | protected static final String IS_LOADED = "is_loaded";
67 |
68 | protected boolean isLoaded(){
69 | return mSp.getBoolean(IS_LOADED, false);
70 | }
71 | protected void setIsLoaded(){
72 | applyPreference(IS_LOADED,true);
73 | }
74 |
75 | protected void setIsLoadedFalse(){
76 | applyPreference(IS_LOADED,false);
77 | }
78 |
79 | private static final boolean USE_APPLY = Build.VERSION.SDK_INT >= Build.VERSION_CODES.GINGERBREAD;
80 |
81 | /**
82 | * {@link android.content.SharedPreferences.Editor#apply()} is quicker than
83 | * {@link android.content.SharedPreferences.Editor#commit()} which wouldn't matter except that writing to
84 | * preferences is IO which we want to minimize as much as possible
85 | * @param editor
86 | */
87 | @TargetApi(Build.VERSION_CODES.GINGERBREAD)
88 | private static void editorApply(SharedPreferences.Editor editor)
89 | {
90 | if(USE_APPLY) {
91 | editor.apply();
92 | } else {
93 | editor.commit();
94 | }
95 | }
96 |
97 | protected SharedPreferences getPrefs() {
98 | return mSp;
99 | }
100 | }
101 |
--------------------------------------------------------------------------------
/sample/src/main/java/codemonkeylabs/androidzipcodelib/sample/ZipcodeSample.java:
--------------------------------------------------------------------------------
1 | package codemonkeylabs.androidzipcodelib.sample;
2 |
3 | import android.app.Activity;
4 | import android.os.AsyncTask;
5 | import android.os.Bundle;
6 | import android.text.Editable;
7 | import android.text.TextWatcher;
8 | import android.view.LayoutInflater;
9 | import android.view.View;
10 | import android.view.ViewGroup;
11 | import android.widget.EditText;
12 | import android.widget.TextView;
13 | import android.widget.Toast;
14 |
15 | import codemonkeylabs.androidzipcodelib.library.ZipResult;
16 | import codemonkeylabs.androidzipcodelib.library.ZipcodeLib;
17 | import codemonkeylabs.androidzipcodelib.library.ZipcodeListener;
18 |
19 | public class ZipcodeSample extends Activity {
20 |
21 | protected EditText zipCode = null;
22 | protected ViewGroup container = null;
23 | protected LayoutInflater layoutInflater = null;
24 |
25 | @Override
26 | public void onCreate(Bundle savedInstanceState)
27 | {
28 | super.onCreate(savedInstanceState);
29 | setContentView(R.layout.main);
30 | wireUi();
31 | }
32 |
33 | protected void wireUi()
34 | {
35 | this.zipCode = (EditText)findViewById(R.id.zipCode);
36 | this.container = (ViewGroup)findViewById(R.id.container);
37 |
38 | layoutInflater = (LayoutInflater)getSystemService(LAYOUT_INFLATER_SERVICE);
39 |
40 | this.zipCode.addTextChangedListener(new TextWatcher() {
41 | @Override
42 | public void beforeTextChanged(CharSequence charSequence, int i, int i2, int i3) {
43 | }
44 | @Override
45 | public void onTextChanged(CharSequence charSequence, int i, int i2, int i3) {
46 | }
47 | @Override
48 | public void afterTextChanged(Editable editable) {
49 | if(editable.toString().length() == 5)
50 | getStateAndZip(editable.toString());
51 | }
52 | });
53 |
54 | }
55 |
56 | public void getStateAndZip(final String zipcodeStr)
57 | {
58 | new AsyncTask