Apache Tomcat 6.0.43

org.apache.catalina.tribes
Class ByteMessage

java.lang.Object
  extended by org.apache.catalina.tribes.ByteMessage
All Implemented Interfaces:
java.io.Externalizable, java.io.Serializable

public class ByteMessage
extends java.lang.Object
implements java.io.Serializable, java.io.Externalizable

A byte message is not serialized and deserialized by the channel instead it is sent as a byte array
By default Tribes uses java serialization when it receives an object to be sent over the wire. Java serialization is not the most efficient of serializing data, and Tribes might not even have access to the correct class loaders to deserialize the object properly.
The ByteMessage class is a class where the channel when it receives it will not attempt to perform serialization, instead it will simply stream the getMessage() bytes.
If you are using multiple applications on top of Tribes you should add some sort of header so that you can decide with the ChannelListener.accept() whether this message was intended for you.

Author:
Filip Hanik
See Also:
Serialized Form

Constructor Summary
ByteMessage()
          Creates an empty byte message Constructor also for deserialization
ByteMessage(byte[] data)
          Creates a byte message wit h
 
Method Summary
 byte[] getMessage()
          Returns the message contents of this byte message
 void readExternal(java.io.ObjectInput in)
           
 void setMessage(byte[] message)
          Sets the message contents of this byte message
 void writeExternal(java.io.ObjectOutput out)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ByteMessage

public ByteMessage()
Creates an empty byte message Constructor also for deserialization


ByteMessage

public ByteMessage(byte[] data)
Creates a byte message wit h

Parameters:
data - byte[] - the message contents
Method Detail

getMessage

public byte[] getMessage()
Returns the message contents of this byte message

Returns:
byte[] - message contents, can be null

setMessage

public void setMessage(byte[] message)
Sets the message contents of this byte message

Parameters:
message - byte[]

readExternal

public void readExternal(java.io.ObjectInput in)
                  throws java.io.IOException
Specified by:
readExternal in interface java.io.Externalizable
Parameters:
in - ObjectInput
Throws:
java.io.IOException
See Also:
Externalizable.readExternal(java.io.ObjectInput)

writeExternal

public void writeExternal(java.io.ObjectOutput out)
                   throws java.io.IOException
Specified by:
writeExternal in interface java.io.Externalizable
Parameters:
out - ObjectOutput
Throws:
java.io.IOException
See Also:
Externalizable.writeExternal(java.io.ObjectOutput)

Apache Tomcat 6.0.43

Copyright © 2000-2014 Apache Software Foundation. All Rights Reserved.