LocalMessageManager
Used for efficient and simple delivery of messages within you application. It's an alternative to LocalBroadcastManager.
- Simple to use
- Can send any arbitrary object (doesn't need to be Parceable / Serializable / Bundle)
- Very efficient - objects are pooled and no new instances are created during delivery
- Uses standard Android Handler for message delivery
- Messages are always delivered to the main UI thread
- No Context needed
- Lightweight - just one main class ( LocalMessageManager)
Comparision with LocalBroadcastManager
- Less complex code (compare with LocalBroadcastManager source)
- No need to use a Bundle to transfer the data and add unnecessary string keys
- Doesn't create any new instances, less impact on Garbage Collector
- No need to define IntentFilters / Actions
- Less error prone due to more straighforward API
How to implement
You can send a message from anywhere. If you don't need any parameters, just use:
LocalMessageManager.getInstance().send(R.id.msg_sample_event);
(The message ID is an integer. You can use simple constants or Android IDs or anything else).
If you want to send an arbitrary object:
LocalMessageManager.getInstance().send(R.id.msg_sample_event, new MyCustomObject());
(you can also send a simple integer argument or a Bundle)
Register receiver. In case of an Activity this is usually onStart(), or onCreate(). You can also put this code into your base activity or fragment.
LocalMessageManager.getInstance().addListener(this);
You can listen to all events or add only a listener to a specific message ID.
Unregister receiver. In case of an Activity this is usually in onStop() or onDestroy(). You can also put this code into your base activity or fragment.
LocalMessageManager.getInstance().removeListener(this);
Create a listener or let your class implement LocalMessageCallback.
@Override public void handleMessage(@NonNull final LocalMessage msg) {
switch (msg.getId()) {
case R.id.msg_sample_event : {
mTextView.setText("Received simple event");
}
break;
}
}
Download
Grab via Gradle:
compile 'eu.inloop:localmessagemanager:0.1.7'