/*
 * Copyright (c) 2013 Cisco Systems, Inc. and others.  All rights reserved.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License v1.0 which accompanies this distribution,
 * and is available at http://www.eclipse.org/legal/epl-v10.html
 */

package org.opendaylight.controller.hosttracker.hostAware;

import java.net.InetAddress;
import org.opendaylight.controller.hosttracker.hostAware.HostNodeConnector;


/**
 * This Interface  defines the methods to trigger the discovery of
 * a Host and to probe if a learned Host is still in the network.
 *
 *
 *
 */
public interface IHostFinder {
    /**
     * This method initiates the discovery of a host based on its IP address. This is triggered
     * by query of an application to the HostTracker. The requested IP address
     * doesn't exist in the local database at this point.
     *
     * @param networkAddress	IP Address encapsulated in InetAddress class
     *
     */
    public void find(InetAddress networkAddress);

    /**
     * This method is called by HostTracker to see if a learned Host is still in the network.
     * Used mostly for ARP Aging.
     *
     * @param host			The Host that needs to be probed
     */
    public void probe(HostNodeConnector host);
}