MessageList (org.faktorips.runtime 3.21.5-SNAPSHOT API)

java.lang.Object
- org.faktorips.runtime.MessageList

All Implemented Interfaces:

Serializable, Iterable<Message>
```
public class MessageList
extends Object
implements Serializable, Iterable<Message>
```
A list of Messages.

See Also:

Message, Serialized Form

Constructor Summary

Constructors
Constructor and Description

MessageList()
Creates an empty message list.

MessageList(Message message)
Creates a message list that contains the given message.

Constructors
Constructor and Description
`MessageList()` Creates an empty message list.
`MessageList(Message message)` Creates a message list that contains the given message.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`add(Message message)` Adds the message to the list.
`void`	`add(MessageList messageList)` Adds the messages in the given list to this list.
`void`	`add(MessageList messageList, ObjectProperty invalidObjectProperty, boolean override)` Copies the messages from the given list to this list and sets the message's invalid object properties.
`void`	`clear()` Removes all of the messages from this list.
`boolean`	`containsErrorMsg()` Returns true if one the messages in the list is an error message, otherwise false.
`static MessageList`	`createCopy(MessageList list, Object oldObject, Object newObject)` Creates a copy from the message list and replaces all references to the old object with the new object.
`boolean`	`equals(Object obj)`
`Message`	`getFirstMessage(Severity severity)` Returns the first message with the given severity or null if none is found.
`Message`	`getMessage(int index)` Returns the message at the indicated index (indexing starts with 0).
`Message`	`getMessageByCode(String code)` Returns the first message in the list that has the specified message code.
`MessageList`	`getMessagesByCode(String code)` Returns a new message list containing all the message in this list that have the specified message code.
`MessageList`	`getMessagesByMarker(IMarker marker)` Returns a new message list containing all the message in this list that have the specified `IMarker`.
`MessageList`	`getMessagesByMarker(IPredicate<IMarker> markerPredicate)` Returns a new message list containing all the message in this list with a `IMarker` the specified `IPredicate` matches.
`MessageList`	`getMessagesFor(Object object)` Returns a new list with the messages in this list that belong to the given object (any property).
`MessageList`	`getMessagesFor(Object object, String property)` Returns a new list with the messages in this list that belong to the given object and property.
`MessageList`	`getMessagesFor(Object object, String property, int index)` Returns a new list with the messages in this list that belong to the given object and property and the property is of the given index.
`Message`	`getMessageWithHighestSeverity()` Returns the message with the highest severity.
`int`	`getNoOfMessages()` Deprecated. Use #size() instead
`Severity`	`getSeverity()` Returns the message list's severity.
`String`	`getText()` Returns the text of all messages in the list, separated by the system's default line separator.
`int`	`hashCode()`
`boolean`	`isEmpty()` Returns true if the list is empty.
`Iterator<Message>`	`iterator()` Returns an iterator over the messages in this list.
`int`	`size()` Returns the number of messages in the list.
`String`	`toString()` Returns all messages in the list separated by a line separator.

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

Methods inherited from interface java.lang.Iterable
forEach, spliterator

- Constructor Detail
  - MessageList
```
public MessageList()
```
    Creates an empty message list.
  - MessageList
```
public MessageList(Message message)
```
    Creates a message list that contains the given message.
    
    Throws:
    
    NullPointerException - if message is null.
- Method Detail
  - createCopy
```
public static final MessageList createCopy(MessageList list,
                                           Object oldObject,
                                           Object newObject)
```
    Creates a copy from the message list and replaces all references to the old object with the new object.
    
    Parameters:
    
    list - the list to copy
    
    oldObject - the old object reference that should be replaced.
    
    newObject - the object reference to set
  - add
```
public void add(Message message)
```
    Adds the message to the list.
    
    Parameters:
    
    message - the Message to add. Ignored if null.
  - add
```
public void add(MessageList messageList)
```
    Adds the messages in the given list to this list.
  - add
```
public void add(MessageList messageList,
                ObjectProperty invalidObjectProperty,
                boolean override)
```
    Copies the messages from the given list to this list and sets the message's invalid object properties.
    
    Parameters:
    
    messageList - the list to copy the messages from.
    
    invalidObjectProperty - the object and it's property that the messages refer to.
    
    override - true if the invalidObjectProperty should be set in all messages. false if the invalidObjectProperty is set only for messages that do not contain any invalid object property information.
  - isEmpty
```
public boolean isEmpty()
```
    Returns true if the list is empty.
  - getNoOfMessages
```
@Deprecated
public int getNoOfMessages()
```
    Deprecated. Use #size() instead
    
    Returns the number of messages in the list.
  - size
```
public int size()
```
    Returns the number of messages in the list.
    
    Returns:
    
    The size of the message list
  - getMessage
```
public Message getMessage(int index)
```
    Returns the message at the indicated index (indexing starts with 0).
    
    Throws:
    
    IndexOutOfBoundsException - if the index is out of range.
  - getFirstMessage
```
public Message getFirstMessage(Severity severity)
```
    Returns the first message with the given severity or null if none is found.
  - getMessageWithHighestSeverity
```
public Message getMessageWithHighestSeverity()
```
    Returns the message with the highest severity. If there are multiple such messages, the first one is returned. If this list isEmpty(), null is returned.
  - getMessageByCode
```
public Message getMessageByCode(String code)
```
    Returns the first message in the list that has the specified message code. Returns null if the list does not contain such a message.
    
    Parameters:
    
    code - the code to look for. May be null, as messages may have null as their message code.
  - getMessagesByCode
```
public MessageList getMessagesByCode(String code)
```
    Returns a new message list containing all the message in this list that have the specified message code. Returns an empty list if this list does not contain any message with the given code.
    
    Parameters:
    
    code - the code to look for. May be null, as messages may have null as their message code.
  - getMessagesByMarker
```
public MessageList getMessagesByMarker(IMarker marker)
```
    Returns a new message list containing all the message in this list that have the specified IMarker. Returns an empty list if this list does not contain any message with the given IMarker.
    
    Parameters:
    
    marker - the IMarker to look for. If null, all messages without a IMarker are returned.
  - getMessagesByMarker
```
public MessageList getMessagesByMarker(IPredicate<IMarker> markerPredicate)
```
    Returns a new message list containing all the message in this list with a IMarker the specified IPredicate matches. Returns an empty list if this list does not contain any such message.
    Sample usage: messages.getMessagesByMarker(new IPredicate<IMarker>(){public boolean test(IMarker t){return t.isRequiredInformationMissing();}});
    Sample usage (Java8): messages.getMessagesByMarker(IMarker::isRequiredInformationMissing);
    
    Parameters:
    
    markerPredicate - to match a IMarker with. Must not be null
    
    Throws:
    
    NullPointerException - if markerPredicate is null
  - getSeverity
```
public Severity getSeverity()
```
    Returns the message list's severity. This is the maximum severity of the list's messages. If the list does not contain any messages, the method returns 0.
  - getText
```
public String getText()
```
    Returns the text of all messages in the list, separated by the system's default line separator.
  - containsErrorMsg
```
public boolean containsErrorMsg()
```
    Returns true if one the messages in the list is an error message, otherwise false.
  - getMessagesFor
```
public MessageList getMessagesFor(Object object)
```
    Returns a new list with the messages in this list that belong to the given object (any property). Returns an empty list if no such message is found.
  - getMessagesFor
```
public MessageList getMessagesFor(Object object,
                                  String property,
                                  int index)
```
    Returns a new list with the messages in this list that belong to the given object and property and the property is of the given index. Returns an empty list if no such message is found.
  - getMessagesFor
```
public MessageList getMessagesFor(Object object,
                                  String property)
```
    Returns a new list with the messages in this list that belong to the given object and property. Returns an empty list if no such message is found.
  - iterator
```
public Iterator<Message> iterator()
```
    Returns an iterator over the messages in this list.
    
    Specified by:
    
    iterator in interface Iterable<Message>
  - clear
```
public void clear()
```
    Removes all of the messages from this list. This list will be empty after this call returns.
  - toString
```
public String toString()
```
    Returns all messages in the list separated by a line separator. Overridden method.
    
    Overrides:
    
    toString in class Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object

Class MessageList

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface java.lang.Iterable

Constructor Detail

MessageList

MessageList

Method Detail

createCopy

add

add

add

isEmpty

getNoOfMessages

size

getMessage

getFirstMessage

getMessageWithHighestSeverity

getMessageByCode

getMessagesByCode

getMessagesByMarker

getMessagesByMarker

getSeverity

getText

containsErrorMsg

getMessagesFor

getMessagesFor

getMessagesFor

iterator

clear

toString

hashCode

equals