This library is designed for the communication between classes in java / android by sending and receiving messages. Messages can be any object.
The design of this library is such that the modularity of the code is enhanced and provide a controlled system for sending and receiving messages. One of the key advantages of this library is that the message handling can be done both synchronusly(if the sender thread is same as the receiver thread) or asynchronously as provided. All the subscribing classes are holded with weakreferences, hense the memory leak do not take place. The usecases in which this library's power can be understood is when compared to other pub/sub libraries. Situations in which many instances of a single class require to process messages based on the sender. Example: A class wants to send message to few of the instances of the same class. The schema diagram provided below will provide a better insight.
- Default Channel: This is the prebuilt channel and allows global communication. When subscribed to this channel, the class can send messages to all the subscribed classes with message type, on this channel.
- Public Channel: This channel is designed for filtered communication. Public channels are created and the subscribers of this channel can receive messages broadcasted to this channel. The messages can also be send to selected subscribes.
- Private Channel: This channel is designed to control the access to the channel. The private channels need to be created and stores the owner information. Only the owner can add new subscribers. The messages can be interchanged between any combination of the added subscribers.
You can connect with me here:
dependencies {
compile 'com.mindorks:java-jpost:0.0.4'
}dependencies {
compile 'com.mindorks:android-jpost:0.0.4'
}- In contrast to the existing pub-sub libraries, it hold the subscribers with weakreference. Thus it doesn't create memory leaks.
- Single message can be sent to selected subscribes. This avoids the problem of event getting received at undesirable places. Thus minimising the chances of abnormal application behaviour.
- The subscriber addition can be controlled by using private channels. It minimises the chances of adding subscribes by mistake to receive undesirable messages.
- It is a tiny library < 55kb . Thus not effecting the application overall size.
- It facilitates synchronous as well as asynchronous message delivery and processing.
- It provides a mechanism to run code asynchronously.
The one point entry for this library is the class JPost. It contains static methods to access BroadcastCenter class and core functionality related to the library management.
JPost.getBroadcastCenter(): This method is used to get the instance of BroadcastCenter class (BroadcastCenter is described below)JPost.shutdown(): This method closes theJPostfor the async operations and removes all the pool threads. It should called when the program terminates or as required. This call let the message delivery already in process to continue.JPost.haltAndShutdown(): This method does the same operation as do theJPost.shutdown()but it also removes all the message delivery tasks.;
createPrivateChannel(T owner, Integer channelId): Creates a private channel requiring a unique int channel id. The owner is assignedowner.hashCode()as subscriber id.createPrivateChannel(T owner, Integer channelId, Integer subscriberId): Creates a private channel requiring a unique int channel id. The owner is givensubscriberIdas subscriber id.createPublicChannel(Integer channelId): Creates a public channel requiring a unique int channel id.stopChannel(Integer channelId): Stops the channel with channel id temporarily.reopenChannel(Integer channelId): Reopen the channel which has been stopped but not terminated.terminateChannel(Integer channelId): Completely removes the channel and can not be used later.getChannel(Integer channelId): Return the channel with channel id else returns null.broadcast(T msg): This method sends messages to all the subscribers of the default global channel.broadcastAsync(T msg): This method sends messages asynchronously to all the subscribers of the default global channel. The thread calling this methods can process with remaining tasks as usual.broadcast(Integer channelId, T msg, Integer... subscribers): This method sends messages to the subscribers of the channel of a particular channel id. If subscribers is not provided then all the subscribers of this channel receiver the message.broadcastAsync(Integer channelId, T msg, Integer... subscribers): Does the same as above(method 10) but asynchronously.broadcast(V registeredSubscriber, Integer channelId, T msg, Integer... subscribers): This method is used to send message on a private channel. Only the registered subscribers can send and receive messges on private channel.broadcastAsync(V registeredSubscriber, Integer channelId, T msg, Integer... subscribers): Does the same as above(method 12) but asynchronously.addSubscriber(T subscriber): This method add subscribers to default global channel.addSubscriber(Integer channelId, T subscriber): This method add subscribers to public channels with subscriber havingsubscriber.hashCode()as the subscriber id.addSubscriberAsync(Integer channelId, T subscriber): Does the same as above(method 15) but asynchronously.addSubscriber(Integer channelId, T subscriber, Integer subscriberId): This method add subscribers to public channels with subscriber havingsubscriberIdas the subscriber id.addSubscriberAsync(Integer channelId, T subscriber, Integer subscriberId): Does the same as above(method 17) but asynchronously.addSubscriber(V owner, Integer channelId, T subscriber): This method add subscribers to private channels. Only owner of the channel can add subscribers to this channel. The subscriber is given subscriber.hashCode() as the subscriber id.addSubscriberAsync(V owner, Integer channelId, T subscriber): Does the same as above(method 19) but asynchronously.addSubscriber(V owner, Integer channelId, T subscriber, Integer subscriberId): This method add subscribers to private channels. Only owner of the channel can add subscribers to this channel. The subscriber is givensubscriberIdas the subscriber id.addSubscriberAsync(V owner, Integer channelId, T subscriber, Integer subscriberId): Does the same as above(method 21) but asynchronously.removeSubscriber(T subscriber): Removes subscriber form the default global channel.removeSubscriber(Integer channelId, T subscriber): Removes subscriber form a public channel.removeSubscriber(T registeredSubscriber, Integer channelId, Integer subscriberId): Removes subscriber form a private channel. Only registered subscribers of the private channel can remove a subscriber.getAllSubscribersWeakRef(): returns a collection of weakreference holding the subscriber.
The messages are received via @OnMessage method annotation. The class subscribing any message has to create a method with message object as the parameter and annotate it with @OnMessage.
channelId: This parameter in the annotation, attaches the message reception to a particular channel on which the class has subscribed. If not provided will be listening to the default global channel.isCommonReceiver: This parameter sets the message reception from any channel on which the class has subscribed.
@OnUiThread
@OnMessage
private void onMessage(final Message msg){
textView.setText(msg.getMsg());
} -keepattributes *Annotation*
-keepclassmembers class ** {
@com.mindorks.jpost.core.OnMessage <methods>;
@com.mindorks.androidjpost.droid.OnUiThread <methods>;
} public class Message1 {
private String msg;
public Message1(String msg) {
this.msg = msg;
}
public String getMsg() {
return "Message1: " + msg;
}
public void setMsg(String msg) {
this.msg = msg;
}
} public SubscriberA() {
try {
JPost.getBroadcastCenter().addSubscriber(this);
}catch (AlreadyExistsException | NullObjectException e){
e.printStackTrace();
}
}
@OnMessage
private void onMessage1(Message1 msg){
System.out.println("SubscriberA: "+ msg.getMsg());
} //TO SEND THROUGH THE CLASS RUNNING THREAD USER
JPost.getBroadcastCenter().broadcast(new Message1("Application sending message"));
// TO SEND ASYNCHRONOUSLY
try {
JPost.getBroadcastCenter().broadcastAsync(new Message2("Application sending message"));
}catch (JPostNotRunningException e){
e.printStackTrace();
} class ChannelIds{
public static final int publicChannel1 = 1;
}
.....
try {
JPost.getBroadcastCenter().createPublicChannel(ChannelIds.publicChannel1);
}catch (AlreadyExistsException e){
e.printStackTrace();
} public SubscriberA() {
// TO ADD SUBSCRIBER SYNCHRONOUSLY
try {
JPost.getBroadcastCenter().addSubscriber(ChannelIds.publicChannel1, this);
}catch (PermissionException | NoSuchChannelException | AlreadyExistsException
| IllegalChannelStateException | NullObjectException e){
e.printStackTrace();
}
...
// TO ADD SUBSCRIBER ASYNCHRONOUSLY
// JPost.getBroadcastCenter().addSubscriberAsync(ChannelIds.publicChannel1, this);
}
@OnMessage(channelId = ChannelIds.publicChannel1)
private void onMessage1(Message1 msg){
System.out.println("SubscriberA: " + msg.getMsg());
} //TO SEND THROUGH THE CLASS RUNNING THREAD USER
JPost.getBroadcastCenter().broadcast(ChannelIds.publicChannel1, new Message1("Application sending public message"));
// TO SEND ASYNCHRONOUSLY
try {
JPost.getBroadcastCenter().broadcastAsync(ChannelIds.publicChannel1, new Message1("Application sending public async message"));
}catch (JPostNotRunningException e){
e.printStackTrace();
}Example 3: Creating private channel, adding subscribers(Only creator/owner of the channel has adding subscribers right) and sending and receiving messages over it
public class ChannelIds {
public static final int privateChannel1 = 2;
}
// CREATING PRIVATE CHANNEL
try {
JPost.getBroadcastCenter().createPrivateChannel(this, ChannelIds.privateChannel1);
}catch (AlreadyExistsException e){
e.printStackTrace();
}
// ADDING
try {
JPost.getBroadcastCenter().addSubscriber(this, ChannelIds.privateChannel1, subscriberA);
}catch (PermissionException | NoSuchChannelException | AlreadyExistsException
| IllegalChannelStateException | NullObjectException e){
e.printStackTrace();
}
// SUBSCRIBING PRIVATE MESSAGES
@OnMessage(channelId = ChannelIds.privateChannel1)
private void onMessage1(Message1 msg){
System.out.println("SubscriberD: " + msg.getMsg());
}
1. The subscribers are added with unique ids. If id is not provided then its hashcode is taken as the id.
int subscriberId = 1;
try {
JPost.getBroadcastCenter().addSubscriber(ChannelIds.publicChannel1, this, subscriberId);
}catch (PermissionException | NoSuchChannelException | AlreadyExistsException
| IllegalChannelStateException | NullObjectException e){
e.printStackTrace();
} int subscriberId1 = 1;
int subscriberId2 = 2;
try {
JPost.getBroadcastCenter().broadcastAsync(ChannelIds.publicChannel1,
new Message1("Application sending public message"), subscriberId1, subscriberId2);
}catch (JPostNotRunningException e){
e.printStackTrace();
}Recent Library: PlaceHolderView
PlaceHolderView create views without any adapter in very modular form. It uses the power of RecyclerView and enhances it to another level. For the first time with the list view comes card stack view.
Copyright (C) 2016 Janishar Ali Anwar
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