KeysAndCert (I2P Anonymous Network - Java Documentation

java.lang.Object
- net.i2p.data.DataStructureImpl
- - net.i2p.data.KeysAndCert

All Implemented Interfaces:

Serializable, DataStructure

Direct Known Subclasses:

Destination, RouterIdentity
```
public class KeysAndCert
extends DataStructureImpl
```
KeysAndCert has a public key, a signing key, and a certificate. In that order. We also store a cached Hash. Implemented in 0.8.2 and retrofitted over Destination and RouterIdentity. There's actually no difference between the two of them. As of 0.9.9 this data structure is immutable after the two keys and the certificate are set; attempts to change them will throw an IllegalStateException.

Since:

0.8.2

Author:

zzz

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type Field Description

protected Certificate _certificate

protected byte[] _padding

protected PublicKey _publicKey

protected SigningPublicKey _signingKey

Fields
Modifier and Type	Field	Description
`protected Certificate`	`_certificate`
`protected byte[]`	`_padding`
`protected PublicKey`	`_publicKey`
`protected SigningPublicKey`	`_signingKey`

Constructor Summary

Constructors
Constructor Description

KeysAndCert()

Constructors
Constructor	Description
`KeysAndCert()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`Hash`	`calculateHash()`	Throws IllegalStateException if keys and cert are not initialized, as of 0.9.12.
`boolean`	`equals(Object object)`
`Certificate`	`getCertificate()`
`Hash`	`getHash()`	Throws IllegalStateException if keys and cert are not initialized, as of 0.9.12.
`byte[]`	`getPadding()`
`PublicKey`	`getPublicKey()`
`SigningPublicKey`	`getSigningPublicKey()`
`SigType`	`getSigType()`
`int`	`hashCode()`	the signing key has enough randomness in it to use it by itself for speed
`void`	`readBytes(InputStream in)`	Load up the current object with data from the given stream.
`void`	`setCertificate(Certificate cert)`
`void`	`setPadding(byte[] padding)`
`void`	`setPublicKey(PublicKey key)`
`void`	`setSigningPublicKey(SigningPublicKey key)`
`String`	`toString()`
`void`	`writeBytes(OutputStream out)`	Write out the data structure to the stream, using the format defined in the I2P data structure specification.

Methods inherited from class net.i2p.data.DataStructureImpl
fromBase64, fromByteArray, read, toBase64, toByteArray

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - _publicKey
```
protected PublicKey _publicKey
```
  - _signingKey
```
protected SigningPublicKey _signingKey
```
  - _certificate
```
protected Certificate _certificate
```
  - _padding
```
protected byte[] _padding
```
- Constructor Detail
  - KeysAndCert
```
public KeysAndCert()
```
- Method Detail
  - getCertificate
```
public Certificate getCertificate()
```
  - setCertificate
```
public void setCertificate(Certificate cert)
```
    Throws:
    
    IllegalStateException - if was already set
  - getSigType
```
public SigType getSigType()
```
    Returns:
    
    null if not set or unknown
    
    Since:
    
    0.9.17
  - getPublicKey
```
public PublicKey getPublicKey()
```
  - setPublicKey
```
public void setPublicKey(PublicKey key)
```
    Throws:
    
    IllegalStateException - if was already set
  - getSigningPublicKey
```
public SigningPublicKey getSigningPublicKey()
```
  - setSigningPublicKey
```
public void setSigningPublicKey(SigningPublicKey key)
```
    Throws:
    
    IllegalStateException - if was already set
  - getPadding
```
public byte[] getPadding()
```
    Since:
    
    0.9.16
  - setPadding
```
public void setPadding(byte[] padding)
```
    Throws:
    
    IllegalStateException - if was already set
    
    Since:
    
    0.9.12
  - readBytes
```
public void readBytes(InputStream in)
               throws DataFormatException,
                      IOException
```
    Description copied from interface: DataStructure
    
    Load up the current object with data from the given stream. Data loaded this way must match the I2P data structure specification. Warning - many classes will throw IllegalStateException if data is already set.
    
    Parameters:
    
    in - stream to read from
    
    Throws:
    
    IllegalStateException - if data already set
    
    DataFormatException - if the data is improperly formatted
    
    IOException - if there was a problem reading the stream
  - writeBytes
```
public void writeBytes(OutputStream out)
                throws DataFormatException,
                       IOException
```
    Description copied from interface: DataStructure
    
    Write out the data structure to the stream, using the format defined in the I2P data structure specification.
    
    Parameters:
    
    out - stream to write to
    
    Throws:
    
    DataFormatException - if the data was incomplete or not yet ready to be written
    
    IOException - if there was a problem writing to the stream
  - equals
```
public boolean equals(Object object)
```
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    the signing key has enough randomness in it to use it by itself for speed
    
    Overrides:
    
    hashCode in class Object
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - calculateHash
```
public Hash calculateHash()
```
    Throws IllegalStateException if keys and cert are not initialized, as of 0.9.12. Prior to that, returned null.
    
    Specified by:
    
    calculateHash in interface DataStructure
    
    Overrides:
    
    calculateHash in class DataStructureImpl
    
    Returns:
    
    SHA256 hash, or null if there were problems (data format or io errors)
    
    Throws:
    
    IllegalStateException
  - getHash
```
public Hash getHash()
```
    Throws IllegalStateException if keys and cert are not initialized, as of 0.9.12. Prior to that, returned null.
    
    Throws:
    
    IllegalStateException

Class KeysAndCert

Field Summary

Constructor Summary

Method Summary

Methods inherited from class net.i2p.data.DataStructureImpl

Methods inherited from class java.lang.Object

Field Detail

_publicKey

_signingKey

_certificate

_padding

Constructor Detail

KeysAndCert

Method Detail

getCertificate

setCertificate

getSigType

getPublicKey

setPublicKey

getSigningPublicKey

setSigningPublicKey

getPadding

setPadding

readBytes

writeBytes

equals

hashCode

toString

calculateHash

getHash