Android Open Source - Absolute-Android-RSS A A Widget Provider

• Back to Development/rss  ↑

From Project

Back to project page Absolute-Android-RSS.

License

The source code is released under:

Apache License

Java Source Code

/*Copyright 2010 University Of Utah Android Development Group
 *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
 *// w w w.  ja v a2  s .c o m
 * 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.AA.Recievers;

import java.util.ArrayList;
import java.util.Collections;

import android.app.PendingIntent;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.content.SharedPreferences;
import android.content.SharedPreferences.Editor;
import android.os.Bundle;
import android.widget.RemoteViews;

import com.AA.R;
import com.AA.Activities.AAMain;
import com.AA.Other.Article;
import com.AA.Services.RssService;

/***
 * Receiver for the widget; Handles updates for the widget
 */
public class AAWidgetProvider extends AppWidgetProvider {
  /***
   * Receiver for anything that shoots off an intent "RSSFinish"
   * or an intent that is meant to update the widget
   */
  @Override public void onReceive(Context context, Intent intent) {
    //If we have finished fetching new data;
    //Otherwise launch our service to fetch the data
    //TODO - May change this a bit. Tends to do some weird things with the
    //Enabled intent. Apparantly that gets called in all sorts of random places, and
    //we only need it for BootComplete and only if there is at least one widget on the home
    if(intent.getAction().equals("RSSFinish"))  {
      updateArticles(context, intent);
    } else if(intent.getAction().equals(AppWidgetManager.ACTION_APPWIDGET_ENABLED)) {
      launchService(context);
    }

    super.onReceive(context, intent);
  }  

  /***
   * This method handles when a widget or multiple widgets are removed from
   * the homescreen(or some other embedded location)
   */
  @Override public void onDeleted(Context context, int[] appWidgetIds) {
    SharedPreferences settings = context.getSharedPreferences("settings", 0);
    Editor edit = settings.edit();
    edit.putInt("widgetCount", settings.getInt("widgetCount", 0) - 1);

    //Go through all the widgets that are being deleted, and remove their
    //data from the settings file
    for(int i = 0; i < appWidgetIds.length; i++) {
      edit.remove("" + appWidgetIds[i]);
    }
    edit.commit();

    //If we have no more widgets, there is no need for background updates
    if(settings.getInt("widgetCount", 0) <= 0)
      AlarmReceiver.stopAlarm(context);
  }

  /***
   * Updates the widget with the newest article
   * 
   * @param context - Context that gives us access to some system operations
   * @param intent - The intent that launched this receiver
   */
  private static void updateArticles(Context context, Intent intent) {
    //Gets the bundle sent from RssService
    Bundle articleBundle = intent.getBundleExtra("articles");
    ArrayList<String> titles = articleBundle.getStringArrayList("titles");
    ArrayList<Article> articles = new ArrayList<Article>();

    //If this was called before service did any work, set the list to an empty list
    if(titles == null)
      titles = new ArrayList<String>();

    //For every article in our bundle, add it into our new arraylist
    for(String title : titles)
      articles.add((Article)articleBundle.getSerializable(title));

    //Sort the list and update the widget with the latest article(or throw up an error message)
    Collections.sort(articles);  
    if(!articles.isEmpty())
      updateWidget(context, articles.get(0).getTitle(), articles.get(0).getDescription());
    else
      updateWidget(context, "Uh Oh", "Something happened. No data received");
  }
  
  /***
   * Sends out an update to the widget with the given title and description
   *
   * @param context - Context that gives us access to some system operations
   * @param title - Text that will go in the title block
   * @param description - Text that goes in the description block
   */
  private static void updateWidget(Context context, String title, String description)  {
    AppWidgetManager widgetManager = AppWidgetManager.getInstance(context);

    //Tells our widget to open the activity when the widget is clicked
    Intent activity = new Intent();
    activity.setClass(context, AAMain.class);
    PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, activity, 0);

    //Gets the "Remote View" of our widget layout. Internally inflates the 
    //views inside it and updates pieces that we request
    RemoteViews rv_main = new RemoteViews(context.getPackageName(),R.layout.widget_layout);
    rv_main.setOnClickPendingIntent(R.id.iv_widget_bottom, pendingIntent);
    rv_main.setOnClickPendingIntent(R.id.iv_widget_top, pendingIntent);    
    rv_main.setTextViewText(R.id.tv_title, title);
    rv_main.setTextViewText(R.id.tv_description, description);

    //For every registered widget, set the image for the top bar(left or center aligned)
    //and update the widget
    int[] widgetIds = widgetManager.getAppWidgetIds(
        new ComponentName(context, AAWidgetProvider.class));
    for(int i = 0; i < widgetIds.length; i++) {
      rv_main.setImageViewResource(R.id.iv_widget_top,
          context.getSharedPreferences("settings", 0).getInt(
              "" + widgetIds[i], R.drawable.widget_layout_top));

      widgetManager.updateAppWidget(widgetIds[i], rv_main);
    }
  }

  /***
   * Launches the service and updates the widget with some prep data
   *
   * @param context - Context that gives us access to system functions
   */
  public static void launchService(Context context) {
    updateWidget(context, "Fetching Data...", "Please wait while I get latest news.");
    AlarmReceiver.startAlarm(context);
    Intent service = new Intent();
    service.putExtra("background", true);
    service.setClass(context, RssService.class);
    context.startService(service);
  }
}

Java Source Code List

• Back to Development/rss  ↑