iii
Preface ............................................................................................................................. ix
1. Overview ...................................................................................................................... 1
1.1. Channel ............................................................................................................. 2
1.2. Building Blocks ................................................................................................... 2
1.3. The Protocol Stack ............................................................................................. 3
2. Installation and Configuration ..................................................................................... 5
2.1. Requirements ..................................................................................................... 5
2.2. Structure of the source version ............................................................................ 5
2.3. Building JGroups (source distribution only) ........................................................... 5
2.4. Testing your Setup ............................................................................................. 6
2.5. Running a Demo Program ................................................................................... 6
2.6. Using IP Multicasting without a network connection ............................................... 7
2.7. It doesn't work ! .................................................................................................. 8
2.8. Problems with IPv6 ............................................................................................. 8
2.9. Wiki ................................................................................................................... 9
2.10. I have discovered a bug ! .................................................................................. 9
2.11. Supported classes ............................................................................................ 9
2.11.1. Experimental .......................................................................................... 9
2.11.2. Unsupported ........................................................................................ 10
3. API ............................................................................................................................. 11
3.1. Utility classes .................................................................................................... 11
3.1.1. objectToByteBuffer(), objectFromByteBuffer() ........................................... 11
3.1.2. objectToStream(), objectFromStream() .................................................... 11
3.2. Interfaces ......................................................................................................... 11
3.2.1. MessageListener .................................................................................... 11
3.2.2. MembershipListener ............................................................................... 12
3.2.3. Receiver ................................................................................................ 13
3.2.4. ReceiverAdapter ..................................................................................... 13
3.2.5. ChannelListener ..................................................................................... 14
3.3. Address ............................................................................................................ 14
3.4. Message .......................................................................................................... 15
3.5. Header ............................................................................................................. 16
3.6. Event ............................................................................................................... 16
3.7. View ................................................................................................................. 17
3.7.1. ViewId ................................................................................................... 17
3.7.2. MergeView ............................................................................................. 17
3.8. JChannel .......................................................................................................... 18
3.8.1. Creating a channel ................................................................................. 18
3.8.2. Giving the channel a logical name ........................................................... 23
3.8.3. Generating custom addresses ................................................................. 23
3.8.4. Joining a cluster ..................................................................................... 24
3.8.5. Joining a cluster and getting the state in one operation ............................. 25
3.8.6. Getting the local address and the cluster name ........................................ 25
3.8.7. Getting the current view ......................................................................... 25
