1 
2 package gov.nist.javax.sip;
3 
4 import java.security.cert.Certificate;
5 
6 import javax.net.ssl.SSLPeerUnverifiedException;
7 import javax.sip.SipProvider;
8 import javax.sip.Transaction;
9 
10 public interface TransactionExt extends Transaction {
11 
12     /**
13      * Get the Sip Provider associated with this transaction
14      */
getSipProvider()15     public SipProvider getSipProvider();
16 
17     /**
18      * Returns the IP address of the upstream/downstream hop from which this message was initially received
19      * @return the IP address of the upstream/downstream hop from which this message was initially received
20      * @since 2.0
21      */
getPeerAddress()22     public String getPeerAddress();
23     /**
24      * Returns the port of the upstream/downstream hop from which this message was initially received
25      * @return the port of the upstream/downstream hop from which this message was initially received
26      * @since 2.0
27      */
getPeerPort()28     public int getPeerPort();
29     /**
30      * Returns the name of the protocol with which this message was initially received
31      * @return the name of the protocol with which this message was initially received
32      * @since 2.0
33      */
getTransport()34     public String getTransport();
35 
36     /**
37      * return the ip address on which this message was initially received
38      * @return the ip address on which this message was initially received
39      */
getHost()40     public String getHost();
41     /**
42      * return the port on which this message was initially received
43      * @return the port on which this message was initially received
44      */
getPort()45     public int getPort();
46 
47     /**
48      * Return the Cipher Suite that was used for the SSL handshake.
49      *
50      * @return     Returns the cipher suite in use by the session which was produced by the handshake.
51      * @throw UnsupportedOperationException if this is not a secure client transaction.
52      */
getCipherSuite()53     public String getCipherSuite() throws UnsupportedOperationException;
54 
55     /**
56      * Get the certificate(s) that were sent to the peer during handshaking.
57      *@return the certificate(s) that were sent to the peer during handshaking.
58      *@throw UnsupportedOperationException if this is not a secure client transaction.
59      *
60      */
getLocalCertificates()61    Certificate[] getLocalCertificates() throws UnsupportedOperationException;
62 
63     /**
64      * @return the identity of the peer which was identified as part of defining the session.
65      * @throws SSLPeerUnverifiedException
66      * @throw UnsupportedOperationException if this is not a secure client transaction.
67      */
getPeerCertificates()68    Certificate[]  getPeerCertificates() throws SSLPeerUnverifiedException;
69 }
70