org.jivesoftware.smackx.ox

Class OpenPgpMessage

java.lang.Object

org.jivesoftware.smackx.ox.OpenPgpMessage

public class OpenPgpMessage
extends java.lang.Object

This class embodies a decrypted and/or verified OpenPgpElement.
The content can be one of the following three OpenPgpContentElements:

SignElement: The content is expected to be signed with the senders key, but unencrypted.
CryptElement: The content is expected to be encrypted, but not signed.
SigncryptElement: The content is expected to be signed with the senders key and encrypted.

To determine, of which nature the content of the message is, use getState(). You should utilize this information to cast the return value of getOpenPgpContentElement() correctly.
Use getMetadata() in order to get information about the messages encryption status, its signatures etc.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	OpenPgpMessage.State

Constructor Summary

Constructors

Constructor and Description
OpenPgpMessage(byte[] bytes, OpenPgpMessage.State state, org.pgpainless.decryption_verification.OpenPgpMetadata metadata) Constructor.
OpenPgpMessage(java.lang.String content, OpenPgpMessage.State state, org.pgpainless.decryption_verification.OpenPgpMetadata metadata) Constructor.

Method Summary

Modifier and Type	Method and Description
org.pgpainless.decryption_verification.OpenPgpMetadata	getMetadata() Return metadata about the encrypted message.
OpenPgpContentElement	getOpenPgpContentElement() Return the decrypted OpenPgpContentElement of this message.
OpenPgpMessage.State	getState() Return the state of the message.

Methods inherited from class java.lang.Object

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

Constructor Detail

OpenPgpMessage

public OpenPgpMessage(java.lang.String content,
                      OpenPgpMessage.State state,
                      org.pgpainless.decryption_verification.OpenPgpMetadata metadata)

Constructor.

Parameters:

content - XML representation of the decrypted OpenPgpContentElement.

state - OpenPgpMessage.State of the OpenPgpContentElement.

metadata - Metadata about the encryption.

OpenPgpMessage

public OpenPgpMessage(byte[] bytes,
                      OpenPgpMessage.State state,
                      org.pgpainless.decryption_verification.OpenPgpMetadata metadata)

Constructor.

Parameters:

bytes - bytes of the XML representation of the decrypted OpenPgpContentElement.

state - OpenPgpMessage.State of the OpenPgpContentElement.

metadata - metadata about the encryption.

Method Detail

getOpenPgpContentElement

public OpenPgpContentElement getOpenPgpContentElement()
                                               throws org.jivesoftware.smack.xml.XmlPullParserException,
                                                      java.io.IOException

Return the decrypted OpenPgpContentElement of this message. To determine, whether the element is a SignElement, CryptElement or SigncryptElement, please consult getState().

Returns:

OpenPgpContentElement

Throws:

org.jivesoftware.smack.xml.XmlPullParserException - if the parser encounters an error.

java.io.IOException - if the parser encounters an error.

getState

public OpenPgpMessage.State getState()
                              throws java.io.IOException,
                                     org.jivesoftware.smack.xml.XmlPullParserException

Return the state of the message. This value determines, whether the message was a SignElement, CryptElement or SigncryptElement.

Returns:

state of the content element.

Throws:

java.io.IOException - if the parser encounters an error.

org.jivesoftware.smack.xml.XmlPullParserException - if the parser encounters and error.

getMetadata

public org.pgpainless.decryption_verification.OpenPgpMetadata getMetadata()

Return metadata about the encrypted message.

Returns:

metadata TODO javadoc me please