001 /* 002 * Copyright 2006 Stephen J. McConnell. 003 * 004 * Licensed under the Apache License, Version 2.0 (the "License"); 005 * you may not use this file except in compliance with the License. 006 * You may obtain a copy of the License at 007 * 008 * http://www.apache.org/licenses/LICENSE-2.0 009 * 010 * Unless required by applicable law or agreed to in writing, software 011 * distributed under the License is distributed on an "AS IS" BASIS, 012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 013 * implied. 014 * 015 * See the License for the specific language governing permissions and 016 * limitations under the License. 017 */ 018 019 package net.dpml.runtime; 020 021 import java.util.concurrent.TimeUnit; 022 023 /** 024 * Component interface. 025 * 026 * @author <a href="http://www.dpml.net">Digital Product Management Laboratory</a> 027 * @version 2.0.0 028 */ 029 public interface Component 030 { 031 /** 032 * Return the component name. 033 * @return the name 034 */ 035 String getName(); 036 037 /** 038 * Add a listener to the component. 039 * @param listener the component listener 040 */ 041 void addComponentListener( ComponentListener listener ); 042 043 /** 044 * Remove a listener from the component. 045 * @param listener the component listener 046 */ 047 void removeComponentListener( ComponentListener listener ); 048 049 /** 050 * Return a decommissioning provider. 051 * @return the provider 052 */ 053 Provider getProvider(); 054 055 /** 056 * Release a provider. 057 * @param provider the provider to release 058 */ 059 void release( Provider provider ); 060 061 /** 062 * Terminate the component. 063 */ 064 void terminate(); 065 } 066