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 /** 022 * Component interface. 023 * 024 * @author <a href="http://www.dpml.net">Digital Product Management Library</a> 025 * @version 2.1.1 026 */ 027 public interface Component 028 { 029 /** 030 * Return the component name. 031 * @return the name 032 */ 033 String getName(); 034 035 /** 036 * Add a listener to the component. 037 * @param listener the component listener 038 */ 039 void addComponentListener( ComponentListener listener ); 040 041 /** 042 * Remove a listener from the component. 043 * @param listener the component listener 044 */ 045 void removeComponentListener( ComponentListener listener ); 046 047 /** 048 * Return a decommissioning provider. 049 * @return the provider 050 */ 051 Provider getProvider(); 052 053 /** 054 * Release a provider. 055 * @param provider the provider to release 056 */ 057 void release( Provider provider ); 058 059 /** 060 * Terminate the component. 061 */ 062 void terminate(); 063 } 064