1 /*
2  * JBoss, Home of Professional Open Source
3  * This code has been contributed to the public domain.
4  *
5  * This software is provided by NIST as a service and is expressly
6  * provided "AS IS."  NIST MAKES NO WARRANTY OF ANY KIND, EXPRESS, IMPLIED
7  * OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTY OF
8  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT
9  * AND DATA ACCURACY.  NIST does not warrant or make any representations
10  * regarding the use of the software or the results thereof, including but
11  * not limited to the correctness, accuracy, reliability or usefulness of
12  * the software.
13  *
14  * Permission to use this software is contingent upon your acceptance
15  * of the terms of this agreement.
16  */
17 package gov.nist.javax.sip;
18 
19 /**
20  * @author jean.deruelle@gmail.com
21  *
22  */
23 public interface UtilsExt {
24 
25     /**
26      * Generate a call identifier. This is useful when we want to generate a
27      * call identifier in advance of generating a message.
28      * @since 2.0
29      */
30     public String generateCallIdentifier(String address);
31 
32     /**
33      * Generate a tag for a FROM header or TO header. Just return a random 4
34      * digit integer (should be enough to avoid any clashes!) Tags only need to
35      * be unique within a call.
36      *
37      * @return a string that can be used as a tag parameter.
38      *
39      * synchronized: needed for access to 'rand', else risk to generate same tag
40      * twice
41      * @since 2.0
42      */
43     public String generateTag();
44     /**
45      * Generate a cryptographically random identifier that can be used to
46      * generate a branch identifier.
47      *
48      * @return a cryptographically random gloablly unique string that can be
49      *         used as a branch identifier.
50      * @since 2.0
51      */
52     public String generateBranchId();
53 
54 
55 }
56