eu.stratosphere.nephele.event.job.AbstractEvent Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of stratosphere-runtime Show documentation
The newest version!
/***********************************************************************************************************************
 * Copyright (C) 2010-2013 by the Stratosphere project (http://stratosphere.eu)
 *
 * 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 eu.stratosphere.nephele.event.job;

import java.io.DataInput;
import java.io.DataOutput;
import java.io.IOException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.concurrent.atomic.AtomicLong;

import eu.stratosphere.core.io.IOReadableWritable;

/**
 * An abstract event is transmitted from the job manager to the
 * job client in order to inform the user about the job progress.
 * 
 */
public abstract class AbstractEvent implements IOReadableWritable {

	/**
	 * Static variable that points to the current global sequence number
	 */
	private static final AtomicLong GLOBAL_SEQUENCE_NUMBER = new AtomicLong(0);

	/**
	 * Auxiliary object which helps to convert a {@link Date} object to the given string representation.
	 */
	private static final SimpleDateFormat DATA_FORMATTER = new SimpleDateFormat("MM/dd/yyyy HH:mm:ss");

	/**
	 * The timestamp of the event.
	 */
	private long timestamp = -1;

	/**
	 * The sequence number of the event.
	 */
	private long sequenceNumber = -1;

	/**
	 * Constructs a new abstract event object.
	 * 
	 * @param timestamp
	 *        the timestamp of the event.
	 */
	public AbstractEvent(final long timestamp) {
		this.timestamp = timestamp;
		this.sequenceNumber = GLOBAL_SEQUENCE_NUMBER.incrementAndGet();
	}

	public long getSequenceNumber() {
		return this.sequenceNumber;
	}

	/**
	 * Constructs a new abstract event object. This constructor
	 * is required for the deserialization process and is not
	 * supposed to be called directly.
	 */
	public AbstractEvent() {
	}


	@Override
	public void read(final DataInput in) throws IOException {

		// Read the timestamp
		this.timestamp = in.readLong();
		this.sequenceNumber = in.readLong();
	}


	@Override
	public void write(final DataOutput out) throws IOException {

		// Write the timestamp
		out.writeLong(this.timestamp);
		out.writeLong(this.sequenceNumber);
	}

	/**
	 * Returns the timestamp of the event.
	 * 
	 * @return the timestamp of the event
	 */
	public long getTimestamp() {
		return this.timestamp;
	}

	/**
	 * Converts the timestamp of an event from its "milliseconds since beginning the epoch"
	 * representation into a unified string representation.
	 * 
	 * @param timestamp
	 *        the timestamp in milliseconds since the beginning of "the epoch"
	 * @return the string unified representation of the timestamp
	 */
	public static String timestampToString(final long timestamp) {

		return DATA_FORMATTER.format(new Date(timestamp));

	}


	@Override
	public boolean equals(final Object obj) {

		if (obj instanceof AbstractEvent) {

			final AbstractEvent abstractEvent = (AbstractEvent) obj;
			if (this.timestamp == abstractEvent.getTimestamp()) {
				return true;
			}
		}

		return false;
	}


	@Override
	public int hashCode() {

		return (int) (this.timestamp % Integer.MAX_VALUE);
	}
}