View Javadoc

1   /***
2    *     Ambient - A music player for the Android platform
3    Copyright (C) 2007 Martin Vysny
4    
5    This program is free software: you can redistribute it and/or modify
6    it under the terms of the GNU General Public License as published by
7    the Free Software Foundation, either version 3 of the License, or
8    (at your option) any later version.
9    
10   This program is distributed in the hope that it will be useful,
11   but WITHOUT ANY WARRANTY; without even the implied warranty of
12   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13   GNU General Public License for more details.
14  
15   You should have received a copy of the GNU General Public License
16   along with this program.  If not, see <http://www.gnu.org/licenses/>.
17   */
18  
19  package sk.baka.ambient.commons;
20  
21  import java.lang.ref.Reference;
22  
23  /***
24   * Refers to an object. Contrary to {@link Reference} the object will never be
25   * spuriously set to <code>null</code>.
26   * 
27   * @param <T>
28   *            the type of the object being referred to.
29   * @author Martin Vysny
30   */
31  public interface Ref<T> {
32  	/***
33  	 * Returns referred object.
34  	 * 
35  	 * @return referred object.
36  	 */
37  	T get();
38  }