ACLMessage

java.lang.Object
- jade.lang.acl.ACLMessage

All Implemented Interfaces:

Serializable, Cloneable

Direct Known Subclasses:

OntoACLMessage
```
public class ACLMessage
extends Object
implements Cloneable, Serializable
```
The class ACLMessage implements an ACL message compliant to the FIPA 2000 "FIPA ACL Message Structure Specification" (fipa000061) specifications. All parameters are couples keyword: value. All keywords are private final String. All values can be set by using the methods set and can be read by using the methods get.
Warning: since JADE 3.1 an exception might be thrown during the serialization of the ACLMessage parameters (with exception of the content of the ACLMessage) because of a limitation to 65535 in the total number of bytes needed to represent all the characters of a String (see also java.io.DataOutput#writeUTF(String)).
The methods setByteSequenceContent() and getByteSequenceContent() allow to send arbitrary sequence of bytes over the content of an ACLMessage.
The couple of methods setContentObject() and getContentObject() allow to send serialized Java objects over the content of an ACLMessage. These method are not strictly FIPA compliant so their usage is not encouraged.

Version:

0.9

Author:

Fabio Bellifemine - CSELT

See Also:

FIPA Spec, Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`ACCEPT_PROPOSAL` constant identifying the FIPA performative
`static int`	`AGREE` constant identifying the FIPA performative
`static String`	`AMS_FAILURE_AGENT_NOT_FOUND` AMS failure reasons
`static String`	`AMS_FAILURE_AGENT_UNREACHABLE`
`static String`	`AMS_FAILURE_FOREIGN_AGENT_NO_ADDRESS`
`static String`	`AMS_FAILURE_FOREIGN_AGENT_UNREACHABLE`
`static String`	`AMS_FAILURE_SERVICE_ERROR`
`static String`	`AMS_FAILURE_UNAUTHORIZED`
`static String`	`AMS_FAILURE_UNEXPECTED_ERROR`
`private byte[]`	`byteSequenceContent`
`static int`	`CANCEL` constant identifying the FIPA performative
`static int`	`CFP` constant identifying the FIPA performative
`static int`	`CONFIRM` constant identifying the FIPA performative
`private StringBuffer`	`content`
`private String`	`conversation_id`
`private ArrayList`	`dests`
`static int`	`DISCONFIRM` constant identifying the FIPA performative
`private String`	`encoding`
`static int`	`FAILURE` constant identifying the FIPA performative
`static String`	`IGNORE_FAILURE` User defined parameter key specifying, when set to "true", that if the delivery of a message fails, no FAILURE notification has to be sent back to the sender.
`private String`	`in_reply_to`
`static int`	`INFORM` constant identifying the FIPA performative
`static int`	`INFORM_IF` constant identifying the FIPA performative
`static int`	`INFORM_REF` constant identifying the FIPA performative
`private String`	`language`
`private Envelope`	`messageEnvelope`
`static String`	`NO_CLONE` User defined parameter key specifying that this message does not need to be cloned by the message delivery service.
`static int`	`NOT_UNDERSTOOD` constant identifying the FIPA performative
`private String`	`ontology`
`private int`	`performative`
`private static String[]`	`performatives` This array of Strings keeps the names of the performatives
`private Long`	`persistentID`
`static String`	`POST_TIME_STAMP` User defined parameter key specifying that the corresponding value must be replaced by the JADE runtime by an ISO8601 encoded time-stamp at posting time.
`static int`	`PROPAGATE` constant identifying the FIPA performative
`static int`	`PROPOSE` constant identifying the FIPA performative
`private String`	`protocol`
`static int`	`PROXY` constant identifying the FIPA performative
`static int`	`QUERY_IF` constant identifying the FIPA performative
`static int`	`QUERY_REF` constant identifying the FIPA performative
`private static int`	`RECEIVERS_EXPECTED_SIZE` These constants represent the expected size of the 2 array lists used by this class
`static int`	`REFUSE` constant identifying the FIPA performative
`static int`	`REJECT_PROPOSAL` constant identifying the FIPA performative
`private long`	`reply_byInMillisec`
`private ArrayList`	`reply_to`
`private String`	`reply_with`
`private static int`	`REPLYTO_EXPECTED_SIZE`
`static int`	`REQUEST` constant identifying the FIPA performative
`static int`	`REQUEST_WHEN` constant identifying the FIPA performative
`static int`	`REQUEST_WHENEVER` constant identifying the FIPA performative
`private static long`	`serialVersionUID`
`private AID`	`source`
`static int`	`SUBSCRIBE` constant identifying the FIPA performative
`static String`	`SYNCH_DELIVERY` User defined parameter key specifying that this message must be delivered synchronously.
`static String`	`TRACE` User defined parameter key specifying that the JADE tracing mechanism should be activated for this message.
`static int`	`UNKNOWN` constant identifying an unknown performative
`private Properties`	`userDefProps`

Constructor Summary

Constructors
Constructor and Description
`ACLMessage()` Deprecated. Since every ACL Message must have a message type, you should use the new constructor which gets a message type as a parameter. To avoid problems, now this constructor silently sets the message type to `not-understood`.
`ACLMessage(int perf)` This constructor creates an ACL message object with the specified performative.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addReceiver(AID r)` Adds a value to `:receiver` slot.
`void`	`addReplyTo(AID dest)` Adds a value to `:reply-to` slot.
`void`	`addUserDefinedParameter(String key, String value)` Add a new user defined parameter to this ACLMessage.
`void`	`clearAllReceiver()` Removes all values from `:receiver` slot.
`void`	`clearAllReplyTo()` Removes all values from `:reply_to` slot.
`Object`	`clearUserDefinedParameter(String key)` Removes the key and its corresponding value from the list of user defined parameters in this ACLMessage.
`Object`	`clone()` Clone an `ACLMessage` object.
`ACLMessage`	`createReply()` create a new ACLMessage that is a reply to this message.
`Iterator`	`getAllIntendedReceiver()` retrieve the whole list of intended receivers for this message.
`static String[]`	`getAllPerformativeNames()` Returns the list of the communicative acts as an array of `String`.
`Iterator`	`getAllReceiver()` Reads `:receiver` slot.
`Iterator`	`getAllReplyTo()` Reads `:reply_to` slot.
`Properties`	`getAllUserDefinedParameters()` Return all user defined parameters of this ACLMessage in form of a Properties object
`byte[]`	`getByteSequenceContent()` Reads `:content` slot.
`String`	`getContent()` Reads `:content` slot.
`Serializable`	`getContentObject()` This method returns the content of this ACLMessage when they have been written via the method `setContentObject`.
`String`	`getConversationId()` Reads `:conversation-id` slot.
`String`	`getEncoding()` Reads `:encoding` slot.
`Envelope`	`getEnvelope()` Reads the envelope attached to this message, if any.
`String`	`getInReplyTo()` Reads `:reply-to` slot.
`static int`	`getInteger(String perf)` Returns the integer corresponding to the performative
`String`	`getLanguage()` Reads `:language` slot.
`String`	`getOntology()` Reads `:ontology` slot.
`int`	`getPerformative()` return the integer representing the performative of this object
`static String`	`getPerformative(int perf)` Returns the string corresponding to the integer for the performative
`private Long`	`getPersistentID()`
`String`	`getProtocol()` Reads `:protocol` slot.
`private ArrayList`	`getReceivers()`
`String`	`getReplyBy()` Deprecated. Since the value of this slot is a Date by definition, then the `getReplyByDate` should be used that returns a Date
`Date`	`getReplyByDate()` Reads `:reply-by` slot.
`private ArrayList`	`getReplyTo()`
`String`	`getReplyWith()` Reads `:reply-with` slot.
`AID`	`getSender()` Reads `:sender` slot.
`String`	`getUserDefinedParameter(String key)` Searches for the user defined parameter with the specified key.
`private Serializable`	`getUserDefinedProperties()`
`boolean`	`hasByteSequenceContent()` This method allows to check if the content of this ACLMessage is a byteSequence or a String
`boolean`	`removeReceiver(AID r)` Removes a value from `:receiver` slot.
`boolean`	`removeReplyTo(AID dest)` Removes a value from `:reply_to` slot.
`boolean`	`removeUserDefinedParameter(String key)` Removes the key and its corresponding value from the list of user defined parameters in this ACLMessage.
`void`	`reset()` Resets all the message slots.
`void`	`setAllUserDefinedParameters(Properties userDefProps)` Replace all user defined parameters of this ACLMessage with the specified Properties object.
`void`	`setByteSequenceContent(byte[] byteSequenceContent)` Writes the `:content` slot.
`void`	`setContent(String content)` Writes the `:content` slot.
`void`	`setContentObject(Serializable s)` This method sets the content of this ACLMessage to a Java object.
`void`	`setConversationId(String str)` Writes the `:conversation-id` slot.
`void`	`setDefaultEnvelope()` Writes the message envelope for this message, using the `:sender` and `:receiver` message slots to fill in the envelope.
`void`	`setEncoding(String str)` Writes the `:encoding` slot.
`void`	`setEnvelope(Envelope e)` Attaches an envelope to this message.
`void`	`setInReplyTo(String reply)` Writes the `:in-reply-to` slot.
`void`	`setLanguage(String str)` Writes the `:language` slot.
`void`	`setOntology(String str)` Writes the `:ontology` slot.
`void`	`setPerformative(int perf)` set the performative of this ACL message object to the passed constant.
`private void`	`setPersistentID(Long l)`
`void`	`setProtocol(String str)` Writes the `:protocol` slot.
`private void`	`setReceivers(ArrayList al)`
`void`	`setReplyByDate(Date date)` Writes the `:reply-by` slot.
`private void`	`setReplyTo(ArrayList al)`
`void`	`setReplyWith(String reply)` Writes the `:reply-with` slot.
`void`	`setSender(AID s)` Writes the `:sender` slot.
`private void`	`setUserDefinedProperties(Serializable p)`
`String`	`toString()` Convert an ACL message to its string representation.

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - serialVersionUID
```
private static final long serialVersionUID
```
    See Also:
    
    Constant Field Values
  - ACCEPT_PROPOSAL
```
public static final int ACCEPT_PROPOSAL
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - AGREE
```
public static final int AGREE
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - CANCEL
```
public static final int CANCEL
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - CFP
```
public static final int CFP
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - CONFIRM
```
public static final int CONFIRM
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - DISCONFIRM
```
public static final int DISCONFIRM
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - FAILURE
```
public static final int FAILURE
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - INFORM
```
public static final int INFORM
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - INFORM_IF
```
public static final int INFORM_IF
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - INFORM_REF
```
public static final int INFORM_REF
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - NOT_UNDERSTOOD
```
public static final int NOT_UNDERSTOOD
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - PROPOSE
```
public static final int PROPOSE
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - QUERY_IF
```
public static final int QUERY_IF
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - QUERY_REF
```
public static final int QUERY_REF
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - REFUSE
```
public static final int REFUSE
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - REJECT_PROPOSAL
```
public static final int REJECT_PROPOSAL
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - REQUEST
```
public static final int REQUEST
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - REQUEST_WHEN
```
public static final int REQUEST_WHEN
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - REQUEST_WHENEVER
```
public static final int REQUEST_WHENEVER
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - SUBSCRIBE
```
public static final int SUBSCRIBE
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - PROXY
```
public static final int PROXY
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - PROPAGATE
```
public static final int PROPAGATE
```
    constant identifying the FIPA performative
    
    See Also:
    
    Constant Field Values
  - UNKNOWN
```
public static final int UNKNOWN
```
    constant identifying an unknown performative
    
    See Also:
    
    Constant Field Values
  - performative
```
private int performative
```
  - performatives
```
private static final String[] performatives
```
    This array of Strings keeps the names of the performatives
  - IGNORE_FAILURE
```
public static final String IGNORE_FAILURE
```
    User defined parameter key specifying, when set to "true", that if the delivery of a message fails, no FAILURE notification has to be sent back to the sender.
    
    See Also:
    
    Constant Field Values
  - POST_TIME_STAMP
```
public static final String POST_TIME_STAMP
```
    User defined parameter key specifying that the corresponding value must be replaced by the JADE runtime by an ISO8601 encoded time-stamp at posting time.
    
    See Also:
    
    Constant Field Values
  - TRACE
```
public static final String TRACE
```
    User defined parameter key specifying that the JADE tracing mechanism should be activated for this message.
    
    See Also:
    
    Constant Field Values
  - NO_CLONE
```
public static final String NO_CLONE
```
    User defined parameter key specifying that this message does not need to be cloned by the message delivery service. This should be used ONLY when the message object will not be modified after being sent
    
    See Also:
    
    Constant Field Values
  - SYNCH_DELIVERY
```
public static final String SYNCH_DELIVERY
```
    User defined parameter key specifying that this message must be delivered synchronously. It should be noticed that when using synchronous delivery message order is not guaranteed.
    
    See Also:
    
    Constant Field Values
  - AMS_FAILURE_AGENT_NOT_FOUND
```
public static final String AMS_FAILURE_AGENT_NOT_FOUND
```
    AMS failure reasons
    
    See Also:
    
    Constant Field Values
  - AMS_FAILURE_AGENT_UNREACHABLE
```
public static final String AMS_FAILURE_AGENT_UNREACHABLE
```
    See Also:
    
    Constant Field Values
  - AMS_FAILURE_SERVICE_ERROR
```
public static final String AMS_FAILURE_SERVICE_ERROR
```
    See Also:
    
    Constant Field Values
  - AMS_FAILURE_UNAUTHORIZED
```
public static final String AMS_FAILURE_UNAUTHORIZED
```
    See Also:
    
    Constant Field Values
  - AMS_FAILURE_FOREIGN_AGENT_UNREACHABLE
```
public static final String AMS_FAILURE_FOREIGN_AGENT_UNREACHABLE
```
    See Also:
    
    Constant Field Values
  - AMS_FAILURE_FOREIGN_AGENT_NO_ADDRESS
```
public static final String AMS_FAILURE_FOREIGN_AGENT_NO_ADDRESS
```
    See Also:
    
    Constant Field Values
  - AMS_FAILURE_UNEXPECTED_ERROR
```
public static final String AMS_FAILURE_UNEXPECTED_ERROR
```
    See Also:
    
    Constant Field Values
  - source
```
private AID source
```
  - RECEIVERS_EXPECTED_SIZE
```
private static final int RECEIVERS_EXPECTED_SIZE
```
    These constants represent the expected size of the 2 array lists used by this class
    
    See Also:
    
    Constant Field Values
  - REPLYTO_EXPECTED_SIZE
```
private static final int REPLYTO_EXPECTED_SIZE
```
    See Also:
    
    Constant Field Values
  - dests
```
private ArrayList dests
```
  - reply_to
```
private ArrayList reply_to
```
  - content
```
private StringBuffer content
```
  - byteSequenceContent
```
private byte[] byteSequenceContent
```
  - reply_with
```
private String reply_with
```
  - in_reply_to
```
private String in_reply_to
```
  - encoding
```
private String encoding
```
  - language
```
private String language
```
  - ontology
```
private String ontology
```
  - reply_byInMillisec
```
private long reply_byInMillisec
```
  - protocol
```
private String protocol
```
  - conversation_id
```
private String conversation_id
```
  - userDefProps
```
private Properties userDefProps
```
  - messageEnvelope
```
private Envelope messageEnvelope
```
  - persistentID
```
private Long persistentID
```
- Constructor Detail
  - ACLMessage
```
public ACLMessage()
```
    Deprecated. Since every ACL Message must have a message type, you should use the new constructor which gets a message type as a parameter. To avoid problems, now this constructor silently sets the message type to not-understood.
    
    See Also:
    
    ACLMessage(int)
  - ACLMessage
```
public ACLMessage(int perf)
```
    This constructor creates an ACL message object with the specified performative. If the passed integer does not correspond to any of the known performatives, it silently initializes the message to not-understood.
- Method Detail
  - getAllPerformativeNames
```
public static String[] getAllPerformativeNames()
```
    Returns the list of the communicative acts as an array of String.
  - setSender
```
public void setSender(AID s)
```
    Writes the :sender slot. Warning: no checks are made to validate the slot value.
    
    Parameters:
    
    source - The new value for the slot.
    
    See Also:
    
    getSender()
  - addReceiver
```
public void addReceiver(AID r)
```
    Adds a value to :receiver slot. Warning: no checks are made to validate the slot value.
    
    Parameters:
    
    r - The value to add to the slot value set.
  - removeReceiver
```
public boolean removeReceiver(AID r)
```
    Removes a value from :receiver slot. Warning: no checks are made to validate the slot value.
    
    Parameters:
    
    r - The value to remove from the slot value set.
    
    Returns:
    
    true if the AID has been found and removed, false otherwise
  - clearAllReceiver
```
public void clearAllReceiver()
```
    Removes all values from :receiver slot. Warning: no checks are made to validate the slot value.
  - addReplyTo
```
public void addReplyTo(AID dest)
```
    Adds a value to :reply-to slot. Warning: no checks are made to validate the slot value.
    
    Parameters:
    
    dest - The value to add to the slot value set.
  - removeReplyTo
```
public boolean removeReplyTo(AID dest)
```
    Removes a value from :reply_to slot. Warning: no checks are made to validate the slot value.
    
    Parameters:
    
    dest - The value to remove from the slot value set.
    
    Returns:
    
    true if the AID has been found and removed, false otherwise
  - clearAllReplyTo
```
public void clearAllReplyTo()
```
    Removes all values from :reply_to slot. Warning: no checks are made to validate the slot value.
  - setPerformative
```
public void setPerformative(int perf)
```
    set the performative of this ACL message object to the passed constant. Remind to use the set of constants (i.e. INFORM, REQUEST, ... ) defined in this class
  - setContent
```
public void setContent(String content)
```
    Writes the :content slot. Warning: no checks are made to validate the slot value.
    
    Notice that, in general, setting a String content and getting back a byte sequence content - or viceversa - does not return the same value, i.e. the following relation does not hold getByteSequenceContent(setByteSequenceContent(getContent().getBytes())) is equal to getByteSequenceContent()
    
    Parameters:
    
    content - The new value for the slot.
    
    See Also:
    
    getContent(), setByteSequenceContent(byte[]), setContentObject(Serializable s)
  - setByteSequenceContent
```
public void setByteSequenceContent(byte[] byteSequenceContent)
```
    Writes the :content slot. Warning: no checks are made to validate the slot value.
    
    Notice that, in general, setting a String content and getting back a byte sequence content - or viceversa - does not return the same value, i.e. the following relation does not hold getByteSequenceContent(setByteSequenceContent(getContent().getBytes())) is equal to getByteSequenceContent()
    
    Parameters:
    
    byteSequenceContent - The new value for the slot.
    
    See Also:
    
    setContent(String s), getByteSequenceContent(), setContentObject(Serializable s)
  - setContentObject
```
public void setContentObject(Serializable s)
                      throws IOException
```
    This method sets the content of this ACLMessage to a Java object. It is not FIPA compliant so its usage is not encouraged. For example:
```
 ACLMessage msg = new ACLMessage(ACLMessage.INFORM);
 Date d = new Date(); 
 try{
  msg.setContentObject(d);
 }catch(IOException e){}
 
```
    Parameters:
    
    s - the object that will be used to set the content of the ACLMessage.
    
    Throws:
    
    IOException - if an I/O error occurs.
  - getContentObject
```
public Serializable getContentObject()
                              throws UnreadableException
```
    This method returns the content of this ACLMessage when they have been written via the method setContentObject. It is not FIPA compliant so its usage is not encouraged. For example to read Java objects from the content
```
 ACLMessage msg = blockingReceive();
 try{
  Date d = (Date)msg.getContentObject();
 }catch(UnreadableException e){}
 
```
    Returns:
    
    the object read from the content of this ACLMessage
    
    Throws:
    
    UnreadableException - when an error occurs during the decoding.
  - setReplyWith
```
public void setReplyWith(String reply)
```
    Writes the :reply-with slot. Warning: no checks are made to validate the slot value.
    
    Parameters:
    
    reply - The new value for the slot.
    
    See Also:
    
    getReplyWith()
  - setInReplyTo
```
public void setInReplyTo(String reply)
```
    Writes the :in-reply-to slot. Warning: no checks are made to validate the slot value.
    
    Parameters:
    
    reply - The new value for the slot.
    
    See Also:
    
    getInReplyTo()
  - setEncoding
```
public void setEncoding(String str)
```
    Writes the :encoding slot. Warning: no checks are made to validate the slot value.
    
    Parameters:
    
    str - The new value for the slot.
    
    See Also:
    
    getEncoding()
  - setLanguage
```
public void setLanguage(String str)
```
    Writes the :language slot. Warning: no checks are made to validate the slot value.
    
    Parameters:
    
    str - The new value for the slot.
    
    See Also:
    
    getLanguage()
  - setOntology
```
public void setOntology(String str)
```
    Writes the :ontology slot. Warning: no checks are made to validate the slot value.
    
    Parameters:
    
    str - The new value for the slot.
    
    See Also:
    
    getOntology()
  - setReplyByDate
```
public void setReplyByDate(Date date)
```
    Writes the :reply-by slot. Warning: no checks are made to validate the slot value.
    
    Parameters:
    
    date - The new value for the slot.
    
    See Also:
    
    getReplyByDate()
  - setProtocol
```
public void setProtocol(String str)
```
    Writes the :protocol slot. Warning: no checks are made to validate the slot value.
    
    Parameters:
    
    str - The new value for the slot.
    
    See Also:
    
    getProtocol()
  - setConversationId
```
public void setConversationId(String str)
```
    Writes the :conversation-id slot. Warning: no checks are made to validate the slot value.
    
    Parameters:
    
    str - The new value for the slot.
    
    See Also:
    
    getConversationId()
  - getAllReceiver
```
public Iterator getAllReceiver()
```
    Reads :receiver slot.
    
    Returns:
    
    An Iterator containing the Agent IDs of the receiver agents for this message.
  - getAllReplyTo
```
public Iterator getAllReplyTo()
```
    Reads :reply_to slot.
    
    Returns:
    
    An Iterator containing the Agent IDs of the reply_to agents for this message.
  - getSender
```
public AID getSender()
```
    Reads :sender slot.
    
    Returns:
    
    The value of :senderslot.
    
    See Also:
    
    setSender(AID).
  - getPerformative
```
public static String getPerformative(int perf)
```
    Returns the string corresponding to the integer for the performative
    
    Returns:
    
    the string corresponding to the integer for the performative; "NOT-UNDERSTOOD" if the integer is out of range.
  - getInteger
```
public static int getInteger(String perf)
```
    Returns the integer corresponding to the performative
  - getPerformative
```
public int getPerformative()
```
    return the integer representing the performative of this object
    
    Returns:
    
    an integer representing the performative of this object
  - hasByteSequenceContent
```
public boolean hasByteSequenceContent()
```
    This method allows to check if the content of this ACLMessage is a byteSequence or a String
    
    Returns:
    
    true if it is a byteSequence, false if it is a String
  - getContent
```
public String getContent()
```
    Reads :content slot.
    
    Notice that, in general, setting a String content and getting back a byte sequence content - or viceversa - does not return the same value, i.e. the following relation does not hold getByteSequenceContent(setByteSequenceContent(getContent().getBytes())) is equal to getByteSequenceContent()
    
    Returns:
    
    The value of :content slot.
    
    See Also:
    
    setContent(String), getByteSequenceContent(), getContentObject()
  - getByteSequenceContent
```
public byte[] getByteSequenceContent()
```
    Reads :content slot.
    
    Notice that, in general, setting a String content and getting back a byte sequence content - or viceversa - does not return the same value, i.e. the following relation does not hold getByteSequenceContent(setByteSequenceContent(getContent().getBytes())) is equal to getByteSequenceContent()
    
    Returns:
    
    The value of :content slot.
    
    See Also:
    
    getContent(), setByteSequenceContent(byte[]), getContentObject()
  - getReplyWith
```
public String getReplyWith()
```
    Reads :reply-with slot.
    
    Returns:
    
    The value of :reply-withslot.
    
    See Also:
    
    setReplyWith(String).
  - getInReplyTo
```
public String getInReplyTo()
```
    Reads :reply-to slot.
    
    Returns:
    
    The value of :reply-toslot.
    
    See Also:
    
    setInReplyTo(String).
  - getEncoding
```
public String getEncoding()
```
    Reads :encoding slot.
    
    Returns:
    
    The value of :encodingslot.
    
    See Also:
    
    setEncoding(String).
  - getLanguage
```
public String getLanguage()
```
    Reads :language slot.
    
    Returns:
    
    The value of :languageslot.
    
    See Also:
    
    setLanguage(String).
  - getOntology
```
public String getOntology()
```
    Reads :ontology slot.
    
    Returns:
    
    The value of :ontologyslot.
    
    See Also:
    
    setOntology(String).
  - getReplyBy
```
public String getReplyBy()
```
    Deprecated. Since the value of this slot is a Date by definition, then the getReplyByDate should be used that returns a Date
    
    Reads :reply-by slot.
    
    Returns:
    
    The value of :reply-byslot, as a string.
    
    See Also:
    
    getReplyByDate().
  - getReplyByDate
```
public Date getReplyByDate()
```
    Reads :reply-by slot.
    
    Returns:
    
    The value of :reply-byslot, as a Date object.
    
    See Also:
    
    setReplyByDate(Date).
  - getProtocol
```
public String getProtocol()
```
    Reads :protocol slot.
    
    Returns:
    
    The value of :protocolslot.
    
    See Also:
    
    setProtocol(String).
  - getConversationId
```
public String getConversationId()
```
    Reads :conversation-id slot.
    
    Returns:
    
    The value of :conversation-idslot.
    
    See Also:
    
    setConversationId(String).
  - addUserDefinedParameter
```
public void addUserDefinedParameter(String key,
                                    String value)
```
    Add a new user defined parameter to this ACLMessage. Notice that according to the FIPA specifications, the keyword of a user-defined parameter must not contain space inside. Note that the user does not need to (and shall not) add the prefix "X-" to the keyword. This is automatically added by the StringACLCodec.
    
    Parameters:
    
    key - the property key.
    
    value - the property value
  - getUserDefinedParameter
```
public String getUserDefinedParameter(String key)
```
    Searches for the user defined parameter with the specified key. The method returns null if the parameter is not found.
    
    Parameters:
    
    key - the parameter key.
    
    Returns:
    
    the value in this ACLMessage with the specified key value.
  - getAllUserDefinedParameters
```
public Properties getAllUserDefinedParameters()
```
    Return all user defined parameters of this ACLMessage in form of a Properties object
  - setAllUserDefinedParameters
```
public void setAllUserDefinedParameters(Properties userDefProps)
```
    Replace all user defined parameters of this ACLMessage with the specified Properties object.
  - removeUserDefinedParameter
```
public boolean removeUserDefinedParameter(String key)
```
    Removes the key and its corresponding value from the list of user defined parameters in this ACLMessage.
    
    Parameters:
    
    key - the key that needs to be removed
    
    Returns:
    
    true if the property has been found and removed, false otherwise
  - clearUserDefinedParameter
```
public Object clearUserDefinedParameter(String key)
```
    Removes the key and its corresponding value from the list of user defined parameters in this ACLMessage.
    
    Parameters:
    
    key - the key that needs to be removed
    
    Returns:
    
    the value to which the key had been mapped or null if the key was not present
  - setEnvelope
```
public void setEnvelope(Envelope e)
```
    Attaches an envelope to this message. The envelope is used by the ACC for inter-platform messaging.
    
    Parameters:
    
    e - The Envelope object to attach to this message.
    
    See Also:
    
    jade.lang.acl, jade.lang.acl
  - setDefaultEnvelope
```
public void setDefaultEnvelope()
```
    Writes the message envelope for this message, using the :sender and :receiver message slots to fill in the envelope.
    
    See Also:
    
    jade.lang.acl, jade.lang.acl
  - getEnvelope
```
public Envelope getEnvelope()
```
    Reads the envelope attached to this message, if any.
    
    Returns:
    
    The envelope for this message.
    
    See Also:
    
    jade.lang.acl, jade.lang.acl
  - toString
```
public String toString()
```
    Convert an ACL message to its string representation. This method writes a representation of this ACLMessage into a character string. If the content is a bytesequence, then it is automatically converted into Base64 encoding.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    A String representing this message.
  - clone
```
public Object clone()
```
    Clone an ACLMessage object.
    
    Overrides:
    
    clone in class Object
    
    Returns:
    
    A copy of this ACLMessage object. The copy must be casted back to ACLMessage type before being used.
  - reset
```
public void reset()
```
    Resets all the message slots.
  - createReply
```
public ACLMessage createReply()
```
    create a new ACLMessage that is a reply to this message. In particular, it sets the following parameters of the new message: receiver, language, ontology, protocol, conversation-id, in-reply-to, reply-with. The programmer needs to set the communicative-act and the content. Of course, if he wishes to do that, he can reset any of the fields.
    
    Returns:
    
    the ACLMessage to send as a reply
  - getAllIntendedReceiver
```
public Iterator getAllIntendedReceiver()
```
    retrieve the whole list of intended receivers for this message.
    
    Returns:
    
    An Iterator over all the intended receivers of this message taking into account the Envelope ":intended-receiver" first, the Envelope ":to" second and the message ":receiver" last.
  - getPersistentID
```
private Long getPersistentID()
```
  - setPersistentID
```
private void setPersistentID(Long l)
```
  - setReceivers
```
private void setReceivers(ArrayList al)
```
  - getReceivers
```
private ArrayList getReceivers()
```
  - setReplyTo
```
private void setReplyTo(ArrayList al)
```
  - getReplyTo
```
private ArrayList getReplyTo()
```
  - setUserDefinedProperties
```
private void setUserDefinedProperties(Serializable p)
```
  - getUserDefinedProperties
```
private Serializable getUserDefinedProperties()
```

Class ACLMessage

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

serialVersionUID

ACCEPT_PROPOSAL

AGREE

CANCEL

CFP

CONFIRM

DISCONFIRM

FAILURE

INFORM

INFORM_IF

INFORM_REF

NOT_UNDERSTOOD

PROPOSE

QUERY_IF

QUERY_REF

REFUSE

REJECT_PROPOSAL

REQUEST

REQUEST_WHEN

REQUEST_WHENEVER

SUBSCRIBE

PROXY

PROPAGATE

UNKNOWN

performative

performatives

IGNORE_FAILURE

POST_TIME_STAMP

TRACE

NO_CLONE

SYNCH_DELIVERY

AMS_FAILURE_AGENT_NOT_FOUND

AMS_FAILURE_AGENT_UNREACHABLE

AMS_FAILURE_SERVICE_ERROR

AMS_FAILURE_UNAUTHORIZED

AMS_FAILURE_FOREIGN_AGENT_UNREACHABLE

AMS_FAILURE_FOREIGN_AGENT_NO_ADDRESS

AMS_FAILURE_UNEXPECTED_ERROR

source

RECEIVERS_EXPECTED_SIZE

REPLYTO_EXPECTED_SIZE

dests

reply_to

content

byteSequenceContent

reply_with

in_reply_to

encoding

language

ontology

reply_byInMillisec

protocol

conversation_id

userDefProps

messageEnvelope

persistentID

Constructor Detail

ACLMessage

ACLMessage

Method Detail

getAllPerformativeNames

setSender

addReceiver

removeReceiver

clearAllReceiver

addReplyTo

removeReplyTo

clearAllReplyTo

setPerformative

setContent

setByteSequenceContent

setContentObject

getContentObject

setReplyWith