01: /*
02: * <copyright>
03: *
04: * Copyright 1997-2004 Mobile Intelligence Corp
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: package org.cougaar.core.service.community;
27:
28: import javax.naming.directory.Attributes;
29:
30: /**
31: * Interface defining entities that are associated with a community. An
32: * entity is typically an Agent or a Community.
33: */
34: public interface Entity {
35:
36: /**
37: * Set entity name.
38: * @param name Entity name
39: */
40: public void setName(String name);
41:
42: /**
43: * Get entity name.
44: * @return Entity name
45: */
46: public String getName();
47:
48: /**
49: * Set entity attributes.
50: * @param attrs Entity attributes
51: */
52: public void setAttributes(Attributes attrs);
53:
54: /**
55: * Get entity attributes.
56: * @return Entity attributes
57: */
58: public Attributes getAttributes();
59:
60: /**
61: * Returns an XML representation of Entity.
62: */
63: public String toXml();
64:
65: /**
66: * Returns an XML representation of Entity.
67: * @param indent Blank string used to pad beginning of entry to control
68: * indentation formatting
69: */
70: public String toXml(String indent);
71:
72: /**
73: * Creates a string representation of an Attribute set.
74: */
75: public String attrsToString();
76: }
|