Java tutorial
/* * Copyright (C) 2012 Andrew Neal 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.boko.vimusic.ui.fragments; import static com.boko.vimusic.utils.PreferenceUtils.ALBUM_LAYOUT; import java.util.List; import android.app.Activity; import android.os.Bundle; import android.os.SystemClock; import android.support.v4.app.Fragment; import android.support.v4.app.LoaderManager.LoaderCallbacks; import android.support.v4.content.Loader; import android.view.ContextMenu; import android.view.ContextMenu.ContextMenuInfo; import android.view.LayoutInflater; import android.view.Menu; import android.view.MenuItem; import android.view.SubMenu; import android.view.View; import android.view.ViewGroup; import android.widget.AbsListView; import android.widget.AbsListView.OnScrollListener; import android.widget.AdapterView; import android.widget.AdapterView.AdapterContextMenuInfo; import android.widget.AdapterView.OnItemClickListener; import android.widget.GridView; import android.widget.ListView; import android.widget.TextView; import com.boko.vimusic.MusicStateListener; import com.boko.vimusic.R; import com.boko.vimusic.adapters.AlbumAdapter; import com.boko.vimusic.cache.ImageFetcher; import com.boko.vimusic.loaders.AlbumLoader; import com.boko.vimusic.menu.CreateNewPlaylist; import com.boko.vimusic.menu.DeleteDialog; import com.boko.vimusic.menu.FragmentMenuItems; import com.boko.vimusic.model.Album; import com.boko.vimusic.model.Song; import com.boko.vimusic.recycler.RecycleHolder; import com.boko.vimusic.ui.activities.BaseActivity; import com.boko.vimusic.utils.CommonUtils; import com.boko.vimusic.utils.MusicUtils; import com.boko.vimusic.utils.NavUtils; import com.boko.vimusic.utils.PreferenceUtils; import com.viewpagerindicator.TitlePageIndicator; /** * This class is used to display all of the albums on a user's device. * * @author Andrew Neal (andrewdneal@gmail.com) */ public class AlbumFragment extends Fragment implements LoaderCallbacks<List<Album>>, OnScrollListener, OnItemClickListener, MusicStateListener { /** * Used to keep context menu items from bleeding into other fragments */ private static final int GROUP_ID = 3; /** * Grid view column count. ONE - list, TWO - normal grid, FOUR - landscape */ private static final int ONE = 1, TWO = 2, FOUR = 4; /** * LoaderCallbacks identifier */ private static final int LOADER = 0; /** * Fragment UI */ private ViewGroup mRootView; /** * The adapter for the grid */ private AlbumAdapter mAdapter; /** * The grid view */ private GridView mGridView; /** * The list view */ private ListView mListView; /** * Album song list */ private Song[] mAlbumList; /** * Represents an album */ private Album mAlbum; /** * True if the list should execute {@code #restartLoader()}. */ private boolean mShouldRefresh = false; /** * {@inheritDoc} */ @Override public void onAttach(final Activity activity) { super.onAttach(activity); // Register the music status listener ((BaseActivity) activity).setMusicStateListenerListener(this); } /** * {@inheritDoc} */ @Override public void onCreate(final Bundle savedInstanceState) { super.onCreate(savedInstanceState); int layout = R.layout.list_item_normal; if (isSimpleLayout()) { layout = R.layout.list_item_normal; } else if (isDetailedLayout()) { layout = R.layout.list_item_detailed; } else { layout = R.layout.grid_items_normal; } mAdapter = new AlbumAdapter(getActivity(), layout); } /** * {@inheritDoc} */ @Override public View onCreateView(final LayoutInflater inflater, final ViewGroup container, final Bundle savedInstanceState) { // The View for the fragment's UI if (isSimpleLayout()) { mRootView = (ViewGroup) inflater.inflate(R.layout.list_base, null); initListView(); } else { mRootView = (ViewGroup) inflater.inflate(R.layout.grid_base, null); initGridView(); } return mRootView; } /** * {@inheritDoc} */ @Override public void onActivityCreated(final Bundle savedInstanceState) { super.onActivityCreated(savedInstanceState); // Enable the options menu setHasOptionsMenu(true); // Start the loader getLoaderManager().initLoader(LOADER, null, this); } /** * {@inheritDoc} */ @Override public void onPause() { super.onPause(); mAdapter.flush(); } /** * {@inheritDoc} */ @Override public void onCreateContextMenu(final ContextMenu menu, final View v, final ContextMenuInfo menuInfo) { super.onCreateContextMenu(menu, v, menuInfo); // Get the position of the selected item final AdapterContextMenuInfo info = (AdapterContextMenuInfo) menuInfo; // Create a new album mAlbum = mAdapter.getItem(info.position); // Create a list of the album's songs mAlbumList = MusicUtils.getSongListForAlbum(getActivity(), mAlbum.getId()); // Play the album menu.add(GROUP_ID, FragmentMenuItems.PLAY_SELECTION, Menu.NONE, getString(R.string.context_menu_play_selection)); // Add the album to the queue menu.add(GROUP_ID, FragmentMenuItems.ADD_TO_QUEUE, Menu.NONE, getString(R.string.add_to_queue)); // Add the album to a playlist final SubMenu subMenu = menu.addSubMenu(GROUP_ID, FragmentMenuItems.ADD_TO_PLAYLIST, Menu.NONE, R.string.add_to_playlist); MusicUtils.makePlaylistMenu(getActivity(), GROUP_ID, subMenu, false); // View more content by the album artist menu.add(GROUP_ID, FragmentMenuItems.MORE_BY_ARTIST, Menu.NONE, getString(R.string.context_menu_more_by_artist)); // Remove the album from the list menu.add(GROUP_ID, FragmentMenuItems.DELETE, Menu.NONE, getString(R.string.context_menu_delete)); } /** * {@inheritDoc} */ @Override public boolean onContextItemSelected(final MenuItem item) { // Avoid leaking context menu selections if (item.getGroupId() == GROUP_ID) { switch (item.getItemId()) { case FragmentMenuItems.PLAY_SELECTION: MusicUtils.playAll(getActivity(), mAlbumList, 0, false); return true; case FragmentMenuItems.ADD_TO_QUEUE: MusicUtils.addToQueue(getActivity(), mAlbumList); return true; case FragmentMenuItems.NEW_PLAYLIST: CreateNewPlaylist.getInstance(mAlbumList).show(getFragmentManager(), "CreatePlaylist"); return true; case FragmentMenuItems.MORE_BY_ARTIST: NavUtils.openArtistProfile(getActivity(), mAlbum.mArtistName); return true; case FragmentMenuItems.PLAYLIST_SELECTED: final String id = item.getIntent().getStringExtra("playlist"); MusicUtils.addToPlaylist(getActivity(), mAlbumList, id); return true; case FragmentMenuItems.DELETE: mShouldRefresh = true; final String album = mAlbum.getName(); DeleteDialog .newInstance(album, mAlbumList, ImageFetcher.generateAlbumCacheKey(album, mAlbum.mArtistName)) .show(getFragmentManager(), "DeleteDialog"); return true; default: break; } } return super.onContextItemSelected(item); } /** * {@inheritDoc} */ @Override public void onScrollStateChanged(final AbsListView view, final int scrollState) { // Pause disk cache access to ensure smoother scrolling if (scrollState == AbsListView.OnScrollListener.SCROLL_STATE_FLING || scrollState == AbsListView.OnScrollListener.SCROLL_STATE_TOUCH_SCROLL) { mAdapter.setPauseDiskCache(true); } else { mAdapter.setPauseDiskCache(false); mAdapter.notifyDataSetChanged(); } } /** * {@inheritDoc} */ @Override public void onItemClick(final AdapterView<?> parent, final View view, final int position, final long id) { mAlbum = mAdapter.getItem(position); NavUtils.openAlbumProfile(getActivity(), mAlbum.getName(), mAlbum.mArtistName, mAlbum.getId()); } /** * {@inheritDoc} */ @Override public Loader<List<Album>> onCreateLoader(final int id, final Bundle args) { return new AlbumLoader(getActivity()); } /** * {@inheritDoc} */ @Override public void onLoadFinished(final Loader<List<Album>> loader, final List<Album> data) { // Check for any errors if (data.isEmpty()) { // Set the empty text final TextView empty = (TextView) mRootView.findViewById(R.id.empty); empty.setText(getString(R.string.empty_music)); if (isSimpleLayout()) { mListView.setEmptyView(empty); } else { mGridView.setEmptyView(empty); } return; } // Start fresh mAdapter.unload(); // Add the data to the adpater for (final Album album : data) { mAdapter.add(album); } // Build the cache mAdapter.buildCache(); } /** * {@inheritDoc} */ @Override public void onLoaderReset(final Loader<List<Album>> loader) { // Clear the data in the adapter mAdapter.unload(); } /** * Scrolls the list to the currently playing album when the user touches the * header in the {@link TitlePageIndicator}. */ public void scrollToCurrentAlbum() { final int currentAlbumPosition = getItemPositionByAlbum(); if (currentAlbumPosition != 0) { if (isSimpleLayout()) { mListView.setSelection(currentAlbumPosition); } else { mGridView.setSelection(currentAlbumPosition); } } } /** * @return The position of an item in the list or grid based on the id of * the currently playing album. */ private int getItemPositionByAlbum() { final String albumId = MusicUtils.getCurrentAlbumId(); if (mAdapter == null) { return 0; } for (int i = 0; i < mAdapter.getCount(); i++) { if (mAdapter.getItem(i).getId().equals(albumId)) { return i; } } return 0; } /** * Restarts the loader. */ public void refresh() { // Wait a moment for the preference to change. SystemClock.sleep(10); getLoaderManager().restartLoader(LOADER, null, this); } /** * {@inheritDoc} */ @Override public void onScroll(final AbsListView view, final int firstVisibleItem, final int visibleItemCount, final int totalItemCount) { // Nothing to do } /** * {@inheritDoc} */ @Override public void restartLoader() { // Update the list when the user deletes any items if (mShouldRefresh) { getLoaderManager().restartLoader(LOADER, null, this); } mShouldRefresh = false; } /** * {@inheritDoc} */ @Override public void onMetaChanged() { // Nothing to do } /** * Sets up various helpers for both the list and grid * * @param list * The list or grid */ private void initAbsListView(final AbsListView list) { // Release any references to the recycled Views list.setRecyclerListener(new RecycleHolder()); // Listen for ContextMenus to be created list.setOnCreateContextMenuListener(this); // Show the albums and songs from the selected artist list.setOnItemClickListener(this); // To help make scrolling smooth list.setOnScrollListener(this); } /** * Sets up the list view */ private void initListView() { // Initialize the grid mListView = (ListView) mRootView.findViewById(R.id.list_base); // Set the data behind the list mListView.setAdapter(mAdapter); // Set up the helpers initAbsListView(mListView); mAdapter.setTouchPlay(true); } /** * Sets up the grid view */ private void initGridView() { // Initialize the grid mGridView = (GridView) mRootView.findViewById(R.id.grid_base); // Set the data behind the grid mGridView.setAdapter(mAdapter); // Set up the helpers initAbsListView(mGridView); if (CommonUtils.isLandscape(getActivity())) { if (isDetailedLayout()) { mAdapter.setLoadExtraData(true); mGridView.setNumColumns(TWO); } else { mGridView.setNumColumns(FOUR); } } else { if (isDetailedLayout()) { mAdapter.setLoadExtraData(true); mGridView.setNumColumns(ONE); } else { mGridView.setNumColumns(TWO); } } } private boolean isSimpleLayout() { return PreferenceUtils.getInstance(getActivity()).isSimpleLayout(ALBUM_LAYOUT, getActivity()); } private boolean isDetailedLayout() { return PreferenceUtils.getInstance(getActivity()).isDetailedLayout(ALBUM_LAYOUT, getActivity()); } }