1 /* 2 * Copyright (C) The Apache Software Foundation. All rights reserved. 3 * 4 * This software is published under the terms of the Apache Software License 5 * version 1.1, a copy of which has been included with this distribution in 6 * the LICENSE.txt file. 7 */ 8 package org.apache.avalon.excalibur.event; 9 10 /** 11 * A Source implements the side of an event queue where QueueElements are 12 * dequeued operations only. 13 * 14 * @author <a HREF="mailto:bloritsch@apache.org">Berin Loritsch</a> 15 */ 16 public interface Message extends QueueElement 17 { 18 /** 19 * Get the attachment associated with this Message. If there is no 20 * attachment, this method will return null. 21 */ 22 Object getAttachment(); 23 24 /** 25 * Attach an Object to the message. 26 */ 27 void attach( Object attachment ); 28 29 /** 30 * Clear the attachment. 31 */ 32 void clear(); 33 }