atom.widget.ArrayAdapter Maven / Gradle / Ivy
/*
* Copyright © 2014 Geeoz, and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* The Research Projects is dual-licensed under the GNU General Public
* License, version 2.0 (GPLv2) and the Geeoz Commercial License.
*
* Solely for non-commercial purposes. A purpose is non-commercial only if
* it is in no manner primarily intended for or directed toward commercial
* advantage or private monetary compensation.
*
* This Geeoz Software is supplied to you by Geeoz in consideration of your
* agreement to the following terms, and your use, installation, modification
* or redistribution of this Geeoz Software constitutes acceptance of these
* terms. If you do not agree with these terms, please do not use, install,
* modify or redistribute this Geeoz Software.
*
* Neither the name, trademarks, service marks or logos of Geeoz may be used
* to endorse or promote products derived from the Geeoz Software without
* specific prior written permission from Geeoz.
*
* The Geeoz Software is provided by Geeoz on an "AS IS" basis. GEEOZ MAKES NO
* WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED
* WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE, REGARDING THE GEEOZ SOFTWARE OR ITS USE AND OPERATION ALONE OR IN
* COMBINATION WITH YOUR PRODUCTS.
*
* IN NO EVENT SHALL GEEOZ BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL
* OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, MODIFICATION
* AND/OR DISTRIBUTION OF THE GEEOZ SOFTWARE, HOWEVER CAUSED AND WHETHER UNDER
* THEORY OF CONTRACT, TORT (INCLUDING NEGLIGENCE), STRICT LIABILITY OR
* OTHERWISE, EVEN IF GEEOZ HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* A copy of the GNU General Public License is included in the distribution in
* the file LICENSE and at
*
* http://www.gnu.org/licenses/gpl-2.0.html
*
* If you are using the Research Projects for commercial purposes, we
* encourage you to visit
*
* http://products.geeoz.com/license
*
* for more details.
*
* This software or hardware and documentation may provide access to
* or information on content, products, and services from third parties.
* Geeoz and its affiliates are not responsible for and expressly disclaim
* all warranties of any kind with respect to third-party content, products,
* and services. Geeoz and its affiliates will not be responsible for any loss,
* costs, or damages incurred due to your access to or use of third-party
* content, products, or services. If a third-party content exists, the
* additional copyright notices and license terms applicable to portions of the
* software are set forth in the THIRD_PARTY_LICENSE_README file.
*
* Please contact Geeoz or visit www.geeoz.com if you need additional
* information or have any questions.
*/
package atom.widget;
import atom.content.XmlResourceBundles;
import atom.view.OnClickListener;
import atom.view.View;
import atom.view.ViewGroup;
import java.util.Arrays;
import java.util.List;
import java.util.ResourceBundle;
/**
* A corresponded adapter that is backed by an array of arbitrary objects. By
* default this class expects that the provided resource id references a single
* TextView. If you want to use a more complex layout, use the constructors that
* also takes a field id. That field id should reference a TextView in the
* larger layout resource.
*
* However the TextView is referenced, it will be filled with the toString()
* of each object in the array. You can add lists or arrays of custom objects.
* Override the toString() method of your objects to determine what text will be
* displayed for the item in the list.
*
* To use something other than TextViews for the array display, for instance,
* ImageViews, or to have some of data besides toString() results fill the
* views, override {@link #getView(int, View, ViewGroup)} to return the type of
* view you want.
*
* @param an corresponded object type
* @author Alex Voloshyn
* @author Serge Voloshyn
* @version 1.4 4/20/14
*/
public class ArrayAdapter
implements SpinnerAdapter, ListAdapter, OnClickListener {
/**
* Contains the list of objects that represent the data of this
* ArrayAdapter. The content of this list is referred to as "the array" in
* the documentation.
*/
private final T[] origin;
/**
* Contains the list of objects that represent filtered the data.
*/
private List objects;
/**
* View group that used as header.
*/
private ViewGroup headerView;
/**
* View group that used as body.
*/
private ViewGroup bodyView;
/**
* Item click listener.
*/
private OnItemClickListener listener;
/**
* Default array adapter constructor with array initialization.
*
* @param array an initial array for the adapter
*/
@SafeVarargs
public ArrayAdapter(final T... array) {
super();
origin = array;
objects = Arrays.asList(origin);
}
/**
* Retrieve array with original objects.
*
* @return an array with original objects
*/
protected final T[] getOrigin() {
return origin;
}
/**
* Sets a list with objects that used by adapter.
*
* @param list list with objects
*/
protected final void setObjects(final List list) {
objects = list;
}
@Override
public final View getDropDownView(final int position,
final View convertView,
final ViewGroup parent) {
final View view = getView(position, convertView, parent);
view.setElement(View.Element.option);
return view;
}
@Override
public final int getCount() {
if (objects == null) {
return 0;
}
return objects.size();
}
@Override
public final T getItem(final int position) {
return objects.get(position);
}
@Override
public final View getView(final int position,
final View convertView,
final ViewGroup parent) {
final TextView text = new TextView();
text.setViewId(String.valueOf(position));
text.setText(String.valueOf(objects.get(position)));
if (listener != null) {
text.setOnClickListener(this);
}
return text;
}
@Override
public void filter() {
//Override this method for array filtering
}
@Override
public final ViewGroup getHeaderView() {
return headerView;
}
/**
* Sets header view for adapter.
*
* @param group view group for header
*/
public final void setHeaderView(final ViewGroup group) {
headerView = group;
}
@Override
public final ViewGroup getBodyView() {
if (bodyView == null) {
bodyView = new LinearLayout();
} else {
bodyView.getChildren().clear();
}
for (int i = 0; i < getCount(); i++) {
bodyView.addView(getView(i, null, bodyView));
}
return bodyView;
}
@Override
public final ViewGroup getFooterView() {
return null;
}
/**
* Not supported by this implementation.
*
* Alternative implementation supporting paging is
* {@link ArrayPagingAdapter}.
*
* @param count max count of the items on the same page
*/
@Override
public final void setRowPerPage(final int count) {
//not supported by this implementation
}
@Override
public void setOnItemClickListener(final OnItemClickListener aListener) {
listener = aListener;
}
@Override
public void onClick(final View view) {
if (listener != null) {
final int index = Integer.parseInt(view.getViewId());
listener.onClick(index, getItem(index));
}
}
/**
* Creates a new ArrayAdapter from external resources.
*
* @param entries reference to an array resource that will populated
* @return an ArrayAdapter.
*/
public static ArrayAdapter createFromResource(
final String entries) {
final ResourceBundle bundle = XmlResourceBundles.STRINGS.getBundle();
final String[] strings = bundle.getStringArray(entries);
return new ArrayAdapter<>(strings);
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy