001 /* 002 * HostInfoFinder.java 003 * 004 * Created on May 12, 2003, 2:23 PM 005 * 006 * This file is part of the STAR Scheduler. 007 * Copyright (c) 2002-2006 STAR Collaboration - Brookhaven National Laboratory 008 * 009 * STAR Scheduler is free software; you can redistribute it and/or modify 010 * it under the terms of the GNU General Public License as published by 011 * the Free Software Foundation; either version 2 of the License, or 012 * (at your option) any later version. 013 * 014 * STAR Scheduler is distributed in the hope that it will be useful, 015 * but WITHOUT ANY WARRANTY; without even the implied warranty of 016 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 017 * GNU General Public License for more details. 018 * 019 * You should have received a copy of the GNU General Public License 020 * along with STAR Scheduler; if not, write to the Free Software 021 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 022 */ 023 024 package gov.bnl.star.offline.scheduler.monitor; 025 026 import java.util.*; 027 028 /** 029 * 030 * @author Gabriele Carcassi 031 * @author Efstratios Efstathiadis 032 */ 033 public interface HostInfoFinder { 034 /** Returns the host information for the given hostname 035 * @param hostName the full hostname (i.e. rcas6023.rcf.bnl.gov) 036 * @return the information about the host or null if no information is available 037 */ 038 HostInfo getHostInfo(String hostName); 039 /** Returns the host information for all the hosts available. If no hosts 040 * information is available, it will return an empty collection. 041 * @return a collection of HostInfo objects 042 */ 043 Collection getHostInfo(); 044 /** Returns the host information for the hostnames provided. If no host information 045 * is found, an empty collection is returned. 046 * @param hostNames a collection of Strings with the full host name (i.e. rcas6023.rcf.bnl.gov) 047 * @return a collection of HostInfo objects. 048 */ 049 Collection getHostInfo(Collection hostNames); 050 }