├── .gitignore
├── .idea
├── .name
├── codeStyleSettings.xml
├── compiler.xml
├── copyright
│ └── profiles_settings.xml
├── gradle.xml
├── inspectionProfiles
│ ├── Project_Default.xml
│ └── profiles_settings.xml
├── misc.xml
├── modules.xml
├── uiDesigner.xml
└── vcs.xml
├── Persistence.iml
├── README.md
├── app
├── .gitignore
├── app.iml
├── build.gradle
├── proguard-rules.pro
└── src
│ ├── androidTest
│ └── java
│ │ └── com
│ │ └── codepath
│ │ └── persistencedemo
│ │ └── ApplicationTest.java
│ └── main
│ ├── AndroidManifest.xml
│ ├── java
│ └── com
│ │ └── codepath
│ │ └── persistencedemo
│ │ ├── activities
│ │ └── MainActivity.java
│ │ ├── adapters
│ │ └── InstagramPostsAdapter.java
│ │ ├── core
│ │ └── MainApplication.java
│ │ ├── helpers
│ │ └── Utils.java
│ │ ├── models
│ │ ├── InstagramPost.java
│ │ └── InstagramUser.java
│ │ ├── networking
│ │ └── InstagramClient.java
│ │ └── persistence
│ │ └── InstagramClientDatabase.java
│ └── res
│ ├── drawable
│ └── gray_oval.xml
│ ├── layout
│ ├── activity_main.xml
│ └── layout_item_post.xml
│ ├── menu
│ └── menu_main.xml
│ ├── mipmap-hdpi
│ └── ic_launcher.png
│ ├── mipmap-mdpi
│ └── ic_launcher.png
│ ├── mipmap-xhdpi
│ └── ic_launcher.png
│ ├── mipmap-xxhdpi
│ └── ic_launcher.png
│ ├── values-w820dp
│ └── dimens.xml
│ └── values
│ ├── colors.xml
│ ├── dimens.xml
│ ├── strings.xml
│ └── styles.xml
├── build.gradle
├── gradle.properties
├── gradle
└── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
└── settings.gradle
/.gitignore:
--------------------------------------------------------------------------------
1 | .gradle
2 | /local.properties
3 | /.idea/workspace.xml
4 | /.idea/libraries
5 | .DS_Store
6 | /build
7 |
--------------------------------------------------------------------------------
/.idea/.name:
--------------------------------------------------------------------------------
1 | PersistenceDemo
--------------------------------------------------------------------------------
/.idea/codeStyleSettings.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
11 |
12 |
13 |
--------------------------------------------------------------------------------
/.idea/compiler.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
--------------------------------------------------------------------------------
/.idea/copyright/profiles_settings.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
--------------------------------------------------------------------------------
/.idea/gradle.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
--------------------------------------------------------------------------------
/.idea/inspectionProfiles/Project_Default.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |
--------------------------------------------------------------------------------
/.idea/inspectionProfiles/profiles_settings.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
--------------------------------------------------------------------------------
/.idea/misc.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
23 |
24 |
25 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
35 |
36 |
37 |
38 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
46 |
47 |
48 |
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 |
63 |
64 |
65 |
66 |
67 |
68 |
69 |
70 |
71 |
72 |
73 |
74 |
75 |
76 |
77 |
78 |
79 |
80 |
81 |
82 | Android API 22 Platform
83 |
84 |
85 |
86 |
87 |
88 |
89 |
90 |
91 |
92 |
93 |
94 | 1.8
95 |
96 |
97 |
98 |
99 |
100 |
101 |
102 |
103 |
104 |
105 |
106 |
107 |
108 |
109 |
110 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
--------------------------------------------------------------------------------
/.idea/modules.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/.idea/uiDesigner.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | -
6 |
7 |
8 | -
9 |
10 |
11 | -
12 |
13 |
14 | -
15 |
16 |
17 | -
18 |
19 |
20 |
21 |
22 |
23 | -
24 |
25 |
26 |
27 |
28 |
29 | -
30 |
31 |
32 |
33 |
34 |
35 | -
36 |
37 |
38 |
39 |
40 |
41 | -
42 |
43 |
44 |
45 |
46 | -
47 |
48 |
49 |
50 |
51 | -
52 |
53 |
54 |
55 |
56 | -
57 |
58 |
59 |
60 |
61 | -
62 |
63 |
64 |
65 |
66 | -
67 |
68 |
69 |
70 |
71 | -
72 |
73 |
74 | -
75 |
76 |
77 |
78 |
79 | -
80 |
81 |
82 |
83 |
84 | -
85 |
86 |
87 |
88 |
89 | -
90 |
91 |
92 |
93 |
94 | -
95 |
96 |
97 |
98 |
99 | -
100 |
101 |
102 | -
103 |
104 |
105 | -
106 |
107 |
108 | -
109 |
110 |
111 | -
112 |
113 |
114 |
115 |
116 | -
117 |
118 |
119 | -
120 |
121 |
122 |
123 |
124 |
--------------------------------------------------------------------------------
/.idea/vcs.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
--------------------------------------------------------------------------------
/Persistence.iml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # android-instagram-persistence
2 |
3 | Starter project for SQLite persistence workshop:
4 | * When network is available, get data from Instagram API
5 | * When network is NOT available, get data from SQLite (to be implemented)
6 | * 
7 |
--------------------------------------------------------------------------------
/app/.gitignore:
--------------------------------------------------------------------------------
1 | /build
2 |
--------------------------------------------------------------------------------
/app/app.iml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
23 |
24 |
25 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
35 |
36 |
37 |
38 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
46 |
47 |
48 |
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 |
63 |
64 |
65 |
66 |
67 |
68 |
69 |
70 |
71 |
72 |
73 |
74 |
75 |
76 |
77 |
78 |
79 |
80 |
81 |
82 |
83 |
84 |
85 |
86 |
87 |
88 |
89 |
90 |
91 |
92 |
93 |
94 |
95 |
96 |
97 |
98 |
99 |
100 |
101 |
--------------------------------------------------------------------------------
/app/build.gradle:
--------------------------------------------------------------------------------
1 | buildscript {
2 | repositories {
3 | jcenter()
4 | }
5 | dependencies {
6 | classpath 'com.android.tools.build:gradle:1.1.1'
7 | }
8 | }
9 | apply plugin: 'com.android.application'
10 |
11 | repositories {
12 | jcenter()
13 | }
14 |
15 | android {
16 | compileSdkVersion 22
17 | buildToolsVersion "22.0.1"
18 |
19 | defaultConfig {
20 | applicationId "com.codepath.persistencedemo"
21 | minSdkVersion 16
22 | targetSdkVersion 22
23 | versionCode 1
24 | versionName "1.0"
25 | }
26 | buildTypes {
27 | release {
28 | minifyEnabled false
29 | proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
30 | }
31 | }
32 | }
33 |
34 | dependencies {
35 | compile fileTree(dir: 'libs', include: ['*.jar'])
36 | compile 'com.android.support:appcompat-v7:22.2.0'
37 | compile 'com.android.support:support-v4:22.2.0'
38 | compile 'com.android.support:design:22.2.0'
39 | compile 'com.android.support:recyclerview-v7:21.0.0'
40 | compile 'com.facebook.fresco:fresco:0.5.2'
41 | compile 'com.loopj.android:android-async-http:1.4.7'
42 | }
43 |
--------------------------------------------------------------------------------
/app/proguard-rules.pro:
--------------------------------------------------------------------------------
1 | # Add project specific ProGuard rules here.
2 | # By default, the flags in this file are appended to flags specified
3 | # in /opt/android_sdk/tools/proguard/proguard-android.txt
4 | # You can edit the include path and order by changing the proguardFiles
5 | # directive in build.gradle.
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 | #}
18 |
--------------------------------------------------------------------------------
/app/src/androidTest/java/com/codepath/persistencedemo/ApplicationTest.java:
--------------------------------------------------------------------------------
1 | package com.codepath.persistencedemo;
2 |
3 | import android.app.Application;
4 | import android.test.ApplicationTestCase;
5 |
6 | /**
7 | * Testing Fundamentals
8 | */
9 | public class ApplicationTest extends ApplicationTestCase {
10 | public ApplicationTest() {
11 | super(Application.class);
12 | }
13 | }
--------------------------------------------------------------------------------
/app/src/main/AndroidManifest.xml:
--------------------------------------------------------------------------------
1 |
2 |
4 |
5 |
6 |
7 |
8 |
9 |
15 |
18 |
19 |
20 |
21 |
22 |
23 |
24 |
25 |
26 |
27 |
--------------------------------------------------------------------------------
/app/src/main/java/com/codepath/persistencedemo/activities/MainActivity.java:
--------------------------------------------------------------------------------
1 | package com.codepath.persistencedemo.activities;
2 |
3 | import android.content.Context;
4 | import android.net.ConnectivityManager;
5 | import android.net.NetworkInfo;
6 | import android.os.Bundle;
7 | import android.support.v7.app.AppCompatActivity;
8 | import android.support.v7.widget.LinearLayoutManager;
9 | import android.support.v7.widget.RecyclerView;
10 | import android.util.Log;
11 | import android.widget.Toast;
12 |
13 | import com.codepath.persistencedemo.R;
14 | import com.codepath.persistencedemo.adapters.InstagramPostsAdapter;
15 | import com.codepath.persistencedemo.helpers.Utils;
16 | import com.codepath.persistencedemo.models.InstagramPost;
17 | import com.codepath.persistencedemo.networking.InstagramClient;
18 | import com.loopj.android.http.JsonHttpResponseHandler;
19 |
20 | import org.apache.http.Header;
21 | import org.json.JSONObject;
22 |
23 | import java.util.ArrayList;
24 | import java.util.List;
25 |
26 | public class MainActivity extends AppCompatActivity {
27 | private static final String TAG = "MainActivity";
28 |
29 | private List posts;
30 | private InstagramPostsAdapter postsAdapter;
31 |
32 | RecyclerView rvInstagramPosts;
33 |
34 | @Override
35 | protected void onCreate(Bundle savedInstanceState) {
36 | super.onCreate(savedInstanceState);
37 | setContentView(R.layout.activity_main);
38 | rvInstagramPosts = (RecyclerView) findViewById(R.id.rvInstagramPosts);
39 |
40 | RecyclerView.LayoutManager layoutManager = new LinearLayoutManager(this,
41 | LinearLayoutManager.VERTICAL, false);
42 | rvInstagramPosts.setLayoutManager(layoutManager);
43 |
44 | posts = new ArrayList<>();
45 | postsAdapter = new InstagramPostsAdapter(posts);
46 |
47 | rvInstagramPosts.setAdapter(postsAdapter);
48 | fetchPopularPosts();
49 | }
50 |
51 | private void fetchPopularPosts() {
52 | if (isNetworkAvailable()) {
53 | Toast.makeText(this, getString(R.string.network_available_toast), Toast.LENGTH_LONG).show();
54 | fetchPopularPostsFromInstagramApi();
55 | } else {
56 | // TODO: Implement the offline scenario
57 | }
58 | }
59 |
60 | private void fetchPopularPostsFromInstagramApi() {
61 | InstagramClient.getPopularPosts(new JsonHttpResponseHandler() {
62 |
63 | @Override
64 | public void onSuccess(int statusCode, Header[] headers, JSONObject response) {
65 | posts.clear();
66 | List newPosts = Utils.decodePostsFromJsonResponse(response);
67 | posts.addAll(newPosts);
68 | postsAdapter.notifyDataSetChanged();
69 | }
70 |
71 | @Override
72 | public void onFailure(int statusCode, Header[] headers, Throwable throwable, JSONObject errorResponse) {
73 | Log.d(TAG, "Network error when fetching popular posts");
74 | throwable.printStackTrace();
75 | }
76 | });
77 | }
78 |
79 | private boolean isNetworkAvailable() {
80 | ConnectivityManager connectivityManager
81 | = (ConnectivityManager) getSystemService(Context.CONNECTIVITY_SERVICE);
82 | NetworkInfo activeNetworkInfo = connectivityManager.getActiveNetworkInfo();
83 | return activeNetworkInfo != null && activeNetworkInfo.isConnectedOrConnecting();
84 | }
85 | }
86 |
--------------------------------------------------------------------------------
/app/src/main/java/com/codepath/persistencedemo/adapters/InstagramPostsAdapter.java:
--------------------------------------------------------------------------------
1 | package com.codepath.persistencedemo.adapters;
2 |
3 | import android.net.Uri;
4 | import android.support.v7.widget.RecyclerView;
5 | import android.text.format.DateUtils;
6 | import android.view.LayoutInflater;
7 | import android.view.View;
8 | import android.view.ViewGroup;
9 | import android.widget.TextView;
10 | import com.codepath.persistencedemo.R;
11 | import com.codepath.persistencedemo.models.InstagramPost;
12 | import com.facebook.drawee.view.SimpleDraweeView;
13 |
14 | import java.util.ArrayList;
15 | import java.util.List;
16 |
17 | public class InstagramPostsAdapter extends RecyclerView.Adapter {
18 | private static final String TAG = "InstagramPostsAdapter";
19 |
20 | private List posts;
21 |
22 | public InstagramPostsAdapter(List posts) {
23 | this.posts = (posts == null ? new ArrayList() : posts);
24 | }
25 |
26 | @Override
27 | public PostItemViewHolder onCreateViewHolder(ViewGroup viewGroup, int position) {
28 | View itemView = LayoutInflater.from(viewGroup.getContext()).inflate(R.layout.layout_item_post, viewGroup, false);
29 | return new PostItemViewHolder(itemView);
30 | }
31 |
32 | @Override
33 | public void onBindViewHolder(PostItemViewHolder postItemViewHolder, int position) {
34 | final InstagramPost instagramPost = posts.get(position);
35 |
36 | postItemViewHolder.tvUserName.setText(instagramPost.user.userName);
37 | postItemViewHolder.tvRelativeTimestamp.setText(
38 | DateUtils.getRelativeTimeSpanString(instagramPost.createdTime * 1000,
39 | System.currentTimeMillis(), DateUtils.SECOND_IN_MILLIS));
40 |
41 | // Reset image view
42 | postItemViewHolder.sdvProfileImage.setImageURI(null);
43 |
44 | Uri profilePictureUri = Uri.parse(instagramPost.user.profilePictureUrl);
45 | postItemViewHolder.sdvProfileImage.setImageURI(profilePictureUri);
46 | }
47 |
48 | @Override
49 | public int getItemCount() {
50 | return posts == null ? 0 : posts.size();
51 | }
52 |
53 | public static final class PostItemViewHolder extends RecyclerView.ViewHolder {
54 | TextView tvUserName;
55 | TextView tvRelativeTimestamp;
56 | SimpleDraweeView sdvProfileImage;
57 |
58 | public PostItemViewHolder(View itemView) {
59 | super(itemView);
60 |
61 | tvUserName = (TextView) itemView.findViewById(R.id.tvUserName);
62 | tvRelativeTimestamp = (TextView) itemView.findViewById(R.id.tvRelativeTimestamp);
63 | sdvProfileImage = (SimpleDraweeView) itemView.findViewById(R.id.sdvProfileImage);
64 | }
65 | }
66 | }
67 |
--------------------------------------------------------------------------------
/app/src/main/java/com/codepath/persistencedemo/core/MainApplication.java:
--------------------------------------------------------------------------------
1 | package com.codepath.persistencedemo.core;
2 |
3 | import android.app.Application;
4 | import com.facebook.drawee.backends.pipeline.Fresco;
5 |
6 | public class MainApplication extends Application {
7 | private static final String TAG = "MainApplication";
8 | private static MainApplication instance;
9 |
10 | public static MainApplication sharedApplication() {
11 | assert(instance != null);
12 | return instance;
13 | }
14 |
15 | @Override
16 | public void onCreate() {
17 | instance = this;
18 | super.onCreate();
19 | Fresco.initialize(this);
20 | }
21 | }
22 |
--------------------------------------------------------------------------------
/app/src/main/java/com/codepath/persistencedemo/helpers/Utils.java:
--------------------------------------------------------------------------------
1 | package com.codepath.persistencedemo.helpers;
2 |
3 | import com.codepath.persistencedemo.models.InstagramPost;
4 | import org.json.JSONArray;
5 | import org.json.JSONObject;
6 |
7 | import java.util.ArrayList;
8 | import java.util.List;
9 |
10 | public class Utils {
11 | private static final String TAG = "Utils";
12 |
13 | public static List decodePostsFromJsonResponse(JSONObject jsonObject) {
14 | List posts = InstagramPost.fromJson(getDataJsonArray(jsonObject));
15 | return posts == null ? new ArrayList() : posts;
16 | }
17 |
18 | private static JSONArray getDataJsonArray(JSONObject jsonObject) {
19 | JSONArray jsonArray = null;
20 | if (jsonObject != null) {
21 | jsonArray = jsonObject.optJSONArray("data");
22 | }
23 | return jsonArray;
24 | }
25 | }
26 |
--------------------------------------------------------------------------------
/app/src/main/java/com/codepath/persistencedemo/models/InstagramPost.java:
--------------------------------------------------------------------------------
1 | package com.codepath.persistencedemo.models;
2 |
3 | import org.json.JSONArray;
4 | import org.json.JSONException;
5 | import org.json.JSONObject;
6 |
7 | import java.io.Serializable;
8 | import java.util.ArrayList;
9 | import java.util.List;
10 |
11 | public class InstagramPost implements Serializable {
12 | public InstagramUser user;
13 | public long createdTime;
14 |
15 | public static InstagramPost fromJson(JSONObject jsonObject) {
16 | if (jsonObject == null) {
17 | return null;
18 | }
19 |
20 | InstagramPost post = new InstagramPost();
21 |
22 | try {
23 | post.user = InstagramUser.fromJson(jsonObject.getJSONObject("user"));
24 | post.createdTime = jsonObject.getLong("created_time");
25 | } catch (JSONException e) {
26 | e.printStackTrace();
27 | return null;
28 | }
29 | return post;
30 | }
31 |
32 | public static List fromJson(JSONArray jsonArray) {
33 | if (jsonArray == null) {
34 | return null;
35 | }
36 |
37 | List posts = new ArrayList<>();
38 | for (int i = 0; i < jsonArray.length(); i++) {
39 | JSONObject jsonObject;
40 | try {
41 | jsonObject = jsonArray.getJSONObject(i);
42 | } catch (Exception e) {
43 | e.printStackTrace();
44 | continue;
45 | }
46 | InstagramPost post = InstagramPost.fromJson(jsonObject);
47 | if (post != null) {
48 | posts.add(post);
49 | }
50 | }
51 | return posts;
52 | }
53 | }
54 |
--------------------------------------------------------------------------------
/app/src/main/java/com/codepath/persistencedemo/models/InstagramUser.java:
--------------------------------------------------------------------------------
1 | package com.codepath.persistencedemo.models;
2 |
3 | import org.json.JSONArray;
4 | import org.json.JSONException;
5 | import org.json.JSONObject;
6 |
7 | import java.io.Serializable;
8 | import java.util.ArrayList;
9 | import java.util.List;
10 |
11 | public class InstagramUser implements Serializable {
12 | public String userName;
13 | public String profilePictureUrl;
14 |
15 | public static InstagramUser fromJson(JSONObject jsonObject) {
16 | if (jsonObject == null) {
17 | return null;
18 | }
19 |
20 | InstagramUser user = new InstagramUser();
21 |
22 | try {
23 | user.userName = jsonObject.getString("username");
24 | user.profilePictureUrl = jsonObject.getString("profile_picture");
25 | } catch (JSONException e) {
26 | e.printStackTrace();
27 | return null;
28 | }
29 | return user;
30 | }
31 |
32 | public static List fromJson(JSONArray jsonArray) {
33 | if (jsonArray == null) {
34 | return null;
35 | }
36 |
37 | List users = new ArrayList<>();
38 | for (int i = 0; i < jsonArray.length(); i++) {
39 | JSONObject jsonObject;
40 | try {
41 | jsonObject = jsonArray.getJSONObject(i);
42 | } catch (Exception e) {
43 | e.printStackTrace();
44 | continue;
45 | }
46 | InstagramUser user = InstagramUser.fromJson(jsonObject);
47 | if (user != null) {
48 | users.add(user);
49 | }
50 | }
51 | return users;
52 | }
53 |
54 | }
55 |
--------------------------------------------------------------------------------
/app/src/main/java/com/codepath/persistencedemo/networking/InstagramClient.java:
--------------------------------------------------------------------------------
1 | package com.codepath.persistencedemo.networking;
2 |
3 | import com.loopj.android.http.AsyncHttpClient;
4 | import com.loopj.android.http.AsyncHttpResponseHandler;
5 | import com.loopj.android.http.RequestParams;
6 |
7 | public class InstagramClient {
8 | private static final String BASE_URL = "https://api.instagram.com/v1/";
9 | private static final String CLIENT_ID = "e05c462ebd86446ea48a5af73769b602";
10 |
11 | private static AsyncHttpClient client = new AsyncHttpClient();
12 |
13 | public static void getPopularPosts(AsyncHttpResponseHandler responseHandler) {
14 | client.get(getAbsoluteUrl("media/popular"), getDefaultRequestParams(), responseHandler);
15 | }
16 |
17 | private static String getAbsoluteUrl(String relativeUrl) {
18 | return BASE_URL + relativeUrl;
19 | }
20 |
21 | private static RequestParams getDefaultRequestParams() {
22 | RequestParams params = new RequestParams();
23 | params.put("client_id", CLIENT_ID);
24 | return params;
25 | }
26 | }
27 |
--------------------------------------------------------------------------------
/app/src/main/java/com/codepath/persistencedemo/persistence/InstagramClientDatabase.java:
--------------------------------------------------------------------------------
1 | package com.codepath.persistencedemo.persistence;
2 |
3 | import android.content.ContentValues;
4 | import android.content.Context;
5 | import android.database.Cursor;
6 | import android.database.sqlite.SQLiteDatabase;
7 | import android.database.sqlite.SQLiteOpenHelper;
8 | import android.util.Log;
9 |
10 | import com.codepath.persistencedemo.models.InstagramPost;
11 | import com.codepath.persistencedemo.models.InstagramUser;
12 |
13 | import java.util.ArrayList;
14 | import java.util.List;
15 |
16 | public class InstagramClientDatabase extends SQLiteOpenHelper {
17 | private static final String TAG = "InstagramClientDatabase";
18 |
19 | // Constants
20 | private static final String DATABASE_NAME = "instagramClientDatabase";
21 | private static final int DATABASE_VERSION = 1;
22 |
23 | private static final String TABLE_POSTS = "posts";
24 | private static final String TABLE_USERS = "users";
25 |
26 | // Posts table columns
27 | private static final String KEY_POST_ID = "id";
28 | private static final String KEY_POST_USER_ID_FK = "userId";
29 | private static final String KEY_POST_CREATED_TIME = "createdTime";
30 |
31 | // Users table columns
32 | private static final String KEY_USER_ID = "id";
33 | private static final String KEY_USER_NAME = "userName";
34 | private static final String KEY_USER_PROFILE_PICTURE_URL = "profilePictureUrl";
35 |
36 | private static String CREATE_POSTS_TABLE = "CREATE TABLE " + TABLE_POSTS +
37 | "(" +
38 | KEY_POST_ID + " INTEGER PRIMARY KEY," +
39 | KEY_POST_USER_ID_FK + " INTEGER REFERENCES " + TABLE_USERS + "," +
40 | KEY_POST_CREATED_TIME + " INTEGER" +
41 | ")";
42 |
43 | private static String CREATE_USERS_TABLE = "CREATE TABLE " + TABLE_USERS +
44 | "(" +
45 | KEY_USER_ID + " INTEGER PRIMARY KEY," +
46 | KEY_USER_NAME + " TEXT," +
47 | KEY_USER_PROFILE_PICTURE_URL + " TEXT" +
48 | ")";
49 |
50 | /* SELECT * FROM POSTS
51 | * LEFT OUTER JOIN USERS
52 | * ON POSTS.KEY_POST_USER_ID_FK = USERS.KEY_USER_ID
53 | */
54 | private static String POSTS_SELECT_QUERY =
55 | String.format("SELECT * FROM %s LEFT OUTER JOIN %s ON %s.%s = %s.%s",
56 | TABLE_POSTS,
57 | TABLE_USERS,
58 | TABLE_POSTS, KEY_POST_USER_ID_FK,
59 | TABLE_USERS, KEY_USER_ID);
60 |
61 | // Singleton instance
62 | private static InstagramClientDatabase sInstance;
63 |
64 | /**
65 | * Constructor should be private to prevent direct instantiation.
66 | * make call to static method "getInstance()" instead.
67 | */
68 | private InstagramClientDatabase(Context context) {
69 | super(context, DATABASE_NAME, null, DATABASE_VERSION);
70 | }
71 |
72 | public static synchronized InstagramClientDatabase getInstance(Context context) {
73 | if (sInstance == null) {
74 | // Use the application context, which will ensure that you
75 | // don't accidentally leak an Activity's context.
76 | // See this article for more information: http://bit.ly/6LRzfx
77 | sInstance = new InstagramClientDatabase(context.getApplicationContext());
78 | }
79 | return sInstance;
80 | }
81 |
82 | @Override
83 | public void onConfigure(SQLiteDatabase db) {
84 | super.onConfigure(db);
85 | db.setForeignKeyConstraintsEnabled(true);
86 | }
87 |
88 | @Override
89 | public void onCreate(SQLiteDatabase db) {
90 | db.execSQL(CREATE_POSTS_TABLE);
91 | db.execSQL(CREATE_USERS_TABLE);
92 | }
93 |
94 | @Override
95 | public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
96 | if (oldVersion != newVersion) {
97 | db.execSQL("DROP TABLE IF EXISTS " + TABLE_POSTS);
98 | db.execSQL("DROP TABLE IF EXISTS " + TABLE_USERS);
99 | onCreate(db);
100 | }
101 | }
102 |
103 | // Create methods
104 | public void addInstagramPosts(List posts) {
105 | if (posts == null) {
106 | throw new IllegalArgumentException(String.format("Attemping to add a null list of posts to %s", DATABASE_NAME));
107 | }
108 |
109 | // should be done off UI thread
110 | SQLiteDatabase db = getWritableDatabase();
111 | db.beginTransaction();
112 | try {
113 | for (InstagramPost post : posts) {
114 | long userId = addUser(post.user);
115 |
116 | ContentValues values = new ContentValues();
117 | values.put(KEY_POST_USER_ID_FK, userId);
118 | values.put(KEY_POST_CREATED_TIME, post.createdTime);
119 |
120 | db.insert(TABLE_POSTS, null, values);
121 | }
122 | db.setTransactionSuccessful();
123 | } catch (Exception e) {
124 | Log.wtf(TAG, "Error while trying to add posts to database");
125 | e.printStackTrace();
126 | } finally {
127 | db.endTransaction();
128 | }
129 | }
130 |
131 | private long addUser(InstagramUser user) {
132 | if (user == null) {
133 | throw new IllegalArgumentException(String.format("Attemping to add a null user to %s", DATABASE_NAME));
134 | }
135 | SQLiteDatabase db = getWritableDatabase();
136 |
137 | ContentValues values = new ContentValues();
138 | values.put(KEY_USER_NAME, user.userName);
139 | values.put(KEY_USER_PROFILE_PICTURE_URL, user.profilePictureUrl);
140 |
141 | return db.insert(TABLE_USERS, null, values);
142 | }
143 |
144 | // Read method
145 | public List getAllInstagramPosts() {
146 | List posts = new ArrayList<>();
147 |
148 | SQLiteDatabase db = getReadableDatabase();
149 | Cursor cursor = db.rawQuery(POSTS_SELECT_QUERY, null);
150 | try {
151 | if (cursor.moveToFirst()) {
152 | do {
153 | InstagramUser newUser = new InstagramUser();
154 | newUser.userName = cursor.getString(cursor.getColumnIndex(KEY_USER_NAME));
155 | newUser.profilePictureUrl = cursor.getString(cursor.getColumnIndex(KEY_USER_PROFILE_PICTURE_URL));
156 |
157 | InstagramPost newPost = new InstagramPost();
158 | newPost.createdTime = cursor.getLong(cursor.getColumnIndex(KEY_POST_CREATED_TIME));
159 | newPost.user = newUser;
160 | posts.add(newPost);
161 | } while(cursor.moveToNext());
162 | }
163 | } catch (Exception e) {
164 | Log.wtf(TAG, "Error while trying to get posts from database");
165 | e.printStackTrace();
166 | } finally {
167 | closeCursor(cursor);
168 | }
169 |
170 | return posts;
171 | }
172 |
173 | // Delete method
174 | public void emptyAllTables() {
175 | SQLiteDatabase db = getWritableDatabase();
176 | db.beginTransaction();
177 | try {
178 | db.delete(TABLE_POSTS, null, null);
179 | db.delete(TABLE_USERS, null, null);
180 | db.setTransactionSuccessful();
181 | } catch (Exception e) {
182 | Log.wtf(TAG, "Error while trying to empty all tables in database");
183 | e.printStackTrace();
184 | } finally {
185 | db.endTransaction();
186 | }
187 | }
188 |
189 | // Helper method
190 | public void closeCursor(Cursor cursor) {
191 | if (cursor != null && !cursor.isClosed()) {
192 | cursor.close();
193 | }
194 | }
195 | }
196 |
--------------------------------------------------------------------------------
/app/src/main/res/drawable/gray_oval.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
--------------------------------------------------------------------------------
/app/src/main/res/layout/activity_main.xml:
--------------------------------------------------------------------------------
1 |
6 |
7 |
12 |
13 |
14 |
--------------------------------------------------------------------------------
/app/src/main/res/layout/layout_item_post.xml:
--------------------------------------------------------------------------------
1 |
2 |
12 |
13 |
21 |
22 |
34 |
35 |
48 |
49 |
50 |
--------------------------------------------------------------------------------
/app/src/main/res/menu/menu_main.xml:
--------------------------------------------------------------------------------
1 |
10 |
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-hdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/codepath/android-instagram-persistence/abdda5621033bcafaf1af045e7aa8e3144a642ed/app/src/main/res/mipmap-hdpi/ic_launcher.png
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-mdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/codepath/android-instagram-persistence/abdda5621033bcafaf1af045e7aa8e3144a642ed/app/src/main/res/mipmap-mdpi/ic_launcher.png
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xhdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/codepath/android-instagram-persistence/abdda5621033bcafaf1af045e7aa8e3144a642ed/app/src/main/res/mipmap-xhdpi/ic_launcher.png
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xxhdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/codepath/android-instagram-persistence/abdda5621033bcafaf1af045e7aa8e3144a642ed/app/src/main/res/mipmap-xxhdpi/ic_launcher.png
--------------------------------------------------------------------------------
/app/src/main/res/values-w820dp/dimens.xml:
--------------------------------------------------------------------------------
1 |
2 |
5 | 64dp
6 |
7 |
--------------------------------------------------------------------------------
/app/src/main/res/values/colors.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | #A5A7AA
5 | #4B4F54
6 | #E6E6E6
7 | #125688
8 | #00538B
9 | #004876
10 | #BBBBBB
11 |
12 |
--------------------------------------------------------------------------------
/app/src/main/res/values/dimens.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 | 16dp
4 | 16dp
5 |
6 |
--------------------------------------------------------------------------------
/app/src/main/res/values/strings.xml:
--------------------------------------------------------------------------------
1 |
2 | PersistenceDemo
3 |
4 | Hello world!
5 | Settings
6 |
7 | Loading cached data from SQLite!
8 | Refreshing data from Instagram API!
9 |
10 |
11 |
--------------------------------------------------------------------------------
/app/src/main/res/values/styles.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/build.gradle:
--------------------------------------------------------------------------------
1 | // Top-level build file where you can add configuration options common to all sub-projects/modules.
2 |
3 | buildscript {
4 | repositories {
5 | jcenter()
6 | }
7 | dependencies {
8 | classpath 'com.android.tools.build:gradle:1.1.1'
9 |
10 | // NOTE: Do not place your application dependencies here; they belong
11 | // in the individual module build.gradle files
12 | }
13 | }
14 |
15 | allprojects {
16 | repositories {
17 | jcenter()
18 | }
19 | }
20 |
--------------------------------------------------------------------------------
/gradle.properties:
--------------------------------------------------------------------------------
1 | # Project-wide Gradle settings.
2 |
3 | # IDE (e.g. Android Studio) users:
4 | # Gradle settings configured through the IDE *will override*
5 | # any settings specified in this file.
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
--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.jar:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/codepath/android-instagram-persistence/abdda5621033bcafaf1af045e7aa8e3144a642ed/gradle/wrapper/gradle-wrapper.jar
--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.properties:
--------------------------------------------------------------------------------
1 | #Wed Apr 10 15:27:10 PDT 2013
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.1-all.zip
7 |
--------------------------------------------------------------------------------
/gradlew:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env bash
2 |
3 | ##############################################################################
4 | ##
5 | ## Gradle start up script for UN*X
6 | ##
7 | ##############################################################################
8 |
9 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
10 | DEFAULT_JVM_OPTS=""
11 |
12 | APP_NAME="Gradle"
13 | APP_BASE_NAME=`basename "$0"`
14 |
15 | # Use the maximum available, or set MAX_FD != -1 to use that value.
16 | MAX_FD="maximum"
17 |
18 | warn ( ) {
19 | echo "$*"
20 | }
21 |
22 | die ( ) {
23 | echo
24 | echo "$*"
25 | echo
26 | exit 1
27 | }
28 |
29 | # OS specific support (must be 'true' or 'false').
30 | cygwin=false
31 | msys=false
32 | darwin=false
33 | case "`uname`" in
34 | CYGWIN* )
35 | cygwin=true
36 | ;;
37 | Darwin* )
38 | darwin=true
39 | ;;
40 | MINGW* )
41 | msys=true
42 | ;;
43 | esac
44 |
45 | # For Cygwin, ensure paths are in UNIX format before anything is touched.
46 | if $cygwin ; then
47 | [ -n "$JAVA_HOME" ] && JAVA_HOME=`cygpath --unix "$JAVA_HOME"`
48 | fi
49 |
50 | # Attempt to set APP_HOME
51 | # Resolve links: $0 may be a link
52 | PRG="$0"
53 | # Need this for relative symlinks.
54 | while [ -h "$PRG" ] ; do
55 | ls=`ls -ld "$PRG"`
56 | link=`expr "$ls" : '.*-> \(.*\)$'`
57 | if expr "$link" : '/.*' > /dev/null; then
58 | PRG="$link"
59 | else
60 | PRG=`dirname "$PRG"`"/$link"
61 | fi
62 | done
63 | SAVED="`pwd`"
64 | cd "`dirname \"$PRG\"`/" >&-
65 | APP_HOME="`pwd -P`"
66 | cd "$SAVED" >&-
67 |
68 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
69 |
70 | # Determine the Java command to use to start the JVM.
71 | if [ -n "$JAVA_HOME" ] ; then
72 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
73 | # IBM's JDK on AIX uses strange locations for the executables
74 | JAVACMD="$JAVA_HOME/jre/sh/java"
75 | else
76 | JAVACMD="$JAVA_HOME/bin/java"
77 | fi
78 | if [ ! -x "$JAVACMD" ] ; then
79 | die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
80 |
81 | Please set the JAVA_HOME variable in your environment to match the
82 | location of your Java installation."
83 | fi
84 | else
85 | JAVACMD="java"
86 | which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
87 |
88 | Please set the JAVA_HOME variable in your environment to match the
89 | location of your Java installation."
90 | fi
91 |
92 | # Increase the maximum file descriptors if we can.
93 | if [ "$cygwin" = "false" -a "$darwin" = "false" ] ; then
94 | MAX_FD_LIMIT=`ulimit -H -n`
95 | if [ $? -eq 0 ] ; then
96 | if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
97 | MAX_FD="$MAX_FD_LIMIT"
98 | fi
99 | ulimit -n $MAX_FD
100 | if [ $? -ne 0 ] ; then
101 | warn "Could not set maximum file descriptor limit: $MAX_FD"
102 | fi
103 | else
104 | warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
105 | fi
106 | fi
107 |
108 | # For Darwin, add options to specify how the application appears in the dock
109 | if $darwin; then
110 | GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
111 | fi
112 |
113 | # For Cygwin, switch paths to Windows format before running java
114 | if $cygwin ; then
115 | APP_HOME=`cygpath --path --mixed "$APP_HOME"`
116 | CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
117 |
118 | # We build the pattern for arguments to be converted via cygpath
119 | ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
120 | SEP=""
121 | for dir in $ROOTDIRSRAW ; do
122 | ROOTDIRS="$ROOTDIRS$SEP$dir"
123 | SEP="|"
124 | done
125 | OURCYGPATTERN="(^($ROOTDIRS))"
126 | # Add a user-defined pattern to the cygpath arguments
127 | if [ "$GRADLE_CYGPATTERN" != "" ] ; then
128 | OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
129 | fi
130 | # Now convert the arguments - kludge to limit ourselves to /bin/sh
131 | i=0
132 | for arg in "$@" ; do
133 | CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
134 | CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option
135 |
136 | if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition
137 | eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
138 | else
139 | eval `echo args$i`="\"$arg\""
140 | fi
141 | i=$((i+1))
142 | done
143 | case $i in
144 | (0) set -- ;;
145 | (1) set -- "$args0" ;;
146 | (2) set -- "$args0" "$args1" ;;
147 | (3) set -- "$args0" "$args1" "$args2" ;;
148 | (4) set -- "$args0" "$args1" "$args2" "$args3" ;;
149 | (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
150 | (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
151 | (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
152 | (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
153 | (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
154 | esac
155 | fi
156 |
157 | # Split up the JVM_OPTS And GRADLE_OPTS values into an array, following the shell quoting and substitution rules
158 | function splitJvmOpts() {
159 | JVM_OPTS=("$@")
160 | }
161 | eval splitJvmOpts $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS
162 | JVM_OPTS[${#JVM_OPTS[*]}]="-Dorg.gradle.appname=$APP_BASE_NAME"
163 |
164 | exec "$JAVACMD" "${JVM_OPTS[@]}" -classpath "$CLASSPATH" org.gradle.wrapper.GradleWrapperMain "$@"
165 |
--------------------------------------------------------------------------------
/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 |
--------------------------------------------------------------------------------
/settings.gradle:
--------------------------------------------------------------------------------
1 | include ':app'
2 |
--------------------------------------------------------------------------------