//----------------------------BEGIN LICENSE----------------------------
/* 
 * Willow : the Open Source WorkFlow Project
 * Distributable under GNU LGPL license by gun.org
 *
 * Copyright (C) 2004-2010  huihoo.org 
 * Copyright (C) 2004-2010  ZosaTapo <dertyang@hotmail.com> 
 * 
 * ====================================================================
 * Project Homepage : http://www.huihoo.org/willow
 * Source Forge     : http://sourceforge.net/projects/huihoo
 * Mailing list     : willow@lists.sourceforge.net 
 */
//----------------------------END  LICENSE-----------------------------
package org.huihoo.willow;


public interface Connector
{
	// ------------------------------------------------------------- Properties

	/**
	 * Return the <code>Service</code> with which we are associated (if any).
	 */
	public Service getService();


	/**
	 * Set the <code>Service</code> with which we are associated (if any).
	 *
	 * @param service The service that owns this Engine
	 */
	public void setService(Service service);
	
	/**
	 * Set Pathname to the Connector configuration file(if any).
	 */
	public void setConfigFile(String file);

	/**
	 * Return Pathname to the Connector configuration file(if any).
	 */
	public String getConfigFile();

	
	/**
	 * Return descriptive information about this Provider implementation.
	 */
	public String getInfo();

	// --------------------------------------------------------- Public Methods
	/**
	 * Invoke a pre-startup initialization. This is used to allow Connector
	 * to bind to restricted ports under Unix operating environments.
	 *
	 * @exception LifecycleException If this server was already initialized.
	 */
	public void initialize() throws LifecycleException;
}
