diff --git a/samples/ApiDemos/AndroidManifest.xml b/samples/ApiDemos/AndroidManifest.xml index c3d66dfab..9e0e85751 100644 --- a/samples/ApiDemos/AndroidManifest.xml +++ b/samples/ApiDemos/AndroidManifest.xml @@ -368,7 +368,7 @@ - @@ -376,7 +376,15 @@ - + + + + + + + @@ -385,7 +393,7 @@ - @@ -393,7 +401,7 @@ - @@ -401,7 +409,7 @@ - @@ -409,7 +417,7 @@ - @@ -417,7 +425,7 @@ - @@ -425,7 +433,7 @@ - @@ -433,9 +441,9 @@ - + - @@ -443,7 +451,7 @@ - @@ -451,7 +459,7 @@ - @@ -459,7 +467,7 @@ - @@ -483,6 +491,18 @@ android:enabled="@bool/atLeastHoneycomb" /> + + + + + + + + + + diff --git a/samples/ApiDemos/_index.html b/samples/ApiDemos/_index.html index 399ef8669..ffe5db5b8 100644 --- a/samples/ApiDemos/_index.html +++ b/samples/ApiDemos/_index.html @@ -37,7 +37,8 @@ document.write(""+ "
  • Media
    • "+ "
  • OS
    • "+ "
  • Text
    • "+ -"
  • Views
    • "); +"
  • Views
    • "+ +"
  • Static Support Library
    • "); } diff --git a/samples/ApiDemos/res/layout-land/fragment_arguments_support.xml b/samples/ApiDemos/res/layout-land/fragment_arguments_support.xml new file mode 100644 index 000000000..9aa8dafbd --- /dev/null +++ b/samples/ApiDemos/res/layout-land/fragment_arguments_support.xml @@ -0,0 +1,57 @@ + + + + + + + + + + + + + + + + + + + + diff --git a/samples/ApiDemos/res/layout-land/fragment_layout_support.xml b/samples/ApiDemos/res/layout-land/fragment_layout_support.xml index 383e41c90..de31341ec 100644 --- a/samples/ApiDemos/res/layout-land/fragment_layout_support.xml +++ b/samples/ApiDemos/res/layout-land/fragment_layout_support.xml @@ -22,7 +22,7 @@ android:orientation="horizontal" android:layout_width="match_parent" android:layout_height="match_parent"> - diff --git a/samples/ApiDemos/res/layout/fragment_arguments_support.xml b/samples/ApiDemos/res/layout/fragment_arguments_support.xml new file mode 100644 index 000000000..b218f82cb --- /dev/null +++ b/samples/ApiDemos/res/layout/fragment_arguments_support.xml @@ -0,0 +1,54 @@ + + + + + + + + + + + + + + + + + + + + diff --git a/samples/ApiDemos/res/layout/fragment_hide_show_support.xml b/samples/ApiDemos/res/layout/fragment_hide_show_support.xml index dc87ba3bb..e4245bd26 100644 --- a/samples/ApiDemos/res/layout/fragment_hide_show_support.xml +++ b/samples/ApiDemos/res/layout/fragment_hide_show_support.xml @@ -34,7 +34,7 @@ android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Hide" /> - @@ -48,7 +48,7 @@ android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Hide" /> - diff --git a/samples/ApiDemos/res/layout/fragment_layout_support.xml b/samples/ApiDemos/res/layout/fragment_layout_support.xml index 1d974ddee..08c40bf57 100644 --- a/samples/ApiDemos/res/layout/fragment_layout_support.xml +++ b/samples/ApiDemos/res/layout/fragment_layout_support.xml @@ -20,7 +20,7 @@ - diff --git a/samples/ApiDemos/res/values/strings.xml b/samples/ApiDemos/res/values/strings.xml index 36b44c783..d86b1942f 100644 --- a/samples/ApiDemos/res/values/strings.xml +++ b/samples/ApiDemos/res/values/strings.xml @@ -152,32 +152,36 @@ App/Fragment/Stack New fragment - App/Fragment Support/Alert Dialog + Support/App/Fragment/Alert Dialog - App/Fragment Support/Hide and Show + Support/App/Fragment/Arguments - App/Fragment Support/Context Menu + Support/App/Fragment/Hide and Show - App/Fragment Support/Dialog + Support/App/Fragment/Context Menu - App/Fragment Support/Dialog or Activity + Support/App/Fragment/Dialog - App/Fragment Support/Layout + Support/App/Fragment/Dialog or Activity - App/Fragment Support/List Array + Support/App/Fragment/Layout - App/Fragment Support/List Cursor Loader + Support/App/Fragment/List Array - App/Fragment Support/Menu + Support/App/Fragment/List Cursor Loader - App/Fragment Support/Retain Instance + Support/App/Fragment/Menu - App/Fragment Support/Receive Result + Support/App/Fragment/Retain Instance - App/Fragment Support/Stack + Support/App/Fragment/Receive Result + + Support/App/Fragment/Stack App/Loader/Throttle + Support/Loader/Throttle + App/Activity/Menu Open menu Close menu diff --git a/samples/ApiDemos/src/com/example/android/apis/app/_index.html b/samples/ApiDemos/src/com/example/android/apis/app/_index.html index 3615e262d..fa69dee98 100644 --- a/samples/ApiDemos/src/com/example/android/apis/app/_index.html +++ b/samples/ApiDemos/src/com/example/android/apis/app/_index.html @@ -92,6 +92,11 @@
    Demonstrates how to use a DialogFragment to show and manage an AlertDialog.
    +
    Fragment Arguments
    +
    Demonstrates how a fragment can be initialized with arguments, + supplying them either as an argument Bundle at runtime or XML attributes + in a <fragment> tag.
    +
    Fragment Context Menu
    Demonstrates how to display and respond to a context menu that is display from a fragment's view hierarchy.
    diff --git a/samples/ApiDemos/src/com/example/android/apis/support/_index.html b/samples/ApiDemos/src/com/example/android/apis/support/_index.html new file mode 100644 index 000000000..806a57196 --- /dev/null +++ b/samples/ApiDemos/src/com/example/android/apis/support/_index.html @@ -0,0 +1,76 @@ + +

    This section includes samples showing the use of Android's +static support library. This library contains code that you can +build in to your application to access new features and common +utilities while being able to run down to version 1.6 (API 4) +of the platform.

    + + + +

    Fragment

    +
    +
    Fragment Alert Dialog
    +
    Demonstrates how to use a DialogFragment to show and manage an + AlertDialog.
    + +
    Fragment Arguments
    +
    Demonstrates how a fragment can be initialized with arguments, + supplying them either as an argument Bundle at runtime or XML attributes + in a <fragment> tag.
    + +
    Fragment Context Menu
    +
    Demonstrates how to display and respond to a context menu that is + display from a fragment's view hierarchy.
    + +
    Fragment Dialog
    +
    Demonstrates use of DialogFragment to show various types of dialogs.
    + +
    Fragment Dialog or Activity
    +
    Demonstrates how the same Fragment implementation can be used to provide the UI + for either an Activity or Dialog.
    + +
    Fragment Hide Show
    +
    Demonstrates hiding and showing fragments.
    + +
    Fragment Layout
    +
    Demonstrates use of the <fragment> tag to embed a Fragment in + an Activity's content view layout, and making the layout change based on + configuration to achieve different UI flows.
    + +
    Fragment List Array
    +
    Demonstrates use of ListFragment to show the contents of a simple ArrayAdapter.
    + +
    Fragment List Cursor Loader
    +
    Demonstrates use of LoaderManager to perform a query for a Cursor that + populates a ListFragment.
    + +
    Fragment Menu
    +
    Demonstrates populating custom menu items from a Fragment.
    + +
    Fragment Receive Result
    +
    Demonstrates starting a new Activity from a Fragment, and receiving + a result back from it.
    + +
    Fragment Retain Instance
    +
    Demonstrates a Fragment can be used to easily retain active state across + an Activity's configuration change.
    + +
    Fragment Stack
    +
    Demonstrates creating a stack of Fragment instances similar to the + traditional stack of activities.
    + +
    + +

    LoaderManager

    +
    +
    Loader Throttle
    +
    Complete end-to-end demonstration of a simple content provider that + populates data in a list through a cursor loader. The UI allows the list + to be populated with a series of items, showing how AsyncTaskLoader's + throttling facility can be used to control how much a Loader is refreshed + in this case.
    +
    + \ No newline at end of file diff --git a/samples/ApiDemos/src/com/example/android/apis/app/FragmentAlertDialogSupport.java b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentAlertDialogSupport.java similarity index 98% rename from samples/ApiDemos/src/com/example/android/apis/app/FragmentAlertDialogSupport.java rename to samples/ApiDemos/src/com/example/android/apis/support/app/FragmentAlertDialogSupport.java index 84e0ef6c6..d7f6ae93f 100644 --- a/samples/ApiDemos/src/com/example/android/apis/app/FragmentAlertDialogSupport.java +++ b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentAlertDialogSupport.java @@ -14,7 +14,7 @@ * limitations under the License. */ -package com.example.android.apis.app; +package com.example.android.apis.support.app; import com.example.android.apis.R; diff --git a/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentArgumentsSupport.java b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentArgumentsSupport.java new file mode 100644 index 000000000..1ff71859b --- /dev/null +++ b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentArgumentsSupport.java @@ -0,0 +1,113 @@ +/* + * Copyright (C) 2011 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.example.android.apis.support.app; + +import com.example.android.apis.R; + +import android.support.v4.app.FragmentActivity; +import android.support.v4.app.Fragment; +import android.support.v4.app.FragmentTransaction; + +import android.app.Activity; +import android.content.res.TypedArray; +import android.os.Bundle; +import android.util.AttributeSet; +import android.view.LayoutInflater; +import android.view.View; +import android.view.ViewGroup; +import android.widget.TextView; + +/** + * Demonstrates a fragment that can be configured through both Bundle arguments + * and layout attributes. + */ +public class FragmentArgumentsSupport extends FragmentActivity { +//BEGIN_INCLUDE(create) + @Override protected void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + setContentView(R.layout.fragment_arguments_support); + + if (savedInstanceState == null) { + // First-time init; create fragment to embed in activity. + FragmentTransaction ft = getSupportFragmentManager().beginTransaction(); + Fragment newFragment = MyFragment.newInstance("From Arguments"); + ft.add(R.id.created, newFragment); + ft.commit(); + } + } +//END_INCLUDE(create) + +//BEGIN_INCLUDE(fragment) + public static class MyFragment extends Fragment { + CharSequence mLabel; + + /** + * Create a new instance of MyFragment that will be initialized + * with the given arguments. + */ + static MyFragment newInstance(CharSequence label) { + MyFragment f = new MyFragment(); + Bundle b = new Bundle(); + b.putCharSequence("label", label); + f.setArguments(b); + return f; + } + + /** + * Parse attributes during inflation from a view hierarchy into the + * arguments we handle. + */ + @Override public void onInflate(Activity activity, AttributeSet attrs, + Bundle savedInstanceState) { + super.onInflate(activity, attrs, savedInstanceState); + + TypedArray a = activity.obtainStyledAttributes(attrs, + R.styleable.FragmentArguments); + mLabel = a.getText(R.styleable.FragmentArguments_android_label); + a.recycle(); + } + + /** + * During creation, if arguments have been supplied to the fragment + * then parse those out. + */ + @Override public void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + + Bundle args = getArguments(); + if (args != null) { + CharSequence label = args.getCharSequence("label"); + if (label != null) { + mLabel = label; + } + } + } + + /** + * Create the view for this fragment, using the arguments given to it. + */ + @Override public View onCreateView(LayoutInflater inflater, ViewGroup container, + Bundle savedInstanceState) { + View v = inflater.inflate(R.layout.hello_world, container, false); + View tv = v.findViewById(R.id.text); + ((TextView)tv).setText(mLabel != null ? mLabel : "(no label)"); + tv.setBackgroundDrawable(getResources().getDrawable(android.R.drawable.gallery_thumb)); + return v; + } + } +//END_INCLUDE(fragment) +} diff --git a/samples/ApiDemos/src/com/example/android/apis/app/FragmentContextMenuSupport.java b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentContextMenuSupport.java similarity index 98% rename from samples/ApiDemos/src/com/example/android/apis/app/FragmentContextMenuSupport.java rename to samples/ApiDemos/src/com/example/android/apis/support/app/FragmentContextMenuSupport.java index 3b4af5fb2..a934145ac 100644 --- a/samples/ApiDemos/src/com/example/android/apis/app/FragmentContextMenuSupport.java +++ b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentContextMenuSupport.java @@ -14,7 +14,7 @@ * limitations under the License. */ -package com.example.android.apis.app; +package com.example.android.apis.support.app; import com.example.android.apis.R; diff --git a/samples/ApiDemos/src/com/example/android/apis/app/FragmentDialogOrActivitySupport.java b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentDialogOrActivitySupport.java similarity index 98% rename from samples/ApiDemos/src/com/example/android/apis/app/FragmentDialogOrActivitySupport.java rename to samples/ApiDemos/src/com/example/android/apis/support/app/FragmentDialogOrActivitySupport.java index 20e4569c7..fe677aaff 100644 --- a/samples/ApiDemos/src/com/example/android/apis/app/FragmentDialogOrActivitySupport.java +++ b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentDialogOrActivitySupport.java @@ -14,7 +14,7 @@ * limitations under the License. */ -package com.example.android.apis.app; +package com.example.android.apis.support.app; import com.example.android.apis.R; diff --git a/samples/ApiDemos/src/com/example/android/apis/app/FragmentDialogSupport.java b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentDialogSupport.java similarity index 99% rename from samples/ApiDemos/src/com/example/android/apis/app/FragmentDialogSupport.java rename to samples/ApiDemos/src/com/example/android/apis/support/app/FragmentDialogSupport.java index 9b93d48a8..666151df6 100644 --- a/samples/ApiDemos/src/com/example/android/apis/app/FragmentDialogSupport.java +++ b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentDialogSupport.java @@ -14,7 +14,7 @@ * limitations under the License. */ -package com.example.android.apis.app; +package com.example.android.apis.support.app; import com.example.android.apis.R; diff --git a/samples/ApiDemos/src/com/example/android/apis/app/FragmentHideShowSupport.java b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentHideShowSupport.java similarity index 98% rename from samples/ApiDemos/src/com/example/android/apis/app/FragmentHideShowSupport.java rename to samples/ApiDemos/src/com/example/android/apis/support/app/FragmentHideShowSupport.java index bd5161d34..d34716016 100644 --- a/samples/ApiDemos/src/com/example/android/apis/app/FragmentHideShowSupport.java +++ b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentHideShowSupport.java @@ -14,7 +14,7 @@ * limitations under the License. */ -package com.example.android.apis.app; +package com.example.android.apis.support.app; import com.example.android.apis.R; diff --git a/samples/ApiDemos/src/com/example/android/apis/app/FragmentLayoutSupport.java b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentLayoutSupport.java similarity index 99% rename from samples/ApiDemos/src/com/example/android/apis/app/FragmentLayoutSupport.java rename to samples/ApiDemos/src/com/example/android/apis/support/app/FragmentLayoutSupport.java index b6aa7eeaa..e1c63ae03 100644 --- a/samples/ApiDemos/src/com/example/android/apis/app/FragmentLayoutSupport.java +++ b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentLayoutSupport.java @@ -14,7 +14,7 @@ * limitations under the License. */ -package com.example.android.apis.app; +package com.example.android.apis.support.app; import com.example.android.apis.R; import com.example.android.apis.Shakespeare; diff --git a/samples/ApiDemos/src/com/example/android/apis/app/FragmentListArraySupport.java b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentListArraySupport.java similarity index 97% rename from samples/ApiDemos/src/com/example/android/apis/app/FragmentListArraySupport.java rename to samples/ApiDemos/src/com/example/android/apis/support/app/FragmentListArraySupport.java index aa3df3232..2bcc018ee 100644 --- a/samples/ApiDemos/src/com/example/android/apis/app/FragmentListArraySupport.java +++ b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentListArraySupport.java @@ -14,7 +14,7 @@ * limitations under the License. */ -package com.example.android.apis.app; +package com.example.android.apis.support.app; import com.example.android.apis.Shakespeare; diff --git a/samples/ApiDemos/src/com/example/android/apis/app/FragmentListCursorLoaderSupport.java b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentListCursorLoaderSupport.java similarity index 99% rename from samples/ApiDemos/src/com/example/android/apis/app/FragmentListCursorLoaderSupport.java rename to samples/ApiDemos/src/com/example/android/apis/support/app/FragmentListCursorLoaderSupport.java index 35a2f3578..98aa47f2b 100644 --- a/samples/ApiDemos/src/com/example/android/apis/app/FragmentListCursorLoaderSupport.java +++ b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentListCursorLoaderSupport.java @@ -14,7 +14,7 @@ * limitations under the License. */ -package com.example.android.apis.app; +package com.example.android.apis.support.app; import android.support.v4.app.FragmentActivity; import android.support.v4.app.FragmentManager; diff --git a/samples/ApiDemos/src/com/example/android/apis/app/FragmentMenuSupport.java b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentMenuSupport.java similarity index 99% rename from samples/ApiDemos/src/com/example/android/apis/app/FragmentMenuSupport.java rename to samples/ApiDemos/src/com/example/android/apis/support/app/FragmentMenuSupport.java index 05d94cae3..5ac309a1b 100644 --- a/samples/ApiDemos/src/com/example/android/apis/app/FragmentMenuSupport.java +++ b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentMenuSupport.java @@ -14,7 +14,7 @@ * limitations under the License. */ -package com.example.android.apis.app; +package com.example.android.apis.support.app; import com.example.android.apis.R; diff --git a/samples/ApiDemos/src/com/example/android/apis/app/FragmentReceiveResultSupport.java b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentReceiveResultSupport.java similarity index 98% rename from samples/ApiDemos/src/com/example/android/apis/app/FragmentReceiveResultSupport.java rename to samples/ApiDemos/src/com/example/android/apis/support/app/FragmentReceiveResultSupport.java index 3a3a34ae2..f430e69fe 100644 --- a/samples/ApiDemos/src/com/example/android/apis/app/FragmentReceiveResultSupport.java +++ b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentReceiveResultSupport.java @@ -14,9 +14,10 @@ * limitations under the License. */ -package com.example.android.apis.app; +package com.example.android.apis.support.app; import com.example.android.apis.R; +import com.example.android.apis.app.SendResult; import android.support.v4.app.Fragment; import android.support.v4.app.FragmentActivity; diff --git a/samples/ApiDemos/src/com/example/android/apis/app/FragmentRetainInstanceSupport.java b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentRetainInstanceSupport.java similarity index 99% rename from samples/ApiDemos/src/com/example/android/apis/app/FragmentRetainInstanceSupport.java rename to samples/ApiDemos/src/com/example/android/apis/support/app/FragmentRetainInstanceSupport.java index b83ca444f..dbf0cfb88 100644 --- a/samples/ApiDemos/src/com/example/android/apis/app/FragmentRetainInstanceSupport.java +++ b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentRetainInstanceSupport.java @@ -14,7 +14,7 @@ * limitations under the License. */ -package com.example.android.apis.app; +package com.example.android.apis.support.app; import com.example.android.apis.R; diff --git a/samples/ApiDemos/src/com/example/android/apis/app/FragmentStackSupport.java b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentStackSupport.java similarity index 98% rename from samples/ApiDemos/src/com/example/android/apis/app/FragmentStackSupport.java rename to samples/ApiDemos/src/com/example/android/apis/support/app/FragmentStackSupport.java index 9cc2e0460..404721b3f 100644 --- a/samples/ApiDemos/src/com/example/android/apis/app/FragmentStackSupport.java +++ b/samples/ApiDemos/src/com/example/android/apis/support/app/FragmentStackSupport.java @@ -14,7 +14,7 @@ * limitations under the License. */ -package com.example.android.apis.app; +package com.example.android.apis.support.app; import com.example.android.apis.R; diff --git a/samples/ApiDemos/src/com/example/android/apis/support/app/LoaderThrottleSupport.java b/samples/ApiDemos/src/com/example/android/apis/support/app/LoaderThrottleSupport.java new file mode 100644 index 000000000..e8f4af57b --- /dev/null +++ b/samples/ApiDemos/src/com/example/android/apis/support/app/LoaderThrottleSupport.java @@ -0,0 +1,503 @@ +/* + * Copyright (C) 2011 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.example.android.apis.support.app; + +//BEGIN_INCLUDE(complete) +import android.support.v4.app.FragmentActivity; +import android.support.v4.app.FragmentManager; +import android.support.v4.app.ListFragment; +import android.support.v4.app.LoaderManager; +import android.support.v4.content.CursorLoader; +import android.support.v4.content.Loader; +import android.support.v4.widget.SimpleCursorAdapter; + +import android.content.ContentProvider; +import android.content.ContentResolver; +import android.content.ContentUris; +import android.content.ContentValues; +import android.content.Context; +import android.content.UriMatcher; +import android.database.Cursor; +import android.database.DatabaseUtils; +import android.database.SQLException; +import android.database.sqlite.SQLiteDatabase; +import android.database.sqlite.SQLiteOpenHelper; +import android.database.sqlite.SQLiteQueryBuilder; +import android.net.Uri; +import android.os.AsyncTask; +import android.os.Bundle; +import android.provider.BaseColumns; +import android.text.TextUtils; +import android.util.Log; +import android.view.Menu; +import android.view.MenuInflater; +import android.view.MenuItem; +import android.view.View; +import android.widget.ListView; + +import java.util.HashMap; + +/** + * Demonstration of bottom to top implementation of a content provider holding + * structured data through displaying it in the UI, using throttling to reduce + * the number of queries done when its data changes. + */ +public class LoaderThrottleSupport extends FragmentActivity { + // Debugging. + static final String TAG = "LoaderThrottle"; + + /** + * The authority we use to get to our sample provider. + */ + public static final String AUTHORITY = "com.example.android.apis.support.app.LoaderThrottle"; + + /** + * Definition of the contract for the main table of our provider. + */ + public static final class MainTable implements BaseColumns { + + // This class cannot be instantiated + private MainTable() {} + + /** + * The table name offered by this provider + */ + public static final String TABLE_NAME = "main"; + + /** + * The content:// style URL for this table + */ + public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/main"); + + /** + * The content URI base for a single row of data. Callers must + * append a numeric row id to this Uri to retrieve a row + */ + public static final Uri CONTENT_ID_URI_BASE + = Uri.parse("content://" + AUTHORITY + "/main/"); + + /** + * The MIME type of {@link #CONTENT_URI}. + */ + public static final String CONTENT_TYPE + = "vnd.android.cursor.dir/vnd.example.api-demos-throttle"; + + /** + * The MIME type of a {@link #CONTENT_URI} sub-directory of a single row. + */ + public static final String CONTENT_ITEM_TYPE + = "vnd.android.cursor.item/vnd.example.api-demos-throttle"; + /** + * The default sort order for this table + */ + public static final String DEFAULT_SORT_ORDER = "data COLLATE LOCALIZED ASC"; + + /** + * Column name for the single column holding our data. + *

    Type: TEXT

    + */ + public static final String COLUMN_NAME_DATA = "data"; + } + + /** + * This class helps open, create, and upgrade the database file. + */ + static class DatabaseHelper extends SQLiteOpenHelper { + + private static final String DATABASE_NAME = "loader_throttle.db"; + private static final int DATABASE_VERSION = 2; + + DatabaseHelper(Context context) { + + // calls the super constructor, requesting the default cursor factory. + super(context, DATABASE_NAME, null, DATABASE_VERSION); + } + + /** + * + * Creates the underlying database with table name and column names taken from the + * NotePad class. + */ + @Override + public void onCreate(SQLiteDatabase db) { + db.execSQL("CREATE TABLE " + MainTable.TABLE_NAME + " (" + + MainTable._ID + " INTEGER PRIMARY KEY," + + MainTable.COLUMN_NAME_DATA + " TEXT" + + ");"); + } + + /** + * + * Demonstrates that the provider must consider what happens when the + * underlying datastore is changed. In this sample, the database is upgraded the database + * by destroying the existing data. + * A real application should upgrade the database in place. + */ + @Override + public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { + + // Logs that the database is being upgraded + Log.w(TAG, "Upgrading database from version " + oldVersion + " to " + + newVersion + ", which will destroy all old data"); + + // Kills the table and existing data + db.execSQL("DROP TABLE IF EXISTS notes"); + + // Recreates the database with a new version + onCreate(db); + } + } + + /** + * A very simple implementation of a content provider. + */ + public static class SimpleProvider extends ContentProvider { + // A projection map used to select columns from the database + private final HashMap mNotesProjectionMap; + // Uri matcher to decode incoming URIs. + private final UriMatcher mUriMatcher; + + // The incoming URI matches the main table URI pattern + private static final int MAIN = 1; + // The incoming URI matches the main table row ID URI pattern + private static final int MAIN_ID = 2; + + // Handle to a new DatabaseHelper. + private DatabaseHelper mOpenHelper; + + /** + * Global provider initialization. + */ + public SimpleProvider() { + // Create and initialize URI matcher. + mUriMatcher = new UriMatcher(UriMatcher.NO_MATCH); + mUriMatcher.addURI(AUTHORITY, MainTable.TABLE_NAME, MAIN); + mUriMatcher.addURI(AUTHORITY, MainTable.TABLE_NAME + "/#", MAIN_ID); + + // Create and initialize projection map for all columns. This is + // simply an identity mapping. + mNotesProjectionMap = new HashMap(); + mNotesProjectionMap.put(MainTable._ID, MainTable._ID); + mNotesProjectionMap.put(MainTable.COLUMN_NAME_DATA, MainTable.COLUMN_NAME_DATA); + } + + /** + * Perform provider creation. + */ + @Override + public boolean onCreate() { + mOpenHelper = new DatabaseHelper(getContext()); + // Assumes that any failures will be reported by a thrown exception. + return true; + } + + /** + * Handle incoming queries. + */ + @Override + public Cursor query(Uri uri, String[] projection, String selection, + String[] selectionArgs, String sortOrder) { + + // Constructs a new query builder and sets its table name + SQLiteQueryBuilder qb = new SQLiteQueryBuilder(); + qb.setTables(MainTable.TABLE_NAME); + + switch (mUriMatcher.match(uri)) { + case MAIN: + // If the incoming URI is for main table. + qb.setProjectionMap(mNotesProjectionMap); + break; + + case MAIN_ID: + // The incoming URI is for a single row. + qb.setProjectionMap(mNotesProjectionMap); + qb.appendWhere(MainTable._ID + "=?"); + selectionArgs = DatabaseUtils.appendSelectionArgs(selectionArgs, + new String[] { uri.getLastPathSegment() }); + break; + + default: + throw new IllegalArgumentException("Unknown URI " + uri); + } + + + if (TextUtils.isEmpty(sortOrder)) { + sortOrder = MainTable.DEFAULT_SORT_ORDER; + } + + SQLiteDatabase db = mOpenHelper.getReadableDatabase(); + + Cursor c = qb.query(db, projection, selection, selectionArgs, + null /* no group */, null /* no filter */, sortOrder); + + c.setNotificationUri(getContext().getContentResolver(), uri); + return c; + } + + /** + * Return the MIME type for an known URI in the provider. + */ + @Override + public String getType(Uri uri) { + switch (mUriMatcher.match(uri)) { + case MAIN: + return MainTable.CONTENT_TYPE; + case MAIN_ID: + return MainTable.CONTENT_ITEM_TYPE; + default: + throw new IllegalArgumentException("Unknown URI " + uri); + } + } + + /** + * Handler inserting new data. + */ + @Override + public Uri insert(Uri uri, ContentValues initialValues) { + if (mUriMatcher.match(uri) != MAIN) { + // Can only insert into to main URI. + throw new IllegalArgumentException("Unknown URI " + uri); + } + + ContentValues values; + + if (initialValues != null) { + values = new ContentValues(initialValues); + } else { + values = new ContentValues(); + } + + if (values.containsKey(MainTable.COLUMN_NAME_DATA) == false) { + values.put(MainTable.COLUMN_NAME_DATA, ""); + } + + SQLiteDatabase db = mOpenHelper.getWritableDatabase(); + + long rowId = db.insert(MainTable.TABLE_NAME, null, values); + + // If the insert succeeded, the row ID exists. + if (rowId > 0) { + Uri noteUri = ContentUris.withAppendedId(MainTable.CONTENT_ID_URI_BASE, rowId); + getContext().getContentResolver().notifyChange(noteUri, null); + return noteUri; + } + + throw new SQLException("Failed to insert row into " + uri); + } + + /** + * Handle deleting data. + */ + @Override + public int delete(Uri uri, String where, String[] whereArgs) { + SQLiteDatabase db = mOpenHelper.getWritableDatabase(); + String finalWhere; + + int count; + + switch (mUriMatcher.match(uri)) { + case MAIN: + // If URI is main table, delete uses incoming where clause and args. + count = db.delete(MainTable.TABLE_NAME, where, whereArgs); + break; + + // If the incoming URI matches a single note ID, does the delete based on the + // incoming data, but modifies the where clause to restrict it to the + // particular note ID. + case MAIN_ID: + // If URI is for a particular row ID, delete is based on incoming + // data but modified to restrict to the given ID. + finalWhere = DatabaseUtils.concatenateWhere( + MainTable._ID + " = " + ContentUris.parseId(uri), where); + count = db.delete(MainTable.TABLE_NAME, finalWhere, whereArgs); + break; + + default: + throw new IllegalArgumentException("Unknown URI " + uri); + } + + getContext().getContentResolver().notifyChange(uri, null); + + return count; + } + + /** + * Handle updating data. + */ + @Override + public int update(Uri uri, ContentValues values, String where, String[] whereArgs) { + SQLiteDatabase db = mOpenHelper.getWritableDatabase(); + int count; + String finalWhere; + + switch (mUriMatcher.match(uri)) { + case MAIN: + // If URI is main table, update uses incoming where clause and args. + count = db.update(MainTable.TABLE_NAME, values, where, whereArgs); + break; + + case MAIN_ID: + // If URI is for a particular row ID, update is based on incoming + // data but modified to restrict to the given ID. + finalWhere = DatabaseUtils.concatenateWhere( + MainTable._ID + " = " + ContentUris.parseId(uri), where); + count = db.update(MainTable.TABLE_NAME, values, finalWhere, whereArgs); + break; + + default: + throw new IllegalArgumentException("Unknown URI " + uri); + } + + getContext().getContentResolver().notifyChange(uri, null); + + return count; + } + } + + @Override + protected void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + + FragmentManager fm = getSupportFragmentManager(); + + // Create the list fragment and add it as our sole content. + if (fm.findFragmentById(android.R.id.content) == null) { + ThrottledLoaderListFragment list = new ThrottledLoaderListFragment(); + fm.beginTransaction().add(android.R.id.content, list).commit(); + } + } + + public static class ThrottledLoaderListFragment extends ListFragment + implements LoaderManager.LoaderCallbacks { + + // Menu identifiers + static final int POPULATE_ID = Menu.FIRST; + static final int CLEAR_ID = Menu.FIRST+1; + + // This is the Adapter being used to display the list's data. + SimpleCursorAdapter mAdapter; + + // If non-null, this is the current filter the user has provided. + String mCurFilter; + + // Task we have running to populate the database. + AsyncTask mPopulatingTask; + + @Override public void onActivityCreated(Bundle savedInstanceState) { + super.onActivityCreated(savedInstanceState); + + setEmptyText("No data. Select 'Populate' to fill with data from Z to A at a rate of 4 per second."); + setHasOptionsMenu(true); + + // Create an empty adapter we will use to display the loaded data. + mAdapter = new SimpleCursorAdapter(getActivity(), + android.R.layout.simple_list_item_1, null, + new String[] { MainTable.COLUMN_NAME_DATA }, + new int[] { android.R.id.text1 }, 0); + setListAdapter(mAdapter); + + // Prepare the loader. Either re-connect with an existing one, + // or start a new one. + getLoaderManager().initLoader(0, null, this); + } + + @Override public void onCreateOptionsMenu(Menu menu, MenuInflater inflater) { + menu.add(Menu.NONE, POPULATE_ID, 0, "Populate") + .setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM); + menu.add(Menu.NONE, CLEAR_ID, 0, "Clear") + .setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM); + } + + @Override public boolean onOptionsItemSelected(MenuItem item) { + final ContentResolver cr = getActivity().getContentResolver(); + + switch (item.getItemId()) { + case POPULATE_ID: + if (mPopulatingTask != null) { + mPopulatingTask.cancel(false); + } + mPopulatingTask = new AsyncTask() { + @Override protected Void doInBackground(Void... params) { + for (char c='Z'; c>='A'; c--) { + if (isCancelled()) { + break; + } + StringBuilder builder = new StringBuilder("Data "); + builder.append(c); + ContentValues values = new ContentValues(); + values.put(MainTable.COLUMN_NAME_DATA, builder.toString()); + cr.insert(MainTable.CONTENT_URI, values); + // Wait a bit between each insert. + try { + Thread.sleep(250); + } catch (InterruptedException e) { + } + } + return null; + } + }; + mPopulatingTask.executeOnExecutor( + AsyncTask.THREAD_POOL_EXECUTOR, (Void[])null); + return true; + + case CLEAR_ID: + if (mPopulatingTask != null) { + mPopulatingTask.cancel(false); + mPopulatingTask = null; + } + AsyncTask task = new AsyncTask() { + @Override protected Void doInBackground(Void... params) { + cr.delete(MainTable.CONTENT_URI, null, null); + return null; + } + }; + task.execute((Void[])null); + return true; + + default: + return super.onOptionsItemSelected(item); + } + } + + @Override public void onListItemClick(ListView l, View v, int position, long id) { + // Insert desired behavior here. + Log.i(TAG, "Item clicked: " + id); + } + + // These are the rows that we will retrieve. + static final String[] PROJECTION = new String[] { + MainTable._ID, + MainTable.COLUMN_NAME_DATA, + }; + + public Loader onCreateLoader(int id, Bundle args) { + CursorLoader cl = new CursorLoader(getActivity(), MainTable.CONTENT_URI, + PROJECTION, null, null, null); + cl.setUpdateThrottle(2000); // update at most every 2 seconds. + return cl; + } + + public void onLoadFinished(Loader loader, Cursor data) { + mAdapter.swapCursor(data); + } + + public void onLoaderReset(Loader loader) { + mAdapter.swapCursor(null); + } + } +} +//END_INCLUDE(complete)