001// Copyright 2004, 2005 The Apache Software Foundation 002// 003// Licensed under the Apache License, Version 2.0 (the "License"); 004// you may not use this file except in compliance with the License. 005// You may obtain a copy of the License at 006// 007// http://www.apache.org/licenses/LICENSE-2.0 008// 009// Unless required by applicable law or agreed to in writing, software 010// distributed under the License is distributed on an "AS IS" BASIS, 011// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 012// See the License for the specific language governing permissions and 013// limitations under the License. 014 015package org.apache.hivemind.lib; 016 017/** 018 * Service interface for performing name lookups. This is typically 019 * implemented as a wrapper around JNDI. This service is available 020 * as <code>hivemind.lib.NameLookup</code>. 021 * 022 * @author Howard Lewis Ship 023 */ 024 025public interface NameLookup 026{ 027 /** 028 * Performs the lookup, returning the object that was found. 029 * 030 * @param name the name to lookup 031 * @param expected the expected class of the object; the object found must be assignable 032 * to this class (which may be a class or interface) 033 * @throws org.apache.tapestry.ApplicationRuntimeException if an error occurs during 034 * the lookup, or if the found object can not be assigned to the expected class. 035 */ 036 public Object lookup(String name, Class expected); 037}