01: /*
02: * <copyright>
03: *
04: * Copyright 1997-2004 BBNT Solutions, LLC
05: * under sponsorship of the Defense Advanced Research Projects
06: * Agency (DARPA).
07: *
08: * You can redistribute this software and/or modify it under the
09: * terms of the Cougaar Open Source License as published on the
10: * Cougaar Open Source Website (www.cougaar.org).
11: *
12: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
13: * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
14: * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
15: * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
16: * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
17: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
18: * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
19: * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
20: * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
21: * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
22: * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
23: *
24: * </copyright>
25: */
26:
27: package org.cougaar.core.agent;
28:
29: import org.cougaar.core.component.ContainerSupport;
30: import org.cougaar.core.mts.MessageAddress;
31: import org.cougaar.util.log.Logger;
32: import org.cougaar.util.log.Logging;
33:
34: /**
35: * The abstract agent base class, which is subclassed by {@link
36: * AgentImpl}.
37: * <p>
38: * This is primarily a marker class, since AgentImpl is used for
39: * all agent types.
40: */
41: public abstract class Agent extends ContainerSupport {
42: /** The Insertion point for any Agent, defined relative to the AgentManager. */
43: public static final String INSERTION_POINT = AgentManager.INSERTION_POINT
44: + ".Agent";
45:
46: public boolean add(Object o) {
47: try {
48: return super .add(o);
49: } catch (RuntimeException re) {
50: Logger logger = Logging.getLogger(this .getClass());
51: logger.error("Failed to add " + o + " to " + this , re);
52: throw re;
53: }
54: }
55:
56: protected String specifyContainmentPoint() {
57: return INSERTION_POINT;
58: }
59:
60: //backwards compatability for direct pointers to the agent
61: public abstract MessageAddress getAgentIdentifier();
62: }
|