162 lines
4.4 KiB
Java
162 lines
4.4 KiB
Java
/**
|
|
* Copyright 2013 Netflix, Inc.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
package rx;
|
|
|
|
/**
|
|
* An object representing a notification sent to an {@link Observable}.
|
|
*
|
|
* For the Microsoft Rx equivalent see: http://msdn.microsoft.com/en-us/library/hh229462(v=vs.103).aspx
|
|
*/
|
|
public class Notification<T> {
|
|
|
|
private final Kind kind;
|
|
private final Exception exception;
|
|
private final T value;
|
|
|
|
/**
|
|
* A constructor used to represent an onNext notification.
|
|
*
|
|
* @param value
|
|
* The data passed to the onNext method.
|
|
*/
|
|
public Notification(T value) {
|
|
this.value = value;
|
|
this.exception = null;
|
|
this.kind = Kind.OnNext;
|
|
}
|
|
|
|
/**
|
|
* A constructor used to represent an onError notification.
|
|
*
|
|
* @param exception
|
|
* The exception passed to the onError notification.
|
|
*/
|
|
public Notification(Exception exception) {
|
|
this.exception = exception;
|
|
this.value = null;
|
|
this.kind = Kind.OnError;
|
|
}
|
|
|
|
/**
|
|
* A constructor used to represent an onCompleted notification.
|
|
*/
|
|
public Notification() {
|
|
this.exception = null;
|
|
this.value = null;
|
|
this.kind = Kind.OnCompleted;
|
|
}
|
|
|
|
/**
|
|
* Retrieves the exception associated with an onError notification.
|
|
*
|
|
* @return The exception associated with an onError notification.
|
|
*/
|
|
public Exception getException() {
|
|
return exception;
|
|
}
|
|
|
|
/**
|
|
* Retrieves the data associated with an onNext notification.
|
|
*
|
|
* @return The data associated with an onNext notification.
|
|
*/
|
|
public T getValue() {
|
|
return value;
|
|
}
|
|
|
|
/**
|
|
* Retrieves a value indicating whether this notification has a value.
|
|
*
|
|
* @return a value indicating whether this notification has a value.
|
|
*/
|
|
public boolean hasValue() {
|
|
return isOnNext() && value != null;
|
|
}
|
|
|
|
/**
|
|
* Retrieves a value indicating whether this notification has an exception.
|
|
*
|
|
* @return a value indicating whether this notification has an exception.
|
|
*/
|
|
public boolean hasException() {
|
|
return isOnError() && exception != null;
|
|
}
|
|
|
|
/**
|
|
* The kind of notification: OnNext, OnError, OnCompleted
|
|
*
|
|
* @return
|
|
*/
|
|
public Kind getKind() {
|
|
return kind;
|
|
}
|
|
|
|
public boolean isOnError() {
|
|
return getKind() == Kind.OnError;
|
|
}
|
|
|
|
public boolean isOnCompleted() {
|
|
return getKind() == Kind.OnCompleted;
|
|
}
|
|
|
|
public boolean isOnNext() {
|
|
return getKind() == Kind.OnNext;
|
|
}
|
|
|
|
public static enum Kind {
|
|
OnNext, OnError, OnCompleted
|
|
}
|
|
|
|
@Override
|
|
public String toString() {
|
|
StringBuilder str = new StringBuilder("[").append(super.toString()).append(" ").append(getKind());
|
|
if (hasValue())
|
|
str.append(" ").append(getValue());
|
|
if (hasException())
|
|
str.append(" ").append(getException().getMessage());
|
|
str.append("]");
|
|
return str.toString();
|
|
}
|
|
|
|
@Override
|
|
public int hashCode() {
|
|
int hash = getKind().hashCode();
|
|
if (hasValue())
|
|
hash = hash * 31 + getValue().hashCode();
|
|
if (hasException())
|
|
hash = hash * 31 + getException().hashCode();
|
|
return hash;
|
|
}
|
|
|
|
@Override
|
|
public boolean equals(Object obj) {
|
|
if (obj == null)
|
|
return false;
|
|
if (this == obj)
|
|
return true;
|
|
if (obj.getClass() != getClass())
|
|
return false;
|
|
Notification<?> notification = (Notification<?>) obj;
|
|
if (notification.getKind() != getKind())
|
|
return false;
|
|
if (hasValue() && !getValue().equals(notification.getValue()))
|
|
return false;
|
|
if (hasException() && !getException().equals(notification.getException()))
|
|
return false;
|
|
return true;
|
|
}
|
|
}
|