Home | History | Annotate | Download | only in ims
      1 /*
      2 * Conditions Of Use
      3 *
      4 * This software was developed by employees of the National Institute of
      5 * Standards and Technology (NIST), an agency of the Federal Government.
      6 * Pursuant to title 15 Untied States Code Section 105, works of NIST
      7 * employees are not subject to copyright protection in the United States
      8 * and are considered to be in the public domain.  As a result, a formal
      9 * license is not needed to use the software.
     10 *
     11 * This software is provided by NIST as a service and is expressly
     12 * provided "AS IS."  NIST MAKES NO WARRANTY OF ANY KIND, EXPRESS, IMPLIED
     13 * OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTY OF
     14 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT
     15 * AND DATA ACCURACY.  NIST does not warrant or make any representations
     16 * regarding the use of the software or the results thereof, including but
     17 * not limited to the correctness, accuracy, reliability or usefulness of
     18 * the software.
     19 *
     20 * Permission to use this software is contingent upon your acceptance
     21 * of the terms of this agreement
     22 *
     23 * .
     24 *
     25 */
     26 /*****************************************************************************
     27  * PRODUCT OF PT INOVACAO - EST DEPARTMENT and Aveiro University - Portugal)   *
     28  *****************************************************************************/
     29 
     30 
     31 package gov.nist.javax.sip.header.ims;
     32 
     33 import javax.sip.InvalidArgumentException;
     34 import javax.sip.header.Header;
     35 
     36 
     37 /**
     38  * The P-Media-Authorization SIP Private Header - RFC 3313.
     39  *
     40  * <p>Sintax:</p>
     41  * <pre>
     42  * P-Media-Authorization   = "P-Media-Authorization" HCOLON
     43  *                            P-Media-Authorization-Token
     44  *                            *(COMMA P-Media-Authorization-Token)
     45  * P-Media-Authorization-Token = 1*HEXDIG
     46  * </pre>
     47  *
     48  * @author Miguel Freitas (IT) PT-Inovacao
     49  */
     50 
     51 public interface PMediaAuthorizationHeader extends Header
     52 {
     53 
     54     /**
     55      * Name of PMediaAuthorizationHeader
     56      */
     57     public final static String NAME = "P-Media-Authorization";
     58 
     59     /**
     60      * Set the media authorization token.
     61      * @param token - media authorization token to set
     62      * @throws InvalidArgumentException - if token is null or empty
     63      */
     64     public void setMediaAuthorizationToken(String token) throws InvalidArgumentException;
     65 
     66     /**
     67      * Get the media authorization token.
     68      * @return token
     69      */
     70     public String getToken();
     71 
     72 
     73 }
     74