All Downloads are FREE. Search and download functionalities are using the official Maven repository.

reactor.bus.Event Maven / Gradle / Ivy

/*
 * Copyright (c) 2011-2014 Pivotal Software, 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 reactor.bus;

import reactor.core.support.Assert;
import reactor.core.support.Recyclable;
import reactor.core.support.UUIDUtils;
import reactor.fn.Consumer;
import reactor.fn.tuple.Tuple;
import reactor.fn.tuple.Tuple2;

import java.io.Serializable;
import java.util.*;

/**
 * Wrapper for an object that needs to be processed by {@link reactor.fn.Consumer}s.
 *
 * @param 
 *     The type of the wrapped object
 *
 * @author Jon Brisbin
 * @author Stephane Maldini
 * @author Andy Wilkinson
 */
public class Event implements Serializable, Recyclable {

  private static final long serialVersionUID = -2476263092040373361L;
  private final transient Consumer errorConsumer;
  private volatile        UUID                id;
  private volatile        Headers             headers;
  private volatile        Object              replyTo;
  private volatile        Object              key;
  private volatile        T                   data;

  /**
   * Creates a new Event based on the type T of {@data data}
   *
   * @param klass
   */
  public Event(Class klass) {
    this.headers = null;
    this.data = null;
    this.errorConsumer = null;
  }

  /**
   * Creates a new Event with the given {@code headers} and {@code data}.
   *
   * @param headers
   *     The headers
   * @param data
   *     The data
   */
  public Event(Headers headers, T data) {
    this.headers = headers;
    this.data = data;
    this.errorConsumer = null;
  }

  /**
   * Creates a new Event with the given {@code headers}, {@code data} and {@link reactor.fn.Consumer }.
   *
   * @param headers
   *     The headers
   * @param data
   *     The data
   * @param errorConsumer
   *     error consumer callback
   */
  public Event(Headers headers, T data, Consumer errorConsumer) {
    this.headers = headers;
    this.data = data;
    this.errorConsumer = errorConsumer;
  }

  /**
   * Creates a new Event with the given {@code data}. The event will have empty headers.
   *
   * @param data
   *     The data
   */
  public Event(T data) {
    this.data = data;
    this.errorConsumer = null;
  }

  /**
   * Wrap the given object with an {@link Event}.
   *
   * @param obj
   *     The object to wrap.
   *
   * @return The new {@link Event}.
   */
  public static  Event wrap(T obj) {
    return new Event(obj);
  }

  /**
   * Wrap the given object with an {@link Event} and set the {@link Event#getReplyTo() replyTo} to the given {@code
   * replyToKey}.
   *
   * @param obj
   *     The object to wrap.
   * @param replyToKey
   *     The key to use as a {@literal replyTo}.
   * @param 
   *     The type of the given object.
   *
   * @return The new {@link Event}.
   */
  public static  Event wrap(T obj, Object replyToKey) {
    return new Event(obj).setReplyTo(replyToKey);
  }

  /**
   * Get the globally-unique id of this event.
   *
   * @return Unique {@link UUID} of this event.
   */
  public synchronized UUID getId() {
    if (null == id) {
      id = UUIDUtils.create();
    }
    return id;
  }

  /**
   * Get the {@link Headers} attached to this event.
   *
   * @return The Event's Headers
   */
  public synchronized Headers getHeaders() {
    if (null == headers) {
      headers = new Headers();
    }
    return headers;
  }

  /**
   * Get the key to send replies to.
   *
   * @return The reply-to key
   */
  public Object getReplyTo() {
    return replyTo;
  }

  /**
   * Set the {@code key} that interested parties should send replies to.
   *
   * @param replyTo
   *     The key to use to notify sender of replies.
   *
   * @return {@literal this}
   */
  public Event setReplyTo(Object replyTo) {
    Assert.notNull(replyTo, "ReplyTo cannot be null.");
    this.replyTo = replyTo;
    return this;
  }

  /**
   * Get the key this event was notified on.
   *
   * @return The key used to notify consumers of this event.
   */
  public Object getKey() {
    return key;
  }

  /**
   * Set the key this event is being notified with.
   *
   * @param key
   *     The key used to notify consumers of this event.
   *
   * @return {@literal this}
   */
  public Event setKey(Object key) {
    this.key = key;
    return this;
  }

  /**
   * Get the internal data being wrapped.
   *
   * @return The data.
   */
  public T getData() {
    return data;
  }

  /**
   * Set the internal data to wrap.
   *
   * @param data
   *     Data to wrap.
   *
   * @return {@literal this}
   */
  public Event setData(T data) {
    this.data = data;
    return this;
  }

  /**
   * Get the internal error consumer callback being wrapped.
   *
   * @return the consumer.
   */
  public Consumer getErrorConsumer() {
    return errorConsumer;
  }

  /**
   * Create a copy of this event, reusing same headers, data and replyTo
   *
   * @return {@literal event copy}
   */
  public Event copy() {
    return copy(data);
  }

  /**
   * Create a copy of this event, reusing same headers and replyTo
   *
   * @return {@literal event copy}
   */
  public  Event copy(E data) {
    if (null != replyTo) {
      return new Event(headers, data, errorConsumer).setReplyTo(replyTo);
    } else {
      return new Event(headers, data, errorConsumer);
    }
  }

  /**
   * Consumes error, using a producer defined callback
   *
   * @param throwable
   *     The error to consume
   */
  public void consumeError(Throwable throwable) {
    if (null != errorConsumer) {
      errorConsumer.accept(throwable);
    }
  }

  @Override
  public void recycle() {
    this.id = null;
    if (null != this.headers) {
      this.headers.headers.clear();
    }
    this.replyTo = null;
    this.key = null;
    this.data = null;
  }

  public void override(Event ev) {
    this.id = ev.id;
    this.headers = ev.headers;
    this.replyTo = ev.replyTo;
    this.data = ev.data;
  }

  @Override
  public String toString() {
    return "Event{" +
        "id=" + id +
        ", headers=" + headers +
        ", replyTo=" + replyTo +
        ", key=" + key +
        ", data=" + data +
        '}';
  }

  /**
   * Headers are a Map-like structure of name-value pairs. Header names are case-insensitive, as determined by {@link
   * String#CASE_INSENSITIVE_ORDER}. A header can be removed by setting its value to {@code null}.
   */
  public static class Headers implements Serializable, Iterable> {

    /**
     * The name of the origin header
     *
     * @see #setOrigin(String)
     * @see #setOrigin(UUID)
     * @see #getOrigin()
     */
    public static final String ORIGIN = "x-reactor-origin";

    private static final long serialVersionUID = 4984692586458514948L;

    private final Object monitor = UUIDUtils.create();
    private final Map headers;

    private Headers(boolean sealed, Map headers) {
      Map copy = new TreeMap(String.CASE_INSENSITIVE_ORDER);
      copyHeaders(headers, copy);
      if (sealed) {
        this.headers = Collections.unmodifiableMap(copy);
      } else {
        this.headers = copy;
      }
    }

    /**
     * Creates a new Headers instance by copying the contents of the given {@code headers} Map. Note that, as the map is
     * copied, subsequent changes to its contents will have no effect upon the Headers.
     *
     * @param headers
     *     The map to copy.
     */
    public Headers(Map headers) {
      this(false, headers);
    }

    /**
     * Create an empty Headers
     */
    public Headers() {
      this(false, null);
    }

    /**
     * Sets all of the headers represented by entries in the given {@code headers} Map. Any entry with a null value will
     * cause the header matching the entry's name to be removed.
     *
     * @param headers
     *     The map of headers to set.
     *
     * @return {@code this}
     */
    public Headers setAll(Map headers) {
      if (null == headers || headers.isEmpty()) {
        return this;
      } else {
        synchronized (this.monitor) {
          copyHeaders(headers, this.headers);
        }
      }
      return this;
    }

    /**
     * Set the header value. If {@code value} is {@code null} the header with the given {@code name} will be removed.
     *
     * @param name
     *     The name of the header.
     * @param value
     *     The header's value.
     *
     * @return {@code this}
     */
    public  Headers set(String name, V value) {
      synchronized (this.monitor) {
        setHeader(name, value, headers);
      }
      return this;
    }

    /**
     * Set the origin header. The origin is simply a unique id to indicate to consumers where it should send replies. If
     * {@code id} is {@code null} the origin header will be removed.
     *
     * @param id
     *     The id of the origin component.
     *
     * @return {@code this}
     */
    public Headers setOrigin(UUID id) {
      String idString = id == null ? null : id.toString();
      return setOrigin(idString);
    }

    /**
     * Get the origin header
     *
     * @return The origin header, may be {@code null}.
     */
    public String getOrigin() {
      synchronized (this.monitor) {
        return (String) headers.get(ORIGIN);
      }
    }

    /**
     * Set the origin header. The origin is simply a unique id to indicate to consumers where it should send replies. If
     * {@code id} is {@code null} this origin header will be removed.
     *
     * @param id
     *     The id of the origin component.
     *
     * @return {@code this}
     */
    public Headers setOrigin(String id) {
      synchronized (this.monitor) {
        setHeader(ORIGIN, id, headers);
      }
      return this;
    }

    /**
     * Get the value for the given header.
     *
     * @param name
     *     The header name.
     *
     * @return The value of the header, or {@code null} if none exists.
     */
    @SuppressWarnings("unchecked")
    public  V get(String name) {
      synchronized (monitor) {
        return (V) headers.get(name);
      }
    }

    /**
     * Determine whether the headers contain a value for the given name.
     *
     * @param name
     *     The header name.
     *
     * @return {@code true} if a value exists, {@code false} otherwise.
     */
    public boolean contains(String name) {
      synchronized (monitor) {
        return headers.containsKey(name);
      }
    }

    /**
     * Get these headers as an unmodifiable {@link Map}.
     *
     * @return The unmodifiable header map
     */
    public Map asMap() {
      synchronized (monitor) {
        return Collections.unmodifiableMap(headers);
      }
    }

    /**
     * Get the headers as a read-only version
     *
     * @return A read-only version of the headers.
     */
    public Headers readOnly() {
      synchronized (monitor) {
        return new Headers(true, headers);
      }
    }

    /**
     * Returns an unmodifiable Iterator over a copy of this Headers' contents.
     */
    @Override
    public Iterator> iterator() {
      synchronized (this.monitor) {
        List> headers = new ArrayList>(this.headers.size());
        for (Map.Entry header : this.headers.entrySet()) {
          headers.add(Tuple.of(header.getKey(), header.getValue()));
        }
        return Collections.unmodifiableList(headers).iterator();
      }
    }

    @Override
    public String toString() {
      return headers.toString();
    }

    private void copyHeaders(Map source, Map target) {
      if (source != null) {
        for (Map.Entry entry : source.entrySet()) {
          setHeader(entry.getKey(), entry.getValue(), target);
        }
      }
    }

    private void setHeader(String name, Object value, Map target) {
      if (value == null) {
        target.remove(name);
      } else {
        target.put(name, value);
      }
    }
  }

}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy