org.fusesource.hawtbuf.proto

Class UninitializedMessageException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.fusesource.hawtbuf.proto.UninitializedMessageException

All Implemented Interfaces:

java.io.Serializable

public class UninitializedMessageException
extends java.lang.RuntimeException

Thrown when attempting to build a protocol message that is missing required fields. This is a RuntimeException because it normally represents a programming error: it happens when some code which constructs a message fails to set all the fields. parseFrom() methods do not throw this; they throw an InvalidProtocolBufferException if required fields are missing, because it is not a programming error to receive an incomplete message. In other words, UninitializedMessageException should never be thrown by correct code, but InvalidProtocolBufferException might be.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.List<java.lang.String>	missingFields

Constructor Summary

Constructors

Constructor and Description
UninitializedMessageException(java.util.List<java.lang.String> missingFields)

Method Summary

Modifier and Type	Method and Description
InvalidProtocolBufferException	asInvalidProtocolBufferException() Converts this exception to an InvalidProtocolBufferException.
private static java.lang.String	buildDescription(java.util.List<java.lang.String> missingFields) Construct the description string for this exception.
java.util.List<java.lang.String>	getMissingFields() Get a list of human-readable names of required fields missing from this message.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Field Detail

missingFields

private final java.util.List<java.lang.String> missingFields

Constructor Detail

UninitializedMessageException

public UninitializedMessageException(java.util.List<java.lang.String> missingFields)

Method Detail

getMissingFields

public java.util.List<java.lang.String> getMissingFields()

Get a list of human-readable names of required fields missing from this message. Each name is a full path to a field, e.g. "foo.bar[5].baz".

asInvalidProtocolBufferException

public InvalidProtocolBufferException asInvalidProtocolBufferException()

Converts this exception to an InvalidProtocolBufferException. When a parsed message is missing required fields, this should be thrown instead of UninitializedMessageException.

buildDescription

private static java.lang.String buildDescription(java.util.List<java.lang.String> missingFields)

Construct the description string for this exception.