hudson.cli
Class Connection

java.lang.Object
  hudson.cli.Connection

public class Connection
extends Object

Field Summary

DataInputStream	din
DataOutputStream	dout
InputStream	in
OutputStream	out

Constructor Summary

Connection(InputStream in, OutputStream out)

Connection(Socket socket)

Method Summary

void	close()
KeyAgreement	diffieHellman(boolean side) Performs a Diffie-Hellman key exchange and produce a common secret between two ends of the connection.
void	proveIdentity(byte[] sharedSecret, KeyPair key) Used in conjunction with verifyIdentity(byte[]) to prove that we actually own the private key of the given key pair.
boolean	readBoolean()
X509EncodedKeySpec	readKey()
<T> T	readObject() Receives an object sent by writeObject(Object)
String	readUTF()
PublicKey	verifyIdentity(byte[] sharedSecret) Verifies that we are talking to a peer that actually owns the private key corresponding to the public key we get.
void	writeBoolean(boolean b)
void	writeKey(Key key)
void	writeObject(Object o) Sends a serializable object.
void	writeUTF(String msg)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

in

public final InputStream in

out

public final OutputStream out

din

public final DataInputStream din

dout

public final DataOutputStream dout

Constructor Detail

Connection

public Connection(Socket socket)
           throws IOException

Throws:

IOException

Connection

public Connection(InputStream in,
                  OutputStream out)

Method Detail

writeUTF

public void writeUTF(String msg)
              throws IOException

Throws:

IOException

readUTF

public String readUTF()
               throws IOException

Throws:

IOException

writeBoolean

public void writeBoolean(boolean b)
                  throws IOException

Throws:

IOException

readBoolean

public boolean readBoolean()
                    throws IOException

Throws:

IOException

writeObject

public void writeObject(Object o)
                 throws IOException

Sends a serializable object.

Throws:

IOException

readObject

public <T> T readObject()
             throws IOException,
                    ClassNotFoundException

Receives an object sent by writeObject(Object)

Throws:

IOException

ClassNotFoundException

writeKey

public void writeKey(Key key)
              throws IOException

Throws:

IOException

readKey

public X509EncodedKeySpec readKey()
                           throws IOException

Throws:

IOException

diffieHellman

public KeyAgreement diffieHellman(boolean side)
                           throws IOException,
                                  GeneralSecurityException

Performs a Diffie-Hellman key exchange and produce a common secret between two ends of the connection.

DH is also useful as a coin-toss algorithm. Two parties get the same random number without trusting each other.

Throws:

IOException

GeneralSecurityException

proveIdentity

public void proveIdentity(byte[] sharedSecret,
                          KeyPair key)
                   throws IOException,
                          GeneralSecurityException

Used in conjunction with verifyIdentity(byte[]) to prove that we actually own the private key of the given key pair.

Throws:

IOException

GeneralSecurityException

verifyIdentity

public PublicKey verifyIdentity(byte[] sharedSecret)
                         throws IOException,
                                GeneralSecurityException

Verifies that we are talking to a peer that actually owns the private key corresponding to the public key we get.

Throws:

IOException

GeneralSecurityException

close

public void close()
           throws IOException

Throws:

IOException