Java tutorial
/* /* * Copyright (C) 2014 The Android Open Source Project * Copyright (C) 2014 The Android Open Source Project * * * Licensed under the Apache License, Version 2.0 (the "License"); * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * You may obtain a copy of the License at * * * http://www.apache.org/licenses/LICENSE-2.0 * http://www.apache.org/licenses/LICENSE-2.0 * * * Unless required by applicable law or agreed to in writing, software * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * See the License for the specific language governing permissions and * limitations under the License. * limitations under the License. */ package com.udacity.sunshine.fragment; import android.content.Intent; import android.database.Cursor; import android.net.Uri; import android.os.Bundle; import android.support.annotation.Nullable; import android.support.v4.app.Fragment; import android.support.v4.app.LoaderManager.LoaderCallbacks; import android.support.v4.content.CursorLoader; import android.support.v4.content.Loader; import android.util.Log; import android.view.LayoutInflater; import android.view.Menu; import android.view.MenuInflater; import android.view.MenuItem; import android.view.View; import android.view.ViewGroup; import android.widget.AdapterView; import android.widget.ListView; import com.udacity.sunshine.R; import com.udacity.sunshine.Utility; import com.udacity.sunshine.adapter.ForecastAdapter; import com.udacity.sunshine.data.WeatherContract.LocationEntry; import com.udacity.sunshine.data.WeatherContract.WeatherEntry; import com.udacity.sunshine.sync.SunshineSyncAdapter; public class ForecastFragment extends Fragment implements LoaderCallbacks<Cursor> { private final String TAG = this.getClass().getSimpleName(); private ForecastAdapter mForecastAdapter; private ListView mListView; private int mPosition = ListView.INVALID_POSITION; private boolean mUseTodayLayout; private static final String SELECTED_KEY = "selected_position"; /** * A callback interface that all activities containing this fragment must * implement. This mechanism allows activities to be notified of item * selections. */ public interface Callback { /** DetailFragmentCallback for when an item has been selected. */ void onItemSelected(Uri dateUri); } private static final int FORECAST_LOADER_ID = 0x001; // For the forecast view we're showing only a small subset(?) of the stored data. // Specify the columns we need. private static final String[] FORECAST_COLUMNS = { // In this case the id needs to be fully qualified with a table name, since // the content provider joins the location & weather tables in the background // (both have an _id column) // On the one hand, that's annoying. On the other, you can search the weather table // using the location set by the user, which is only in the Location table. // So the convenience is worth it. WeatherEntry.TABLE_NAME + "." + WeatherEntry._ID, WeatherEntry.COLUMN_DATE, WeatherEntry.COLUMN_SHORT_DESC, WeatherEntry.COLUMN_MAX_TEMP, WeatherEntry.COLUMN_MIN_TEMP, LocationEntry.COLUMN_LOCATION_SETTING, WeatherEntry.COLUMN_WEATHER_ID, LocationEntry.COLUMN_COORD_LAT, LocationEntry.COLUMN_COORD_LONG }; // These indices() are tied(?) to FORECAST_COLUMNS. If FORECAST_COLUMNS changes, these // must change. public static final int COL_WEATHER_ID = 0; public static final int COL_WEATHER_DATE = 1; public static final int COL_WEATHER_DESC = 2; public static final int COL_WEATHER_MAX_TEMP = 3; public static final int COL_WEATHER_MIN_TEMP = 4; public static final int COL_LOCATION_SETTING = 5; public static final int COL_WEATHER_CONDITION_ID = 6; public static final int COL_COORD_LAT = 7; public static final int COL_COORD_LONG = 8; @Override public void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); // ?? menu Fragment? setHasOptionsMenu(true); } @Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { // The CursorAdapter will take data from our cursor and use it to populate the listView it's attached to mForecastAdapter = new ForecastAdapter(getActivity(), null, 0); View rootView = inflater.inflate(R.layout.fragment_forecast, container, false); mListView = (ListView) rootView.findViewById(R.id.listview_forecast); mListView.setAdapter(mForecastAdapter); mListView.setOnItemClickListener(new AdapterView.OnItemClickListener() { @Override public void onItemClick(AdapterView<?> adapterView, View view, int position, long l) { // CursorAdapter returns a cursor at the correct position for getItem(), // or null if it cannot seek to that position. Cursor cursor = (Cursor) adapterView.getItemAtPosition(position); if (cursor != null) { String locationSetting = Utility.getPreferredLocation(getActivity()); ((Callback) getActivity()).onItemSelected(WeatherEntry .buildWeatherLocationWithDate(locationSetting, cursor.getLong(COL_WEATHER_DATE))); } mPosition = position; } }); // If there's instance state, mine it for useful information. // The end-goal here is that the user never knows that turning their device sideways // does crazy lifecycle related things. It should feel like some stuff stretched out, // or magically appeared to take advantage of room, but data or place in the app was never // actually *lost*. if (savedInstanceState != null && savedInstanceState.containsKey(SELECTED_KEY)) { // The listview probably hasn't even been populated yet. Actually perform the // swapout in onLoadFinished. mPosition = savedInstanceState.getInt(SELECTED_KEY); } mForecastAdapter.setmUseTodayLayout(mUseTodayLayout); return rootView; } @Override public void onActivityCreated(@Nullable Bundle savedInstanceState) { getLoaderManager().initLoader(FORECAST_LOADER_ID, null, this); super.onActivityCreated(savedInstanceState); } @Override public void onSaveInstanceState(Bundle outState) { // When tablets rotate, the currently selected list item needs to be saved. // When no item is selected, mPosition will be set to ListView.INVALID_POSITION, // so check for that before storing. if (mPosition != ListView.INVALID_POSITION) { outState.putInt(SELECTED_KEY, mPosition); } super.onSaveInstanceState(outState); } @Override public void onCreateOptionsMenu(Menu menu, MenuInflater inflater) { inflater.inflate(R.menu.forecastfragment, menu); } @Override public boolean onOptionsItemSelected(MenuItem item) { // AndroidManifest.xml??parent Activity? // ?Home Action int id = item.getItemId(); if (id == R.id.action_refresh) { updateWeather(); return true; } if (id == R.id.action_map) { openPreferredLocationInMap(); } return super.onOptionsItemSelected(item); } private void openPreferredLocationInMap() { // Using the URI scheme for showing a location found on a map. This super-handy // intent can is detailed in the "Common Intents" page of Android's developer site: // http://developer.android.com/guide/components/intents-common.html#Maps if (null != mForecastAdapter) { Cursor cursor = mForecastAdapter.getCursor(); if (null != cursor) { if (!cursor.moveToFirst()) return; cursor.moveToPosition(0); String posLat = cursor.getString(COL_COORD_LAT); String posLong = cursor.getString(COL_COORD_LONG); Uri geoLocation = Uri.parse("geo:" + posLat + "," + posLong); Intent intent = new Intent(Intent.ACTION_VIEW); intent.setData(geoLocation); if (intent.resolveActivity(getActivity().getPackageManager()) != null) { startActivity(intent); } else { Log.d(TAG, "Couldn't call " + geoLocation.toString() + ", no receiving apps installed!"); } } } } public void onIsMetricChanged() { getLoaderManager().restartLoader(FORECAST_LOADER_ID, null, this); } // since we read the location when we create the loader, all we need to do is restart things public void onLocationChanged() { updateWeather(); getLoaderManager().restartLoader(FORECAST_LOADER_ID, null, this); } // private void updateWeather() { // 1. // FetchWeatherTask weatherTask = new FetchWeatherTask(getActivity()); // String location = Utility.getPreferredLocation(getActivity()); // weatherTask.execute(location); // 2. // Intent intent = new Intent(getActivity(), SunshineService.class); // intent.putExtra(SunshineService.LOCATION_QUERY_EXTRA, // Utility.getPreferredLocation(getActivity())); // getActivity().startService(intent); // 3. // Intent alarmIntent = new Intent(getActivity(), SunshineService.AlarmReceiver.class); // alarmIntent.putExtra(SunshineService.LOCATION_QUERY_EXTRA, // Utility.getPreferredLocation(getActivity())); // // // wrap in a pending intent which only fires once. // PendingIntent pi = PendingIntent.getBroadcast(getActivity(), // 0, // alarmIntent, // PendingIntent.FLAG_ONE_SHOT); // getBroadcast(context, 0, i, 0); // // AlarmManager alarmManager = (AlarmManager) getActivity().getSystemService(Context.ALARM_SERVICE); // // // Set the AlarmManager to wake up the system. // alarmManager.set(AlarmManager.RTC, System.currentTimeMillis() + 5000, pi); SunshineSyncAdapter.syncImmediately(getActivity()); } @Override public Loader<Cursor> onCreateLoader(int id, Bundle args) { // This is called when a new Loader needs to be created, This // fragment only uses one loader, so we don't care about checking the id. // To only show current and future dates, filter the query to return weather only for // dates after or including today. String locationSetting = Utility.getPreferredLocation(getActivity()); // sort order : Ascending, by date. String sortOrder = WeatherEntry.COLUMN_DATE + " ASC"; Uri weatherForLocationUri = WeatherEntry.buildWeatherLocationWithStartDate(locationSetting, System.currentTimeMillis()); return new CursorLoader(getActivity(), weatherForLocationUri, FORECAST_COLUMNS, // null for all null, null, sortOrder); } @Override public void onLoadFinished(Loader<Cursor> loader, Cursor cursor) { mForecastAdapter.swapCursor(cursor); mForecastAdapter.notifyDataSetChanged(); if (mPosition != ListView.INVALID_POSITION) { // If we don't need to restart the loader, and there's a desired position to restore to, do so now. mListView.smoothScrollToPosition(mPosition); } } @Override public void onLoaderReset(Loader<Cursor> loader) { mForecastAdapter.swapCursor(null); } public void setUseTodayLayout(boolean useTodayLayout) { mUseTodayLayout = useTodayLayout; if (mForecastAdapter != null) { mForecastAdapter.setmUseTodayLayout(useTodayLayout); } } }