Receiving intents

Since AndroidAnnotations 3.1

The @Receiver annotation let your code be notified of intents without having to manually declare and register a BroadcastReceiver.

@EActivity
public class ActivityWithValidReceiver extends Activity {

  @Receiver(actions = "org.androidannotations.ACTION_1")
  protected void onAction1() {
    // Will be called when an org.androidannotations.ACTION_1 intent is sent.
  }
}

The @Receiver supports activities, fragments and services.

Registration

The annotation creates and registers programmatically a BroadcastReceiver during the lifecycle of the the parent class (Activity, Fragment or Service) according to the registerAt optional parameter.

@EFragment
public class FragmentWithValidReceiver extends Fragment {

  @Receiver(actions = "org.androidannotations.ACTION_1")
  protected void onAction1RegisteredOnCreateOnDestroy() {
  }

  @Receiver(actions = "org.androidannotations.ACTION_2", registerAt = Receiver.RegisterAt.OnAttachOnDetach)
  protected void onAction2RegisteredOnAttachOnDetach(Intent intent) {
  }

  @Receiver(actions = "org.androidannotations.ACTION_3", registerAt = Receiver.RegisterAt.OnStartOnStop)
  protected void action3RegisteredOnStartOnStop() {
  }

  @Receiver(actions = "org.androidannotations.ACTION_4", registerAt = Receiver.RegisterAt.OnResumeOnPause)
  protected void action4RegisteredOnResumeOnPause(Intent intent) {
  }
}

The registration may occur at:

• OnCreateOnDestroy (default)
• OnAttachOnDetach
• OnResumeOnPause
• OnStartOnStop

Local broadcasting

The optional parameter local register the BroadcastReceiver locally using LocalBroadcastManager

@EService
public class ServiceWithValidReceiver extends Service {

  @Receiver(actions = "org.androidannotations.ACTION_1", local = true)
  protected void onAction1OnCreate() {  
  }

  @Override
  public IBinder onBind(Intent intent) {
    return null;
  }
}