/*
 * @(#)Connector.java
 *
 * Project:		JHotdraw - a GUI framework for technical drawings
 *				http://www.jhotdraw.org
 *				http://jhotdraw.sourceforge.net
 * Copyright:	© by the original author(s) and all contributors
 * License:		Lesser GNU Public License (LGPL)
 *				http://www.opensource.org/licenses/lgpl-license.html
 */

package org.jhotdraw.framework;

import java.awt.*;
import java.io.Serializable;

import org.jhotdraw.util.*;

/**
 * Connectors know how to locate a connection point on a figure.
 * A Connector knows its owning figure and can determine either
 * the start or the endpoint of a given connection figure. A connector
 * has a display box that describes the area of a figure it is
 * responsible for. A connector can be visible but it doesn't have
 * to be.<br>
 * <hr>
 * <b>Design Patterns</b><P>
 * <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
 * <b><a href=../pattlets/sld004.htm>Strategy</a></b><br>
 * Connector implements the strategy to determine the connections points.<br>
 * <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
 * <b><a href=../pattlets/sld016.htm>Factory Method</a></b><br>
 * Connectors are created by the Figure's factory method connectorAt.
 * <hr>
 *
 * @see Figure#connectorAt
 * @see ConnectionFigure
 *
 * @version <$CURRENT_VERSION$>
 */
public interface Connector extends Serializable, Storable {

	/**
	 * Finds the start point for the connection.
	 */
	public abstract Point findStart(ConnectionFigure connection);

	/**
	 * Finds the end point for the connection.
	 */
	public abstract Point findEnd(ConnectionFigure connection);

	/**
	 * Gets the connector's owner.
	 */
	public abstract Figure owner();

	/**
	 * Gets the display box of the connector.
	 */
	public abstract Rectangle displayBox();

	/**
	 * Tests if a point is contained in the connector.
	 */
	public abstract boolean containsPoint(int x, int y);

	/**
	 * Draws this connector. Connectors don't have to be visible
	 * and it is OK leave this method empty.
	 */
	public abstract void draw(Graphics g);

	/**
	 * Requests that the connector should show itself or hide itself.  The
	 * ConnectionFigure which desires to connect to this Connector is passed in.
	 * If a connector should show itself it should do so when draw is called, if
	 * so desired.
	 */
	public void connectorVisibility(boolean isVisible, ConnectionFigure courtingConnection);
    //cfm1 *******************************************************************
    /**
     * Supports connector dragging.
     * 
     */
     public abstract Point connectorMovedTo(int x, int y);
     
  
    /**
     * Returns a 'finalized' connector. Can be used to change Connector.
     * 
     * @param start - true if a startConnector
     * @return - final Connector
     */    
    public Connector finalizeConnector(boolean start);
//  cfm1 *******************************************************************

}