Repository files navigation

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.

1. 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.
2. 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.
3. 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:

• Janishar Ali
• Twitter
• YouTube Channel

dependencies {    compile'com.mindorks:java-jpost:0.0.4'}

dependencies {    compile'com.mindorks:android-jpost:0.0.4'}

1. In contrast to the existing pub-sub libraries, it hold the subscribers with weakreference. Thus it doesn't create memory leaks.
2. 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.
3. The subscriber addition can be controlled by using private channels. It minimises the chances of adding subscribes by mistake to receive undesirable messages.
4. It is a tiny library < 55kb . Thus not effecting the application overall size.
5. It facilitates synchronous as well as asynchronous message delivery and processing.
6. It provides a mechanism to run code asynchronously.

1. JPost.getBroadcastCenter(): This method is used to get the instance of BroadcastCenter class (BroadcastCenter is described below)
2. JPost.shutdown(): This method closes theJPost for 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.
3. JPost.haltAndShutdown(): This method does the same operation as do theJPost.shutdown() but it also removes all the message delivery tasks.;

1. createPrivateChannel(T owner, Integer channelId): Creates a private channel requiring a unique int channel id. The owner is assignedowner.hashCode() as subscriber id.
2. createPrivateChannel(T owner, Integer channelId, Integer subscriberId): Creates a private channel requiring a unique int channel id. The owner is givensubscriberId as subscriber id.
3. createPublicChannel(Integer channelId): Creates a public channel requiring a unique int channel id.
4. stopChannel(Integer channelId): Stops the channel with channel id temporarily.
5. reopenChannel(Integer channelId): Reopen the channel which has been stopped but not terminated.
6. terminateChannel(Integer channelId): Completely removes the channel and can not be used later.
7. getChannel(Integer channelId): Return the channel with channel id else returns null.
8. broadcast(T msg): This method sends messages to all the subscribers of the default global channel.
9. 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.
10. 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.
11. broadcastAsync(Integer channelId, T msg, Integer... subscribers): Does the same as above(method 10) but asynchronously.
12. 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.
13. broadcastAsync(V registeredSubscriber, Integer channelId, T msg, Integer... subscribers): Does the same as above(method 12) but asynchronously.
14. addSubscriber(T subscriber): This method add subscribers to default global channel.
15. addSubscriber(Integer channelId, T subscriber): This method add subscribers to public channels with subscriber havingsubscriber.hashCode() as the subscriber id.
16. addSubscriberAsync(Integer channelId, T subscriber): Does the same as above(method 15) but asynchronously.
17. addSubscriber(Integer channelId, T subscriber, Integer subscriberId): This method add subscribers to public channels with subscriber havingsubscriberId as the subscriber id.
18. addSubscriberAsync(Integer channelId, T subscriber, Integer subscriberId): Does the same as above(method 17) but asynchronously.
19. 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.
20. addSubscriberAsync(V owner, Integer channelId, T subscriber): Does the same as above(method 19) but asynchronously.
21. 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 givensubscriberId as the subscriber id.
22. addSubscriberAsync(V owner, Integer channelId, T subscriber, Integer subscriberId): Does the same as above(method 21) but asynchronously.
23. removeSubscriber(T subscriber): Removes subscriber form the default global channel.
24. removeSubscriber(Integer channelId, T subscriber): Removes subscriber form a public channel.
25. removeSubscriber(T registeredSubscriber, Integer channelId, Integer subscriberId): Removes subscriber form a private channel. Only registered subscribers of the private channel can remove a subscriber.
26. getAllSubscribersWeakRef(): returns a collection of weakreference holding the subscriber.

1. 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.
2. isCommonReceiver: This parameter sets the message reception from any channel on which the class has subscribed.

@OnUiThread@OnMessageprivatevoidonMessage(finalMessagemsg){textView.setText(msg.getMsg());    }

-keepattributes*Annotation*-keepclassmembers class** {@com.mindorks.jpost.core.OnMessage<methods>;@com.mindorks.androidjpost.droid.OnUiThread<methods>;  }

publicclassMessage1 {privateStringmsg;publicMessage1(Stringmsg) {this.msg =msg;     }publicStringgetMsg() {return"Message1: " +msg;     }publicvoidsetMsg(Stringmsg) {this.msg =msg;      }   }

publicSubscriberA() {try {JPost.getBroadcastCenter().addSubscriber(this);        }catch (AlreadyExistsException |NullObjectExceptione){e.printStackTrace();        }    }@OnMessageprivatevoidonMessage1(Message1msg){System.out.println("SubscriberA: "+msg.getMsg());    }

//TO SEND THROUGH THE CLASS RUNNING THREAD USERJPost.getBroadcastCenter().broadcast(newMessage1("Application sending message"));// TO SEND ASYNCHRONOUSLYtry {JPost.getBroadcastCenter().broadcastAsync(newMessage2("Application sending message"));    }catch (JPostNotRunningExceptione){e.printStackTrace();    }

classChannelIds{publicstaticfinalintpublicChannel1 =1;    }        .....try {JPost.getBroadcastCenter().createPublicChannel(ChannelIds.publicChannel1);    }catch (AlreadyExistsExceptione){e.printStackTrace();    }

publicSubscriberA() {// TO ADD SUBSCRIBER SYNCHRONOUSLYtry {JPost.getBroadcastCenter().addSubscriber(ChannelIds.publicChannel1,this);        }catch (PermissionException |NoSuchChannelException |AlreadyExistsException                   |IllegalChannelStateException |NullObjectExceptione){e.printStackTrace();        }                ...// TO ADD SUBSCRIBER ASYNCHRONOUSLY// JPost.getBroadcastCenter().addSubscriberAsync(ChannelIds.publicChannel1, this);    }@OnMessage(channelId =ChannelIds.publicChannel1)privatevoidonMessage1(Message1msg){System.out.println("SubscriberA: " +msg.getMsg());    }

//TO SEND THROUGH THE CLASS RUNNING THREAD USERJPost.getBroadcastCenter().broadcast(ChannelIds.publicChannel1,newMessage1("Application sending public message"));// TO SEND ASYNCHRONOUSLYtry {JPost.getBroadcastCenter().broadcastAsync(ChannelIds.publicChannel1,newMessage1("Application sending public async message"));    }catch (JPostNotRunningExceptione){e.printStackTrace();    }

publicclassChannelIds {publicstaticfinalintprivateChannel1 =2;    }// CREATING PRIVATE CHANNELtry {JPost.getBroadcastCenter().createPrivateChannel(this,ChannelIds.privateChannel1);    }catch (AlreadyExistsExceptione){e.printStackTrace();    }// ADDINGtry {JPost.getBroadcastCenter().addSubscriber(this,ChannelIds.privateChannel1,subscriberA);    }catch (PermissionException |NoSuchChannelException |AlreadyExistsException                   |IllegalChannelStateException |NullObjectExceptione){e.printStackTrace();    }// SUBSCRIBING PRIVATE MESSAGES@OnMessage(channelId =ChannelIds.privateChannel1)privatevoidonMessage1(Message1msg){System.out.println("SubscriberD: " +msg.getMsg());    }

intsubscriberId =1;try {JPost.getBroadcastCenter().addSubscriber(ChannelIds.publicChannel1,this,subscriberId);    }catch (PermissionException |NoSuchChannelException |AlreadyExistsException                 |IllegalChannelStateException |NullObjectExceptione){e.printStackTrace();    }

intsubscriberId1 =1;intsubscriberId2 =2;try {JPost.getBroadcastCenter().broadcastAsync(ChannelIds.publicChannel1,newMessage1("Application sending public message"),subscriberId1,subscriberId2);    }catch (JPostNotRunningExceptione){e.printStackTrace();    }

Android Networking

   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