org.codehaus.groovy.runtime.DefaultGroovyMethodsSupport Maven / Gradle / Ivy
The newest version!
/*
* Copyright 2003-2008 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.codehaus.groovy.runtime;
import groovy.lang.EmptyRange;
import groovy.lang.Range;
import org.codehaus.groovy.runtime.typehandling.DefaultTypeTransformation;
import java.io.Closeable;
import java.io.IOException;
import java.lang.reflect.Array;
import java.util.*;
import java.util.logging.Logger;
/**
* Support methods for DefaultGroovyMethods and PluginDefaultMethods.
*/
public class DefaultGroovyMethodsSupport {
private static final Logger LOG = Logger.getLogger(DefaultGroovyMethodsSupport.class.getName());
// helper method for getAt and putAt
protected static RangeInfo subListBorders(int size, Range range) {
int from = normaliseIndex(DefaultTypeTransformation.intUnbox(range.getFrom()), size);
int to = normaliseIndex(DefaultTypeTransformation.intUnbox(range.getTo()), size);
boolean reverse = range.isReverse();
if (from > to) {
// support list[1..-1]
int tmp = to;
to = from;
from = tmp;
reverse = !reverse;
}
return new RangeInfo(from, to + 1, reverse);
}
// helper method for getAt and putAt
protected static RangeInfo subListBorders(int size, EmptyRange range) {
int from = normaliseIndex(DefaultTypeTransformation.intUnbox(range.getFrom()), size);
return new RangeInfo(from, from, false);
}
/**
* This converts a possibly negative index to a real index into the array.
*
* @param i the unnormalised index
* @param size the array size
* @return the normalised index
*/
protected static int normaliseIndex(int i, int size) {
int temp = i;
if (i < 0) {
i += size;
}
if (i < 0) {
throw new ArrayIndexOutOfBoundsException("Negative array index [" + temp + "] too large for array size " + size);
}
return i;
}
/**
* Close the Closeable. Logging a warning if any problems occur.
*
* @param c the thing to close
*/
public static void closeWithWarning(Closeable c) {
if (c != null) {
try {
c.close();
} catch (IOException e) {
LOG.warning("Caught exception during close(): " + e);
}
}
}
/**
* Close the Closeable. Ignore any problems that might occur.
*
* @param c the thing to close
*/
public static void closeQuietly(Closeable c) {
if (c != null) {
try {
c.close();
} catch (IOException e) {
/* ignore */
}
}
}
protected static class RangeInfo {
public final int from;
public final int to;
public final boolean reverse;
public RangeInfo(int from, int to, boolean reverse) {
this.from = from;
this.to = to;
this.reverse = reverse;
}
}
@SuppressWarnings("unchecked")
protected static Collection cloneSimilarCollection(Collection orig, int newCapacity) {
Collection answer = (Collection) cloneObject(orig);
if (answer != null) return answer;
// fall back to creation
answer = createSimilarCollection(orig, newCapacity);
answer.addAll(orig);
return answer;
}
private static Object cloneObject(Object orig) {
if (orig instanceof Cloneable) {
try {
return InvokerHelper.invokeMethod(orig, "clone", new Object[0]);
} catch (Exception ex) {
// ignore
}
}
return null;
}
protected static Collection createSimilarOrDefaultCollection(Object object) {
if (object instanceof Collection) {
return createSimilarCollection((Collection) object);
}
return new ArrayList();
}
protected static Collection createSimilarCollection(Collection collection) {
return createSimilarCollection(collection, collection.size());
}
protected static Collection createSimilarCollection(Collection orig, int newCapacity) {
if (orig instanceof Set) {
return createSimilarSet((Set) orig);
}
if (orig instanceof List) {
return createSimilarList((List) orig, newCapacity);
}
if (orig instanceof Queue) {
return new LinkedList();
}
return new ArrayList(newCapacity);
}
protected static List createSimilarList(List orig, int newCapacity) {
if (orig instanceof LinkedList)
return new LinkedList();
if (orig instanceof Stack)
return new Stack();
if (orig instanceof Vector)
return new Vector();
return new ArrayList(newCapacity);
}
@SuppressWarnings("unchecked")
protected static T[] createSimilarArray(T[] orig, int newCapacity) {
Class componentType = (Class) orig.getClass().getComponentType();
return (T[]) Array.newInstance(componentType, newCapacity);
}
@SuppressWarnings("unchecked")
protected static Set createSimilarSet(Set orig) {
if (orig instanceof SortedSet) {
return new TreeSet(((SortedSet)orig).comparator());
}
return new LinkedHashSet();
}
@SuppressWarnings("unchecked")
protected static Map createSimilarMap(Map orig) {
if (orig instanceof SortedMap) {
return new TreeMap(((SortedMap)orig).comparator());
}
if (orig instanceof Properties) {
return (Map) new Properties();
}
if (orig instanceof Hashtable) {
return new Hashtable();
}
return new LinkedHashMap();
}
@SuppressWarnings("unchecked")
protected static Map cloneSimilarMap(Map orig) {
Map answer = (Map) cloneObject(orig);
if (answer != null) return answer;
// fall back to some defaults
if (orig instanceof TreeMap)
return new TreeMap(orig);
if (orig instanceof Properties) {
Map map = (Map) new Properties();
map.putAll(orig);
return map;
}
if (orig instanceof Hashtable)
return new Hashtable(orig);
return new LinkedHashMap(orig);
}
/**
* Determines if all items of this array are of the same type.
*
* @param cols an array of collections
* @return true if the collections are all of the same type
*/
@SuppressWarnings("unchecked")
protected static boolean sameType(Collection[] cols) {
List all = new LinkedList();
for (Collection col : cols) {
all.addAll(col);
}
if (all.size() == 0)
return true;
Object first = all.get(0);
//trying to determine the base class of the collections
//special case for Numbers
Class baseClass;
if (first instanceof Number) {
baseClass = Number.class;
} else if (first == null) {
baseClass = NullObject.class;
} else {
baseClass = first.getClass();
}
for (Collection col : cols) {
for (Object o : col) {
if (!baseClass.isInstance(o)) {
return false;
}
}
}
return true;
}
}