Classes in this File | Line Coverage | Branch Coverage | Complexity | ||||
Domain |
|
| 1.0;1 |
1 | /* | |
2 | * Copyright (c) 2009, Swiss Federal Department of Defence Civil Protection and Sport | |
3 | * (http://www.vbs.admin.ch) | |
4 | * Copyright (c) 2009, Ergon Informatik AG (http://www.ergon.ch) | |
5 | * All rights reserved. | |
6 | * | |
7 | * Licensed under the Open Permis License which accompanies this distribution, | |
8 | * and is available at http://www.openpermis.org/BSDlicenceKent.txt | |
9 | */ | |
10 | package org.openpermis.policy; | |
11 | ||
12 | import java.net.URI; | |
13 | ||
14 | /** | |
15 | * A domain represents a set of addressable entities. | |
16 | * <p>Individual entities are universally addressed with uniform resource identifiers. | |
17 | * This includes HTTP URLs for services or LDAP distinguished names for subjects.</p> | |
18 | * <p>Domains may include and exclude individual entities or entire subtrees of a | |
19 | * directory structure.</p> | |
20 | * @since 0.1.0 | |
21 | */ | |
22 | public interface Domain | |
23 | extends Part, Identifiable | |
24 | { | |
25 | ||
26 | //---- Methods | |
27 | ||
28 | /** | |
29 | * Checks if this domain contains the specified entity. | |
30 | * @param identity the entity to search for, may be {@code null}. | |
31 | * @return {@code true} if this domain contains the specified entity, | |
32 | * {@code false} if the entity is not contained or the supplied entity is {@code null}. | |
33 | * @since 0.1.0 | |
34 | */ | |
35 | public boolean contains (URI identity); | |
36 | ||
37 | } |