package de.internetzky.grails.clamav;

import java.io.InputStream;

/**
 * Interface for virus validation. 
 * @author Marc Guillemot
 */
public interface AntiVirusService 
{
	/**
	 * Indicates if the services is alive.
	 * @return <code>false</code> for instance if the external resources on which this services relies aren't available
	 */
    boolean isAlive();
    
    /**
     * Scans a stream for known viruses.
     * @param _stream the stream to scan (will be closed by this method)
     * @return the name of the virus found if any. Emtpy string otherwise
     */
    String scan(final InputStream _stream);
}