net.solarnetwork.central.user.domain.UserAlert Maven / Gradle / Ivy

Go to download
/* ==================================================================
 * UserAlert.java - 15/05/2015 11:31:07 am
 * 
 * Copyright 2007-2015 SolarNetwork.net Dev Team
 * 
 * This program is free software; you can redistribute it and/or 
 * modify it under the terms of the GNU General Public License as 
 * published by the Free Software Foundation; either version 2 of 
 * the License, or (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful, 
 * but WITHOUT ANY WARRANTY; without even the implied warranty of 
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 
 * General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License 
 * along with this program; if not, write to the Free Software 
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 
 * 02111-1307 USA
 * ==================================================================
 */

package net.solarnetwork.central.user.domain;

import java.math.BigDecimal;
import java.time.Instant;
import java.util.Arrays;
import java.util.Collection;
import java.util.Collections;
import java.util.List;
import java.util.Map;
import java.util.stream.Collectors;
import com.fasterxml.jackson.annotation.JsonIgnore;
import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.annotation.JsonPropertyOrder;
import net.solarnetwork.central.dao.BaseEntity;
import net.solarnetwork.central.dao.UserRelatedEntity;
import net.solarnetwork.codec.JsonUtils;
import net.solarnetwork.domain.SerializeIgnore;

/**
 * An alert condition definition. User alerts are designed to cover conditions
 * such as
 * 
 * 
 * node X has not posted data in Y hours
 * node X posted value V for property A greater
 * than T
 * location L posted value V for property A less
 * than T
 * 
 * 
 * @author matt
 * @version 2.2
 */
@JsonPropertyOrder({ "id", "created", "userId", "nodeId", "type", "status", "validTo", "options" })
public class UserAlert extends BaseEntity implements UserRelatedEntity {

	private static final long serialVersionUID = -912662853889560214L;

	private Long userId;
	private UserAlertType type;
	private UserAlertStatus status;
	private Long nodeId;
	private Instant validTo;
	private Map options;
	private String optionsJson;

	// transient
	private UserAlertSituation situation;

	/**
	 * Get the options object as a JSON string.
	 * 
	 * 
	 * This method will ignore null values.
	 * 
	 * 
	 * @return a JSON encoded string, never null
	 */
	@SerializeIgnore
	@JsonIgnore
	public String getOptionsJson() {
		if ( optionsJson == null ) {
			optionsJson = JsonUtils.getJSONString(options, "{}");
		}
		return optionsJson;
	}

	/**
	 * Set the options object via a JSON string.
	 * 
	 * 
	 * This method will remove any previously created options and replace it
	 * with the values parsed from the JSON. All floating point values will be
	 * converted to {@link BigDecimal} instances.
	 * 
	 * 
	 * @param json
	 *        the JSON to set
	 */
	@JsonProperty
	// @JsonProperty needed because of @JsonIgnore on getter
	public void setOptionsJson(String json) {
		optionsJson = json;
		options = null;
	}

	@Override
	public Long getUserId() {
		return userId;
	}

	public void setUserId(Long userId) {
		this.userId = userId;
	}

	public UserAlertType getType() {
		return type;
	}

	public void setType(UserAlertType type) {
		this.type = type;
	}

	public UserAlertStatus getStatus() {
		return status;
	}

	public void setStatus(UserAlertStatus status) {
		this.status = status;
	}

	public Long getNodeId() {
		return nodeId;
	}

	public void setNodeId(Long nodeId) {
		this.nodeId = nodeId;
	}

	public Instant getValidTo() {
		return validTo;
	}

	public void setValidTo(Instant validTo) {
		this.validTo = validTo;
	}

	@SuppressWarnings("unchecked")
	@JsonProperty
	public Map getOptions() {
		if ( options == null && optionsJson != null ) {
			options = JsonUtils.getObjectFromJSON(optionsJson, Map.class);
		}
		return options;
	}

	/**
	 * Set the options instance to use.
	 * 
	 * 
	 * This will replace any value set previously via
	 * {@link #setOptionsJson(String)} as well.
	 * 
	 * 
	 * @param options
	 *        the samples instance to set
	 */
	@JsonProperty
	public void setOptions(Map options) {
		this.options = options;
		optionsJson = null;
	}

	/**
	 * Get the {@link UserAlertOptions#EMAIL_TOS} list as an array.
	 * 
	 * @return the email list, or {@literal null} if the option is not available
	 * @since 2.1
	 */
	public String[] optionEmailTos() {
		String[] result = null;
		if ( options != null ) {
			Object o = options.get(UserAlertOptions.EMAIL_TOS);
			if ( o instanceof Collection ) {
				result = ((Collection) o).stream().map(Object::toString).toArray(String[]::new);
			} else if ( o instanceof String[] ) {
				result = (String[]) o;
			} else if ( o != null ) {
				result = new String[] { o.toString() };
			}
		}
		return result;
	}

	/**
	 * Get the {@link UserAlertOptions#SOURCE_IDS} list.
	 * 
	 * @return the source ID list, or {@literal null} if the option is not
	 *         available
	 * @since 2.2
	 */
	public List optionSourceIds() {
		List result = null;
		if ( options != null ) {
			Object o = options.get(UserAlertOptions.SOURCE_IDS);
			if ( o instanceof Collection ) {
				result = ((List) o).stream().map(Object::toString).collect(Collectors.toList());
			} else if ( o instanceof String[] ) {
				result = Arrays.asList((String[]) o);
			} else if ( o != null ) {
				result = Collections.singletonList(o.toString());
			}
		}
		return result;
	}

	@Override
	public String toString() {
		StringBuilder builder = new StringBuilder();
		builder.append("UserAlert{id=");
		builder.append(getId());
		builder.append(", userId=");
		builder.append(userId);
		builder.append(", type=");
		builder.append(type);
		builder.append(", status=");
		builder.append(status);
		if ( nodeId != null ) {
			builder.append(", ");
			builder.append("nodeId=");
			builder.append(nodeId);
		}
		builder.append("}");
		return builder.toString();
	}

	public UserAlertSituation getSituation() {
		return situation;
	}

	public void setSituation(UserAlertSituation situation) {
		this.situation = situation;
	}

}