fr.faylixe.googlecodejam.client.Round Maven / Gradle / Ivy

Go to download
package fr.faylixe.googlecodejam.client;

import fr.faylixe.googlecodejam.client.common.NamedObject;
import fr.faylixe.googlecodejam.client.executor.HttpRequestExecutor;
import fr.faylixe.googlecodejam.client.executor.Request;
import fr.faylixe.googlecodejam.client.webservice.InitialValues;

import java.io.IOException;
import java.security.GeneralSecurityException;

/**
 * POJO class that represents a Google Jam {@link Round}.
 * A {@link Round} is defined by a name, and a dashboard
 * URL.
 * 
 * @author fv
 */
public final class Round extends NamedObject {

	/** Serialization index. **/
	private static final long serialVersionUID = 1L;

	/** URL path of a contest. **/
	protected static final String CODEJAM_PATH = "/codejam/contest/";

	/** Prefix for built round URL. **/
	protected static final String ROUND_PREFIX = "/dashboard";

	/** Label used for parent contest when parent could not be retrieved. **/
	private static final String UNKNOWN_PARENT = "unkwown-contest";

	/** Class name of the HTML description node. **/
	public static final String DESCRIPTION_CLASS_NAME = "desc";

	/** Name of the parent contest. **/
	private final String parent;

	/** URL of this round dashboard. **/
	private final String url;

	/**
	 * Default constructor.
	 * 
	 * @param parent Name of the parent contest of this round.
	 * @param name Name of this round.
	 * @param url URL of this round dashboard.
	 */
	protected Round(final String parent, final String name, final String url) {
		super(name);
		this.parent = parent;
		this.url = url;
	}

	/**
	 * Getter for the parent contest name.
	 * 
	 * @return Name of the parent contest.
	 */
	public String getContestName() {
		return parent;
	}

	/**
	 * Getter for round dashboard URL.
	 * 
	 * @return URL of this round dashboard.
	 */
	public String getURL() {
		return url;
	}
	
	/** {@inheritDoc} **/
	@Override
	public int hashCode() {
		return url.hashCode();
	}
	
	/** {@inheritDoc} **/
	@Override
	public boolean equals(final Object object) {
		if (object == this) {
			return true;
		}
		if (object == null || object.getClass() != getClass()) {
			return false;
		}
		final Round other = (Round) object;
		return url.equals(other.getURL());
	}

	/**
	 * Static factory method that creates a round from the
	 * given identifier.
	 * 
	 * @param identifier Round id to use.
	 * @param cookie Cookie value to use for retrieving contest.
	 * @return Created round.
	 * @throws IOException If any error occurs while retrieving round information.
	 * @throws GeneralSecurityException If any error occurs while creating {@link HttpRequestExecutor} instance.
	 */
	public static Round fromIdentifier(final String identifier, final String cookie) throws GeneralSecurityException, IOException {
		final StringBuilder builder = new StringBuilder();
		builder
			.append(CODEJAM_PATH)
			.append(identifier)
			.append(ROUND_PREFIX);
		return fromURL(builder.toString(), cookie);
	}

	/**
	 * Static factory method that creates a round from the
	 * given url.
	 * 
	 * @param url Round url.
	 * @param cookie Cookie value to use for retrieving contest.
	 * @return Created round.
	 * @throws IOException If any error occurs while retrieving round information.
	 * @throws GeneralSecurityException If any error occurs while creating {@link HttpRequestExecutor} instance.
	 */
	public static Round fromURL(final String url, final String cookie) throws GeneralSecurityException, IOException {
		final HttpRequestExecutor executor = HttpRequestExecutor.create(Request.getHostname(), cookie);
		final InitialValues values = InitialValues.get(executor, new Round("", "", url));
		return new Round(UNKNOWN_PARENT, values.getName(), url);
	}

}