mCallback. */
private static final class EmptyCallback implements Callback {
public static final Callback INSTANCE = new EmptyCallback();
@Override public void onBind(MailboxListItem listItem) { }
}
/*
* The type of the row to present to the user. There are 4 defined rows that each
* have a slightly different look. These are typically used in the constant column
* {@link #ROW_TYPE} specified in {@link #PROJECTION} and {@link #SUBMAILBOX_PROJECTION}.
*/
/** Both regular and combined mailboxes */
private static final int ROW_TYPE_MAILBOX = 0;
/** Account "mailboxes" in the combined view */
private static final int ROW_TYPE_ACCOUNT = 1;
// The following types are used when drilling into a mailbox
/** The current mailbox */
private static final int ROW_TYPE_CURMAILBOX = 2;
/** Sub mailboxes */
private static final int ROW_TYPE_SUBMAILBOX = 3;
/** Header */
private static final int ROW_TYPE_HEADER = 4;
/** The type of data contained in the cursor row. */
private static final String ROW_TYPE = "rowType";
/** The original ID of the cursor row. May be negative. */
private static final String ORIGINAL_ID = "orgMailboxId";
/**
* Projection for a typical mailbox or account row.
* NOTE This projection contains two ID columns. The first, named "_id", is used
* by the framework ListView implementation. Since ListView does not handle negative IDs in
* this column, we define a "mailbox_id" column that contains the real mailbox ID; which
* may be negative for special mailboxes.
*/
private static final String[] PROJECTION = new String[] { MailboxColumns.ID,
MailboxColumns.ID + " AS " + ORIGINAL_ID,
MailboxColumns.DISPLAY_NAME, MailboxColumns.TYPE, MailboxColumns.UNREAD_COUNT,
MailboxColumns.MESSAGE_COUNT, ROW_TYPE_MAILBOX + " AS " + ROW_TYPE,
MailboxColumns.FLAGS, MailboxColumns.ACCOUNT_KEY };
/**
* Projection used to retrieve immediate children for a mailbox. The columns need to
* be identical to those in {@link #PROJECTION}. We are only changing the constant
* column {@link #ROW_TYPE}.
*/
private static final String[] SUBMAILBOX_PROJECTION = new String[] { MailboxColumns.ID,
MailboxColumns.ID + " AS " + ORIGINAL_ID,
MailboxColumns.DISPLAY_NAME, MailboxColumns.TYPE, MailboxColumns.UNREAD_COUNT,
MailboxColumns.MESSAGE_COUNT, ROW_TYPE_SUBMAILBOX + " AS " + ROW_TYPE,
MailboxColumns.FLAGS, MailboxColumns.ACCOUNT_KEY };
private static final String[] CURMAILBOX_PROJECTION = new String[] { MailboxColumns.ID,
MailboxColumns.ID + " AS " + ORIGINAL_ID,
MailboxColumns.DISPLAY_NAME, MailboxColumns.TYPE, MailboxColumns.UNREAD_COUNT,
MailboxColumns.MESSAGE_COUNT, ROW_TYPE_CURMAILBOX + " AS " + ROW_TYPE,
MailboxColumns.FLAGS, MailboxColumns.ACCOUNT_KEY };
/** Project to use for matrix cursors; rows MUST be identical to {@link #PROJECTION} */
private static final String[] MATRIX_PROJECTION = new String[] {
MailboxColumns.ID, ORIGINAL_ID, MailboxColumns.DISPLAY_NAME, MailboxColumns.TYPE,
MailboxColumns.UNREAD_COUNT, MailboxColumns.MESSAGE_COUNT, ROW_TYPE, MailboxColumns.FLAGS,
MailboxColumns.ACCOUNT_KEY };
/** All mailboxes for the account */
private static final String ALL_MAILBOX_SELECTION = MailboxColumns.ACCOUNT_KEY + "=?" +
" AND " + Mailbox.USER_VISIBLE_MAILBOX_SELECTION;
/** All system mailboxes for an account */
private static final String SYSTEM_MAILBOX_SELECTION = ALL_MAILBOX_SELECTION
+ " AND " + MailboxColumns.TYPE + "!=" + Mailbox.TYPE_MAIL;
/** All mailboxes with the given parent */
private static final String USER_MAILBOX_SELECTION_WITH_PARENT = ALL_MAILBOX_SELECTION
+ " AND " + MailboxColumns.PARENT_KEY + "=?"
+ " AND " + MailboxColumns.TYPE + "=" + Mailbox.TYPE_MAIL;
/** Selection for a specific mailbox */
private static final String MAILBOX_SELECTION = MailboxColumns.ACCOUNT_KEY + "=?"
+ " AND " + MailboxColumns.ID + "=?";
private static final String MAILBOX_ORDER_BY = "CASE " + MailboxColumns.TYPE
+ " WHEN " + Mailbox.TYPE_INBOX + " THEN 0"
+ " WHEN " + Mailbox.TYPE_DRAFTS + " THEN 1"
+ " WHEN " + Mailbox.TYPE_OUTBOX + " THEN 2"
+ " WHEN " + Mailbox.TYPE_SENT + " THEN 3"
+ " WHEN " + Mailbox.TYPE_TRASH + " THEN 4"
+ " WHEN " + Mailbox.TYPE_JUNK + " THEN 5"
// Other mailboxes (i.e. of Mailbox.TYPE_MAIL) are shown in alphabetical order.
+ " ELSE 10 END"
+ " ," + MailboxColumns.DISPLAY_NAME + " COLLATE LOCALIZED ASC";
/** View is of a "normal" row */
private static final int ITEM_VIEW_TYPE_NORMAL = 0;
/** View is of a separator row */
private static final int ITEM_VIEW_TYPE_HEADER = AdapterView.ITEM_VIEW_TYPE_HEADER_OR_FOOTER;
private static boolean sEnableUpdate = true;
private final LayoutInflater mInflater;
private final ResourceHelper mResourceHelper;
private final Callback mCallback;
public MailboxFragmentAdapter(Context context, Callback callback) {
super(context, null, 0 /* flags; no content observer */);
mInflater = (LayoutInflater) context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
mCallback = (callback == null) ? EmptyCallback.INSTANCE : callback;
mResourceHelper = ResourceHelper.getInstance(context);
}
@Override
public int getViewTypeCount() {
return 2;
}
@Override
public int getItemViewType(int position) {
return isHeader(position) ? ITEM_VIEW_TYPE_HEADER : ITEM_VIEW_TYPE_NORMAL;
}
@Override
public boolean isEnabled(int position) {
return !isHeader(position);
}
// The LabelList has headers which are not
// enabled.
@Override
public boolean areAllItemsEnabled() {
return false;
}
@Override
public void bindView(View view, Context context, Cursor cursor) {
if (view instanceof MailboxListItem) {
bindListItem(view, context, cursor);
} else {
bindListHeader(view, context, cursor);
}
}
@Override
public View newView(Context context, Cursor cursor, ViewGroup parent) {
if (cursor.getInt(cursor.getColumnIndex(ROW_TYPE)) == ROW_TYPE_HEADER) {
return mInflater.inflate(R.layout.mailbox_list_header, parent, false);
}
return mInflater.inflate(R.layout.mailbox_list_item, parent, false);
}
private boolean isHeader(int position) {
Cursor c = getCursor();
if ((c == null) || c.isClosed()) {
return false;
}
c.moveToPosition(position);
int rowType = c.getInt(c.getColumnIndex(ROW_TYPE));
return rowType == ROW_TYPE_HEADER;
}
/** Returns {@code true} if the specified row is of an account in the combined view. */
boolean isAccountRow(int position) {
return isAccountRow((Cursor) getItem(position));
}
/**
* Returns {@code true} if the specified row is a mailbox.
* ({@link #ROW_TYPE_MAILBOX}, {@link #ROW_TYPE_CURMAILBOX} and {@link #ROW_TYPE_SUBMAILBOX})
*/
boolean isMailboxRow(int position) {
return isMailboxRow((Cursor) getItem(position));
}
/** Returns {@code true} if the current row is of an account in the combined view. */
private static boolean isAccountRow(Cursor cursor) {
return getRowType(cursor) == ROW_TYPE_ACCOUNT;
}
/** Returns {@code true} if the current row is a header */
private static boolean isHeaderRow(Cursor cursor) {
return getRowType(cursor) == ROW_TYPE_HEADER;
}
/**
* Returns {@code true} if the current row is a mailbox.
* ({@link #ROW_TYPE_MAILBOX}, {@link #ROW_TYPE_CURMAILBOX} and {@link #ROW_TYPE_SUBMAILBOX})
*/
private static boolean isMailboxRow(Cursor cursor) {
return !(isAccountRow(cursor) || isHeaderRow(cursor));
}
/**
* Returns the ID of the given row. It may be a mailbox or account ID depending upon the
* result of {@link #isAccountRow}.
*/
long getId(int position) {
Cursor c = (Cursor) getItem(position);
return getId(c);
}
/**
* Returns the account ID of the mailbox owner for the given row. If the given row is a
* combined mailbox, {@link Account#ACCOUNT_ID_COMBINED_VIEW} is returned. If the given
* row is an account, returns the account's ID [the same as {@link #ORIGINAL_ID}].
*/
long getAccountId(int position) {
Cursor c = (Cursor) getItem(position);
return getAccountId(c);
}
/**
* Turn on and off list updates; during a drag operation, we do NOT want to the list of
* mailboxes to update, as this would be visually jarring
* @param state whether or not the MailboxList can be updated
*/
static void enableUpdates(boolean state) {
sEnableUpdate = state;
}
private static String getDisplayName(Context context, Cursor cursor) {
final String name = cursor.getString(cursor.getColumnIndex(MailboxColumns.DISPLAY_NAME));
if (isHeaderRow(cursor) || isAccountRow(cursor)) {
// Always use actual name
return name;
} else {
// Use this method for two purposes:
// - Set combined mailbox names
// - Rewrite special mailbox names (e.g. trash)
FolderProperties fp = FolderProperties.getInstance(context);
return fp.getDisplayName(getType(cursor), getId(cursor), name);
}
}
static long getId(Cursor cursor) {
return cursor.getLong(cursor.getColumnIndex(ORIGINAL_ID));
}
static int getType(Cursor cursor) {
return cursor.getInt(cursor.getColumnIndex(MailboxColumns.TYPE));
}
static int getMessageCount(Cursor cursor) {
return cursor.getInt(cursor.getColumnIndex(MailboxColumns.MESSAGE_COUNT));
}
static int getUnreadCount(Cursor cursor) {
return cursor.getInt(cursor.getColumnIndex(MailboxColumns.UNREAD_COUNT));
}
static long getAccountId(Cursor cursor) {
return cursor.getLong(cursor.getColumnIndex(MailboxColumns.ACCOUNT_KEY));
}
private static int getRowType(Cursor cursor) {
return cursor.getInt(cursor.getColumnIndex(ROW_TYPE));
}
private static int getFlags(Cursor cursor) {
return cursor.getInt(cursor.getColumnIndex(MailboxColumns.FLAGS));
}
/**
* {@link Cursor} with extra information which is returned by the loader created by
* {@link MailboxFragmentAdapter#createMailboxesLoader}.
*/
static class CursorWithExtras extends CursorWrapper {
/**
* The number of mailboxes in the cursor if the cursor contains top-level mailboxes.
* Otherwise, the number of *child* mailboxes.
*/
public final int mChildCount;
CursorWithExtras(Cursor cursor, int childCount) {
super(cursor);
mChildCount = childCount;
}
}
private void bindListHeader(View view, Context context, Cursor cursor) {
final TextView nameView = (TextView) view.findViewById(R.id.display_name);
nameView.setText(getDisplayName(context, cursor));
}
private void bindListItem(View view, Context context, Cursor cursor) {
final boolean isAccount = isAccountRow(cursor);
final int type = getType(cursor);
final long id = getId(cursor);
final long accountId = getAccountId(cursor);
final int flags = getFlags(cursor);
final int rowType = getRowType(cursor);
final boolean hasVisibleChildren = (flags & Mailbox.FLAG_HAS_CHILDREN) != 0
&& (flags & Mailbox.FLAG_CHILDREN_VISIBLE) != 0;
MailboxListItem listItem = (MailboxListItem)view;
listItem.mMailboxId = isAccountRow(cursor) ? Mailbox.NO_MAILBOX : id;
listItem.mMailboxType = type;
listItem.mAccountId = accountId;
listItem.mIsValidDropTarget = (id >= 0)
&& !Utility.arrayContains(Mailbox.INVALID_DROP_TARGETS, type)
&& (flags & Mailbox.FLAG_ACCEPTS_MOVED_MAIL) != 0;
listItem.mIsNavigable = hasVisibleChildren;
listItem.mAdapter = this;
// Set the background depending on whether we're in drag mode, the mailbox is a valid
// target, etc.
mCallback.onBind(listItem);
// Set mailbox name
final TextView nameView = (TextView) view.findViewById(R.id.mailbox_name);
nameView.setText(getDisplayName(context, cursor));
// Set count
final int count;
if (isAccountRow(cursor)) {
count = getUnreadCount(cursor);
} else {
FolderProperties fp = FolderProperties.getInstance(context);
count = fp.getMessageCount(type, getUnreadCount(cursor), getMessageCount(cursor));
}
final TextView countView = (TextView) view.findViewById(R.id.message_count);
// Set folder icon
final ImageView folderIcon = (ImageView) view.findViewById(R.id.folder_icon);
folderIcon.setImageDrawable(
FolderProperties.getInstance(context).getIcon(type, id, flags));
final ImageView mailboxExpandedIcon =
(ImageView) view.findViewById(R.id.folder_expanded_icon);
switch (rowType) {
case ROW_TYPE_SUBMAILBOX:
if (hasVisibleChildren) {
mailboxExpandedIcon.setVisibility(View.VISIBLE);
mailboxExpandedIcon.setImageResource(
R.drawable.ic_mailbox_collapsed_holo_light);
} else {
mailboxExpandedIcon.setVisibility(View.INVISIBLE);
mailboxExpandedIcon.setImageDrawable(null);
}
folderIcon.setVisibility(View.INVISIBLE);
break;
case ROW_TYPE_CURMAILBOX:
mailboxExpandedIcon.setVisibility(View.GONE);
mailboxExpandedIcon.setImageDrawable(null);
folderIcon.setVisibility(View.GONE);
break;
case ROW_TYPE_MAILBOX:
default: // Includes ROW_TYPE_ACCOUNT
if (hasVisibleChildren) {
mailboxExpandedIcon.setVisibility(View.VISIBLE);
mailboxExpandedIcon.setImageResource(
R.drawable.ic_mailbox_collapsed_holo_light);
} else {
mailboxExpandedIcon.setVisibility(View.GONE);
mailboxExpandedIcon.setImageDrawable(null);
}
folderIcon.setVisibility(View.VISIBLE);
break;
}
// If the unread count is zero, not to show countView.
if (count > 0) {
countView.setVisibility(View.VISIBLE);
countView.setText(Integer.toString(count));
} else {
countView.setVisibility(View.GONE);
}
final View chipView = view.findViewById(R.id.color_chip);
if (isAccount) {
chipView.setVisibility(View.VISIBLE);
chipView.setBackgroundColor(mResourceHelper.getAccountColor(id));
} else {
chipView.setVisibility(View.GONE);
}
}
/**
* Returns a cursor loader for the mailboxes of the given account. If parentKey
* refers to a valid mailbox ID [e.g. non-zero], restrict the loader to only those mailboxes
* contained by this parent mailbox.
*
* Note the returned loader always returns a {@link CursorWithExtras}.
*/
static Loader