Coverage Report - org.openpermis.policy.Domain
 
Classes in this File Line Coverage Branch Coverage Complexity
Domain
N/A
N/A
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  
 }