/*
 * Licensed Materials - Property of IBM
 *  
 * (C) Copyright IBM Corp. 2014
 * 
 * LICENSE: Eclipse Public License v1.0
 * http://www.eclipse.org/legal/epl-v10.html
 */

package fabric.registry;

/**
 * Represents information about a bearer.
 */
public interface Bearer extends RegistryObject {

	/** Copyright notice. */
	public static final String copyrightNotice = "(C) Copyright IBM Corp. 2014";

	/**
	 * Get the identifier for the bearer.
	 * 
	 * @return the id of the bearer.
	 */
	public String getId();

	/**
	 * Set the identifier for the bearer - this attribute must always be specified. Without it, the object cannot be
	 * saved to the Fabric Registry and will generate an IncompleteObjectException.
	 * 
	 * @param id
	 *            the bearer id.
	 */
	public void setId(String id);

	/**
	 * Get the availability status of the bearer.
	 * 
	 * @return the availability status, one of "available" or "unavailable".
	 */
	public String getAvailability();

	/**
	 * Set the availability status of the bearer - this attribute must always be specified. Without it, the object
	 * cannot be saved to the Fabric Registry and will generate an IncompleteObjectException.
	 * 
	 * @param availability
	 *            the availability status, one of "available" or "unavailable". Cannot be <code>null</code>.
	 */
	public void setAvailability(String availability);

	/**
	 * Get the custom attributes for the bearer.
	 * 
	 * @return the attributes or <code>null</code> if none are specified.
	 */
	public String getAttributes();

	/**
	 * Set the custom attributes for the bearer.
	 * 
	 * @param attributes
	 *            the attributes or <code>null</code>.
	 */
	public void setAttributes(String attributes);

	/**
	 * Get the URI of the attributes.
	 * 
	 * @return the URI or <code>null</code> if not specified.
	 */
	public String getAttributesURI();

	/**
	 * Set the URI of the attributes.
	 * 
	 * @param attributesURI
	 *            a URI or <code>null</code>.
	 */
	public void setAttributesURI(String attributesURI);

	/**
	 * Get the description of the bearer.
	 * 
	 * @return the description or <code>null</code> if none was specified.
	 */
	public String getDescription();

	/**
	 * Set the description of the bearer.
	 * 
	 * @param description
	 *            the description or <code>null</code>.
	 */
	public void setDescription(String description);
}

@@ -1,52 +1,7 @@
 /*%0A
- * Licensed Materials - Property of IBM%0A *  %0A
  * (
@@ -858,33 +858,22 @@
 of %22
-available%22 or %22unavailabl
+true%22 or %22fals
 e%22.%0A
@@ -902,21 +902,18 @@
 tAvailab
-ility
+le
 ();%0A%0A%09/*
@@ -1140,21 +1140,18 @@
  availab
-ility
+le
 %0A%09 *    
@@ -1195,33 +1195,22 @@
 of %22
-available%22 or %22unavailabl
+true%22 or %22fals
 e%22. 
@@ -1266,21 +1266,18 @@
 tAvailab
-ility
+le
 (String 
@@ -1283,21 +1283,18 @@
  availab
-ility
+le
 );%0A%0A%09/**

Update header comments.