A secret (symmetric) key. The purpose of this interface is to group (and provide type safety for) all secret key interfaces.
Provider implementations of this interface must overwrite the
hashCode methods inherited from
java.lang.Object, so that secret keys are compared based on
their underlying key material and not based on reference.
Implementations should override the default
isDestroyed methods from the
javax.security.auth.Destroyable interface to enable
sensitive key information to be destroyed, cleared, or in the case
where such information is immutable, unreferenced.
should also override
to prevent keys that have been destroyed from being serialized.
Keys that implement this interface return the string
as their encoding format (see
getFormat), and return the
raw key bytes as the result of a
getEncoded method call. (The
getEncoded methods are inherited
java.security.Key parent interface.)