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
31package gov.nist.javax.sip.header.ims;
32
33import javax.sip.InvalidArgumentException;
34import 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
51public 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