Provides a system 'resource' access protocol handler.
* This is class allows you to use the njar: URL protocol. It is very * similar to it's jar: cusin. The difference being that jars can be * nested. * *
* An example of how to use this class is: *
*
* URL url = new URL("njar:njar:file:c:/test1.zip^/test2.zip^/hello.txt");
* url.openStream();
*
*
*
* * Please be aware that the njar protocol caches it's jar in temporary * storage when connections are opened into them. So for the above * example, 2 files would cached a temp files names similar to nested-xxxx.jar * * @todo Add accessors so that the cache can be flushed. * * @version $Revision: 2787 $ * @author Hiram Chirino */ @SuppressWarnings("unchecked") public class Handler extends URLStreamHandler { // URL protocol designations public static final String PROTOCOL = "njar"; public static final String NJAR_SEPARATOR = "^/"; public static final String JAR_SEPARATOR = "!/"; private static final Logger log = Logger.getLogger(Handler.class); protected Map savedJars = new HashMap(); public URLConnection openConnection(final URL url) throws IOException { String file = url.getFile(); String embeddedURL = file; String jarPath = ""; boolean trace = log.isTraceEnabled(); int pos = file.lastIndexOf(NJAR_SEPARATOR); if (pos >= 0) { embeddedURL = file.substring(0, pos); if (file.length() > pos + NJAR_SEPARATOR.length()) jarPath = file.substring(pos + NJAR_SEPARATOR.length()); } if (embeddedURL.startsWith(PROTOCOL)) { if (trace) log.trace("Opening next nested jar: " + embeddedURL); File tempJar = (File) savedJars.get(embeddedURL); if (tempJar == null) { URLConnection embededDataConnection = new URL(embeddedURL).openConnection(); if (trace) log.trace("Content length: " + embededDataConnection.getContentLength()); InputStream embededData = embededDataConnection.getInputStream(); tempJar = File.createTempFile("nested-", ".jar"); tempJar.deleteOnExit(); if (trace) log.trace("temp file location : " + tempJar); OutputStream output = new FileOutputStream(tempJar); try { // copyb will buffer the streams for us long bytes = Streams.copyb(embededData, output); if (trace) log.trace("copied " + bytes + " bytes"); } finally { Streams.flush(output); // close an pass errors to throwable handler (we don't care about them) Streams.close(embededData); Streams.close(output); } savedJars.put(embeddedURL, tempJar); } String t = tempJar.getCanonicalFile().toURL().toExternalForm(); if (trace) log.trace("file URL : " + t); t = "njar:" + t + NJAR_SEPARATOR + jarPath; if (trace) log.trace("Opening saved jar: " + t); URL u = new URL(t); if (trace) log.trace("Using URL: " + u); return u.openConnection(); } else { if (trace) log.trace("Opening final nested jar: " + embeddedURL); URL u = new URL("jar:" + embeddedURL + JAR_SEPARATOR + jarPath); if (trace) log.trace("Using URL: " + u); return u.openConnection(); } } public static URL njarToFile(URL url) { if (url.getProtocol().equals(PROTOCOL)) { try { // force the resource we are after to be unpacked - thanks // Jan & David...! URL dummy=new URL(PROTOCOL+":"+url.toString()+NJAR_SEPARATOR+"dummy.jar"); String tmp=dummy.openConnection().getURL().toString(); tmp=tmp.substring("jar:".length()); tmp=tmp.substring(0, tmp.length()-(JAR_SEPARATOR+"dummy.jar").length()); return new URL(tmp); } catch (Exception ignore) { ThrowableHandler.addWarning(ignore); } } return url; } } ././@LongLink 0000000 0000000 0000000 00000000151 00000000000 011562 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/net/protocol/njar/package.html libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/net/protocol/njar/package.0000644 0001750 0001750 00000001543 10470642610 033153 0 ustar twerner twerner
Provides a nested jar ('njar') protocol handler.
URL protocol stream helpers.
This factory is installed by the default server implementaion * to ensure that protocol handlers not in the system classpath are * located. The thread context class is used first followed by the * Class.forName method. *
* * @version $Revision: 2859 $ * @author Jason Dillon * @author Scott.Stark@jboss.org */ @SuppressWarnings("unchecked") public class URLStreamHandlerFactory implements java.net.URLStreamHandlerFactory { /** Class logger. */ private static final Logger log = Logger.getLogger(URLStreamHandlerFactory.class); /** The package prefix where JBoss protocol handlers live. */ public static final String PACKAGE_PREFIX = "org.jboss.net.protocol"; /** A map of protocol names to handlers. Since there can only be one URLStreamHandlerFactory installed, this is a static map that may be cleared. */ private static Map handlerMap = Collections.synchronizedMap(new HashMap()); /** This thread local is used to prevent recursion in the * createURLStreamHandler method. Resolving the protocol handler * class can end up creating a new URL which can loop back into * this factory with a stack like: *
URLStreamHandlerFactory that use the TCL. See bug#669043
createURLStreamHandler():146, URLStreamHandlerFactory.java
getURLStreamHandler():1057, URL.java
():405, URL.java
():329, URL.java
():321, URL.java
():540, URLClassPath.java
run():319, URLClassPath.java
doPrivileged():-1, AccessController.java
getLoader():308, URLClassPath.java
getLoader():285, URLClassPath.java
findResource():136, URLClassPath.java
run():351, URLClassLoader.java
doPrivileged():-1, AccessController.java
findResource():348, URLClassLoader.java
getResource():780, ClassLoader.java
getResourceLocally():250, UnifiedClassLoader.java
getResourceFromClassLoader():333, UnifiedLoaderRepository3.java
getResource():243, UnifiedLoaderRepository3.java
getResource():228, UnifiedClassLoader3.java
So we detect recursion based on the protocol value matches the current
createURLStreamHandlerProtocol setting.
*/
private static ThreadLocal createURLStreamHandlerProtocol = new ThreadLocal();
/** The current packages prefixes determined from the java.protocol.handler.pkgs
property + the org.jboss.net.protocol default package.
*/
private String[] handlerPkgs = {PACKAGE_PREFIX};
/** The last java.protocol.handler.pkgs value. Used to determine if the
java.protocol.handler.pkgs property has changed since handlerPkgs was
last built.
*/
private String lastHandlerPkgs = PACKAGE_PREFIX;
/** A list of JBoss specific protocols for preloading. */
public static final String PROTOCOLS[] = {
"file",
"resource"
};
/**
* Preload the JBoss specific protocol handlers, so that URL knows about
* them even if the handler factory is changed.
*/
@SuppressWarnings("unused")
public static void preload()
{
for (int i = 0; i < PROTOCOLS.length; i ++)
{
try
{
URL url = new URL(PROTOCOLS[i], "", -1, "");
log.trace("Loaded protocol: " + PROTOCOLS[i]);
}
catch (Exception e)
{
log.warn("Failed to load protocol: " + PROTOCOLS[i], e);
}
}
}
/** Clear the current protocol to handler map. The map will be rebuilt
as protocol handlers are requested.
*/
public static void clear()
{
handlerMap.clear();
}
/** Search the handlerPkgs for URLStreamHandler classes matching the
* pkg + protocol + ".Handler" naming convention.
*
* @param protocol The protocol to create a stream handler for
* @return The protocol handler or null if not found
*/
public URLStreamHandler createURLStreamHandler(final String protocol)
{
// Check the handler map
URLStreamHandler handler = (URLStreamHandler) handlerMap.get(protocol);
if( handler != null )
return handler;
// Validate that createURLStreamHandler is not recursing
String prevProtocol = (String) createURLStreamHandlerProtocol.get();
if( prevProtocol != null && prevProtocol.equals(protocol) )
return null;
createURLStreamHandlerProtocol.set(protocol);
// See if the handler pkgs definition has changed
checkHandlerPkgs();
// Search the handlerPkgs for a matching protocol handler
ClassLoader ctxLoader = Thread.currentThread().getContextClassLoader();
for(int p = 0; p < handlerPkgs.length; p ++)
{
try
{
// Form the standard protocol handler class name
String classname = handlerPkgs[p] + "." + protocol + ".Handler";
Class type = null;
try
{
type = ctxLoader.loadClass(classname);
}
catch(ClassNotFoundException e)
{
// Try our class loader
type = Class.forName(classname);
}
if( type != null )
{
handler = (URLStreamHandler) type.newInstance();
handlerMap.put(protocol, handler);
log.trace("Found protocol:"+protocol+" handler:"+handler);
}
}
catch (Throwable ignore)
{
}
}
createURLStreamHandlerProtocol.set(null);
return handler;
}
/** See if the java.protocol.handler.pkgs system property has changed
and if it has, parse it to update the handlerPkgs array.
*/
private synchronized void checkHandlerPkgs()
{
String handlerPkgsProp = System.getProperty("java.protocol.handler.pkgs");
if( handlerPkgsProp != null && handlerPkgsProp.equals(lastHandlerPkgs) == false )
{
// Update the handlerPkgs[] from the handlerPkgsProp
StringTokenizer tokeninzer = new StringTokenizer(handlerPkgsProp, "|");
ArrayListExceptions that are thrown and not explicitly declared are ignored.
*
* @version $Revision: 1958 $
* @author Jason Dillon
*/
public final class Streams
{
private static final Logger log = Logger.getLogger(Streams.class);
/////////////////////////////////////////////////////////////////////////
// Closing //
/////////////////////////////////////////////////////////////////////////
/**
* Attempt to close an InputStream.
*
* @param stream InputStream to attempt to close.
* @return True if stream was closed (or stream was null),
* or false if an exception was thrown.
*/
public static boolean close(final InputStream stream) {
// do not attempt to close null stream, but return sucess
if (stream == null) {
return true;
}
boolean success = true;
try {
stream.close();
}
catch (IOException e) {
success = false;
}
return success;
}
/**
* Attempt to close an OutputStream.
*
* @param stream OutputStream to attempt to close.
* @return True if stream was closed (or stream was null),
* or false if an exception was thrown.
*/
public static boolean close(final OutputStream stream) {
// do not attempt to close null stream, but return sucess
if (stream == null) {
return true;
}
boolean success = true;
try {
stream.close();
}
catch (IOException e) {
success = false;
}
return success;
}
/**
* Attempt to close an InputStream or OutputStream.
*
* @param stream Stream to attempt to close.
* @return True if stream was closed (or stream was null),
* or false if an exception was thrown.
*
* @throws IllegalArgumentException Stream is not an InputStream
* or OuputStream.
*/
public static boolean close(final Object stream) {
boolean success = false;
if (stream instanceof InputStream) {
success = close((InputStream)stream);
}
else if (stream instanceof OutputStream) {
success = close((OutputStream)stream);
}
else {
throw new IllegalArgumentException
("stream is not an InputStream or OutputStream");
}
return success;
}
/**
* Attempt to close an array of InputStreams.
*
* @param streams Array of InputStreams to attempt to close.
* @return True if all streams were closed, or false
* if an exception was thrown.
*/
public static boolean close(final InputStream[] streams) {
boolean success = true;
for (int i=0; i Stream related classes.
* A similar class is present in java.util package of jdk version >= 1.3;
* for compatibility with jdk 1.2 we reimplemented it.
*
* @see TimerQueue
*
* @author Simone Bordet
* @version $Revision: 2787 $
*/
@SuppressWarnings("unchecked")
public abstract class TimerTask
implements Executable, Comparable
{
/** The state before the first execution */
static final int NEW = 1;
/** The state after first execution if the TimerTask is repeating */
static final int SCHEDULED = 2;
/** The state after first execution if the TimerTask is not repeating */
static final int EXECUTED = 3;
/** The state when cancelled */
static final int CANCELLED = 4;
// Attributes ----------------------------------------------------
private final Object m_lock = new Object();
private int m_state;
// this is a constant, and need not be locked
private final long m_period;
private long m_nextExecutionTime;
/**
* Creates a TimerTask object that will be executed once.
*/
protected TimerTask()
{
m_state = NEW;
m_period = 0;
}
/**
* Creates a TimerTask object that will be executed every
* @param period the execution period; if zero, will be executed only once.
*/
protected TimerTask(long period)
{
m_state = NEW;
if (period < 0) throw new IllegalArgumentException("Period can't be negative");
m_period = period;
}
/**
* Cancels the next execution of this TimerTask (if any). {@link Null#VALUE} is used to given an object variable a dual-mode
* nullified value, where null would indicate that the value is
* empty, and {@link Null#VALUE} would idicate that the value has been
* set to null (or something to that effect).
*
* @version $Revision: 2800 $
* @author Jason Dillon
*/
public final class Null
implements Serializable
{
/** The serialVersionUID */
private static final long serialVersionUID = -403173436435490144L;
/** The primary instance of Null. */
public static final Null VALUE = new Null();
/** Do not allow public construction. */
private Null() {}
/**
* Return a string representation.
*
* @return Null
*/
public String toString() {
return null;
}
/**
* Returns zero.
*
* @return Zero.
*/
public int hashCode() {
return 0;
}
/**
* Check if the given object is a Null instance or null.
*
* @param obj Object to test.
* @return True if the given object is a Null instance or null.
*/
public boolean equals(final Object obj) {
if (obj == this) return true;
return (obj == null || obj.getClass() == getClass());
}
}
././@LongLink 0000000 0000000 0000000 00000000147 00000000000 011567 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/JBossStringBuilder.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/JBossStringBuilder.ja0000644 0001750 0001750 00000034253 10470642610 033211 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
import java.io.Serializable;
import java.util.Arrays;
/**
* A JBossStringBuilder, providing the same functionality as the
* java5 StringBuilder, except no Appendable which is java5 specific.
*
* @author Adrian Brock
* @version $Revision: 1958 $
*/
public class JBossStringBuilder implements Serializable, CharSequence
{
/** Serialization */
private static final long serialVersionUID = 1874946609763446794L;
/** The characters */
protected char[] chars;
/** The position */
protected int pos;
/**
* Create a new StringBuilder with no characters and an intial
* size of 16
*/
public JBossStringBuilder()
{
this(16);
}
/**
* Create a new StringBuilder with no characters
*
* @param capacity the initial capacity
*/
public JBossStringBuilder(int capacity)
{
chars = new char[capacity];
}
/**
* Create a new StringBuilder from the given string.
* The initial capacity is the length of the string plus 16
*
* @param string the string
*/
public JBossStringBuilder(String string)
{
this(string.length() + 16);
append(string);
}
/**
* Create a new StringBuilder from the given character sequence.
* The initial capacity is the length of the sequence plus 16
*
* @param charSequence the character sequence
*/
public JBossStringBuilder(CharSequence charSequence)
{
this(charSequence.length() + 16);
append(charSequence);
}
/**
* Create a new StringBuilder from the given character array
*
* @param ch the array
*/
public JBossStringBuilder(char[] ch)
{
this(ch, 0, ch.length);
}
/**
* Create a new StringBuilder from the given character array
*
* @param ch the array
* @param start the start of the array from which to take characters
* @param length the lengh of the array from which to take characters
*/
public JBossStringBuilder(char[] ch, int start, int length)
{
this(length + 16);
append(ch, start, length);
}
public JBossStringBuilder append(Object object)
{
return append(String.valueOf(object));
}
public JBossStringBuilder append(String string)
{
if (string == null)
string = "null";
int length = string.length();
if (length == 0)
return this;
int afterAppend = pos + length;
if (afterAppend > chars.length)
expandCapacity(afterAppend);
string.getChars(0, length, chars, pos);
pos = afterAppend;
return this;
}
public JBossStringBuilder append(StringBuffer buffer)
{
if (buffer == null)
return append("null");
int length = buffer.length();
if (length == 0)
return this;
int afterAppend = pos + length;
if (afterAppend > chars.length)
expandCapacity(afterAppend);
buffer.getChars(0, length, chars, pos);
pos = afterAppend;
return this;
}
public JBossStringBuilder append(CharSequence charSequence)
{
if (charSequence == null)
return append("null");
int length = charSequence.length();
if (length == 0)
return this;
return append(charSequence, 0, charSequence.length());
}
public JBossStringBuilder append(CharSequence charSequence, int start, int end)
{
if (charSequence == null)
return append("null");
if (start < 0 || end < 0 || start > end || start > charSequence.length())
throw new IndexOutOfBoundsException("Invalid start=" + start + " end=" + end + " length=" + charSequence.length());
int length = end - start;
if (length == 0)
return this;
int afterAppend = pos + length;
if (afterAppend > chars.length)
expandCapacity(afterAppend);
for (int i = start; i < end; ++i)
chars[pos++] = charSequence.charAt(i);
pos = afterAppend;
return this;
}
public JBossStringBuilder append(char[] array)
{
if (array == null)
return append("null");
if (array.length == 0)
return this;
String string = String.valueOf(array);
return append(string);
}
public JBossStringBuilder append(char[] array, int offset, int length)
{
if (array == null)
return append("null");
int arrayLength = array.length;
if (offset < 0 || length < 0 || offset + length > arrayLength)
throw new IndexOutOfBoundsException("Invalid offset=" + offset + " length=" + length + " array.length=" + arrayLength);
if (length == 0 || arrayLength == 0)
return this;
String string = String.valueOf(array, offset, length);
return append(string);
}
public JBossStringBuilder append(boolean primitive)
{
String string = String.valueOf(primitive);
return append(string);
}
public JBossStringBuilder append(char primitive)
{
String string = String.valueOf(primitive);
return append(string);
}
public JBossStringBuilder append(int primitive)
{
String string = String.valueOf(primitive);
return append(string);
}
public JBossStringBuilder append(long primitive)
{
String string = String.valueOf(primitive);
return append(string);
}
public JBossStringBuilder append(float primitive)
{
String string = String.valueOf(primitive);
return append(string);
}
public JBossStringBuilder append(double primitive)
{
String string = String.valueOf(primitive);
return append(string);
}
public JBossStringBuilder delete(int start, int end)
{
if (start < 0 || start > pos || start > end || end > pos)
throw new IndexOutOfBoundsException("Invalid start=" + start + " end=" + end + " length=" + pos);
if (start == end)
return this;
int removed = end - start;
System.arraycopy(chars, start + removed, chars, start, pos - end);
pos -= removed;
return this;
}
public JBossStringBuilder deleteCharAt(int index)
{
return delete(index, 1);
}
public JBossStringBuilder replace(int start, int end, String string)
{
delete(start, end);
return insert(start, string);
}
public JBossStringBuilder insert(int index, char[] string)
{
return insert(index, string, 0, string.length);
}
public JBossStringBuilder insert(int index, char[] string, int offset, int len)
{
int stringLength = string.length;
if (index < 0 || index > pos || offset < 0 || len < 0 || (offset + len) > string.length)
throw new IndexOutOfBoundsException("Invalid index=" + index + " offset=" + offset + " len=" + len + " string.length=" + stringLength + " length=" + pos);
if (len == 0)
return this;
int afterAppend = pos + len;
if (afterAppend > chars.length)
expandCapacity(afterAppend);
System.arraycopy(chars, index, chars, index + stringLength, pos - index);
System.arraycopy(string, offset, chars, index, len);
pos = afterAppend;
return this;
}
public JBossStringBuilder insert(int offset, Object object)
{
if (object == null)
return insert(offset, "null");
else
return insert(offset, String.valueOf(object));
}
public JBossStringBuilder insert(int offset, String string)
{
if (offset < 0 || offset > pos)
throw new IndexOutOfBoundsException("Invalid offset=" + offset + " length=" + pos);
if (string == null)
string = "null";
int stringLength = string.length();
int afterAppend = pos + stringLength;
if (afterAppend > chars.length)
expandCapacity(afterAppend);
System.arraycopy(chars, offset, chars, offset + stringLength, pos - offset);
string.getChars(0, stringLength, chars, offset);
pos = afterAppend;
return this;
}
public JBossStringBuilder insert(int offset, CharSequence charSequence)
{
if (charSequence == null)
return insert(offset, "null");
else
return insert(offset, charSequence, 0, charSequence.length());
}
public JBossStringBuilder insert(int offset, CharSequence charSequence, int start, int end)
{
if (charSequence == null)
charSequence = "null";
int sequenceLength = charSequence.length();
if (offset < 0 || offset > pos || start < 0 || end < 0 || start > sequenceLength || end > sequenceLength || start > end)
throw new IndexOutOfBoundsException("Invalid offset=" + offset + " start=" + start + " end=" + end + " sequence.length()=" + sequenceLength + " length=" + pos);
int len = end - start;
if (len == 0)
return this;
int afterAppend = pos + len;
if (afterAppend > chars.length)
expandCapacity(afterAppend);
System.arraycopy(chars, offset, chars, offset + sequenceLength, pos - offset);
for (int i = start; i < end; ++i)
chars[offset++] = charSequence.charAt(i);
pos = afterAppend;
return this;
}
public JBossStringBuilder insert(int offset, boolean primitive)
{
return insert(offset, String.valueOf(primitive));
}
public JBossStringBuilder insert(int offset, char primitive)
{
return insert(offset, String.valueOf(primitive));
}
public JBossStringBuilder insert(int offset, int primitive)
{
return insert(offset, String.valueOf(primitive));
}
public JBossStringBuilder insert(int offset, long primitive)
{
return insert(offset, String.valueOf(primitive));
}
public JBossStringBuilder insert(int offset, float primitive)
{
return insert(offset, String.valueOf(primitive));
}
public JBossStringBuilder insert(int offset, double primitive)
{
return insert(offset, String.valueOf(primitive));
}
public int indexOf(String string)
{
return indexOf(string, 0);
}
public int indexOf(String string, int fromIndex)
{
// FIXME
return toString().indexOf(string, fromIndex);
}
public int indexOf(char ch)
{
return indexOf(ch, 0);
}
public int indexOf(char ch, int fromIndex)
{
// FIXME
return toString().indexOf(ch, fromIndex);
}
public int lastIndexOf(String string)
{
return lastIndexOf(string, pos);
}
public int lastIndexOf(String string, int fromIndex)
{
// FIXME
return toString().lastIndexOf(string, fromIndex);
}
public int lastIndexOf(char ch)
{
return lastIndexOf(ch, pos);
}
public int lastIndexOf(char ch, int fromIndex)
{
// FIXME
return toString().lastIndexOf(ch, fromIndex);
}
public JBossStringBuilder reverse()
{
char[] tmp = new char[pos];
for(int n = 0; n < pos; n ++)
tmp[n] = chars[pos-n-1];
chars = tmp;
return this;
}
public String toString()
{
return new String(chars, 0, pos);
}
public int length()
{
return pos;
}
public int capacity()
{
return chars.length;
}
public void ensureCapacity(int minimum)
{
if (minimum < 0 || minimum < chars.length)
return;
expandCapacity(minimum);
}
public void trimToSize()
{
char[] trimmed = new char[pos];
System.arraycopy(chars, 0, trimmed, 0, pos);
chars = trimmed;
}
public void setLength(int newLength)
{
if (newLength < 0)
throw new StringIndexOutOfBoundsException(newLength);
if (newLength > chars.length)
expandCapacity(newLength);
Arrays.fill(chars, newLength, chars.length, '\0');
pos = newLength;
}
public char charAt(int index)
{
return chars[index];
}
public void getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)
{
if (srcBegin < 0 || dstBegin < 0 || srcBegin > srcEnd || srcEnd > pos || (dstBegin + srcEnd - srcBegin) > dst.length)
throw new IndexOutOfBoundsException("Invalid srcBegin=" + srcBegin + " srcEnd=" + srcEnd + " dstBegin=" + dstBegin + " dst.length=" + dst.length + " length=" + pos);
int len = srcEnd - srcBegin;
if (len == 0)
return;
System.arraycopy(chars, srcBegin, dst, dstBegin, len);
}
public void setCharAt(int index, char ch)
{
if (index < 0 || index > pos)
throw new IndexOutOfBoundsException("Invalid index=" + index + " length=" + pos);
chars[index] = ch;
}
public String substring(int start)
{
return substring(start, pos);
}
public CharSequence subSequence(int start, int end)
{
return substring(start, end);
}
public String substring(int start, int end)
{
if (start < 0 || end < 0 || start > end || end > pos)
throw new IndexOutOfBoundsException("Invalid start=" + start + " end=" + end + " length=" + pos);
return new String(chars, start, end - start);
}
/**
* Expand the capacity to the greater of the minimum
* or twice the current size
*
* @param minimum the minimum
*/
protected void expandCapacity(int minimum)
{
int newSize = chars.length * 2;
if (minimum > newSize)
newSize = minimum;
char[] newChars = new char[newSize];
System.arraycopy(chars, 0, newChars, 0, pos);
chars = newChars;
}
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/WeakObject.java 0000644 0001750 0001750 00000007320 10774222622 032037 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
import java.lang.ref.WeakReference;
import java.lang.ref.ReferenceQueue;
/**
* Convenience class to wrap an Object into a WeakReference.
*
* Modified from java.util.WeakHashMap.WeakKey.
*
* @version $Revision: 2787 $
* @author Jason Dillon
*/
@SuppressWarnings("unchecked")
public final class WeakObject
extends WeakReference
{
/** The hash code of the nested object */
protected final int hashCode;
/**
* Construct a WeakObject.
*
* @param obj Object to reference.
*/
public WeakObject(final Object obj) {
super(obj);
hashCode = obj.hashCode();
}
/**
* Construct a WeakObject.
*
* @param obj Object to reference.
* @param queue Reference queue.
*/
public WeakObject(final Object obj, final ReferenceQueue queue) {
super(obj, queue);
hashCode = obj.hashCode();
}
/**
* Check the equality of an object with this.
*
* @param obj Object to test equality with.
* @return True if object is equal.
*/
public boolean equals(final Object obj) {
if (obj == this) return true;
if (obj != null && obj.getClass() == getClass()) {
WeakObject soft = (WeakObject)obj;
Object a = this.get();
Object b = soft.get();
if (a == null || b == null) return false;
if (a == b) return true;
return a.equals(b);
}
return false;
}
/**
* Return the hash code of the nested object.
*
* @return The hash code of the nested object.
*/
public int hashCode() {
return hashCode;
}
/////////////////////////////////////////////////////////////////////////
// Factory Methods //
/////////////////////////////////////////////////////////////////////////
/**
* Create a WeakObject for the given object.
*
* @param obj Object to reference.
* @return WeakObject or null if object is null.
*/
public static WeakObject create(final Object obj) {
if (obj == null) return null;
else return new WeakObject(obj);
}
/**
* Create a WeakObject for the given object.
*
* @param obj Object to reference.
* @param queue Reference queue.
* @return WeakObject or null if object is null.
*/
public static WeakObject create(final Object obj,
final ReferenceQueue queue)
{
if (obj == null) return null;
else return new WeakObject(obj, queue);
}
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/naming/ 0000755 0001750 0001750 00000000000 11105642363 030422 5 ustar twerner twerner libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/naming/Util.java 0000644 0001750 0001750 00000026573 10774222622 032222 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.naming;
import javax.naming.Context;
import javax.naming.InitialContext;
import javax.naming.LinkRef;
import javax.naming.Name;
import javax.naming.NameNotFoundException;
import javax.naming.NamingException;
import org.jboss.logging.Logger;
/** A static utility class for common JNDI operations.
*
* @author Scott.Stark@jboss.org
* @author adrian@jboss.com
* @version $Revision: 2787 $
*/
@SuppressWarnings("unchecked")
public class Util
{
private static final Logger log = Logger.getLogger(Util.class);
/** Create a subcontext including any intermediate contexts.
@param ctx the parent JNDI Context under which value will be bound
@param name the name relative to ctx of the subcontext.
@return The new or existing JNDI subcontext
@throws javax.naming.NamingException on any JNDI failure
*/
public static Context createSubcontext(Context ctx, String name) throws NamingException
{
Name n = ctx.getNameParser("").parse(name);
return createSubcontext(ctx, n);
}
/** Create a subcontext including any intermediate contexts.
@param ctx the parent JNDI Context under which value will be bound
@param name the name relative to ctx of the subcontext.
@return The new or existing JNDI subcontext
@throws NamingException on any JNDI failure
*/
public static Context createSubcontext(Context ctx, Name name) throws NamingException
{
Context subctx = ctx;
for (int pos = 0; pos < name.size(); pos++)
{
String ctxName = name.get(pos);
try
{
subctx = (Context) ctx.lookup(ctxName);
}
catch (NameNotFoundException e)
{
subctx = ctx.createSubcontext(ctxName);
}
// The current subctx will be the ctx for the next name component
ctx = subctx;
}
return subctx;
}
/** Bind val to name in ctx, and make sure that all intermediate contexts exist
@param ctx the parent JNDI Context under which value will be bound
@param name the name relative to ctx where value will be bound
@param value the value to bind.
@throws NamingException for any error
*/
public static void bind(Context ctx, String name, Object value) throws NamingException
{
Name n = ctx.getNameParser("").parse(name);
bind(ctx, n, value);
}
/** Bind val to name in ctx, and make sure that all intermediate contexts exist
@param ctx the parent JNDI Context under which value will be bound
@param name the name relative to ctx where value will be bound
@param value the value to bind.
@throws NamingException for any error
*/
public static void bind(Context ctx, Name name, Object value) throws NamingException
{
int size = name.size();
String atom = name.get(size - 1);
Context parentCtx = createSubcontext(ctx, name.getPrefix(size - 1));
parentCtx.bind(atom, value);
}
/** Rebind val to name in ctx, and make sure that all intermediate contexts exist
@param ctx the parent JNDI Context under which value will be bound
@param name the name relative to ctx where value will be bound
@param value the value to bind.
@throws NamingException for any error
*/
public static void rebind(Context ctx, String name, Object value) throws NamingException
{
Name n = ctx.getNameParser("").parse(name);
rebind(ctx, n, value);
}
/** Rebind val to name in ctx, and make sure that all intermediate contexts exist
@param ctx the parent JNDI Context under which value will be bound
@param name the name relative to ctx where value will be bound
@param value the value to bind.
@throws NamingException for any error
*/
public static void rebind(Context ctx, Name name, Object value) throws NamingException
{
int size = name.size();
String atom = name.get(size - 1);
Context parentCtx = createSubcontext(ctx, name.getPrefix(size - 1));
parentCtx.rebind(atom, value);
}
/** Unbinds a name from ctx, and removes parents if they are empty
@param ctx the parent JNDI Context under which the name will be unbound
@param name The name to unbind
@throws NamingException for any error
*/
public static void unbind(Context ctx, String name) throws NamingException
{
unbind(ctx, ctx.getNameParser("").parse(name));
}
/** Unbinds a name from ctx, and removes parents if they are empty
@param ctx the parent JNDI Context under which the name will be unbound
@param name The name to unbind
@throws NamingException for any error
*/
public static void unbind(Context ctx, Name name) throws NamingException
{
ctx.unbind(name); //unbind the end node in the name
int sz = name.size();
// walk the tree backwards, stopping at the domain
while (--sz > 0)
{
Name pname = name.getPrefix(sz);
try
{
ctx.destroySubcontext(pname);
}
catch (NamingException e)
{
log.trace("Unable to remove context " + pname, e);
break;
}
}
}
/**
* Lookup an object in the default initial context
*
* @param name the name to lookup
* @param clazz the expected type
* @return the object
* @throws Exception for any error
*/
public static Object lookup(String name, Class clazz) throws Exception
{
InitialContext ctx = new InitialContext();
try
{
return lookup(ctx, name, clazz);
}
finally
{
ctx.close();
}
}
/**
* Lookup an object in the default initial context
*
* @param name the name to lookup
* @param clazz the expected type
* @return the object
* @throws Exception for any error
*/
public static Object lookup(Name name, Class clazz) throws Exception
{
InitialContext ctx = new InitialContext();
try
{
return lookup(ctx, name, clazz);
}
finally
{
ctx.close();
}
}
/**
* Lookup an object in the given context
*
* @param context the context
* @param name the name to lookup
* @param clazz the expected type
* @return the object
* @throws Exception for any error
*/
public static Object lookup(Context context, String name, Class clazz) throws Exception
{
Object result = context.lookup(name);
checkObject(context, name, result, clazz);
return result;
}
/**
* Lookup an object in the given context
*
* @param context the context
* @param name the name to lookup
* @param clazz the expected type
* @return the object
* @throws Exception for any error
*/
public static Object lookup(Context context, Name name, Class clazz) throws Exception
{
Object result = context.lookup(name);
checkObject(context, name.toString(), result, clazz);
return result;
}
/**
* Create a link
*
* @param fromName the from name
* @param toName the to name
* @throws NamingException for any error
*/
public static void createLinkRef(String fromName, String toName) throws NamingException
{
InitialContext ctx = new InitialContext();
createLinkRef(ctx, fromName, toName);
}
/**
* Create a link
*
* @param ctx the context
* @param fromName the from name
* @param toName the to name
* @throws NamingException for any error
*/
public static void createLinkRef(Context ctx, String fromName, String toName) throws NamingException
{
LinkRef link = new LinkRef(toName);
Context fromCtx = ctx;
Name name = ctx.getNameParser("").parse(fromName);
String atom = name.get(name.size()-1);
for(int n = 0; n < name.size()-1; n ++)
{
String comp = name.get(n);
try
{
fromCtx = (Context) fromCtx.lookup(comp);
}
catch(NameNotFoundException e)
{
fromCtx = fromCtx.createSubcontext(comp);
}
}
log.debug("atom: " + atom);
log.debug("link: " + link);
fromCtx.rebind(atom, link);
log.debug("Bound link " + fromName + " to " + toName);
}
/**
* Remove the link ref
*
* @param name the name of the link binding
* @throws NamingException for any error
*/
public static void removeLinkRef(String name) throws NamingException
{
InitialContext ctx = new InitialContext();
removeLinkRef(ctx, name);
}
/**
* Remove the link ref
*
* @param ctx the context
* @param name the name of the link binding
* @throws NamingException for any error
*/
public static void removeLinkRef(Context ctx, String name) throws NamingException
{
log.debug("Unbinding link " + name);
ctx.unbind(name);
}
/**
* Checks an object implements the given class
*
* @param context the context
* @param name the name to lookup
* @param object the object
* @param clazz the expected type
* @throws Exception for any error
*/
protected static void checkObject(Context context, String name, Object object, Class clazz) throws Exception
{
Class objectClass = object.getClass();
if (clazz.isAssignableFrom(objectClass) == false)
{
StringBuffer buffer = new StringBuffer(100);
buffer.append("Object at '").append(name);
buffer.append("' in context ").append(context.getEnvironment());
buffer.append(" is not an instance of ");
appendClassInfo(buffer, clazz);
buffer.append(" object class is ");
appendClassInfo(buffer, object.getClass());
throw new ClassCastException(buffer.toString());
}
}
/**
* Append Class Info
*
* @param buffer the buffer to append to
* @param clazz the class to describe
*/
protected static void appendClassInfo(StringBuffer buffer, Class clazz)
{
buffer.append("[class=").append(clazz.getName());
buffer.append(" classloader=").append(clazz.getClassLoader());
buffer.append(" interfaces={");
Class[] interfaces = clazz.getInterfaces();
for (int i=0; i
* Implementation classes can implement a LRU policy, a random one,
* a MRU one, or any other suitable policy.
*
* @author Simone Bordet
* @version $Revision: 2787 $
*/
public interface CachePolicy
{
/**
* Returns the object paired with the specified key if it's
* present in the cache, otherwise must return null.
* This value is set from the system property
* org.jboss.util.NestedThrowable.parentTraceEnabled
* or if that is not set defaults to true.
*/
boolean PARENT_TRACE_ENABLED = Util.getBoolean("parentTraceEnabled", true);
/**
* A system wide flag to enable or disable printing of the
* nested detail throwable traces.
*
*
* This value is set from the system property
* org.jboss.util.NestedThrowable.nestedTraceEnabled
* or if that is not set defaults to true unless
* using JDK 1.4 with {@link #PARENT_TRACE_ENABLED} set to false,
* then false since there is a native mechansim for this there.
*
*
* Note then when running under 1.4 is is not possible to disable
* the nested trace output, since that is handled by java.lang.Throwable
* which we delegate the parent printing to.
*/
boolean NESTED_TRACE_ENABLED = Util.getBoolean("nestedTraceEnabled",
(Java.isCompatible(Java.VERSION_1_4) &&
!PARENT_TRACE_ENABLED) ||
!Java.isCompatible(Java.VERSION_1_4));
/**
* A system wide flag to enable or disable checking of parent and child
* types to detect uneeded nesting
*
*
* This value is set from the system property
* org.jboss.util.NestedThrowable.detectDuplicateNesting
* or if that is not set defaults to true.
*/
boolean DETECT_DUPLICATE_NESTING = Util.getBoolean("detectDuplicateNesting", true);
/**
* Return the nested throwable.
*
* @return Nested throwable.
*/
Throwable getNested();
/**
* Return the nested Throwable.
*
* For JDK 1.4 compatibility.
*
* @return Nested Throwable.
*/
Throwable getCause();
/////////////////////////////////////////////////////////////////////////
// Nested Throwable Utilities //
/////////////////////////////////////////////////////////////////////////
/**
* Utilitiy methods for the various flavors of
*
* This is a HACK to keep those methods from NPE until this problem
* can be resolved.
*/
private static Logger getLogger()
{
if (log == null)
log = Logger.getLogger(NestedThrowable.class);
return log;
}
protected static boolean getBoolean(String name, boolean defaultValue)
{
name = NestedThrowable.class.getName() + "." + name;
String value = System.getProperty(name, String.valueOf(defaultValue));
// HACK see getLogger() for details
log = getLogger();
log.debug(name + "=" + value);
return new Boolean(value).booleanValue();
}
public static void checkNested(final NestedThrowable parent,
final Throwable child)
{
if (!DETECT_DUPLICATE_NESTING || parent == null || child == null) return;
Class parentType = parent.getClass();
Class childType = child.getClass();
//
// This might be backwards... I always get this confused
//
if (parentType.isAssignableFrom(childType)) {
// HACK see getLogger() for details
log = getLogger();
log.warn("Duplicate throwable nesting of same base type: " +
parentType + " is assignable from: " + childType);
}
}
/**
* Returns a formated message for the given detail message
* and nested This function will create a Jar archive containing the src
* file/directory. The archive will be written to the specified
* OutputStream. This is a shortcut for This function will create a Jar archive containing the src
* file/directory. The archive will be written to the specified
* OutputStream. This is a shortcut for This function will create a Jar archive containing the src
* file/directory. The archive will be written to the specified
* OutputStream. Directories are processed recursively, applying the
* specified filter if it exists.
*
* This is a shortcut for This function will create a Jar archive containing the src
* file/directory. The archive will be written to the specified
* OutputStream. Directories are processed recursively, applying the
* specified filter if it exists.
*
* @param out The output stream to which the generated Jar archive is
* written.
* @param src The file or directory to jar up. Directories will be
* processed recursively.
* @param filter The filter to use while processing directories. Only
* those files matching will be included in the jar archive. If
* null, then all files are included.
* @param prefix The name of an arbitrary directory that will precede all
* entries in the jar archive. If null, then no prefix will be
* used.
* @param man The manifest to use for the Jar archive. If null, then no
* manifest will be included.
* @throws IOException
*/
public static void jar(OutputStream out, File[] src, FileFilter filter,
String prefix, Manifest man) throws IOException
{
for (int i = 0; i < src.length; i++)
{
if (!src[i].exists())
{
throw new FileNotFoundException(src.toString());
}
}
JarOutputStream jout;
if (man == null)
{
jout = new JarOutputStream(out);
}
else
{
jout = new JarOutputStream(out, man);
}
if (prefix != null && prefix.length() > 0 && !prefix.equals("/"))
{
// strip leading '/'
if (prefix.charAt(0) == '/')
{
prefix = prefix.substring(1);
}
// ensure trailing '/'
if (prefix.charAt(prefix.length() - 1) != '/')
{
prefix = prefix + "/";
}
}
else
{
prefix = "";
}
JarInfo info = new JarInfo(jout, filter);
for (int i = 0; i < src.length; i++)
{
jar(src[i], prefix, info);
}
jout.close();
}
/**
* This simple convenience class is used by the jar method to reduce the
* number of arguments needed. It holds all non-changing attributes
* needed for the recursive jar method.
*/
private static class JarInfo
{
public JarOutputStream out;
public FileFilter filter;
public byte[] buffer;
public JarInfo(JarOutputStream out, FileFilter filter)
{
this.out = out;
this.filter = filter;
buffer = new byte[1024];
}
}
/**
* This recursive method writes all matching files and directories to
* the jar output stream.
*/
private static void jar(File src, String prefix, JarInfo info)
throws IOException
{
JarOutputStream jout = info.out;
if (src.isDirectory())
{
// create / init the zip entry
prefix = prefix + src.getName() + "/";
ZipEntry entry = new ZipEntry(prefix);
entry.setTime(src.lastModified());
entry.setMethod(JarOutputStream.STORED);
entry.setSize(0L);
entry.setCrc(0L);
jout.putNextEntry(entry);
jout.closeEntry();
// process the sub-directories
File[] files = src.listFiles(info.filter);
for (int i = 0; i < files.length; i++)
{
jar(files[i], prefix, info);
}
}
else if (src.isFile())
{
// get the required info objects
byte[] buffer = info.buffer;
// create / init the zip entry
ZipEntry entry = new ZipEntry(prefix + src.getName());
entry.setTime(src.lastModified());
jout.putNextEntry(entry);
// dump the file
FileInputStream in = new FileInputStream(src);
int len;
while ((len = in.read(buffer, 0, buffer.length)) != -1)
{
jout.write(buffer, 0, len);
}
in.close();
jout.closeEntry();
}
}
public static void unjar(InputStream in, File dest) throws IOException
{
if (!dest.exists())
{
dest.mkdirs();
}
if (!dest.isDirectory())
{
throw new IOException("Destination must be a directory.");
}
JarInputStream jin = new JarInputStream(in);
byte[] buffer = new byte[1024];
ZipEntry entry = jin.getNextEntry();
while (entry != null)
{
String fileName = entry.getName();
if (fileName.charAt(fileName.length() - 1) == '/')
{
fileName = fileName.substring(0, fileName.length() - 1);
}
if (fileName.charAt(0) == '/')
{
fileName = fileName.substring(1);
}
if (File.separatorChar != '/')
{
fileName = fileName.replace('/', File.separatorChar);
}
File file = new File(dest, fileName);
if (entry.isDirectory())
{
// make sure the directory exists
file.mkdirs();
jin.closeEntry();
}
else
{
// make sure the directory exists
File parent = file.getParentFile();
if (parent != null && !parent.exists())
{
parent.mkdirs();
}
// dump the file
OutputStream out = new FileOutputStream(file);
int len = 0;
while ((len = jin.read(buffer, 0, buffer.length)) != -1)
{
out.write(buffer, 0, len);
}
out.flush();
out.close();
jin.closeEntry();
file.setLastModified(entry.getTime());
}
entry = jin.getNextEntry();
}
/* Explicity write out the META-INF/MANIFEST.MF so that any headers such
as the Class-Path are see for the unpackaged jar
*/
Manifest mf = jin.getManifest();
if (mf != null)
{
File file = new File(dest, "META-INF/MANIFEST.MF");
File parent = file.getParentFile();
if( parent.exists() == false )
{
parent.mkdirs();
}
OutputStream out = new FileOutputStream(file);
mf.write(out);
out.flush();
out.close();
}
jin.close();
}
/** Given a URL check if its a jar url(jar: File related classes. For JDK 1.4 compatibility.
*
* @return Nested Throwable.
*/
public Throwable getCause() {
return nested;
}
/**
* Returns the composite throwable message.
*
* @return The composite throwable message.
*/
public String getMessage() {
return NestedThrowable.Util.getMessage(super.getMessage(), nested);
}
/**
* Prints the composite message and the embedded stack trace to the
* specified print stream.
*
* @param stream Stream to print to.
*/
public void printStackTrace(final PrintStream stream) {
if (nested == null || NestedThrowable.PARENT_TRACE_ENABLED) {
super.printStackTrace(stream);
}
NestedThrowable.Util.print(nested, stream);
}
/**
* Prints the composite message and the embedded stack trace to the
* specified print writer.
*
* @param writer Writer to print to.
*/
public void printStackTrace(final PrintWriter writer) {
if (nested == null || NestedThrowable.PARENT_TRACE_ENABLED) {
super.printStackTrace(writer);
}
NestedThrowable.Util.print(nested, writer);
}
/**
* Prints the composite message and the embedded stack trace to
* System.err.
*/
public void printStackTrace() {
printStackTrace(System.err);
}
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/builder/ 0000755 0001750 0001750 00000000000 11105642363 030577 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000154 00000000000 011565 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/builder/AbstractBuilder.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/builder/AbstractBuild0000644 0001750 0001750 00000004676 10664777142 033277 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source.
* Copyright 2007, Red Hat Middleware LLC, and individual contributors
* as indicated by the @author tags. See the copyright.txt file in the
* distribution for a full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.builder;
import java.security.PrivilegedAction;
/**
* AbstractBuilder.
*
* @param Revisions: 2002/02/13: billb
*
*
* When a security manager is installed, the
* constructor checks for the runtime permissions
* "getClassLoader"
*
* @version $Revision: 2787 $
* @author Adrian Brock
*/
@SuppressWarnings("unchecked")
public class ContextClassLoader
{
/**
* Retrieve a classloader permission
*/
public static final RuntimePermission GETCLASSLOADER = new RuntimePermission("getClassLoader");
/**
* Instantiate a new context class loader
*/
public static final NewInstance INSTANTIATOR = new NewInstance();
/**
* Constructor.
*
* @throws SecurityException when not authroized to get the context classloader
*/
/*package*/ ContextClassLoader()
{
SecurityManager manager = System.getSecurityManager();
if (manager != null)
{
manager.checkPermission(GETCLASSLOADER);
}
}
/**
* Retrieve the context classloader
*
* @return the context classloader
*/
public ClassLoader getContextClassLoader()
{
return getContextClassLoader(Thread.currentThread());
}
/**
* Retrieve the context classloader for the given thread
*
* @param thread the thread
* @return the context classloader
*/
public ClassLoader getContextClassLoader(final Thread thread)
{
return (ClassLoader) AccessController.doPrivileged(new PrivilegedAction()
{
public Object run()
{
return thread.getContextClassLoader();
}
});
}
private static class NewInstance
implements PrivilegedAction
{
public Object run()
{
return new ContextClassLoader();
}
}
}
././@LongLink 0000000 0000000 0000000 00000000175 00000000000 011570 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/loading/ConstructorTCCLClassLoaderSource.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/loading/ConstructorTC0000644 0001750 0001750 00000003752 10774222622 033277 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source.
* Copyright 2008, Red Hat Middleware LLC, and individual contributors
* as indicated by the @author tags. See the copyright.txt file in the
* distribution for a full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.loading;
import java.lang.ref.WeakReference;
import java.security.AccessController;
/**
* {@link ClassLoaderSource} implementation that returns the
* {@link Thread#getContextClassLoader() thread context classloader (TCCL)}
* in effect when this class' constructor is invoked.
*
* @author Brian Stansberry
*/
@SuppressWarnings("unchecked")
public class ConstructorTCCLClassLoaderSource implements ClassLoaderSource
{
private final WeakReference classLoaderRef;
public ConstructorTCCLClassLoaderSource()
{
ContextClassLoader ccl = (ContextClassLoader) AccessController.doPrivileged(ContextClassLoader.INSTANTIATOR);
ClassLoader cl = ccl.getContextClassLoader();
if (cl != null)
classLoaderRef = new WeakReference(cl);
else
classLoaderRef = null;
}
public ClassLoader getClassLoader()
{
return classLoaderRef == null ? null : (ClassLoader) classLoaderRef.get();
}
}
././@LongLink 0000000 0000000 0000000 00000000147 00000000000 011567 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/loading/Translator.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/loading/Translator.ja0000644 0001750 0001750 00000006535 10774222622 033247 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.loading;
import java.security.ProtectionDomain;
/** An interface for transforming byte code before Class creation. This is
* compatible with the JDK1.5 java.lang.instrument.ClassFileTransformer
* proposal.
*
* @author Scott.Stark@jboss.org
* @version $Revision: 2787 $
*/
public interface Translator
{
/** Optionally transform the supplied class file and return a new replacement
* class file.
*
* If a transformer has been registered with the class loading layer,
* the transformer will be called for every new class definition.
* The request for a new class definition is made with defineClass
* The transformer is called during the processing of the request, before
* the class file bytes have been verified or applied.
*
*
* If the implementing method determines that no transformations are needed,
* it should return
*
* When a security manager is installed, the
* constructor checks for the runtime permissions
* "getClassLoader" and "setContextClassLoader".
* This allows the methods of this class to be used later without
* having to run in privileged blocks.
*
* There are optimized methods to perform the operations within
* a switch context. This avoids retrieving the current thread
* on every operation.
*
* @version $Revision: 2787 $
* @author Adrian Brock
*/
@SuppressWarnings("unchecked")
public class ContextClassLoaderSwitcher
extends ContextClassLoader
{
/**
* Set the context classloader permission
*/
public static final RuntimePermission SETCONTEXTCLASSLOADER = new RuntimePermission("setContextClassLoader");
/**
* Instantiate a new context class loader switcher
*/
@SuppressWarnings("hiding")
public static final NewInstance INSTANTIATOR = new NewInstance();
/**
* Constructor.
* @throws SecurityException when not authroized to get/set the context classloader
*/
private ContextClassLoaderSwitcher()
{
super();
SecurityManager manager = System.getSecurityManager();
if (manager != null)
manager.checkPermission(SETCONTEXTCLASSLOADER);
}
/**
* Set the context classloader
* @param cl
*/
public void setContextClassLoader(final ClassLoader cl)
{
setContextClassLoader(Thread.currentThread(), cl);
}
/**
* Set the context classloader for the given thread
*
* @param thread the thread
* @param cl the new context classloader
*/
public void setContextClassLoader(final Thread thread, final ClassLoader cl)
{
AccessController.doPrivileged(new PrivilegedAction()
{
public Object run()
{
thread.setContextClassLoader(cl);
return null;
}
});
}
/**
* Retrieve a switch context
*
* @return the switch context
*/
public SwitchContext getSwitchContext()
{
return new SwitchContext();
}
/**
* Retrieve a switch context and set the new context classloader
*
* @param cl the new classloader
* @return the switch context
*/
public SwitchContext getSwitchContext(final ClassLoader cl)
{
return new SwitchContext(cl);
}
/**
* Retrieve a switch context for the classloader of a given class
*
* @deprecated using a class to determine the classloader is a
* bad idea, it has the same problems as Class.forName()
* @param clazz the class whose classloader should be set
* as the context classloader
* @return the switch context
*/
public SwitchContext getSwitchContext(final Class clazz)
{
return new SwitchContext(clazz.getClassLoader());
}
/**
* A helper class to remember the original classloader and
* avoid continually retrieveing the current thread.
*/
public class SwitchContext
{
/**
* The original classloader
*/
private ClassLoader origCL;
/**
* The current classloader
*/
private ClassLoader currentCL;
/**
* The current thread
*/
private Thread currentThread;
private SwitchContext()
{
currentThread = Thread.currentThread();
origCL = getContextClassLoader(currentThread);
currentCL = origCL;
}
private SwitchContext(ClassLoader cl)
{
this();
setClassLoader(cl);
}
/**
* @return the current thread
*/
public Thread getThread()
{
return currentThread;
}
/**
* @return the original classloader
*/
public ClassLoader getOriginalClassLoader()
{
return origCL;
}
/**
* @return the current classloader
* (as set through this class).
*/
public ClassLoader getCurrentClassLoader()
{
return currentCL;
}
/**
* Change the context classloader
*
* The operation is ignored if the classloader is null
* or has not changed
*
* @param cl the new classloader
*/
public void setClassLoader(ClassLoader cl)
{
if (cl != null && cl != currentCL)
{
setContextClassLoader(currentThread, cl);
currentCL = cl;
}
}
/**
* Reset back to the original classloader,
* only when it has changed.
*/
public void reset()
{
if (currentCL != null && currentCL != origCL)
setContextClassLoader(currentThread, origCL);
}
/**
* Force a reset back to the original classloader,
* useful when somebody else might have changed
* the thread context classloader so we cannot optimize
*/
public void forceReset()
{
setContextClassLoader(currentThread, origCL);
}
}
private static class NewInstance
implements PrivilegedAction
{
public Object run()
{
return new ContextClassLoaderSwitcher();
}
}
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/WaitSync.java 0000644 0001750 0001750 00000003412 10774222622 031560 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
/**
* Interface that gives wait - notify primitives to implementors.
*
* @see Semaphore
*
* @author Simone Bordet
* @version $Revision: 2787 $
*/
public interface WaitSync
extends Sync
{
/**
* Pone in wait status this sync, until {@link #doNotify} is called to wake it up.
*
* @see #doNotify
* @throws InterruptedException
*/
void doWait() throws InterruptedException;
/**
* Wakes up this sync that has been posed in wait status by a {@link #doWait} call.
* If this sync is not waiting, invoking this method should have no effect.
* @see #doWait
* @throws InterruptedException
*/
void doNotify() throws InterruptedException;
}
././@LongLink 0000000 0000000 0000000 00000000147 00000000000 011567 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/NestedSQLException.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/NestedSQLException.ja0000644 0001750 0001750 00000011177 10776226110 033156 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
import java.io.PrintWriter;
import java.io.PrintStream;
import java.sql.SQLException;
/**
* A common superclass for SQLException classes that can contain
* a nested Throwable detail object.
*
* @version $Revision: 2800 $
* @author Jason Dillon
*/
public class NestedSQLException
extends SQLException
implements NestedThrowable
{
/** The serialVersionUID */
private static final long serialVersionUID = -8348882503434035185L;
/** The nested throwable */
protected final Throwable nested;
/**
* Construct a NestedSQLException with the specified detail
* message.
*
* @param msg Detail message.
*/
public NestedSQLException(final String msg) {
super(msg);
this.nested = null;
}
/**
* Construct a NestedSQLException with the specified detail
* message and nested Throwable.
*
* @param msg Detail message.
* @param nested Nested Throwable.
*/
public NestedSQLException(final String msg, final Throwable nested) {
super(msg);
this.nested = nested;
NestedThrowable.Util.checkNested(this, nested);
}
/**
* Construct a NestedSQLException with the specified
* nested Throwable.
*
* @param nested Nested Throwable.
*/
public NestedSQLException(final Throwable nested) {
this(nested.getMessage(), nested);
}
/**
* Construct a NestedSQLException.
*
* @param msg Detail message.
* @param state SQL state message.
*/
public NestedSQLException(final String msg, final String state) {
super(msg, state);
this.nested = null;
}
/**
* Construct a NestedSQLException.
*
* @param msg Detail message.
* @param state SQL state message.
* @param code SQL vendor code.
*/
public NestedSQLException(final String msg, final String state, final int code) {
super(msg, state, code);
this.nested = null;
}
/**
* Return the nested Throwable.
*
* @return Nested Throwable.
*/
public Throwable getNested() {
return nested;
}
/**
* Return the nested Throwable.
*
* For JDK 1.4 compatibility.
*
* @return Nested Throwable.
*/
public Throwable getCause() {
return nested;
}
/**
* Returns the composite throwable message.
*
* @return The composite throwable message.
*/
public String getMessage() {
return NestedThrowable.Util.getMessage(super.getMessage(), nested);
}
/**
* Prints the composite message and the embedded stack trace to the
* specified print stream.
*
* @param stream Stream to print to.
*/
public void printStackTrace(final PrintStream stream) {
if (nested == null || NestedThrowable.PARENT_TRACE_ENABLED) {
super.printStackTrace(stream);
}
NestedThrowable.Util.print(nested, stream);
}
/**
* Prints the composite message and the embedded stack trace to the
* specified print writer.
*
* @param writer Writer to print to.
*/
public void printStackTrace(final PrintWriter writer) {
if (nested == null || NestedThrowable.PARENT_TRACE_ENABLED) {
super.printStackTrace(writer);
}
NestedThrowable.Util.print(nested, writer);
}
/**
* Prints the composite message and the embedded stack trace to
* System.err.
*/
public void printStackTrace() {
printStackTrace(System.err);
}
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/JBossObject.java 0000644 0001750 0001750 00000015444 10774222622 032176 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
import java.lang.ref.SoftReference;
import java.util.Collection;
import java.util.Iterator;
import org.jboss.logging.Logger;
/**
* Utility Class
*
* Utility Class that provides a Logger instance (log) and
* caching of toString() and hashCode() values.
*
* You most probably want to override the method that
* comes from JBossInterface:
*
* public void toShortString(StringBuffer buffer)
*
* to append to the buffer the key class properties, and
* also override the following methods to provide the
* hashCode and the class properties that should be cached:
*
* protected void toString(StringBuffer buffer)
* protected int getHashCode()
*
* Cached values can be flushed using flushJBossObjectCache()
*
* Caching can be disabled by simply overriding toString()
* and hashCode(), or returning false from methods:
*
* protected boolean cacheToString()
* protected boolean cacheGetHashCode()
*
* @author Adrian Brock
* @version $Revision: 2787 $
*/
@SuppressWarnings("unchecked")
public class JBossObject implements JBossInterface
{
/** The log */
protected Logger log;
/** Cached toString */
protected transient SoftReference toString;
/** Cached hashCode */
protected transient int hashCode = Integer.MIN_VALUE;
/**
* Safe equality check
*
* @param one an object
* @param two another object
* @return true when they are equal
*/
public static boolean equals(Object one, Object two)
{
if (one == null && two != null)
return false;
if (one != null && one.equals(two) == false)
return false;
return true;
}
/**
* Safe inequality check
*
* @param one an object
* @param two another object
* @return true when they are not equal
*/
public static boolean notEqual(Object one, Object two)
{
return equals(one, two) == false;
}
/**
* List the set of JBossObjects
*
* @param buffer the buffer
* @param objects the collection of objects
*/
public static void list(JBossStringBuilder buffer, Collection objects)
{
if (objects == null)
return;
buffer.append('[');
if (objects.isEmpty() == false)
{
for (Iterator i = objects.iterator(); i.hasNext();)
{
Object object = i.next();
if (object instanceof JBossObject)
((JBossObject) object).toShortString(buffer);
else
buffer.append(object.toString());
if (i.hasNext())
buffer.append(", ");
}
}
buffer.append(']');
}
/**
* Create a new object
*/
public JBossObject()
{
log = Logger.getLogger(getClass());
}
/**
* Create a new object using the specified Logger instace
*
* @param log the Logger instance to use
*/
public JBossObject(Logger log)
{
this.log = (log != null) ? log : Logger.getLogger(getClass());
}
/**
* Override toString to cache the value
*
* @return the String
*/
public String toString()
{
if (cacheToString() == false)
return toStringImplementation();
String result = null;
if (toString != null)
result = (String) toString.get();
if (result == null)
{
result = toStringImplementation();
toString = new SoftReference(result);
}
return result;
}
/**
* Override hashCode to cache the value
*
* @return the hashCode
*/
public int hashCode()
{
if (hashCode == Integer.MIN_VALUE || cacheGetHashCode() == false)
hashCode = getHashCode();
return hashCode;
}
public Object clone()
{
try
{
return super.clone();
}
catch (CloneNotSupportedException e)
{
throw new RuntimeException(e);
}
}
public String toShortString()
{
JBossStringBuilder buffer = new JBossStringBuilder();
toShortString(buffer);
return buffer.toString();
}
/**
* Append the key class properties to the buffer
*
* @param buffer the buffer
*/
public void toShortString(JBossStringBuilder buffer)
{
}
/**
* Get the class short name
*
* @return the short name of the class
*/
public String getClassShortName()
{
String longName = getClass().getName();
int dot = longName.lastIndexOf('.');
if (dot != -1)
return longName.substring(dot + 1);
return longName;
}
/**
* Implementation of String
*
* @return the string
*/
protected String toStringImplementation()
{
JBossStringBuilder buffer = new JBossStringBuilder();
buffer.append(getClassShortName()).append('@');
buffer.append(Integer.toHexString(System.identityHashCode(this)));
buffer.append('{');
toString(buffer);
buffer.append('}');
return buffer.toString();
}
/**
* Flush the JBossObject cached values
*/
protected void flushJBossObjectCache()
{
toString = null;
hashCode = Integer.MIN_VALUE;
}
/**
* Append the class properties to the buffer
*
* @param buffer the buffer
*/
protected void toString(JBossStringBuilder buffer)
{
}
/**
* Calculate the hashcode
*
* @return the hash code
*/
protected int getHashCode()
{
return super.hashCode();
}
/**
* Whether we should cache the result toString()
*
* @return true by default
*/
protected boolean cacheToString()
{
return true;
}
/**
* Whether we should cache the result hashCode()
*
* @return true by default
*/
protected boolean cacheGetHashCode()
{
return true;
}
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/Heap.java 0000644 0001750 0001750 00000013130 10774222622 030672 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
import java.util.Comparator;
/**
* Data structure that mantains data in a ordered binary tree; each node is
* greater (smaller) or equal than its 2 sub-nodes, for all the hierarchy.
* Elements of this data structure should either implement Comparable, or a
* Comparator should be given as argument to the constructor.
*
* @author Simone Bordet
* @version $Revision: 2787 $
*/
@SuppressWarnings("unchecked")
public class Heap
{
private Comparator m_comparator;
private int m_count;
private Object[] m_nodes;
/**
* Creates a new Heap whose elements inserted implement the
* {@link Comparable} interface.
*/
public Heap()
{
this(null);
}
/**
* Creates a new Heap whose elements are compared using the given
* {@link Comparator}.
* @param comparator
*/
public Heap(Comparator comparator)
{
m_comparator = comparator;
clear();
}
/**
* Inserts the given element in this heap.
* @param obj
*
* @see #extract
*/
public void insert(Object obj)
{
int length = m_nodes.length;
// Expand if necessary
if (m_count == length)
{
Object[] newNodes = new Object[length + length];
System.arraycopy(m_nodes, 0, newNodes, 0, length);
m_nodes = newNodes;
}
// Be cur_slot the first unused slot index; be par_slot its parent index.
// Start from cur_slot and walk up the tree comparing the object to
// insert with the object at par_slot; if it's smaller move down the object at par_slot,
// otherwise cur_slot is the index where insert the object. If not done,
// shift up the tree so that now cur_slot is the old par_slot and
// par_slot is the parent index of the new cur_slot (so the grand-parent
// index of the old cur_slot) and compare again.
int k = m_count;
while (k > 0)
{
int par = parent(k);
if (compare(obj, m_nodes[par]) < 0)
{
m_nodes[k] = m_nodes[par];
k = par;
}
else break;
}
m_nodes[k] = obj;
++m_count;
}
/**
* Removes and returns the least element of this heap.
* @return the extracted object
*
* @see #insert
* @see #peek
*/
public Object extract()
{
if (m_count < 1) {return null;}
else
{
int length = m_nodes.length >> 1;
// Shrink if necessary
if (length > 5 && m_count < (length >> 1))
{
Object[] newNodes = new Object[length];
System.arraycopy(m_nodes, 0, newNodes, 0, length);
m_nodes = newNodes;
}
//
int k = 0;
Object ret = m_nodes[k];
--m_count;
Object last = m_nodes[m_count];
for (;;)
{
int l = left(k);
if (l >= m_count) {break;}
else
{
int r = right(k);
int child = (r >= m_count || compare(m_nodes[l], m_nodes[r]) < 0) ? l : r;
if (compare(last, m_nodes[child]) > 0)
{
m_nodes[k] = m_nodes[child];
k = child;
}
else {break;}
}
}
m_nodes[k] = last;
m_nodes[m_count] = null;
return ret;
}
}
/**
* @return without removing it, the least element of this heap.
*
* @see #extract
*/
public Object peek()
{
if (m_count < 1) {return null;}
else {return m_nodes[0];}
}
/**
* Empties this heap
*/
public void clear()
{
m_count = 0;
m_nodes = new Object[10];
}
protected int compare(Object o1, Object o2)
{
if (m_comparator != null)
{
return m_comparator.compare(o1, o2);
}
else
{
if (o1 == null)
{
if (o2 == null) {return 0;}
else {return -((Comparable)o2).compareTo(o1);}
}
else {return ((Comparable)o1).compareTo(o2);}
}
}
/**
* @return the parent index of Utility classes and interfaces. For JDK 1.4 compatibility.
*
* @return Nested Throwable.
*/
public Throwable getCause() {
return nested;
}
/**
* Returns the composite throwable message.
*
* @return The composite throwable message.
*/
public String getMessage() {
return NestedThrowable.Util.getMessage(super.getMessage(), nested);
}
/**
* Prints the composite message and the embedded stack trace to the
* specified print stream.
*
* @param stream Stream to print to.
*/
public void printStackTrace(final PrintStream stream) {
if (nested == null || NestedThrowable.PARENT_TRACE_ENABLED) {
super.printStackTrace(stream);
}
NestedThrowable.Util.print(nested, stream);
}
/**
* Prints the composite message and the embedded stack trace to the
* specified print writer.
*
* @param writer Writer to print to.
*/
public void printStackTrace(final PrintWriter writer) {
if (nested == null || NestedThrowable.PARENT_TRACE_ENABLED) {
super.printStackTrace(writer);
}
NestedThrowable.Util.print(nested, writer);
}
/**
* Prints the composite message and the embedded stack trace to
* System.err.
*/
public void printStackTrace() {
printStackTrace(System.err);
}
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/Strings.java 0000644 0001750 0001750 00000111223 11041662731 031445 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
import java.io.File;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.net.MalformedURLException;
import java.net.URI;
import java.net.URISyntaxException;
import java.net.URL;
import java.net.URLDecoder;
import java.util.Map;
import java.util.StringTokenizer;
import java.util.List;
import java.util.ArrayList;
import java.util.Locale;
/**
* A collection of String utilities.
*
* @author Jason Dillon
* @author Scott Stark
* @author Claudio Vesco
* @author Dimitris Andreadis
* @version $Revision: 2886 $
*/
@SuppressWarnings("unchecked")
public final class Strings
{
/** An empty string constant */
public static final String EMPTY = "";
/** Millisecond conversion constants */
private static final long MSEC = 1;
private static final long SECS = 1000;
private static final long MINS = 60 * 1000;
private static final long HOUR = 60 * 60 * 1000;
/**
* List of valid Java keywords, see The Java Language Specification
* Second Edition Section 3.9, 3.10.3 and 3.10.7
*/
private static final String[] keywords =
{
"abstract",
"boolean",
"break",
"byte",
"case",
"catch",
"char",
"class",
"const",
"continue",
"default",
"do",
"double",
"else",
"extends",
"final",
"finally",
"float",
"for",
"goto",
"if",
"implements",
"import",
"instanceof",
"int",
"interface",
"long",
"native",
"new",
"package",
"private",
"protected",
"public",
"return",
"short",
"static",
"strictfp",
"super",
"switch",
"synchronized",
"this",
"throw",
"throws",
"transient",
"try",
"void",
"volatile",
"while",
"true", // technically no keywords but we are not picky
"false",
"null"
};
/**
* List of EJB-QL Identifiers as defined in the EJB 2.0 Specification
* Section 11.2.6.1
*/
private static final String[] ejbQlIdentifiers =
{
"AND",
"AS",
"BETWEEN",
"DISTINCT",
"EMPTY",
"FALSE",
"FROM",
"IN",
"IS",
"LIKE",
"MEMBER",
"NOT",
"NULL",
"OBJECT",
"OF",
"OR",
"SELECT",
"UNKNOWN",
"TRUE",
"WHERE",
};
/////////////////////////////////////////////////////////////////////////
// Substitution Methods //
/////////////////////////////////////////////////////////////////////////
/**
* Substitute sub-strings in side of a string.
*
* @param buff Stirng buffer to use for substitution (buffer is not reset)
* @param from String to substitute from
* @param to String to substitute to
* @param string String to look for from in
* @return Substituted string
*/
public static String subst(final StringBuffer buff, final String from,
final String to, final String string)
{
int begin = 0, end = 0;
while ((end = string.indexOf(from, end)) != -1)
{
// append the first part of the string
buff.append(string.substring(begin, end));
// append the replaced string
buff.append(to);
// update positions
begin = end + from.length();
end = begin;
}
// append the rest of the string
buff.append(string.substring(begin, string.length()));
return buff.toString();
}
/**
* Substitute sub-strings in side of a string.
*
* @param from String to substitute from
* @param to String to substitute to
* @param string String to look for from in
* @return Substituted string
*/
public static String subst(final String from, final String to,
final String string)
{
return subst(new StringBuffer(), from, to, string);
}
/**
* Substitute sub-strings in side of a string.
*
* @param buff String buffer to use for substitution (buffer is not reset)
* @param string String to subst mappings in
* @param map Map of from->to strings
* @param beginToken Beginning token
* @param endToken Ending token
* @return Substituted string
*/
public static String subst(final StringBuffer buff, final String string,
final Map map, final String beginToken,
final String endToken)
{
int begin = 0, rangeEnd = 0;
Range range;
while ((range = rangeOf(beginToken, endToken, string, rangeEnd)) != null)
{
// append the first part of the string
buff.append(string.substring(begin, range.begin));
// Get the string to replace from the map
String key = string.substring(range.begin + beginToken.length(),
range.end);
Object value = map.get(key);
// if mapping does not exist then use empty;
if (value == null) value = EMPTY;
// append the replaced string
buff.append(value);
// update positions
begin = range.end + endToken.length();
rangeEnd = begin;
}
// append the rest of the string
buff.append(string.substring(begin, string.length()));
return buff.toString();
}
/**
* Substitute sub-strings in side of a string.
*
* @param string String to subst mappings in
* @param map Map of from->to strings
* @param beginToken Beginning token
* @param endToken Ending token
* @return Substituted string
*/
public static String subst(final String string, final Map map,
final String beginToken, final String endToken)
{
return subst(new StringBuffer(), string, map, beginToken, endToken);
}
/**
* Substitute index identifiers with the replacement value from the
* given array for the corresponding index.
*
* @param buff The string buffer used for the substitution
* (buffer is not reset).
* @param string String substitution format.
* @param replace Array of strings whose values will be used as
* replacements in the given string when a token with
* their index is found.
* @param token The character token to specify the start of an index
* reference.
* @return Substituted string.
*/
public static String subst(final StringBuffer buff, final String string,
final String replace[], final char token)
{
int i = string.length();
for (int j = 0; j >= 0 && j < i; j++)
{
char c = string.charAt(j);
// if the char is the token, then get the index
if (c == token)
{
// if we aren't at the end of the string, get the index
if (j != i)
{
int k = Character.digit(string.charAt(j + 1), 10);
if (k == -1)
{
buff.append(string.charAt(j + 1));
}
else if (k < replace.length)
{
buff.append(replace[k]);
}
j++;
}
}
else
{
buff.append(c);
}
}
return buff.toString();
}
/**
* Substitute index identifiers with the replacement value from the
* given array for the corresponding index.
*
* @param string String substitution format.
* @param replace Array of strings whose values will be used as
* replacements in the given string when a token with
* their index is found.
* @param token The character token to specify the start of an index
* reference.
* @return Substituted string.
*/
public static String subst(final String string, final String replace[],
final char token)
{
return subst(new StringBuffer(), string, replace, token);
}
/**
* Substitute index identifiers (with Compare two strings.
*
* Both or one of them may be null.
* @param me
* @param you
*
* @return true if object equals or intern ==, else false.
*/
public static boolean compare(final String me, final String you)
{
// If both null or intern equals
if (me == you)
return true;
// if me null and you are not
if (me == null && you != null)
return false;
// me will not be null, test for equality
return me.equals(you);
}
/**
* Check if the given string is empty.
*
* @param string String to check
* @return True if string is empty
*/
public static boolean isEmpty(final String string)
{
return string.equals(EMPTY);
}
/**
* Return the nth index of the given token occurring in the given string.
*
* @param string String to search.
* @param token Token to match.
* @param index Nth index.
* @return Index of nth item or -1.
*/
public static int nthIndexOf(final String string, final String token,
final int index)
{
int j = 0;
for (int i = 0; i < index; i++)
{
j = string.indexOf(token, j + 1);
if (j == -1) break;
}
return j;
}
/**
* Capitalize the first character of the given string.
*
* @param string String to capitalize.
* @return Capitalized string.
*
* @throws IllegalArgumentException String is This modifies the string array.
*
* @param strings String array to trim.
* @return String array with each element trimmed.
*/
public static String[] trim(final String[] strings)
{
for (int i = 0; i < strings.length; i++)
{
strings[i] = strings[i].trim();
}
return strings;
}
/**
* Make a URL from the given string.
*
*
* If the string is a properly formatted file URL, then the file
* portion will be made canonical.
*
*
* If the string is an invalid URL then it will be converted into a
* file URL.
*
* @param urlspec The string to construct a URL for.
* @param relativePrefix The string to prepend to relative file
* paths, or null to disable prepending.
* @return A URL for the given string.
*
* @throws MalformedURLException Could not make a URL for the given string.
*/
public static URL toURL(String urlspec, final String relativePrefix) throws MalformedURLException
{
urlspec = urlspec.trim();
URL url;
try
{
url = new URL(urlspec);
if (url.getProtocol().equals("file"))
{
url = makeURLFromFilespec(url.getFile(), relativePrefix);
}
}
catch (Exception e)
{
// make sure we have a absolute & canonical file url
try
{
url = makeURLFromFilespec(urlspec, relativePrefix);
}
catch (IOException n)
{
//
// jason: or should we rethrow e?
//
throw new MalformedURLException(n.toString());
}
}
return url;
}
public static URI toURI(String urispec, final String relativePrefix)
throws URISyntaxException
{
urispec = urispec.trim();
URI uri;
if( urispec.startsWith("file:") )
{
uri = makeURIFromFilespec(urispec.substring(5), relativePrefix);
}
else
{
uri = new URI(urispec);
}
return uri;
}
/** A helper to make a URL from a filespec. */
private static URL makeURLFromFilespec(final String filespec, final String relativePrefix)
throws IOException
{
// make sure the file is absolute & canonical file url
File file = new File(decode(filespec));
// if we have a prefix and the file is not abs then prepend
if (relativePrefix != null && !file.isAbsolute())
{
file = new File(relativePrefix, filespec);
}
// make sure it is canonical (no ../ and such)
file = file.getCanonicalFile();
return file.toURI().toURL();
}
private static String decode(String filespec)
{
try
{
return URLDecoder.decode(filespec, "UTF-8");
}
catch (UnsupportedEncodingException e)
{
throw new RuntimeException("Error decoding filespec: " + filespec, e);
}
}
private static URI makeURIFromFilespec(final String filespec, final String relativePrefix)
{
// make sure the file is absolute & canonical file url
File file = new File(decode(filespec));
// if we have a prefix and the file is not abs then prepend
if (relativePrefix != null && !file.isAbsolute())
{
file = new File(relativePrefix, filespec);
}
return file.toURI();
}
/**
* Make a URL from the given string.
*
* @see #toURL(String,String)
*
* @param urlspec The string to construct a URL for.
* @return A URL for the given string.
*
* @throws MalformedURLException Could not make a URL for the given string.
*/
public static URL toURL(final String urlspec) throws MalformedURLException
{
return toURL(urlspec, null);
}
/**
*
* @param urispec
* @return the uri
* @throws URISyntaxException for any error
*/
public static URI toURI(final String urispec)
throws URISyntaxException
{
return toURI(urispec, null);
}
/**
* Check whether the given String is a reserved Java Keyword
* according to the Java Language Specifications.
*
* @param s String to check
*
* @return
*
* The class is first checked for availablity before setting the system
* property.
* @jmx.mbean
*
* @version $Revision: 1958 $
* @author Adrian Brock
*/
public class SystemPropertyClassValue
implements SystemPropertyClassValueMBean
{
public static final Logger log = Logger.getLogger(SystemPropertyClassValue.class);
/** Property name. */
protected String property;
/** Class Name. */
protected String className;
/**
* Constructor.
*/
public SystemPropertyClassValue()
{
}
/**
* The system property value
*
* @jmx.managed-attribute
*/
public String getProperty()
{
return property;
}
/**
* The system property value
*
* @jmx.managed-attribute
*/
public void setProperty(String property)
{
this.property = property;
}
/**
* The class name to use a value for the system property
* when it is available
*
* @jmx.managed-attribute
*/
public String getClassName()
{
return className;
}
/**
* The class name to use a value for the system property
* when it is available
*
* @jmx.managed-attribute
*/
public void setClassName(String className)
{
this.className = className;
}
/**
* JBoss lifecycle
*
* @jmx.managed-operation
*/
public void create()
{
Throwable error = setSystemPropertyClassValue(property, className);
if (error != null)
log.trace("Error loading class " + className + " property " + property + " not set.", error);
}
/**
* Sets the system property to a class when the class is available.
*
* @param property the property to set
* @param className the class to set as the properties value
* @return any error loading the class
* @exception IllegalArgumentException for a null or empty parameter
*/
public static Throwable setSystemPropertyClassValue(String property, String className)
{
// Validation
if (property == null || property.trim().length() == 0)
throw new IllegalArgumentException("Null or empty property");
if (className == null || className.trim().length() == 0)
throw new IllegalArgumentException("Null or empty class name");
// Is the class available?
try
{
Thread.currentThread().getContextClassLoader().loadClass(className);
}
catch (Throwable problem)
{
return problem;
}
// The class is there, set the property.
System.setProperty(property, className);
return null;
}
}
././@LongLink 0000000 0000000 0000000 00000000145 00000000000 011565 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/package.html libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/package.html0000644 0001750 0001750 00000003760 10470642610 033323 0 ustar twerner twerner
An advanced property access, managment and notification system. This system provides some helpful additions to the standard Java
property system. Some of these features include:
Aims to provide a JavaBeans style api for accessing properties
in a simple, powerful and consistent fashion.
This class needs more work to be fully functional. It should suffice
* for adding property listeners and getting/setting property values,
* but other activies might not work out so well.
*
* @version $Revision: 2787 $
* @author Jason Dillon
* @author Adrian Brock
*/
@SuppressWarnings("unchecked")
public class PropertyGroup extends PropertyMap
{
/** Serial version uid */
private static final long serialVersionUID = -2557641199743063159L;
/** Base property name */
protected final String basename;
/**
* Construct a PropertyGroup.
*
* @param basename Base property name.
* @param container Property container.
*
* @throws NullArgumentException Basename is null.
*/
public PropertyGroup(final String basename, final Properties container)
{
super(container);
if (basename == null)
throw new NullArgumentException("basename");
this.basename = basename;
}
/**
* Get the base property name for this group.
*
* @return Base property name.
*/
public final String getBaseName()
{
return basename;
}
/**
* Make a fully qualified property name.
*
* @param suffix Property name suffix.
*/
private String makePropertyName(final String suffix)
{
return basename + PropertyMap.PROPERTY_NAME_SEPARATOR + suffix;
}
/**
* Make a fully qualified property name.
*
* @param suffix Property name suffix.
*/
private String makePropertyName(final Object suffix)
{
return makePropertyName(String.valueOf(suffix));
}
/**
* Check if this PropertyMap contains a given property name.
*
* @param name Property name.
* @return True if property map or defaults contains key.
*/
public boolean containsKey(final Object name)
{
if (name == null)
throw new NullArgumentException("name");
return super.containsKey(makePropertyName(name));
}
/**
* Set a property.
*
* @param name Property name.
* @param value Property value.
* @return Previous property value or null.
*/
public Object put(final Object name, final Object value)
{
if (name == null)
throw new NullArgumentException("name");
return super.put(makePropertyName(name), value);
}
/**
* Get a property
*
* @param name Property name.
* @return Property value or null.
*/
public Object get(final Object name)
{
if (name == null)
throw new NullArgumentException("name");
return super.get(makePropertyName(name));
}
/**
* Remove a property.
*
* @param name Property name.
* @return Removed property value.
*/
public Object remove(final Object name)
{
if (name == null)
throw new NullArgumentException("name");
return super.remove(makePropertyName(name));
}
/**
* Returns an entry set for all properties in this group.
*
*
* This is currently ver inefficient, but should get the
* job done for now.
*/
@SuppressWarnings("unchecked")
public Set entrySet()
{
final Set superSet = super.entrySet(true);
return new java.util.AbstractSet()
{
private boolean isInGroup(Map.Entry entry)
{
String key = (String) entry.getKey();
return key.startsWith(basename);
}
public int size()
{
Iterator iter = superSet.iterator();
int count = 0;
while (iter.hasNext())
{
Map.Entry entry = (Map.Entry) iter.next();
if (isInGroup(entry))
{
count++;
}
}
return count;
}
public Iterator iterator()
{
return new Iterator()
{
private Iterator iter = superSet.iterator();
private Object next;
public boolean hasNext()
{
if (next != null)
return true;
while (next == null)
{
if (iter.hasNext())
{
Map.Entry entry = (Map.Entry) iter.next();
if (isInGroup(entry))
{
next = entry;
return true;
}
}
else
{
break;
}
}
return false;
}
public Object next()
{
if (next == null)
throw new java.util.NoSuchElementException();
Object obj = next;
next = null;
return obj;
}
public void remove()
{
iter.remove();
}
};
}
};
}
/**
* Add a bound property listener.
*
* Generates a fully qualified property name and adds the listener
* under that name.
*
* @param listener Bound property listener to add.
*/
protected void addPropertyListener(final BoundPropertyListener listener)
{
// get the bound property name
String name = makePropertyName(listener.getPropertyName());
// get the bound listener list for the property
List list = (List) boundListeners.get(name);
// if list is null, then add a new list
if (list == null)
{
list = new ArrayList();
boundListeners.put(name, list);
}
// if listener is not in the list already, then add it
if (!list.contains(listener))
{
list.add(listener);
// notify listener that is is bound
listener.propertyBound(this);
}
}
/**
* Remove a bound property listener.
*
* Generates a fully qualified property name and removes the listener
* under that name.
*
* @param listener Bound property listener to remove.
* @return True if listener was removed.
*/
protected boolean removePropertyListener(final BoundPropertyListener listener)
{
// get the bound property name
String name = makePropertyName(listener.getPropertyName());
// get the bound listener list for the property
List list = (List) boundListeners.get(name);
boolean removed = false;
if (list != null)
{
removed = list.remove(listener);
// notify listener that is was unbound
if (removed)
listener.propertyUnbound(this);
}
return removed;
}
}
././@LongLink 0000000 0000000 0000000 00000000160 00000000000 011562 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/FilePropertyReader.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/FileProperty0000644 0001750 0001750 00000007517 10774222622 033421 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.property;
import java.util.Properties;
import java.util.Map;
import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;
import java.io.BufferedInputStream;
import java.io.IOException;
import org.jboss.util.NullArgumentException;
/**
* Reads properties from one or more files.
*
* @version $Revision: 2787 $
* @author Jason Dillon
*/
@SuppressWarnings("unchecked")
public class FilePropertyReader
implements PropertyReader
{
/** Array of filenames to load properties from */
protected String[] filenames;
/**
* Construct a FilePropertyReader with an array of filenames
* to read from.
*
* @param filenames Filenames to load properties from
*/
public FilePropertyReader(String[] filenames) {
if (filenames == null)
throw new NullArgumentException("filenames");
this.filenames = filenames;
}
/**
* Construct a FilePropertyReader with a single filename to read from.
*
* @param filename Filename to load properties from
*/
public FilePropertyReader(String filename) {
this(new String[] { filename });
}
/**
* Get an input stream for the given filename.
*
* @param filename File name to get input stream for.
* @return Input stream for file.
*
* @throws IOException Failed to get input stream for file.
*/
protected InputStream getInputStream(String filename) throws IOException {
File file = new File(filename);
return new FileInputStream(file);
}
/**
* Load properties from a file into a properties map.
*
* @param props Properties map to load properties into.
* @param filename Filename to read properties from.
*
* @throws IOException Failed to load properties from filename.
* @throws IllegalArgumentException Filename is invalid.
*/
protected void loadProperties(Properties props, String filename)
throws IOException
{
if (filename == null)
throw new NullArgumentException("filename");
if (filename.equals(""))
throw new IllegalArgumentException("filename");
InputStream in = new BufferedInputStream(getInputStream(filename));
props.load(in);
in.close();
}
/**
* Read properties from each specified filename
*
* @return Read properties
*
* @throws PropertyException Failed to read properties.
* @throws IOException I/O error while reading properties.
*/
public Map readProperties()
throws PropertyException, IOException
{
Properties props = new Properties();
// load each specified property file
for (int i=0; i Unless otherwise specified, propertie filenames will be read from
* the org.jboss.properties singleton or array property.
*
* @version $Revision: 2787 $
* @author Jason Dillon
*/
public final class DefaultPropertyReader
extends FilePropertyReader
{
//
// Might want to have a org.jboss.properties.property.name or something
// property to determine what property name to read from.
//
// For now just use 'properties'
//
/** Default property name to read filenames from */
public static final String DEFAULT_PROPERTY_NAME = "properties";
/**
* Construct a DefaultPropertyReader with a specified property
* name.
*
* @param propertyName Property name.
*/
public DefaultPropertyReader(final String propertyName) {
super(getFilenames(propertyName));
}
/**
* Construct a DefaultPropertyReader.
*/
public DefaultPropertyReader() {
this(DEFAULT_PROPERTY_NAME);
}
/**
* Get an array of filenames to load.
*
* @param propertyName Property to read filenames from.
* @return Array of filenames.
* @throws PropertyException
*/
public static String[] getFilenames(final String propertyName)
throws PropertyException
{
String filenames[];
// check for singleton property first
Object filename = PropertyManager.getProperty(propertyName);
if (filename != null) {
filenames = new String[] { String.valueOf(filename) };
}
else {
// if no singleton property exists then look for array props
filenames = PropertyManager.getArrayProperty(propertyName);
}
return filenames;
}
}
././@LongLink 0000000 0000000 0000000 00000000162 00000000000 011564 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/BoundPropertyAdapter.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/BoundPropert0000644 0001750 0001750 00000003544 10470642610 033410 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.property;
/**
* An abstract adapter class for receiving bound property events.
*
* Methods defined in this class are empty. This class exists as
* as convenience for creating listener objects.
*
* @version $Revision: 1958 $
* @author Jason Dillon
*/
public abstract class BoundPropertyAdapter
extends PropertyAdapter
implements BoundPropertyListener
{
/**
* Notifies that this listener was bound to a property.
*
* @param map PropertyMap which contains property bound to.
*/
public void propertyBound(final PropertyMap map) {}
/**
* Notifies that this listener was unbound from a property.
*
* @param map PropertyMap which contains property bound to.
*/
public void propertyUnbound(final PropertyMap map) {}
}
././@LongLink 0000000 0000000 0000000 00000000155 00000000000 011566 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/PropertyManager.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/PropertyMana0000644 0001750 0001750 00000025016 10774222622 033410 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.property;
import java.security.AccessController;
import java.security.PrivilegedAction;
import java.util.Map;
import java.util.Iterator;
import java.io.IOException;
import org.jboss.util.ThrowableHandler;
/**
* A more robust replacement of java.lang.System for property
* access.
*
* @version $Revision: 2787 $
* @author Jason Dillon
* @author Adrian Brock
*/
@SuppressWarnings("unchecked")
public final class PropertyManager
{
/** Property reader list property name */
public static final String READER_PROPERTY_NAME = "org.jboss.util.property.reader";
/** Token which specifies the default property reader */
public static final String DEFAULT_PROPERTY_READER_TOKEN = "DEFAULT";
/** The default property reader name array */
private static final String[] DEFAULT_PROPERTY_READERS = { DEFAULT_PROPERTY_READER_TOKEN };
/** Default property container */
private static PropertyMap props;
/**
* Do not allow instantiation of this class.
*/
private PropertyManager()
{
}
/**
* Initialize the property system.
*/
static
{
// construct default property container and initialze from system props
props = new PropertyMap();
PrivilegedAction action = new PrivilegedAction()
{
public Object run()
{
props.putAll(System.getProperties());
// replace system props to enable notifications via System.setProperty()
System.setProperties(props);
// load properties from initial property readers
String[] readerNames = getArrayProperty(READER_PROPERTY_NAME, DEFAULT_PROPERTY_READERS);
// construct each source and read its properties
for (int i = 0; i < readerNames.length; i++)
{
try
{
if (readerNames[i].equals(DEFAULT_PROPERTY_READER_TOKEN))
{
load(new DefaultPropertyReader());
}
else
{
load(readerNames[i]);
}
}
catch (IOException e)
{
ThrowableHandler.add(e);
}
}
return null;
}
};
AccessController.doPrivileged(action);
}
/**
* Get the default PropertyMap.
*
* @return Default PropertyMap.
*/
public static PropertyMap getDefaultPropertyMap()
{
SecurityManager sm = System.getSecurityManager();
if (sm != null)
sm.checkPropertiesAccess();
return props;
}
/**
* Add a property listener.
*
* @param listener Property listener to add.
*/
public static void addPropertyListener(final PropertyListener listener)
{
SecurityManager sm = System.getSecurityManager();
if (sm != null)
sm.checkPropertiesAccess();
props.addPropertyListener(listener);
}
/**
* Add an array of property listeners.
*
* @param listeners Array of property listeners to add.
*/
public static void addPropertyListeners(final PropertyListener[] listeners)
{
SecurityManager sm = System.getSecurityManager();
if (sm != null)
sm.checkPropertiesAccess();
props.addPropertyListeners(listeners);
}
/**
* Remove a property listener.
*
* @param listener Property listener to remove.
* @return True if listener was removed.
*/
public static boolean removePropertyListener(final PropertyListener listener)
{
return props.removePropertyListener(listener);
}
/**
* Load properties from a map.
*
* @param prefix Prefix to append to all map keys (or null).
* @param map Map containing properties to load.
* @throws PropertyException
*/
public static void load(final String prefix, final Map map) throws PropertyException
{
SecurityManager sm = System.getSecurityManager();
if (sm != null)
sm.checkPropertiesAccess();
props.load(prefix, map);
}
/**
* Load properties from a map.
*
* @param map Map containing properties to load.
* @throws PropertyException
* @throws IOException
*/
public static void load(final Map map) throws PropertyException, IOException
{
SecurityManager sm = System.getSecurityManager();
if (sm != null)
sm.checkPropertiesAccess();
props.load(map);
}
/**
* Load properties from a PropertyReader.
*
* @param reader PropertyReader to read properties from.
* @throws PropertyException
* @throws IOException
*/
public static void load(final PropertyReader reader) throws PropertyException, IOException
{
SecurityManager sm = System.getSecurityManager();
if (sm != null)
sm.checkPropertiesAccess();
props.load(reader);
}
/**
* Load properties from a PropertyReader specifed by the
* given class name.
*
* @param classname Class name of a PropertyReader to
* read from.
* @throws PropertyException
* @throws IOException
*/
public static void load(final String classname) throws PropertyException, IOException
{
SecurityManager sm = System.getSecurityManager();
if (sm != null)
sm.checkPropertiesAccess();
props.load(classname);
}
/**
* Set a property.
*
* @param name Property name.
* @param value Property value.
* @return Previous property value or null.
*/
public static String setProperty(final String name, final String value)
{
SecurityManager sm = System.getSecurityManager();
if (sm != null)
sm.checkPropertyAccess(name);
return (String) props.setProperty(name, value);
}
/**
* Remove a property.
*
* @param name Property name.
* @return Removed property value or null.
*/
public static String removeProperty(final String name)
{
SecurityManager sm = System.getSecurityManager();
if (sm != null)
sm.checkPropertyAccess(name);
return props.removeProperty(name);
}
/**
* Get a property.
*
* @param name Property name.
* @param defaultValue Default property value.
* @return Property value or default.
*/
public static String getProperty(final String name, final String defaultValue)
{
SecurityManager sm = System.getSecurityManager();
if (sm != null)
sm.checkPropertyAccess(name);
return props.getProperty(name, defaultValue);
}
/**
* Get a property.
*
* @param name Property name.
* @return Property value or null.
*/
public static String getProperty(final String name)
{
SecurityManager sm = System.getSecurityManager();
if (sm != null)
sm.checkPropertyAccess(name);
return props.getProperty(name);
}
/**
* Get an array style property.
*
* @param base Base property name.
* @param defaultValues Default property values.
* @return Array of property values or default.
*/
public static String[] getArrayProperty(final String base, final String[] defaultValues)
{
SecurityManager sm = System.getSecurityManager();
if (sm != null)
sm.checkPropertiesAccess();
return props.getArrayProperty(base, defaultValues);
}
/**
* Get an array style property.
*
* @param name Property name.
* @return Array of property values or empty array.
*/
public static String[] getArrayProperty(final String name)
{
SecurityManager sm = System.getSecurityManager();
if (sm != null)
sm.checkPropertyAccess(name);
return props.getArrayProperty(name);
}
/**
* Return an iterator over all contained property names.
*
* @return Property name iterator.
*/
public static Iterator names()
{
SecurityManager sm = System.getSecurityManager();
if (sm != null)
sm.checkPropertiesAccess();
return props.names();
}
/**
* Check if this map contains a given property.
*
* @param name Property name.
* @return True if contains property.
*/
public static boolean containsProperty(final String name)
{
SecurityManager sm = System.getSecurityManager();
if (sm != null)
sm.checkPropertyAccess(name);
return props.containsProperty(name);
}
/**
* Get a property group for the given property base.
*
* @param basename Base property name.
* @return Property group.
*/
public static PropertyGroup getPropertyGroup(final String basename)
{
SecurityManager sm = System.getSecurityManager();
if (sm != null)
sm.checkPropertiesAccess();
return props.getPropertyGroup(basename);
}
/**
* Get a property group for the given property base at the given index.
*
* @param basename Base property name.
* @param index Array property index.
* @return Property group.
*/
public static PropertyGroup getPropertyGroup(final String basename, final int index)
{
SecurityManager sm = System.getSecurityManager();
if (sm != null)
sm.checkPropertiesAccess();
return props.getPropertyGroup(basename, index);
}
}
././@LongLink 0000000 0000000 0000000 00000000163 00000000000 011565 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/BoundPropertyListener.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/BoundPropert0000644 0001750 0001750 00000004647 10470642610 033415 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.property;
/**
* The listener interface for receiving bound property events (as well as
* property events).
*
* Classes that are interested in processing a bound property event
* implement this interface, and register instance objects with a given
* {@link PropertyMap} or via
* {@link PropertyManager#addPropertyListener(PropertyListener)}.
*
* Note that this is not the typical listener interface, as it extends
* from {@link PropertyListener}, and defines {@link #getPropertyName()}
* which is not an event triggered method. This method serves to instruct
* the {@link PropertyMap} the listener is registered with, which property
* it will bind to.
*
* @version $Revision: 1958 $
* @author Jason Dillon
*/
public interface BoundPropertyListener
extends PropertyListener
{
/**
* Get the property name which this listener is bound to.
*
* @return Property name.
*/
String getPropertyName();
/**
* Notifies that this listener was bound to a property.
*
* @param map PropertyMap which contains property bound to.
*/
void propertyBound(PropertyMap map);
/**
* Notifies that this listener was unbound from a property.
*
* @param map PropertyMap which contains property bound to.
*/
void propertyUnbound(PropertyMap map);
}
././@LongLink 0000000 0000000 0000000 00000000151 00000000000 011562 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/PropertyMap.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/PropertyMap.0000644 0001750 0001750 00000052207 10774222622 033331 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.property;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.security.AccessController;
import java.security.PrivilegedAction;
import java.util.List;
import java.util.LinkedList;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.Map;
import java.util.HashMap;
import java.util.Set;
import java.util.HashSet;
import java.util.Collections;
import java.util.Properties;
import javax.naming.Context;
import javax.naming.ldap.LdapContext;
import org.jboss.util.NullArgumentException;
/**
* A replacement for the standard Returns Object instead of String due to limitations with
* Array properties are specified as:
* Indexes begin with zero and must be contiguous. A break in
* continuity signals the end of the array.
*
* @param base Base property name.
* @param defaultValues Default property values.
* @return Array of property values or default.
*/
public String[] getArrayProperty(String base, String[] defaultValues)
{
if (base == null)
throw new NullArgumentException("base");
// create a new list to store indexed values into
List list = new LinkedList();
int i = 0;
while (true)
{
// make the index property name
String name = makeIndexPropertyName(base, i);
// see if there is a value for this property
String value = getProperty(name);
if (value != null)
{
list.add(value);
}
else if (i >= 0)
{
break; // no more index properties
}
i++;
}
String values[] = defaultValues;
// if the list is not empty, then return it as an array
if (list.size() != 0)
{
values = (String[]) list.toArray(new String[list.size()]);
}
return values;
}
/**
* Get an array style property.
*
* @param name Property name.
* @return Array of property values or empty array.
*/
public String[] getArrayProperty(String name)
{
return getArrayProperty(name, EMPTY_ARRAY_PROPERTY);
}
/**
* Return an iterator over all contained property names.
*
* @return Property name iterator.
*/
public Iterator names()
{
return keySet().iterator();
}
/**
* Check if this map contains a given property.
*
* @param name Property name.
* @return True if contains property.
*/
public boolean containsProperty(String name)
{
return containsKey(name);
}
/**
* Get a property group for the given property base.
*
* @param basename Base property name.
* @return Property group.
*/
public PropertyGroup getPropertyGroup(String basename)
{
return new PropertyGroup(basename, this);
}
/**
* Get a property group for the given property base at the given index.
*
* @param basename Base property name.
* @param index Array property index.
* @return Property group.
*/
public PropertyGroup getPropertyGroup(String basename, int index)
{
String name = makeIndexPropertyName(basename, index);
return getPropertyGroup(name);
}
private void readObject(ObjectInputStream stream)
throws IOException, ClassNotFoundException
{
// reset the listener lists
init();
stream.defaultReadObject();
}
private void writeObject(ObjectOutputStream stream)
throws IOException
{
stream.defaultWriteObject();
}
}
././@LongLink 0000000 0000000 0000000 00000000171 00000000000 011564 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/MethodBoundPropertyListener.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/MethodBoundP0000644 0001750 0001750 00000014615 10774222622 033322 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.property;
import java.beans.BeanInfo;
import java.beans.IntrospectionException;
import java.beans.Introspector;
import java.beans.PropertyDescriptor;
import java.beans.PropertyEditor;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import org.jboss.util.ThrowableHandler;
import org.jboss.util.propertyeditor.PropertyEditors;
/**
* Binds property values to class methods.
*
* @version $Revision: 2787 $
* @author Jason Dillon
*/
public class MethodBoundPropertyListener
extends BoundPropertyAdapter
{
/** Property name which we are bound to */
protected final String propertyName;
/** Instance object that contains setter method */
protected final Object instance;
/** Property setter method */
protected final Method setter;
/** Property descriptor */
protected final PropertyDescriptor descriptor;
/**
* Construct a MethodBoundPropertyListener.
*
* @param instance Instance object that contains setter method.
* @param propertyName The name of the property which will be bound.
* @param beanPropertyName The name of the property setter method.
*
* @throws PropertyException
*/
public MethodBoundPropertyListener(final Object instance,
final String propertyName,
final String beanPropertyName)
{
this.instance = instance;
this.propertyName = propertyName;
try {
descriptor = getPropertyDescriptor(beanPropertyName);
if (descriptor == null) {
throw new PropertyException
("missing method for: " + beanPropertyName);
}
setter = descriptor.getWriteMethod();
if (setter == null) {
throw new PropertyException
("missing setter method for: " + beanPropertyName);
}
try {
setter.setAccessible(true);
}
catch (SecurityException e) {
ThrowableHandler.add(e);
}
}
catch (IntrospectionException e) {
throw new PropertyException(e);
}
}
/**
* Get the PropertyDescriptor for the given bean property name.
*
* @param beanPropertyName Bean property name.
* @return PropertyDescriptor.
*/
private PropertyDescriptor getPropertyDescriptor(final String beanPropertyName)
throws IntrospectionException
{
Class instanceType = instance.getClass();
BeanInfo beanInfo = Introspector.getBeanInfo(instanceType);
PropertyDescriptor descriptors[] = beanInfo.getPropertyDescriptors();
PropertyDescriptor descriptor = null;
for (int i=0; i Methods defined in this class are empty. This class exists as
* as convenience for creating listener objects.
*
* @version $Revision: 1958 $
* @author Jason Dillon
*/
public abstract class PropertyAdapter
implements PropertyListener
{
/**
* Notifies that a property was added.
*
* @param event Property event.
*/
public void propertyAdded(final PropertyEvent event) {}
/**
* Notifies that a property was removed.
*
* @param event Property event.
*/
public void propertyRemoved(final PropertyEvent event) {}
/**
* Notifies that a property has changed.
*
* @param event Property event.
*/
public void propertyChanged(final PropertyEvent event) {}
}
././@LongLink 0000000 0000000 0000000 00000000153 00000000000 011564 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/PropertyEvent.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/PropertyEven0000644 0001750 0001750 00000006130 10776226110 033423 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.property;
import java.util.EventObject;
import org.jboss.util.NullArgumentException;
/**
* A property event.
*
* @version $Revision: 2800 $
* @author Jason Dillon
*/
public class PropertyEvent
extends EventObject
{
/** The serialVersionUID */
private static final long serialVersionUID = -5007209897739884086L;
/** Property name. */
protected final String name;
/** Property value. */
protected final String value;
/**
* Construct a new PropertyEvent.
*
* @param source The source of the event.
* @param name The property name effected.
* @param value The value of the property effected.
*
* @throws NullArgumentException Name or source is null.
*/
public PropertyEvent(final Object source,
final String name,
final String value)
{
super(source);
if (name == null)
throw new NullArgumentException("name");
// value can be null
this.name = name;
this.value = value;
}
/**
* Construct a new PropertyEvent.
*
* @param source The source of the event.
* @param name The property name effected.
*
* @throws NullArgumentException Name or source is null.
*/
public PropertyEvent(Object source, String name) {
this(source, name, null);
}
/**
* Get the name of the property that is effected.
*
* @return Property name.
*/
public final String getPropertyName() {
return name;
}
/**
* Get the value of the property that is effected.
*
* @return The value of the property that is effected or null.
*/
public final String getPropertyValue() {
return value;
}
/**
* Return a string representation of this event.
*
* @return A string representation of this event.
*/
public String toString() {
return super.toString() +
"{ name=" + name +
", value=" + value +
" }";
}
}
././@LongLink 0000000 0000000 0000000 00000000170 00000000000 011563 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/FieldBoundPropertyListener.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/FieldBoundPr0000644 0001750 0001750 00000012430 10774222622 033300 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.property;
import org.jboss.util.FieldInstance;
import org.jboss.util.NullArgumentException;
import org.jboss.util.Classes;
import org.jboss.util.ThrowableHandler;
import org.jboss.util.propertyeditor.PropertyEditors;
import java.beans.PropertyEditor;
/**
* Binds property values to class fields.
*
* @version $Revision: 2787 $
* @author Jason Dillon
*/
public class FieldBoundPropertyListener
extends BoundPropertyAdapter
{
/** Property name which we are bound to */
protected final String propertyName;
/** Field instance */
protected final FieldInstance fieldInstance;
/**
* Constructs a FieldBoundPropertyListener.
*
* @param instance Instance object.
* @param fieldName Field name.
* @param propertyName Property to bind to.
*
* @throws NullArgumentException Property name is null.
*/
public FieldBoundPropertyListener(final Object instance,
final String fieldName,
final String propertyName)
{
if (propertyName == null)
throw new NullArgumentException("propertyName");
// FieldInstance checks instance & fieldName
this.propertyName = propertyName;
try {
// construct field instance
fieldInstance = new FieldInstance(instance, fieldName);
try {
fieldInstance.getField().setAccessible(true);
}
catch (SecurityException e) {
ThrowableHandler.add(e);
}
// force the given class to load, so that any CoersionHelpers
// that are nested in it are loaded properly
Classes.forceLoad(fieldInstance.getField().getType());
}
catch (NoSuchFieldException e) {
throw new PropertyException(e);
}
}
/**
* Constructs a FieldBoundPropertyListener.
*
* Field name is used for property name.
*
* @param instance Instance object.
* @param fieldName Field name.
*/
public FieldBoundPropertyListener(final Object instance,
final String fieldName)
{
this(instance, fieldName, fieldName);
}
/**
* Get the property name which this listener is bound to.
*
* @return Property name.
*/
public final String getPropertyName() {
return propertyName;
}
/**
* Filter the property value prior to coercing and binding to field.
*
* Allows instance to filter values prior to object coercion and
* field binding.
*
* @param value Property value.
* @return the filtered value
*/
public String filterValue(String value) {
return value;
}
/**
* Coerce and set specified value to field.
*
* @param value Field value.
*
* @throws PropertyException Failed to set field value.
*/
protected void setFieldValue(String value) {
try {
// filter property value
value = filterValue(value);
// coerce value to field type
Class type = fieldInstance.getField().getType();
PropertyEditor editor = PropertyEditors.findEditor(type);
editor.setAsText(value);
Object coerced = editor.getValue();
// bind value to field
fieldInstance.set(coerced);
}
catch (IllegalAccessException e) {
throw new PropertyException(e);
}
}
/**
* Notifies that a property has been added.
*
* @param event Property event.
*/
public void propertyAdded(final PropertyEvent event) {
setFieldValue(event.getPropertyValue());
}
/**
* Notifies that a property has changed
*
* @param event Property event
*/
public void propertyChanged(final PropertyEvent event) {
setFieldValue(event.getPropertyValue());
}
/**
* Notifies that this listener was bound to a property.
*
* @param map PropertyMap which contains property bound to.
*/
public void propertyBound(final PropertyMap map) {
// only set the field if the map contains the property already
if (map.containsProperty(propertyName)) {
setFieldValue(map.getProperty(propertyName));
}
}
}
././@LongLink 0000000 0000000 0000000 00000000157 00000000000 011570 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/PropertyContainer.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/PropertyCont0000644 0001750 0001750 00000012666 10776226110 033444 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.property;
import java.util.Properties;
/**
* Provides helper methods for working with instance or class properties.
*
* @version $Revision: 2800 $
* @author Jason Dillon
*/
public class PropertyContainer
extends PropertyMap
{
/** The serialVersionUID */
private static final long serialVersionUID = -3347198703863412326L;
/** The group name for this container. */
protected String groupname = " Classes that are interested in processing a property event implement
* this interface, and register instance objects with a given PropertyMap
* or the PropertyManager via Platform specific extentions to the Java programming language. Determines the version of the Java Virtual Machine by checking
* for the availablity of version specific classes.
*
* Classes are loaded in the following order:
* Currently does not support native access and generates random numbers
* for the process id.
*
* @version $Revision: 2800 $
* @author Jason Dillon
*/
public class PID
implements Serializable, Cloneable
{
/** The serialVersionUID */
private static final long serialVersionUID = -6837013326314943907L;
/** The int process identifier. */
protected final int id;
/**
* Construct a new PID.
*
* @param id Process identifier.
*/
protected PID(final int id) {
this.id = id;
}
/**
* Get the int process identifier.
*
* @return int process identifier.
*/
public final int getID() {
return id;
}
/**
* Return a string representation of this PID.
*
* @return A string representation of this PID.
*/
public String toString() {
return String.valueOf(id);
}
/**
* Return a string representation of this PID.
* @param radix
*
* @return A string representation of this PID.
*/
public String toString(int radix) {
return Integer.toString(id, radix);
}
/**
* Return the hash code of this PID.
*
* @return The hash code of this PID.
*/
public int hashCode() {
return id;
}
/**
* Check if the given object is equal to this PID.
*
* @param obj Object to test equality with.
* @return True if object is equals to this PID.
*/
public boolean equals(final Object obj) {
if (obj == this) return true;
if (obj != null && obj.getClass() == getClass()) {
PID pid = (PID)obj;
return pid.id == id;
}
return false;
}
/**
* Returns a copy of this PID.
*
* @return A copy of this PID.
*/
public Object clone() {
try {
return super.clone();
}
catch (CloneNotSupportedException e) {
throw new InternalError();
}
}
/////////////////////////////////////////////////////////////////////////
// Instance Access //
/////////////////////////////////////////////////////////////////////////
/** The single instance of PID for the running Virtual Machine */
private static PID instance = null;
/**
* Get the PID for the current virtual machine.
*
* @return Process identifier.
*/
public synchronized static PID getInstance() {
if (instance == null) {
instance = create();
}
return instance;
}
/**
* Create the PID for the current virtual mahcine.
*
* @return Process identifier.
*/
private static PID create() {
// for now just return a random integer.
int random = Math.abs(new Random().nextInt());
return new PID(random);
}
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/LRUCachePolicy.java 0000644 0001750 0001750 00000035425 11032707620 032570 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
import java.util.HashMap;
import java.util.Map;
/**
* Implementation of a Least Recently Used cache policy.
*
* @author Simone Bordet
* @version $Revision: 2883 $
*/
@SuppressWarnings("unchecked")
public class LRUCachePolicy
implements CachePolicy
{
// Constants -----------------------------------------------------
// Attributes ----------------------------------------------------
/**
* The map holding the cached objects
*/
protected Map m_map;
/**
* The linked list used to implement the LRU algorithm
*/
protected LRUList m_list;
/**
* The maximum capacity of this cache
*/
protected int m_maxCapacity;
/**
* The minimum capacity of this cache
*/
protected int m_minCapacity;
// Static --------------------------------------------------------
// Constructors --------------------------------------------------
/**
* Creates a LRU cache policy object with zero cache capacity.
*
* @see #create
*/
public LRUCachePolicy()
{
}
/**
* Creates a LRU cache policy object with the specified minimum
* and maximum capacity.
* @param min
* @param max
*
* @see #create
*/
public LRUCachePolicy(int min, int max)
{
if (min < 2 || min > max) {throw new IllegalArgumentException("Illegal cache capacities");}
m_minCapacity = min;
m_maxCapacity = max;
}
/**
* Create map holding entries.
*
* @return the map
*/
protected Map createMap()
{
return new HashMap();
}
// Public --------------------------------------------------------
// Service implementation ----------------------------------------------
/**
* Initializes the cache, creating all required objects and initializing their
* values.
* @see #start
* @see #destroy
*/
public void create()
{
m_map = createMap();
m_list = createList();
m_list.m_maxCapacity = m_maxCapacity;
m_list.m_minCapacity = m_minCapacity;
m_list.m_capacity = m_maxCapacity;
}
/**
* Starts this cache that is now ready to be used.
* @see #create
* @see #stop
*/
public void start()
{
}
/**
* Stops this cache thus {@link #flush}ing all cached objects. Modified from java.util.WeakHashMap.WeakKey.
*
* @version $Revision: 2787 $
* @author Jason Dillon
*/
@SuppressWarnings("unchecked")
public final class SoftObject
extends SoftReference
{
/** The hash code of the nested object */
protected final int hashCode;
/**
* Construct a SoftObject.
*
* @param obj Object to reference.
*/
public SoftObject(final Object obj) {
super(obj);
hashCode = obj.hashCode();
}
/**
* Construct a SoftObject.
*
* @param obj Object to reference.
* @param queue Reference queue.
*/
public SoftObject(final Object obj, final ReferenceQueue queue) {
super(obj, queue);
hashCode = obj.hashCode();
}
/**
* Check the equality of an object with this.
*
* @param obj Object to test equality with.
* @return True if object is equal.
*/
public boolean equals(final Object obj) {
if (obj == this) return true;
if (obj != null && obj.getClass() == getClass()) {
SoftObject soft = (SoftObject)obj;
Object a = this.get();
Object b = soft.get();
if (a == null || b == null) return false;
if (a == b) return true;
return a.equals(b);
}
return false;
}
/**
* Return the hash code of the nested object.
*
* @return The hash code of the nested object.
*/
public int hashCode() {
return hashCode;
}
/////////////////////////////////////////////////////////////////////////
// Factory Methods //
/////////////////////////////////////////////////////////////////////////
/**
* Create a SoftObject for the given object.
*
* @param obj Object to reference.
* @return SoftObject or null if object is null.
*/
public static SoftObject create(final Object obj) {
if (obj == null) return null;
else return new SoftObject(obj);
}
/**
* Create a SoftObject for the given object.
*
* @param obj Object to reference.
* @param queue Reference queue.
* @return SoftObject or null if object is null.
*/
public static SoftObject create(final Object obj,
final ReferenceQueue queue)
{
if (obj == null) return null;
else return new SoftObject(obj, queue);
}
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/collection/ 0000755 0001750 0001750 00000000000 11105642364 031305 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000167 00000000000 011571 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/collection/SerializableEnumeration.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/collection/Serializab0000644 0001750 0001750 00000004645 10776226110 033326 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.collection;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Enumeration;
import java.util.NoSuchElementException;
/**
* ???
*
* @author ???
* @version $Revision: 2800 $
*/
@SuppressWarnings("unchecked")
public class SerializableEnumeration
extends ArrayList
implements Enumeration
{
/** The serialVersionUID */
private static final long serialVersionUID = 8678951571196067510L;
private int index;
public SerializableEnumeration () {
index = 0;
}
public SerializableEnumeration (Collection c) {
super(c);
index = 0;
}
public SerializableEnumeration (int initialCapacity) {
super(initialCapacity);
index = 0;
}
public boolean hasMoreElements() {
return (index < size());
}
public Object nextElement() throws NoSuchElementException
{
try {
Object nextObj = get(index);
index++;
return nextObj;
}
catch (IndexOutOfBoundsException e) {
throw new NoSuchElementException();
}
}
private void writeObject(java.io.ObjectOutputStream out)
throws java.io.IOException
{
// the only thing to write is the index field
out.defaultWriteObject();
}
private void readObject(java.io.ObjectInputStream in)
throws java.io.IOException, ClassNotFoundException
{
in.defaultReadObject();
}
}
././@LongLink 0000000 0000000 0000000 00000000160 00000000000 011562 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/collection/WeakValueTreeMap.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/collection/WeakValueT0000644 0001750 0001750 00000003447 11103262257 033245 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.collection;
import java.lang.ref.ReferenceQueue;
import java.util.Comparator;
import java.util.SortedMap;
/**
* This Map will remove entries when the value in the map has been
* cleaned from garbage collection
*
* @author Ales Justin
*/
public class WeakValueTreeMap Based on java.util.WeakHashMap
*
* @param t mappings to be stored in this map.
* @throws NullPointerException if the specified map is null.
*/
public void putAll(Map t) {
// Expand enough to hold t's elements without resizing.
int n = t.size();
if (n == 0)
return;
if (n >= threshold) {
n = (int)(n / loadFactor + 1);
if (n > MAXIMUM_CAPACITY)
n = MAXIMUM_CAPACITY;
int capacity = table.length;
while (capacity < n)
capacity <<= 1;
resize(capacity);
}
for (Iterator i = t.entrySet().iterator(); i.hasNext(); ) {
Map.Entry e = (Map.Entry) i.next();
put(e.getKey(), e.getValue());
}
}
/**
* Removes the mapping for this key from this map if present.
*
* @param key key whose mapping is to be removed from the map.
* @return previous value associated with specified key, or null
* if there was no mapping for key. A null return can
* also indicate that the map previously associated null
* with the specified key.
*/
public Object remove(Object key) {
Object k = maskNull(key);
int h = hash(k);
Entry[] tab = getTable();
int i = indexFor(h, tab.length);
Entry prev = tab[i];
Entry e = prev;
while (e != null) {
Entry next = e.next;
if (h == e.hash && k == e.get()) {
modCount++;
size--;
if (prev == e)
tab[i] = next;
else
prev.next = next;
return e.value;
}
prev = e;
e = next;
}
return null;
}
/** Special version of remove needed by Entry set */
Entry removeMapping(Object o) {
if (!(o instanceof Map.Entry))
return null;
Entry[] tab = getTable();
Map.Entry entry = (Map.Entry)o;
Object k = maskNull(entry.getKey());
int h = hash(k);
int i = indexFor(h, tab.length);
Entry prev = tab[i];
Entry e = prev;
while (e != null) {
Entry next = e.next;
if (h == e.hash && e.equals(entry)) {
modCount++;
size--;
if (prev == e)
tab[i] = next;
else
prev.next = next;
return e;
}
prev = e;
e = next;
}
return null;
}
/**
* Removes all mappings from this map.
*/
public void clear() {
// clear out ref queue. We don't need to expunge entries
// since table is getting cleared.
while (queue.poll() != null)
;
modCount++;
Entry tab[] = table;
for (int i = 0; i < tab.length; ++i)
tab[i] = null;
size = 0;
// Allocation of array may have caused GC, which may have caused
// additional entries to go stale. Removing these entries from the
// reference queue will make them eligible for reclamation.
while (queue.poll() != null)
;
}
/**
* Returns true if this map maps one or more keys to the
* specified value.
*
* @param value value whose presence in this map is to be tested.
* @return true if this map maps one or more keys to the
* specified value.
*/
public boolean containsValue(Object value) {
if (value==null)
return containsNullValue();
Entry tab[] = getTable();
for (int i = tab.length ; i-- > 0 ;)
for (Entry e = tab[i] ; e != null ; e = e.next)
if (value.equals(e.value))
return true;
return false;
}
/**
* Special-case code for containsValue with null argument
*/
private boolean containsNullValue() {
Entry tab[] = getTable();
for (int i = tab.length ; i-- > 0 ;)
for (Entry e = tab[i] ; e != null ; e = e.next)
if (e.value==null)
return true;
return false;
}
/**
* The entries in this hash table extend WeakReference, using its main ref
* field as the key.
*/
private static class Entry extends WeakReference implements Map.Entry {
private Object value;
private final int hash;
private Entry next;
/**
* Create new entry.
*/
Entry(Object key, Object value, ReferenceQueue queue,
int hash, Entry next) {
super(key, queue);
this.value = value;
this.hash = hash;
this.next = next;
}
public Object getKey() {
return unmaskNull(this.get());
}
public Object getValue() {
return value;
}
public Object setValue(Object newValue) {
Object oldValue = value;
value = newValue;
return oldValue;
}
public boolean equals(Object o) {
if (!(o instanceof Map.Entry))
return false;
Map.Entry e = (Map.Entry)o;
Object k1 = getKey();
Object k2 = e.getKey();
if (k1 == k2) {
Object v1 = getValue();
Object v2 = e.getValue();
if (v1 == v2 || (v1 != null && v1.equals(v2)))
return true;
}
return false;
}
public int hashCode() {
Object k = getKey();
Object v = getValue();
return ((k==null ? 0 : System.identityHashCode(k)) ^
(v==null ? 0 : v.hashCode()));
}
public String toString() {
return getKey() + "=" + getValue();
}
}
private abstract class HashIterator implements Iterator {
int index;
Entry entry = null;
Entry lastReturned = null;
int expectedModCount = modCount;
/**
* Strong reference needed to avoid disappearance of key
* between hasNext and next
*/
Object nextKey = null;
/**
* Strong reference needed to avoid disappearance of key
* between nextEntry() and any use of the entry
*/
Object currentKey = null;
HashIterator() {
index = (size() != 0 ? table.length : 0);
}
public boolean hasNext() {
Entry[] t = table;
while (nextKey == null) {
Entry e = entry;
int i = index;
while (e == null && i > 0)
e = t[--i];
entry = e;
index = i;
if (e == null) {
currentKey = null;
return false;
}
nextKey = e.get(); // hold on to key in strong ref
if (nextKey == null)
entry = entry.next;
}
return true;
}
protected Entry nextEntry() {
if (modCount != expectedModCount)
throw new ConcurrentModificationException();
if (nextKey == null && !hasNext())
throw new NoSuchElementException();
lastReturned = entry;
entry = entry.next;
currentKey = nextKey;
nextKey = null;
return lastReturned;
}
public void remove() {
if (lastReturned == null)
throw new IllegalStateException();
if (modCount != expectedModCount)
throw new ConcurrentModificationException();
WeakIdentityHashMap.this.remove(currentKey);
expectedModCount = modCount;
lastReturned = null;
currentKey = null;
}
}
private class ValueIterator extends HashIterator {
public Object next() {
return nextEntry().value;
}
}
private class KeyIterator extends HashIterator {
public Object next() {
return nextEntry().getKey();
}
}
private class EntryIterator extends HashIterator {
public Object next() {
return nextEntry();
}
}
// Views
private transient Set entrySet = null;
/**
* Returns a set view of the keys contained in this map. The set is
* backed by the map, so changes to the map are reflected in the set, and
* vice-versa. The set supports element removal, which removes the
* corresponding mapping from this map, via the Iterator.remove,
* Set.remove, removeAll, retainAll, and
* clear operations. It does not support the add or
* addAll operations.
*
* @return a set view of the keys contained in this map.
*/
public Set keySet() {
Set ks = keySet;
return (ks != null ? ks : (keySet = new KeySet()));
}
private class KeySet extends AbstractSet {
public Iterator iterator() {
return new KeyIterator();
}
public int size() {
return WeakIdentityHashMap.this.size();
}
public boolean contains(Object o) {
return containsKey(o);
}
public boolean remove(Object o) {
if (containsKey(o)) {
WeakIdentityHashMap.this.remove(o);
return true;
}
else
return false;
}
public void clear() {
WeakIdentityHashMap.this.clear();
}
public Object[] toArray() {
Collection c = new ArrayList(size());
for (Iterator i = iterator(); i.hasNext(); )
c.add(i.next());
return c.toArray();
}
public Object[] toArray(Object a[]) {
Collection c = new ArrayList(size());
for (Iterator i = iterator(); i.hasNext(); )
c.add(i.next());
return c.toArray(a);
}
}
/**
* Returns a collection view of the values contained in this map. The
* collection is backed by the map, so changes to the map are reflected in
* the collection, and vice-versa. The collection supports element
* removal, which removes the corresponding mapping from this map, via the
* Iterator.remove, Collection.remove,
* removeAll, retainAll, and clear operations.
* It does not support the add or addAll operations.
*
* @return a collection view of the values contained in this map.
*/
public Collection values() {
Collection vs = values;
return (vs != null ? vs : (values = new Values()));
}
private class Values extends AbstractCollection {
public Iterator iterator() {
return new ValueIterator();
}
public int size() {
return WeakIdentityHashMap.this.size();
}
public boolean contains(Object o) {
return containsValue(o);
}
public void clear() {
WeakIdentityHashMap.this.clear();
}
public Object[] toArray() {
Collection c = new ArrayList(size());
for (Iterator i = iterator(); i.hasNext(); )
c.add(i.next());
return c.toArray();
}
public Object[] toArray(Object a[]) {
Collection c = new ArrayList(size());
for (Iterator i = iterator(); i.hasNext(); )
c.add(i.next());
return c.toArray(a);
}
}
/**
* Returns a collection view of the mappings contained in this map. Each
* element in the returned collection is a Map.Entry. The
* collection is backed by the map, so changes to the map are reflected in
* the collection, and vice-versa. The collection supports element
* removal, which removes the corresponding mapping from the map, via the
* Iterator.remove, Collection.remove,
* removeAll, retainAll, and clear operations.
* It does not support the add or addAll operations.
*
* @return a collection view of the mappings contained in this map.
* @see java.util.Map.Entry
*/
public Set entrySet() {
Set es = entrySet;
return (es != null ? es : (entrySet = new EntrySet()));
}
private class EntrySet extends AbstractSet {
public Iterator iterator() {
return new EntryIterator();
}
public boolean contains(Object o) {
if (!(o instanceof Map.Entry))
return false;
Map.Entry e = (Map.Entry)o;
Entry candidate = getEntry(e.getKey());
return candidate != null && candidate.equals(e);
}
public boolean remove(Object o) {
return removeMapping(o) != null;
}
public int size() {
return WeakIdentityHashMap.this.size();
}
public void clear() {
WeakIdentityHashMap.this.clear();
}
public Object[] toArray() {
Collection c = new ArrayList(size());
for (Iterator i = iterator(); i.hasNext(); )
c.add(new SimpleEntry((Map.Entry) i.next()));
return c.toArray();
}
public Object[] toArray(Object a[]) {
Collection c = new ArrayList(size());
for (Iterator i = iterator(); i.hasNext(); )
c.add(new SimpleEntry((Map.Entry) i.next()));
return c.toArray(a);
}
}
static class SimpleEntry implements Map.Entry {
Object key;
Object value;
public SimpleEntry(Object key, Object value) {
this.key = key;
this.value = value;
}
public SimpleEntry(Map.Entry e) {
this.key = e.getKey();
this.value = e.getValue();
}
public Object getKey() {
return key;
}
public Object getValue() {
return value;
}
public Object setValue(Object value) {
Object oldValue = this.value;
this.value = value;
return oldValue;
}
public boolean equals(Object o) {
if (!(o instanceof Map.Entry))
return false;
Map.Entry e = (Map.Entry)o;
return eq(key, e.getKey()) && eq(value, e.getValue());
}
public int hashCode() {
return ((key == null) ? 0 : key.hashCode()) ^
((value == null) ? 0 : value.hashCode());
}
public String toString() {
return key + "=" + value;
}
private static boolean eq(Object o1, Object o2) {
return (o1 == null ? o2 == null : o1.equals(o2));
}
}
}
././@LongLink 0000000 0000000 0000000 00000000155 00000000000 011566 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/collection/AbstractQueue.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/collection/AbstractQu0000644 0001750 0001750 00000010436 10774222622 033307 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.collection;
import java.util.AbstractCollection;
/**
* An abstract implementation of a Queue. Sub-classes must provide methods
* for Package Specification
Related Documentation
Package Status
Todo
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/graph/ 0000755 0001750 0001750 00000000000 11105642363 030252 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000145 00000000000 011565 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/graph/DFSVisitor.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/graph/DFSVisitor.java0000644 0001750 0001750 00000003350 10774222622 033115 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2006, Red Hat Middleware LLC, and individual contributors
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.graph;
/**
* A spanning tree visitor callback interface
*
* @see Graph#dfsSpanningTree(Vertex, DFSVisitor)
*
* @author Scott.Stark@jboss.org
* @version $Revision$
* @param period
* milliseconds.
* If the TimerTask is executing it will prevent the next execution (if any).
* @return true if one or more scheduled execution will not take place,
* false otherwise.
*/
public boolean cancel()
{
synchronized (getLock())
{
boolean ret = (m_state == SCHEDULED);
m_state = CANCELLED;
return ret;
}
}
// Executable implementation ---------------------------------------
/**
* The task to be executed, to be implemented in subclasses.
*/
public abstract void execute() throws Exception;
// Comparable implementation ---------------------------------------
/**
* A TimerTask is less than another if it will be scheduled before.
* @throws ClassCastException if other is not a TimerTask, according to the Comparable contract
*/
public int compareTo(Object other)
{
if (other == this) return 0;
TimerTask t = (TimerTask) other;
long diff = getNextExecutionTime() - t.getNextExecutionTime();
return (int) diff;
}
/** Returns the mutex that syncs the access to this object */
Object getLock()
{
return m_lock;
}
/** Sets the state of execution of this TimerTask */
void setState(int state)
{
synchronized (getLock())
{
m_state = state;
}
}
/** Returns the state of execution of this TimerTask */
int getState()
{
synchronized (getLock())
{
return m_state;
}
}
/** Returns whether this TimerTask is periodic */
boolean isPeriodic()
{
return m_period > 0;
}
/** Returns the next execution time for this TimerTask */
long getNextExecutionTime()
{
synchronized (getLock())
{
return m_nextExecutionTime;
}
}
/** Sets the next execution time for this TimerTask */
void setNextExecutionTime(long time)
{
synchronized (getLock())
{
m_nextExecutionTime = time;
}
}
/** @return the period of this TimerTask */
protected long getPeriod()
{
return m_period;
}
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/Null.java 0000644 0001750 0001750 00000004604 10776226110 030733 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
import java.io.Serializable;
/**
* A class that represents null.
*
*
// The non-Serializable object to bind
Object nonserializable = ...;
// An arbitrary key to use in the StringRefAddr. The best key is the jndi
// name that the object will be bound under.
String key = ...;
// This places nonserializable into the NonSerializableFactory hashmap under key
NonSerializableFactory.rebind(key, nonserializable);
Context ctx = new InitialContext();
// Bind a reference to nonserializable using NonSerializableFactory as the ObjectFactory
String className = nonserializable.getClass().getName();
String factory = NonSerializableFactory.class.getName();
StringRefAddr addr = new StringRefAddr("nns", key);
Reference memoryRef = new Reference(className, addr, factory, null);
ctx.rebind(key, memoryRef);
*
* Or you can use the {@link #rebind(Context, String, Object)} convenience
* method to simplify the number of steps to:
*
Context ctx = new InitialContext();
// The non-Serializable object to bind
Object nonserializable = ...;
// The jndiName that the object will be bound into ctx with
String jndiName = ...;
// This places nonserializable into the NonSerializableFactory hashmap under key
NonSerializableFactory.rebind(ctx, jndiName, nonserializable);
*
* To unbind the object, use the following code snippet:
*
new InitialContext().unbind(key);
NonSerializableFactory.unbind(key);
*
* @see javax.naming.spi.ObjectFactory
* @see #rebind(Context, String, Object)
*
* @author Scott Stark.
* @version $Revision: 2787 $
*/
@SuppressWarnings("unchecked")
public class NonSerializableFactory implements ObjectFactory
{
private static Map wrapperMap = Collections.synchronizedMap(new HashMap());
/** Place an object into the NonSerializableFactory namespace for subsequent
access by getObject. There cannot be an already existing binding for key.
@param key the name to bind target under. This should typically be the
name that will be used to bind target in the JNDI namespace, but it does
not have to be.
@param target the non-Serializable object to bind.
@throws NameAlreadyBoundException thrown if key already exists in the
NonSerializableFactory map
*/
public static synchronized void bind(String key, Object target) throws NameAlreadyBoundException
{
if( wrapperMap.containsKey(key) == true )
throw new NameAlreadyBoundException(key+" already exists in the NonSerializableFactory map");
wrapperMap.put(key, target);
}
/** Place or replace an object in the NonSerializableFactory namespce
for subsequent access by getObject. Any existing binding for key will be
replaced by target.
@param key the name to bind target under. This should typically be the
name that will be used to bind target in the JNDI namespace, but it does
not have to be.
@param target the non-Serializable object to bind.
*/
public static void rebind(String key, Object target)
{
wrapperMap.put(key, target);
}
/** Remove a binding from the NonSerializableFactory map.
@param key the key into the NonSerializableFactory map to remove.
@throws NameNotFoundException thrown if key does not exist in the
NonSerializableFactory map
*/
public static void unbind(String key) throws NameNotFoundException
{
if( wrapperMap.remove(key) == null )
throw new NameNotFoundException(key+" was not found in the NonSerializableFactory map");
}
/** Remove a binding from the NonSerializableFactory map.
@param name the name for the key into NonSerializableFactory map to remove.
The key is obtained as name.toString().
@throws NameNotFoundException thrown if key does not exist in the
NonSerializableFactory map
*/
public static void unbind(Name name) throws NameNotFoundException
{
String key = name.toString();
if( wrapperMap.remove(key) == null )
throw new NameNotFoundException(key+" was not found in the NonSerializableFactory map");
}
/** Lookup a value from the NonSerializableFactory map.
* @param key
@return the object bound to key is one exists, null otherwise.
*/
public static Object lookup(String key)
{
Object value = wrapperMap.get(key);
return value;
}
/** Lookup a value from the NonSerializableFactory map.
* @param name
@return the object bound to key is one exists, null otherwise.
*/
public static Object lookup(Name name)
{
String key = name.toString();
Object value = wrapperMap.get(key);
return value;
}
/** A convience method that simplifies the process of rebinding a
non-zerializable object into a JNDI context.
@param ctx the JNDI context to rebind to.
@param key the key to use in both the NonSerializableFactory map and JNDI. It
must be a valid name for use in ctx.bind().
@param target the non-Serializable object to bind.
@throws NamingException thrown on failure to rebind key into ctx.
*/
public static synchronized void rebind(Context ctx, String key, Object target) throws NamingException
{
NonSerializableFactory.rebind(key, target);
// Bind a reference to target using NonSerializableFactory as the ObjectFactory
String className = target.getClass().getName();
String factory = NonSerializableFactory.class.getName();
StringRefAddr addr = new StringRefAddr("nns", key);
Reference memoryRef = new Reference(className, addr, factory, null);
ctx.rebind(key, memoryRef);
}
/** A convience method that simplifies the process of rebinding a
non-zerializable object into a JNDI context. This version binds the
target object into the default IntitialContext using name path.
@param name the name to use as JNDI path name. The key into the
NonSerializableFactory map is obtained from the toString() value of name.
The name parameter cannot be a 0 length name.
Any subcontexts between the root and the name must exist.
@param target the non-Serializable object to bind.
@throws NamingException thrown on failure to rebind key into ctx.
*/
public static synchronized void rebind(Name name, Object target) throws NamingException
{
rebind(name, target, false);
}
/** A convience method that simplifies the process of rebinding a
non-zerializable object into a JNDI context. This version binds the
target object into the default IntitialContext using name path.
@param name the name to use as JNDI path name. The key into the
NonSerializableFactory map is obtained from the toString() value of name.
The name parameter cannot be a 0 length name.
@param target the non-Serializable object to bind.
@param createSubcontexts a flag indicating if subcontexts of name should
be created if they do not already exist.
@throws NamingException thrown on failure to rebind key into ctx.
*/
public static synchronized void rebind(Name name, Object target,
boolean createSubcontexts) throws NamingException
{
String key = name.toString();
InitialContext ctx = new InitialContext();
if( createSubcontexts == true && name.size() > 1 )
{
int size = name.size() - 1;
Util.createSubcontext(ctx, name.getPrefix(size));
}
rebind(ctx, key, target);
}
// --- Begin ObjectFactory interface methods
/** Transform the obj Reference bound into the JNDI namespace into the
actual non-Serializable object.
@param obj the object bound in the JNDI namespace. This must be an implementation
of javax.naming.Reference with a javax.naming.RefAddr of type "nns" whose
content is the String key used to location the non-Serializable object in the
NonSerializableFactory map.
@param name ignored.
@param nameCtx ignored.
@param env ignored.
@return the non-Serializable object associated with the obj Reference if one
exists, null if one does not.
*/
public Object getObjectInstance(Object obj, Name name, Context nameCtx, Hashtable env)
throws Exception
{ // Get the nns value from the Reference obj and use it as the map key
Reference ref = (Reference) obj;
RefAddr addr = ref.get("nns");
String key = (String) addr.getContent();
Object target = wrapperMap.get(key);
return target;
}
// --- End ObjectFactory interface methods
}
././@LongLink 0000000 0000000 0000000 00000000150 00000000000 011561 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/UnexpectedThrowable.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/UnexpectedThrowable.j0000644 0001750 0001750 00000004572 10776226110 033311 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
/**
* Thrown to indicate that a Throwable was caught but was not expected.
* This is typical when catching Throwables to handle and rethrow Exceptions
* and Errors.
*
* @version $Revision: 2800 $
* @author Jason Dillon
*/
public class UnexpectedThrowable
extends NestedError
{
/** The serialVersionUID */
private static final long serialVersionUID = 4318032849691437298L;
/**
* Construct a UnexpectedThrowable with the specified
* detail message.
*
* @param msg Detail message.
*/
public UnexpectedThrowable(final String msg) {
super(msg);
}
/**
* Construct a UnexpectedThrowable with the specified
* detail message and nested Throwable.
*
* @param msg Detail message.
* @param nested Nested Throwable.
*/
public UnexpectedThrowable(final String msg, final Throwable nested) {
super(msg, nested);
}
/**
* Construct a UnexpectedThrowable with the specified
* nested Throwable.
*
* @param nested Nested Throwable.
*/
public UnexpectedThrowable(final Throwable nested) {
super(nested);
}
/**
* Construct a UnexpectedThrowable with no detail.
*/
public UnexpectedThrowable() {
super();
}
}
././@LongLink 0000000 0000000 0000000 00000000146 00000000000 011566 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/ThrowableListener.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/ThrowableListener.jav0000644 0001750 0001750 00000002734 10470642610 033315 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
import java.util.EventListener;
/**
* An interface used to handle Throwable events.
*
* @version $Revision: 1958 $
* @author Jason Dillon
*/
public interface ThrowableListener
extends EventListener
{
/**
* Process a throwable.
*
* @param type The type off the throwable.
* @param t Throwable
*/
void onThrowable(int type, Throwable t);
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/Executable.java 0000644 0001750 0001750 00000002432 10774222622 032101 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
/**
* Interface for the execution of a task.
*
* @see WorkerQueue
*
* @author Simone Bordet
* @version $Revision: 2787 $
*/
public interface Executable
{
void execute() throws Exception;
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/CachePolicy.java 0000644 0001750 0001750 00000006625 10774222622 032213 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
/**
* Interface that specifies a policy for caches.
* Implementations of this method must have complexity of order O(1).
* Differently from {@link #peek} this method not only return whether
* the object is present in the cache or not, but also
* applies the implemented policy that will "refresh" the cached
* object in the cache, because this cached object
* was really requested.
*
* @param key the key paired with the object
* @return the object
* @see #peek
*/
Object get(Object key);
/**
* Returns the object paired with the specified key if it's
* present in the cache, otherwise must return null.
* Implementations of this method must have complexity of order O(1).
* This method should not apply the implemented caching policy to the
* object paired with the given key, so that a client can
* query if an object is cached without "refresh" its cache status. Real
* requests for the object must be done using {@link #get}.
*
* @param key the key paired with the object
* @see #get
* @return the object
*/
Object peek(Object key);
/**
* Inserts the specified object into the cache following the
* implemented policy.
* Implementations of this method must have complexity of order O(1).
*
* @param key the key paired with the object
* @param object the object to cache
* @see #remove
*/
void insert(Object key, Object object);
/**
* Remove the cached object paired with the specified key.
* Implementations of this method must have complexity of order O(1).
*
* @param key the key paired with the object
* @see #insert
*/
void remove(Object key);
/**
* Flushes the cached objects from the cache.
*/
void flush();
/**
* @return the size of the cache
*/
int size();
void create() throws Exception;
void start() throws Exception;
void stop();
void destroy();
}
././@LongLink 0000000 0000000 0000000 00000000152 00000000000 011563 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/NoSuchMethodException.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/NoSuchMethodException0000644 0001750 0001750 00000005730 10776226110 033321 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
import java.lang.reflect.Method;
/**
* A better NoSuchMethodException which can take a Method object
* and formats the detail message based on in.
*
* @version $Revision: 2800 $
* @author Jason Dillon
*/
public class NoSuchMethodException
extends java.lang.NoSuchMethodException
{
/** The serialVersionUID */
private static final long serialVersionUID = -3044955578250977290L;
/**
* Construct a NoSuchMethodException with the specified detail
* message.
*
* @param msg Detail message.
*/
public NoSuchMethodException(String msg) {
super(msg);
}
/**
* Construct a NoSuchMethodException using the given method
* object to construct the detail message.
*
* @param method Method to determine detail message from.
*/
public NoSuchMethodException(Method method) {
super(format(method));
}
/**
* Construct a NoSuchMethodException using the given method
* object to construct the detail message.
*
* @param msg Detail message prefix.
* @param method Method to determine detail message suffix from.
*/
public NoSuchMethodException(String msg, Method method) {
super(msg + format(method));
}
/**
* Construct a NoSuchMethodException with no detail.
*/
public NoSuchMethodException() {
super();
}
public static String format(Method method)
{
StringBuffer buffer = new StringBuffer();
buffer.append(method.getName()).append("(");
Class[] paramTypes = method.getParameterTypes();
for (int count = 0; count < paramTypes.length; count++) {
if (count > 0) {
buffer.append(",");
}
buffer.
append(paramTypes[count].getName().substring(paramTypes[count].getName().lastIndexOf(".")+1));
}
buffer.append(")");
return buffer.toString();
}
}
././@LongLink 0000000 0000000 0000000 00000000152 00000000000 011563 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/NullArgumentException.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/NullArgumentException0000644 0001750 0001750 00000006541 10776226110 033377 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
/**
* Thrown to indicate that a method argument was null and
* should not have been.
*
* @version $Revision: 2800 $
* @author Jason Dillon
*/
public class NullArgumentException
extends IllegalArgumentException
{
/** The serialVersionUID */
private static final long serialVersionUID = -2308503249278841584L;
/** The name of the argument that was null. */
protected final String name;
/** The index of the argument or null if no index. */
protected final Object index;
/**
* Construct a NullArgumentException.
*
* @param name Argument name.
*/
public NullArgumentException(final String name) {
super(makeMessage(name));
this.name = name;
this.index = null;
}
/**
* Construct a NullArgumentException.
*
* @param name Argument name.
* @param index Argument index.
*/
public NullArgumentException(final String name, final long index) {
super(makeMessage(name, new Long(index)));
this.name = name;
this.index = new Long(index);
}
/**
* Construct a NullArgumentException.
*
* @param name Argument name.
* @param index Argument index.
*/
public NullArgumentException(final String name, final Object index) {
super(makeMessage(name, index));
this.name = name;
this.index = index;
}
/**
* Construct a NullArgumentException.
*/
public NullArgumentException() {
this.name = null;
this.index = null;
}
/**
* Get the argument name that was null.
*
* @return The argument name that was null.
*/
public final String getArgumentName() {
return name;
}
/**
* Get the argument index.
*
* @return The argument index.
*/
public final Object getArgumentIndex() {
return index;
}
/**
* Make a execption message for the argument name.
*/
private static String makeMessage(final String name) {
return "'" + name + "' is null";
}
/**
* Make a execption message for the argument name and index
*/
private static String makeMessage(final String name, final Object index) {
return "'" + name + "[" + index + "]' is null";
}
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/NestedThrowable.java 0000644 0001750 0001750 00000017540 10774222622 033120 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
import java.io.PrintWriter;
import java.io.PrintStream;
import java.io.Serializable;
import org.jboss.logging.Logger;
import org.jboss.util.platform.Java;
/**
* Interface which is implemented by all the nested throwable flavors.
*
* @version $Revision: 2787 $
* @author Jason Dillon
*/
public interface NestedThrowable
extends Serializable
{
/**
* A system wide flag to enable or disable printing of the
* parent throwable traces.
*
* NestedThrowable.
*/
final class Util
{
// Can not be final due to init bug, see getLogger() for details
private static Logger log = Logger.getLogger(NestedThrowable.class);
/**
* Something is very broken with class nesting, which can sometimes
* leave log uninitialized durring one of the following method calls.
*
* Throwable.
*
* @param msg Detail message.
* @param nested Nested Throwable.
* @return Formatted message.
*/
public static String getMessage(final String msg,
final Throwable nested)
{
StringBuffer buff = new StringBuffer(msg == null ? "" : msg);
if (nested != null) {
buff.append(msg == null ? "- " : "; - ")
.append("nested throwable: (")
.append(nested)
.append(")");
}
return buff.toString();
}
/**
* Prints the nested Throwable to the given stream.
*
* @param nested Nested Throwable.
* @param stream Stream to print to.
*/
public static void print(final Throwable nested,
final PrintStream stream)
{
if (stream == null)
throw new NullArgumentException("stream");
if (NestedThrowable.NESTED_TRACE_ENABLED && nested != null) {
synchronized (stream) {
if (NestedThrowable.PARENT_TRACE_ENABLED) {
stream.print(" + nested throwable: ");
}
else {
stream.print("[ parent trace omitted ]: ");
}
nested.printStackTrace(stream);
}
}
}
/**
* Prints the nested Throwable to the given writer.
*
* @param nested Nested Throwable.
* @param writer Writer to print to.
*/
public static void print(final Throwable nested,
final PrintWriter writer)
{
if (writer == null)
throw new NullArgumentException("writer");
if (NestedThrowable.NESTED_TRACE_ENABLED && nested != null) {
synchronized (writer) {
if (NestedThrowable.PARENT_TRACE_ENABLED) {
writer.print(" + nested throwable: ");
}
else {
writer.print("[ parent trace omitted ]: ");
}
nested.printStackTrace(writer);
}
}
}
}
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/file/ 0000755 0001750 0001750 00000000000 11105642363 030070 5 ustar twerner twerner libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/file/JarUtils.java 0000644 0001750 0001750 00000033164 10774222622 032502 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.file;
import java.io.BufferedInputStream;
import java.io.BufferedOutputStream;
import java.io.File;
import java.io.FileFilter;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.net.JarURLConnection;
import java.net.URL;
import java.net.URLConnection;
import java.util.jar.JarInputStream;
import java.util.jar.JarOutputStream;
import java.util.jar.Manifest;
import java.util.zip.ZipEntry;
/** A utility class for dealing with Jar files.
@author Scott.Stark@jboss.org
@version $Revision: 2787 $
*/
public final class JarUtils
{
/**
* Hide the constructor
*/
private JarUtils()
{
}
/**
*
* jar(out, new File[] { src }, null, null, null);
* jar(out, src, null, null, null);
* jar(out, src, filter, null, null);Package Specification
Related Documentation
Package Status
Todo
././@LongLink 0000000 0000000 0000000 00000000154 00000000000 011565 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/SynchronizedCachePolicy.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/SynchronizedCachePoli0000644 0001750 0001750 00000004671 10470642610 033332 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
/**
* A synchronized cache policy wrapper.
*
* @author Julien Viet
* @version $Revision: 1958 $
* @see CachePolicy
*/
public final class SynchronizedCachePolicy
implements CachePolicy
{
// Attributes ----------------------------------------------------
private final CachePolicy delegate;
// Constructors --------------------------------------------------
public SynchronizedCachePolicy(CachePolicy delegate)
{
this.delegate = delegate;
}
// CachePolicy implementation ------------------------------------
synchronized public Object get(Object key)
{
return delegate.get(key);
}
synchronized public Object peek(Object key)
{
return delegate.get(key);
}
synchronized public void insert(Object key, Object object)
{
delegate.insert(key, object);
}
synchronized public void remove(Object key)
{
delegate.remove(key);
}
synchronized public void flush()
{
delegate.flush();
}
synchronized public int size()
{
return delegate.size();
}
synchronized public void create() throws Exception
{
delegate.create();
}
synchronized public void start() throws Exception
{
delegate.start();
}
synchronized public void stop()
{
delegate.stop();
}
synchronized public void destroy()
{
delegate.destroy();
}
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/NestedError.java 0000644 0001750 0001750 00000010120 10776226110 032243 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
import java.io.PrintWriter;
import java.io.PrintStream;
/**
* A common superclass for Error classes that can
* contain a nested Throwable detail object.
*
* @version $Revision: 2800 $
* @author Jason Dillon
*/
public class NestedError
extends Error
implements NestedThrowable
{
/** The serialVersionUID */
private static final long serialVersionUID = -4135571897343827853L;
/** The nested throwable */
protected final Throwable nested;
/**
* Construct a NestedError with the specified
* detail message.
*
* @param msg Detail message.
*/
public NestedError(final String msg) {
super(msg);
this.nested = null;
}
/**
* Construct a NestedError with the specified
* detail message and nested Throwable.
*
* @param msg Detail message.
* @param nested Nested Throwable.
*/
public NestedError(final String msg, final Throwable nested) {
super(msg);
this.nested = nested;
NestedThrowable.Util.checkNested(this, nested);
}
/**
* Construct a NestedError with the specified
* nested Throwable.
*
* @param nested Nested Throwable.
*/
public NestedError(final Throwable nested) {
this(nested.getMessage(), nested);
}
/**
* Construct a NestedError with no detail.
*/
public NestedError() {
super();
this.nested = null;
}
/**
* Return the nested Throwable.
*
* @return Nested Throwable.
*/
public Throwable getNested() {
return nested;
}
/**
* Return the nested Throwable.
*
*
*
*
*/
public class ApplicationDeadlockException extends RuntimeException
{
/** The serialVersionUID */
private static final long serialVersionUID = -908428091244600395L;
protected boolean retry = false;
public ApplicationDeadlockException()
{
super();
}
public ApplicationDeadlockException(String msg, boolean retry)
{
super(msg);
this.retry = retry;
}
public boolean retryable()
{
return retry;
}
/**
* Detects exception contains is or a ApplicationDeadlockException.
* @param t
* @return true when it is a deadlock
*/
public static ApplicationDeadlockException isADE(Throwable t)
{
while (t!=null)
{
if (t instanceof ApplicationDeadlockException)
{
return (ApplicationDeadlockException)t;
}
else
{
t = t.getCause();
}
}
return null;
}
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/loading/ 0000755 0001750 0001750 00000000000 11105642363 030566 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000156 00000000000 011567 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/loading/ClassLoaderSource.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/loading/ClassLoaderSo0000644 0001750 0001750 00000002716 10772776222 033230 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source.
* Copyright 2008, Red Hat Middleware LLC, and individual contributors
* as indicated by the @author tags. See the copyright.txt file in the
* distribution for a full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.loading;
/**
* Interface for objects that provide a reference to a classloader.
*
* @see org.jboss.util.threadpool.BasicThreadPool#setClassLoaderSource(ClassLoaderSource)
*
* @author Brian Stansberry
*/
public interface ClassLoaderSource
{
/**
* Gets the classloader provided by this object.
*
* @return the classloader, or null if none is available
*/
ClassLoader getClassLoader();
}
././@LongLink 0000000 0000000 0000000 00000000162 00000000000 011564 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/loading/DelegatingClassLoader.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/loading/DelegatingCla0000644 0001750 0001750 00000006463 10774222622 033210 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.loading;
import java.net.URL;
import java.net.URLClassLoader;
import java.net.URLStreamHandlerFactory;
/**
* A URL classloader that delegates to its parent, avoiding
* synchronization.
*
* A standard flag is provided so it can be used as a parent class,
* but later subclassed and to revert to standard class loading
* if the subclass wants to load classes.
*
* @author Adrian Brock
* @version $Revision: 2787 $
*/
public class DelegatingClassLoader
extends URLClassLoader
{
/** The value returned by {@link #getURLs()}. */
public static final URL[] EMPTY_URL_ARRAY = {};
/** Whether to use standard loading */
protected boolean standard = false;
/**
* Constructor
*
* @param parent the parent classloader, cannot be null.
*/
public DelegatingClassLoader(ClassLoader parent)
{
super(EMPTY_URL_ARRAY, parent);
if (parent == null)
throw new IllegalArgumentException("No parent");
}
/**
* Constructor
*
* @param parent the parent classloader, cannot be null.
* @param factory the url stream factory.
*/
public DelegatingClassLoader(ClassLoader parent, URLStreamHandlerFactory factory)
{
super(EMPTY_URL_ARRAY, parent, factory);
if (parent == null)
throw new IllegalArgumentException("No parent");
}
/**
* Load a class, by asking the parent
*
* @param className the class name to load
* @param resolve whether to link the class
* @return the loaded class
* @throws ClassNotFoundException when the class could not be found
*/
protected Class loadClass(String className, boolean resolve)
throws ClassNotFoundException
{
// Revert to standard rules
if (standard)
return super.loadClass(className, resolve);
// Ask the parent
Class clazz = null;
try
{
clazz = getParent().loadClass(className);
}
catch (ClassNotFoundException e)
{
// Not found in parent,
// maybe it is a proxy registered against this classloader?
clazz = findLoadedClass(className);
if (clazz == null)
throw e;
}
// Link the class
if (resolve)
resolveClass(clazz);
return clazz;
}
}
././@LongLink 0000000 0000000 0000000 00000000173 00000000000 011566 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/loading/MyClassLoaderClassLoaderSource.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/loading/MyClassLoader0000644 0001750 0001750 00000002540 10772776222 033227 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source.
* Copyright 2008, Red Hat Middleware LLC, and individual contributors
* as indicated by the @author tags. See the copyright.txt file in the
* distribution for a full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.loading;
/**
* {@link ClassLoaderSource} implementation that returns the ClassLoader
* that loaded this class.
*
* @author Brian Stansberry
*/
public class MyClassLoaderClassLoaderSource implements ClassLoaderSource
{
public ClassLoader getClassLoader()
{
return getClass().getClassLoader();
}
}
././@LongLink 0000000 0000000 0000000 00000000157 00000000000 011570 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/loading/ContextClassLoader.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/loading/ContextClassL0000644 0001750 0001750 00000005531 10774222622 033246 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.loading;
import java.security.AccessController;
import java.security.PrivilegedAction;
/**
* A helper for context classloading.null. Otherwise, it should create a new
* byte[] array and copy the input classfileBuffer into it,
* along with all desired transformations. The input classfileBuffer
* must not be modified.
*
* @param loader - the defining loader of the class to be transformed, may
* be null if the bootstrap loader
* @param className - the fully-qualified name of the class
* @param classBeingRedefined - if this is a redefine, the class being
* redefined, otherwise null
* @param protectionDomain - the protection domain of the class being
* defined or redefined
* @param classfileBuffer - the input byte buffer in class file format - must
* not be modified
*
* @throws Exception - if the input does not represent a well-formed class file
* @return a well-formed class file buffer (the result of the transform),
* or null if no transform is performed.
*/
public byte[] transform(ClassLoader loader,
String className,
Class classBeingRedefined,
ProtectionDomain protectionDomain,
byte[] classfileBuffer)
throws Exception;
/** Called to indicate that the ClassLoader is being discarded by the server.
*
* @param loader - a class loader that has possibly been used previously
* as an argument to transform.
*/
public void unregisterClassLoader(ClassLoader loader);
}
././@LongLink 0000000 0000000 0000000 00000000151 00000000000 011562 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/loading/Translatable.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/loading/Translatable.0000644 0001750 0001750 00000002651 10470642610 033206 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.loading;
import java.net.URL;
/** An interface representing class loader like senamics used in the aop
* layer. Its only purpose was to remove the explicit dependency on the
* JBoss UCL class loader api, but its existence seems to be a hack that
* should be removed.
*
* @version $Revision: 1958 $
*/
public interface Translatable
{
public URL getResourceLocally(String name);
}
././@LongLink 0000000 0000000 0000000 00000000167 00000000000 011571 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/loading/ContextClassLoaderSwitcher.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/loading/ContextClassL0000644 0001750 0001750 00000014437 10774222622 033253 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.loading;
import java.security.AccessController;
import java.security.PrivilegedAction;
/**
* A helper for context classloading switching.index.
* @param index
*/
protected int parent(int index)
{
return (index - 1) >> 1;
}
/**
* @param index
* @return the left child index of index.
*/
protected int left(int index)
{
return index + index + 1;
}
/**
* @param index
* @return the right child index of index.
*/
protected int right(int index)
{
return index + index + 2;
}
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/package.html 0000644 0001750 0001750 00000001526 10470642610 031435 0 ustar twerner twerner
Package Specification
Related Documentation
Package Status
Todo
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/NestedException.java 0000644 0001750 0001750 00000010202 10776226110 033111 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
import java.io.PrintWriter;
import java.io.PrintStream;
/**
* A common superclass for Exception classes that can contain
* a nested Throwable detail object.
*
* @version $Revision: 2800 $
* @author Jason Dillon
*/
public class NestedException
extends Exception
implements NestedThrowable
{
/** The serialVersionUID */
private static final long serialVersionUID = 7003381223684751953L;
/** The nested throwable */
protected final Throwable nested;
/**
* Construct a NestedException with the specified detail
* message.
*
* @param msg Detail message.
*/
public NestedException(final String msg) {
super(msg);
this.nested = null;
}
/**
* Construct a NestedException with the specified detail
* message and nested Throwable.
*
* @param msg Detail message.
* @param nested Nested Throwable.
*/
public NestedException(final String msg, final Throwable nested) {
super(msg);
this.nested = nested;
NestedThrowable.Util.checkNested(this, nested);
}
/**
* Construct a NestedException with the specified
* nested Throwable.
*
* @param nested Nested Throwable.
*/
public NestedException(final Throwable nested) {
this(nested.getMessage(), nested);
}
/**
* Construct a NestedException with no detail.
*/
public NestedException() {
super();
this.nested = null;
}
/**
* Return the nested Throwable.
*
* @return Nested Throwable.
*/
public Throwable getNested() {
return nested;
}
/**
* Return the nested Throwable.
*
* % for the index token)
* with the replacement value from the given array for the corresponding
* index.
*
* @param string String substitution format.
* @param replace Array of strings whose values will be used as
* replacements in the given string when a token with
* their index is found.
* @return Substituted string.
*/
public static String subst(final String string, final String replace[])
{
return subst(new StringBuffer(), string, replace, '%');
}
/////////////////////////////////////////////////////////////////////////
// Range Methods //
/////////////////////////////////////////////////////////////////////////
/**
* Represents a range between two integers.
*/
public static class Range
{
/** The beginning of the range. */
public int begin;
/** The end of the range. */
public int end;
/**
* Construct a new range.
*
* @param begin The beginning of the range.
* @param end The end of the range.
*/
public Range(int begin, int end)
{
this.begin = begin;
this.end = end;
}
/**
* Default constructor.
*/
public Range()
{
}
}
/**
* Return the range from a begining token to an ending token.
*
* @param beginToken String to indicate begining of range.
* @param endToken String to indicate ending of range.
* @param string String to look for range in.
* @param fromIndex Beginning index.
* @return (begin index, end index) or null.
*/
public static Range rangeOf(final String beginToken, final String endToken,
final String string, final int fromIndex)
{
int begin = string.indexOf(beginToken, fromIndex);
if (begin != -1)
{
int end = string.indexOf(endToken, begin + 1);
if (end != -1)
{
return new Range(begin, end);
}
}
return null;
}
/**
* Return the range from a begining token to an ending token.
*
* @param beginToken String to indicate begining of range.
* @param endToken String to indicate ending of range.
* @param string String to look for range in.
* @return (begin index, end index) or null.
*/
public static Range rangeOf(final String beginToken, final String endToken,
final String string)
{
return rangeOf(beginToken, endToken, string, 0);
}
/////////////////////////////////////////////////////////////////////////
// Spliting Methods //
/////////////////////////////////////////////////////////////////////////
/**
* Split up a string into multiple strings based on a delimiter.
*
* @param string String to split up.
* @param delim Delimiter.
* @param limit Limit the number of strings to split into
* (-1 for no limit).
* @return Array of strings.
*/
public static String[] split(final String string, final String delim,
final int limit)
{
// get the count of delim in string, if count is > limit
// then use limit for count. The number of delimiters is less by one
// than the number of elements, so add one to count.
int count = count(string, delim) + 1;
if (limit > 0 && count > limit)
{
count = limit;
}
String strings[] = new String[count];
int begin = 0;
for (int i = 0; i < count; i++)
{
// get the next index of delim
int end = string.indexOf(delim, begin);
// if the end index is -1 or if this is the last element
// then use the string's length for the end index
if (end == -1 || i + 1 == count)
end = string.length();
// if end is 0, then the first element is empty
if (end == 0)
strings[i] = EMPTY;
else
strings[i] = string.substring(begin, end);
// update the begining index
begin = end + 1;
}
return strings;
}
/**
* Split up a string into multiple strings based on a delimiter.
*
* @param string String to split up.
* @param delim Delimiter.
* @return Array of strings.
*/
public static String[] split(final String string, final String delim)
{
return split(string, delim, -1);
}
/////////////////////////////////////////////////////////////////////////
// Joining/Concatenation Methods //
/////////////////////////////////////////////////////////////////////////
/**
* Join an array of strings into one delimited string.
*
* @param buff String buffered used for join (buffer is not reset).
* @param array Array of objects to join as strings.
* @param delim Delimiter to join strings with or null.
* @return Joined string.
*/
public static String join(final StringBuffer buff, final Object array[],
final String delim)
{
boolean haveDelim = (delim != null);
for (int i = 0; i < array.length; i++)
{
buff.append(array[i]);
// if this is the last element then don't append delim
if (haveDelim && (i + 1) < array.length)
{
buff.append(delim);
}
}
return buff.toString();
}
/**
* Join an array of strings into one delimited string.
*
* @param array Array of objects to join as strings.
* @param delim Delimiter to join strings with or null.
* @return Joined string.
*/
public static String join(final Object array[], final String delim)
{
return join(new StringBuffer(), array, delim);
}
/**
* Convert and join an array of objects into one string.
*
* @param array Array of objects to join as strings.
* @return Converted and joined objects.
*/
public static String join(final Object array[])
{
return join(array, null);
}
/**
* Convert and join an array of bytes into one string.
*
* @param array Array of objects to join as strings.
* @return Converted and joined objects.
*/
public static String join(final byte array[])
{
Byte bytes[] = new Byte[array.length];
for (int i = 0; i < bytes.length; i++)
{
bytes[i] = new Byte(array[i]);
}
return join(bytes, null);
}
/**
* Return a string composed of the given array.
*
* @param buff Buffer used to construct string value (not reset).
* @param array Array of objects.
* @param prefix String prefix.
* @param separator Element sepearator.
* @param suffix String suffix.
* @return String in the format of:
* prefix + n ( + separator + n+i)* + suffix.
*/
public static String join(final StringBuffer buff, final Object[] array,
final String prefix, final String separator,
final String suffix)
{
buff.append(prefix);
join(buff, array, separator);
buff.append(suffix);
return buff.toString();
}
/**
* Return a string composed of the given array.
*
* @param array Array of objects.
* @param prefix String prefix.
* @param separator Element sepearator.
* @param suffix String suffix.
* @return String in the format of:
* prefix + n ( + separator + n+i)* + suffix.
*/
public static String join(final Object[] array, final String prefix,
final String separator, final String suffix)
{
return join(new StringBuffer(), array, prefix, separator, suffix);
}
/////////////////////////////////////////////////////////////////////////
// Counting Methods //
/////////////////////////////////////////////////////////////////////////
/**
* Count the number of instances of substring within a string.
*
* @param string String to look for substring in.
* @param substring Sub-string to look for.
* @return Count of substrings in string.
*/
public static int count(final String string, final String substring)
{
int count = 0;
int idx = 0;
while ((idx = string.indexOf(substring, idx)) != -1)
{
idx++;
count++;
}
return count;
}
/**
* Count the number of instances of character within a string.
*
* @param string String to look for substring in.
* @param c Character to look for.
* @return Count of substrings in string.
*/
public static int count(final String string, final char c)
{
return count(string, String.valueOf(c));
}
/////////////////////////////////////////////////////////////////////////
// Padding Methods //
/////////////////////////////////////////////////////////////////////////
/**
* Return a string padded with the given string for the given count.
*
* @param buff String buffer used for padding (buffer is not reset).
* @param string Pad element.
* @param count Pad count.
* @return Padded string.
*/
public static String pad(final StringBuffer buff, final String string,
final int count)
{
for (int i = 0; i < count; i++)
{
buff.append(string);
}
return buff.toString();
}
/**
* Return a string padded with the given string for the given count.
*
* @param string Pad element.
* @param count Pad count.
* @return Padded string.
*/
public static String pad(final String string, final int count)
{
return pad(new StringBuffer(), string, count);
}
/**
* Return a string padded with the given string value of an object
* for the given count.
*
* @param obj Object to convert to a string.
* @param count Pad count.
* @return Padded string.
*/
public static String pad(final Object obj, final int count)
{
return pad(new StringBuffer(), String.valueOf(obj), count);
}
/////////////////////////////////////////////////////////////////////////
// Misc Methods //
/////////////////////////////////////////////////////////////////////////
/**
* true if the given String is a reserved Java
* keyword, false otherwise.
*/
public final static boolean isJavaKeyword(String s)
{
if (s == null || s.length() == 0)
{
return false;
}
for (int i = 0; i < keywords.length; i++)
{
if (keywords[i].equals(s))
{
return true;
}
}
return false;
}
/**
* Check whether the given String is an identifier according to the
* EJB-QL definition. See The EJB 2.0 Documentation Section 11.2.6.1.
*
* @param s String to check
*
* @return true if the given String is a reserved
* identifier in EJB-QL, false otherwise.
*/
public final static boolean isEjbQlIdentifier(String s)
{
if (s == null || s.length() == 0)
{
return false;
}
for (int i = 0; i < ejbQlIdentifiers.length; i++)
{
if (ejbQlIdentifiers[i].equalsIgnoreCase(s))
{
return true;
}
}
return false;
}
/**
* Check whether the given String is a valid identifier according
* to the Java Language specifications.
*
* See The Java Language Specification Second Edition, Section 3.8
* for the definition of what is a valid identifier.
*
* @param s String to check
*
* @return true if the given String is a valid Java
* identifier, false otherwise.
*/
public final static boolean isValidJavaIdentifier(String s)
{
// an empty or null string cannot be a valid identifier
if (s == null || s.length() == 0)
{
return false;
}
char[] c = s.toCharArray();
if (!Character.isJavaIdentifierStart(c[0]))
{
return false;
}
for (int i = 1; i < c.length; i++)
{
if (!Character.isJavaIdentifierPart(c[i]))
{
return false;
}
}
return true;
}
/**
* Returns a new string with all the whitespace removed
*
* @param s the source string
* @return the string without whitespace or null
*/
public static String removeWhiteSpace(String s)
{
String retn = null;
if (s != null)
{
int len = s.length();
StringBuffer sbuf = new StringBuffer(len);
for (int i = 0; i < len; i++)
{
char c = s.charAt(i);
if (!Character.isWhitespace(c))
sbuf.append(c);
}
retn = sbuf.toString();
}
return retn;
}
/**
* The default toString implementation of an object
*
* @param object the object
* @return a string in the form className@hexHashCode
*/
public static final String defaultToString(Object object)
{
if (object == null)
return "null";
else
return object.getClass().getName() + '@' + Integer.toHexString(System.identityHashCode(object));
}
/**
* The default toString implementation of an object
*
* @param object the object
* @param buffer the string builder
*/
public static final void defaultToString(JBossStringBuilder buffer, Object object)
{
if (object == null)
buffer.append("null");
else
{
buffer.append(object.getClass().getName());
buffer.append('@');
buffer.append(Integer.toHexString(System.identityHashCode(object)));
}
}
/**
* The default toString implementation of an object
*
* @param object the object
* @param buffer the string buffer
*/
public static final void defaultToString(StringBuffer buffer, Object object)
{
if (object == null)
buffer.append("null");
else
{
buffer.append(object.getClass().getName());
buffer.append('@');
buffer.append(Integer.toHexString(System.identityHashCode(object)));
}
}
/**
* Parses a time period into a long.
*
* Translates possible [msec|sec|min|h] suffixes
*
* For example:
* "1" -> 1 (msec)
* "1msec -> 1 (msec)
* "1sec" -> 1000 (msecs)
* "1min" -> 60000 (msecs)
* "1h" -> 3600000 (msecs)
*
* Accepts negative periods, e.g. "-1"
*
* @param period the stringfied time period
* @return the parsed time period as long
* @throws NumberFormatException
*/
public static long parseTimePeriod(String period)
{
try
{
String s = period.toLowerCase();
long factor;
// look for suffix
if (s.endsWith("msec"))
{
s = s.substring(0, s.lastIndexOf("msec"));
factor = MSEC;
}
else if (s.endsWith("sec"))
{
s = s.substring(0, s.lastIndexOf("sec"));
factor = SECS;
}
else if (s.endsWith("min"))
{
s = s.substring(0, s.lastIndexOf("min"));
factor = MINS;
}
else if (s.endsWith("h"))
{
s = s.substring(0, s.lastIndexOf("h"));
factor = HOUR;
}
else
{
factor = 1;
}
return Long.parseLong(s) * factor;
}
catch (RuntimeException e)
{
// thrown in addition when period is 'null'
throw new NumberFormatException("For input time period: '" + period + "'");
}
}
/**
* Same like parseTimePeriod(), but guards for negative entries.
*
* @param period the stringfied time period
* @return the parsed time period as long
* @throws NumberFormatException
*/
public static long parsePositiveTimePeriod(String period)
{
long retval = parseTimePeriod(period);
if (retval < 0)
{
throw new NumberFormatException("Negative input time period: '" + period + "'");
}
return retval;
}
/**
* Tokenize the given String into a String array via a StringTokenizer.
*
* The given delimiters string is supposed to consist of any number of
* delimiter characters. Each of those characters can be used to separate
* tokens. A delimiter is always a single character; for multi-character
* delimiters, consider using delimitedListToStringArray
*
* @param str the String to tokenize
* @param delimiters the delimiter characters, assembled as String
* (each of those characters is individually considered as delimiter)
* @param trimTokens trim the tokens via String's trim
* @param ignoreEmptyTokens omit empty tokens from the result array
* (only applies to tokens that are empty after trimming; StringTokenizer
* will not consider subsequent delimiters as token in the first place).
* @return an array of the tokens (null if the input String was null)
*/
public static String[] tokenizeToStringArray(String str, String delimiters, boolean trimTokens, boolean ignoreEmptyTokens)
{
if (str == null)
{
return null;
}
StringTokenizer st = new StringTokenizer(str, delimiters);
ListReference. If the object is null
* then null is returned. If the object is not an instance of
* Reference, then the object is returned.
*
* @param obj Object to dereference.
* @return Dereferenced object.
*/
@SuppressWarnings("unchecked")
public static Object deref(final Object obj) {
if (obj != null && obj instanceof Reference) {
Reference ref = (Reference)obj;
return ref.get();
}
return obj;
}
/**
* Dereference an object
*
* @param
Package Specification
Related Documentation
Package Status
Todo
././@LongLink 0000000 0000000 0000000 00000000154 00000000000 011565 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/PropertyReader.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/PropertyRead0000644 0001750 0001750 00000003313 10774222622 033403 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.property;
import java.util.Map;
import java.io.IOException;
/**
* Iterface used to allow a PropertyMap to read property definitions
* in an implementation independent fashion.
*
* @version $Revision: 2787 $
* @author Jason Dillon
*/
@SuppressWarnings("unchecked")
public interface PropertyReader
{
/**
* Read a map of properties from this input source.
*
* @return Read properties map.
*
* @throws PropertyException Failed to read properties.
* @throws IOException I/O error while reading properties.
*/
Map readProperties() throws PropertyException, IOException;
}
././@LongLink 0000000 0000000 0000000 00000000152 00000000000 011563 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/Configurable.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/Configurable0000644 0001750 0001750 00000002703 10470642610 033361 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.property;
/**
* An interface that allows for dynamic configuration of instance objects
* with properties.
*
* @version $Revision: 1958 $
* @author Jason Dillon
*/
public interface Configurable
{
/**
* Configure this object with the given properties.
*
* @param props Properties to configure from.
*/
void configure(PropertyMap props);
}
././@LongLink 0000000 0000000 0000000 00000000153 00000000000 011564 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/PropertyGroup.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/PropertyGrou0000644 0001750 0001750 00000020322 10774222622 033443 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.property;
import java.util.Properties;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.util.Set;
import java.util.Iterator;
import org.jboss.util.NullArgumentException;
/**
* This is a helper class to access a group of properties with out having to
* refer to their full names.
*
* java.util.Properties
* class which adds, among others, property event capabilities.
*
* @todo consider moving the JNDI property handling to a InitialContextFactoryBuilder
*
* @version $Revision: 2787 $
* @author Jason Dillon
* @author Scott.Stark@jboss.org
* @author Adrian Brock
*/
@SuppressWarnings("unchecked")
public class PropertyMap extends Properties
{
/** Serial version uid */
private static final long serialVersionUID = 8747802918099008518L;
/** Property name separator */
public static final String PROPERTY_NAME_SEPARATOR = ".";
/** Empty array property */
public static final String[] EMPTY_ARRAY_PROPERTY = new String[0];
/** Property listener list */
protected transient List unboundListeners;
/** Bound property name -> listener list map */
protected transient Map boundListeners;
/**
* This map avoids heavy contention for the properties that JNDI looks
* up everytime a new InitialContext instance is created. Once the container is
* up and running getProperty calls other than for the JNDI property are very rare,
* so the double lookup is not much of a performance problem.
* If at all possible, this class should be read-only and use no locks at all.
*/
private transient Map jndiMap;
private final static Object NULL_VALUE = new Object();
/**
* Construct a PropertyMap with default properties.
*
* @param defaults Default properties.
*/
public PropertyMap(Properties defaults)
{
super(defaults);
init();
}
/**
* Construct a PropertyMap.
*/
public PropertyMap()
{
this(null);
}
/** Initialized listener lists and the JNDI properties cache map
*/
private void init()
{
unboundListeners = Collections.synchronizedList(new ArrayList());
boundListeners = Collections.synchronizedMap(new HashMap());
jndiMap = new HashMap();
PrivilegedAction action = new PrivilegedAction()
{
public Object run()
{
Object value = System.getProperty(Context.PROVIDER_URL);
if (value == null) value = NULL_VALUE;
jndiMap.put(Context.PROVIDER_URL, value);
value = System.getProperty(Context.INITIAL_CONTEXT_FACTORY);
if (value == null) value = NULL_VALUE;
jndiMap.put(Context.INITIAL_CONTEXT_FACTORY, value);
value = System.getProperty(Context.OBJECT_FACTORIES);
if (value == null) value = NULL_VALUE;
jndiMap.put(Context.OBJECT_FACTORIES, value);
value = System.getProperty(Context.URL_PKG_PREFIXES);
if (value == null) value = NULL_VALUE;
jndiMap.put(Context.URL_PKG_PREFIXES, value);
value = System.getProperty(Context.STATE_FACTORIES);
if (value == null) value = NULL_VALUE;
jndiMap.put(Context.STATE_FACTORIES, value);
value = System.getProperty(Context.DNS_URL);
if (value == null) value = NULL_VALUE;
jndiMap.put(Context.DNS_URL, value);
value = System.getProperty(LdapContext.CONTROL_FACTORIES);
if (value == null) value = NULL_VALUE;
jndiMap.put(LdapContext.CONTROL_FACTORIES, value);
return null;
}
};
AccessController.doPrivileged(action);
}
/** Called by setProperty to update the jndiMap cache values.
* @param name the property name
* @param value the property value
*/
private void updateJndiCache(String name, String value)
{
if( name == null )
return;
boolean isJndiProperty = name.equals(Context.PROVIDER_URL)
|| name.equals(Context.INITIAL_CONTEXT_FACTORY)
|| name.equals(Context.OBJECT_FACTORIES)
|| name.equals(Context.URL_PKG_PREFIXES)
|| name.equals(Context.STATE_FACTORIES)
|| name.equals(Context.DNS_URL)
|| name.equals(LdapContext.CONTROL_FACTORIES)
;
if( isJndiProperty == true )
jndiMap.put(name, value);
}
/**
* Set a property.
*
* @param name Property name.
* @param value Property value.
* @return Previous property value or null.
*/
public Object put(Object name, Object value)
{
if (name == null)
throw new NullArgumentException("name");
// value can be null
// check if this is a new addition or not prior to updating the hash
boolean add = !containsKey(name);
Object prev = super.put(name, value);
PropertyEvent event =
new PropertyEvent(this, name.toString(), value.toString());
// fire propertyAdded or propertyChanged
if (add)
{
firePropertyAdded(event);
}
else
{
firePropertyChanged(event);
}
return prev;
}
/**
* Remove a property.
*
* @param name Property name.
* @return Removed property value.
*/
public Object remove(Object name)
{
if (name == null)
throw new NullArgumentException("name");
// check if there is a property with this name
boolean contains = containsKey(name);
Object value = null;
if (contains)
{
value = super.remove(name);
if (defaults != null)
{
Object obj = defaults.remove(name);
if (value == null)
{
value = obj;
}
}
// Remove any JNDI property value
jndiMap.remove(name);
PropertyEvent event = new PropertyEvent(this, name.toString(), value.toString());
firePropertyRemoved(event);
}
return value;
}
/**
* Returns a set of keys for all entries in this group and optionally
* all of the keys in the defaults map.
* @param includeDefaults
* @return the key set
*/
public Set keySet(final boolean includeDefaults)
{
if (includeDefaults)
{
Set set = new HashSet();
set.addAll(defaults.keySet());
set.addAll(super.keySet());
return Collections.synchronizedSet(set);
}
return super.keySet();
}
/**
* Returns a set of entrys for all entries in this group and optionally
* all of the entrys in the defaults map.
* @param includeDefaults
* @return the entry set
*/
public Set entrySet(final boolean includeDefaults)
{
if (includeDefaults)
{
Set set = new HashSet();
set.addAll(defaults.entrySet());
set.addAll(super.entrySet());
return Collections.synchronizedSet(set);
}
return super.entrySet();
}
/**
* Add a property listener.
*
* @param listener Property listener to add.
*/
public void addPropertyListener(PropertyListener listener)
{
if (listener == null)
throw new NullArgumentException("listener");
if (listener instanceof BoundPropertyListener)
{
addPropertyListener((BoundPropertyListener) listener);
}
else
{
// only add the listener if it is not in the list already
if (!unboundListeners.contains(listener))
unboundListeners.add(listener);
}
}
/**
* Add a bound property listener.
*
* @param listener Bound property listener to add.
*/
protected void addPropertyListener(BoundPropertyListener listener)
{
// get the bound property name
String name = listener.getPropertyName();
// get the bound listener list for the property
List list = (List) boundListeners.get(name);
// if list is null, then add a new list
if (list == null)
{
list = Collections.synchronizedList(new ArrayList());
boundListeners.put(name, list);
}
// if listener is not in the list already, then add it
if (!list.contains(listener))
{
list.add(listener);
// notify listener that is is bound
listener.propertyBound(this);
}
}
/**
* Add an array of property listeners.
*
* @param listeners Array of property listeners to add.
*/
public void addPropertyListeners(PropertyListener[] listeners)
{
if (listeners == null)
throw new NullArgumentException("listeners");
for (int i = 0; i < listeners.length; i++)
{
addPropertyListener(listeners[i]);
}
}
/**
* Remove a property listener.
*
* @param listener Property listener to remove.
* @return True if listener was removed.
*/
public boolean removePropertyListener(PropertyListener listener)
{
if (listener == null)
throw new NullArgumentException("listener");
boolean removed = false;
if (listener instanceof BoundPropertyListener)
{
removed = removePropertyListener((BoundPropertyListener) listener);
}
else
{
removed = unboundListeners.remove(listener);
}
return removed;
}
/**
* Remove a bound property listener.
*
* @param listener Bound property listener to remove.
* @return True if listener was removed.
*/
protected boolean removePropertyListener(BoundPropertyListener listener)
{
// get the bound property name
String name = listener.getPropertyName();
// get the bound listener list for the property
List list = (List) boundListeners.get(name);
boolean removed = false;
if (list != null)
{
removed = list.remove(listener);
// notify listener that is was unbound
if (removed) listener.propertyUnbound(this);
}
return removed;
}
/**
* Fire a property added event to the given list of listeners.
*
* @param list Listener list.
* @param event Property event.
*/
private void firePropertyAdded(List list, PropertyEvent event)
{
if (list == null) return;
int size = list.size();
for (int i = 0; i < size; i++)
{
PropertyListener listener = (PropertyListener) list.get(i);
listener.propertyAdded(event);
}
}
/**
* Fire a property added event to all registered listeners.
*
* @param event Property event.
*/
protected void firePropertyAdded(PropertyEvent event)
{
// fire all bound listeners (if any) first
if (boundListeners != null)
{
List list = (List) boundListeners.get(event.getPropertyName());
if (list != null)
{
firePropertyAdded(list, event);
}
}
// next fire all unbound listeners
firePropertyAdded(unboundListeners, event);
}
/**
* Fire a property removed event to the given list of listeners.
*
* @param list Listener list.
* @param event Property event.
*/
private void firePropertyRemoved(List list, PropertyEvent event)
{
if (list == null) return;
int size = list.size();
for (int i = 0; i < size; i++)
{
PropertyListener listener = (PropertyListener) list.get(i);
listener.propertyRemoved(event);
}
}
/**
* Fire a property removed event to all registered listeners.
*
* @param event Property event.
*/
protected void firePropertyRemoved(PropertyEvent event)
{
// fire all bound listeners (if any) first
if (boundListeners != null)
{
List list = (List) boundListeners.get(event.getPropertyName());
if (list != null)
{
firePropertyRemoved(list, event);
}
}
// next fire all unbound listeners
firePropertyRemoved(unboundListeners, event);
}
/**
* Fire a property changed event to the given list of listeners.
*
* @param list Listener list.
* @param event Property event.
*/
private void firePropertyChanged(List list, PropertyEvent event)
{
if (list == null) return;
int size = list.size();
for (int i = 0; i < size; i++)
{
PropertyListener listener = (PropertyListener) list.get(i);
listener.propertyChanged(event);
}
}
/**
* Fire a property changed event to all listeners.
*
* @param event Property event.
*/
protected void firePropertyChanged(PropertyEvent event)
{
// fire all bound listeners (if any) first
if (boundListeners != null)
{
List list = (List) boundListeners.get(event.getPropertyName());
if (list != null)
{
firePropertyChanged(list, event);
}
}
// next fire all unbound listeners
firePropertyChanged(unboundListeners, event);
}
/**
* Make a optionaly prefixed property name.
*
* @param base Base property name.
* @param prefix Optional prefix (can be null).
* @return Property name.
*/
protected String makePrefixedPropertyName(String base, String prefix)
{
String name = base;
if (prefix != null)
{
StringBuffer buff = new StringBuffer(base);
if (prefix != null)
{
buff.insert(0, PROPERTY_NAME_SEPARATOR);
buff.insert(0, prefix);
}
return buff.toString();
}
return name;
}
/**
* Load properties from a map.
*
* @param prefix Prefix to append to all map keys (or null).
* @param map Map containing properties to load.
* @throws PropertyException
*/
public void load(String prefix, Map map) throws PropertyException
{
// prefix can be null
if (map == null)
throw new NullArgumentException("map");
// set properties for each key in map
Iterator iter = map.keySet().iterator();
while (iter.hasNext())
{
// make a string key with optional prefix
String key = String.valueOf(iter.next());
String name = makePrefixedPropertyName(key, prefix);
String value = String.valueOf(map.get(name));
// set the property
setProperty(name, value);
}
}
/**
* Load properties from a map.
*
* @param map Map containing properties to load.
* @throws PropertyException
*/
public void load(Map map) throws PropertyException
{
load(null, map);
}
/**
* Load properties from a PropertyReader.
*
* @param reader PropertyReader to read properties from.
* @throws PropertyException
* @throws IOException
*/
public void load(PropertyReader reader) throws PropertyException, IOException
{
if (reader == null)
throw new NullArgumentException("reader");
load(reader.readProperties());
}
/**
* Load properties from a PropertyReader specifed by the given class name.
*
* @param className Class name of a PropertyReader to read from.
* @throws PropertyException
* @throws IOException
*/
public void load(String className) throws PropertyException, IOException
{
if (className == null)
throw new NullArgumentException("className");
PropertyReader reader = null;
try
{
Class type = Class.forName(className);
reader = (PropertyReader) type.newInstance();
}
catch (Exception e)
{
throw new PropertyException(e);
}
// load the properties from the source
load(reader);
}
/**
* Set a property.
*
* java.util.Properties.
*
* @param name Property name.
* @param value Property value.
* @return Previous property value or null.
*/
public Object setProperty(String name, String value)
{
updateJndiCache(name, value);
return put(name, value);
}
public String getProperty(String name)
{
Object value = jndiMap.get(name);
if (value != null)
{
// key was in the map
return (value == NULL_VALUE) ? null : (String) value;
}
return super.getProperty(name);
}
/**
* Remove a property.
*
* @param name Property name.
* @return Removed property value or null.
*/
public String removeProperty(String name)
{
return (String) remove(name);
}
/**
* Make an indexed property name.
*
* @param base Base property name.
* @param index Property index.
* @return Indexed property name.
*/
protected String makeIndexPropertyName(String base, int index)
{
return base + PROPERTY_NAME_SEPARATOR + index;
}
/**
* Get an array style property.
*
* base_property_name.INDEX.
*
* addPropertyListener().
*
* @version $Revision: 1958 $
* @author Jason Dillon
*/
public interface PropertyListener
extends EventListener
{
/**
* Notifies that a property was added
*
* @param event Property event
*/
void propertyAdded(PropertyEvent event);
/**
* Notifies that a property was removed
*
* @param event Property event
*/
void propertyRemoved(PropertyEvent event);
/**
* Notifies that a property has changed
*
* @param event Property event
*/
void propertyChanged(PropertyEvent event);
}
././@LongLink 0000000 0000000 0000000 00000000153 00000000000 011564 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/PropertyError.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/property/PropertyErro0000644 0001750 0001750 00000004367 10776226110 033447 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.property;
import org.jboss.util.NestedError;
/**
* Thrown to indicate a fatal problem with the property system.
*
* @version $Revision: 2800 $
* @author Jason Dillon
*/
public class PropertyError
extends NestedError
{
/** The serialVersionUID */
private static final long serialVersionUID = -4956548740655706282L;
/**
* Construct a PropertyError with the specified detail
* message.
*
* @param msg Detail message.
*/
public PropertyError(String msg) {
super(msg);
}
/**
* Construct a PropertyError with the specified detail
* message and nested Throwable.
*
* @param msg Detail message.
* @param nested Nested Throwable.
*/
public PropertyError(String msg, Throwable nested) {
super(msg, nested);
}
/**
* Construct a PropertyError with the specified
* nested Throwable.
*
* @param nested Nested Throwable.
*/
public PropertyError(Throwable nested) {
super(nested);
}
/**
* Construct a PropertyError with no detail.
*/
public PropertyError() {
super();
}
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/platform/ 0000755 0001750 0001750 00000000000 11105642364 030776 5 ustar twerner twerner ././@LongLink 0000000 0000000 0000000 00000000145 00000000000 011565 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/platform/package.html libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/platform/package.html0000644 0001750 0001750 00000001752 10470642610 033262 0 ustar twerner twerner
Package Specification
Related Documentation
Package Status
Todo
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/platform/Java.java 0000644 0001750 0001750 00000011267 10555402342 032527 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source.
* Copyright 2006, Red Hat Middleware LLC, and individual contributors
* as indicated by the @author tags. See the copyright.txt file in the
* distribution for a full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.platform;
/**
* Provides common access to specifics about the version of Java
* that a virtual machine supports.
*
*
*
*
* After this method is called, a call to {@link #start} will restart the cache.
* @see #start
* @see #destroy
*/
public void stop()
{
if (m_list != null)
{
flush();
}
}
/**
* Destroys the cache that is now unusable.
* To have it working again it must be re-{@link #create}ed and
* re-{@link #start}ed.
*
* @see #create
*/
public void destroy()
{
if( m_map != null )
m_map.clear();
if( m_list != null )
m_list.clear();
}
public Object get(Object key)
{
if (key == null)
{
throw new IllegalArgumentException("Requesting an object using a null key");
}
LRUCacheEntry value = (LRUCacheEntry)m_map.get(key);
if (value != null)
{
m_list.promote(value);
return value.m_object;
}
else
{
cacheMiss();
return null;
}
}
public Object peek(Object key)
{
if (key == null)
{
throw new IllegalArgumentException("Requesting an object using a null key");
}
LRUCacheEntry value = (LRUCacheEntry)m_map.get(key);
if (value == null)
{
return null;
}
else
{
return value.m_object;
}
}
public void insert(Object key, Object o)
{
if (o == null) {throw new IllegalArgumentException("Cannot insert a null object in the cache");}
if (key == null) {throw new IllegalArgumentException("Cannot insert an object in the cache with null key");}
if (m_map.containsKey(key))
{
throw new IllegalStateException("Attempt to put in the cache an object that is already there");
}
m_list.demote();
LRUCacheEntry entry = createCacheEntry(key, o);
m_map.put(key, entry);
m_list.promote(entry);
}
public void remove(Object key)
{
if (key == null) {throw new IllegalArgumentException("Removing an object using a null key");}
Object value = m_map.remove(key);
if (value != null)
{
m_list.remove((LRUCacheEntry)value);
}
//else Do nothing, the object isn't in the cache list
}
public void flush()
{
LRUCacheEntry entry = null;
while ((entry = m_list.m_tail) != null)
{
ageOut(entry);
}
}
public int size() {
return m_list.m_count;
}
// Y overrides ---------------------------------------------------
// Package protected ---------------------------------------------
// Protected -----------------------------------------------------
/**
* Factory method for the linked list used by this cache implementation.
* @return the lru list
*/
protected LRUList createList() {return new LRUList();}
/**
* Callback method called when the cache algorithm ages out of the cache
* the given entry.
* The implementation here is removing the given entry from the cache.
* @param entry
*/
protected void ageOut(LRUCacheEntry entry)
{
remove(entry.m_key);
}
/**
* Callback method called when a cache miss happens.
*/
protected void cacheMiss()
{
}
/**
* Factory method for cache entries
* @param key
* @param value
* @return the entry
*/
protected LRUCacheEntry createCacheEntry(Object key, Object value)
{
return new LRUCacheEntry(key, value);
}
// Private -------------------------------------------------------
// Inner classes -------------------------------------------------
/**
* Double queued list used to store cache entries.
*/
public class LRUList
{
/** The maximum capacity of the cache list */
@SuppressWarnings("hiding")
public int m_maxCapacity;
/** The minimum capacity of the cache list */
@SuppressWarnings("hiding")
public int m_minCapacity;
/** The current capacity of the cache list */
public int m_capacity;
/** The number of cached objects */
public int m_count;
/** The head of the double linked list */
public LRUCacheEntry m_head;
/** The tail of the double linked list */
public LRUCacheEntry m_tail;
/** The cache misses happened */
public int m_cacheMiss;
/**
* Creates a new double queued list.
*/
protected LRUList()
{
m_head = null;
m_tail = null;
m_count = 0;
}
/**
* Promotes the cache entry entry to the last used position
* of the list.
* If the object is already there, does nothing.
* @param entry the object to be promoted, cannot be null
* @see #demote
* @throws IllegalStateException if this method is called with a full cache
*/
protected void promote(LRUCacheEntry entry)
{
if (entry == null) {throw new IllegalArgumentException("Trying to promote a null object");}
if (m_capacity < 1) {throw new IllegalStateException("Can't work with capacity < 1");}
entryPromotion(entry);
entry.m_time = System.currentTimeMillis();
if (entry.m_prev == null)
{
if (entry.m_next == null)
{
// entry is new or there is only the head
if (m_count == 0) // cache is empty
{
m_head = entry;
m_tail = entry;
++m_count;
entryAdded(entry);
}
else if (m_count == 1 && m_head == entry) {} // there is only the head and I want to promote it, do nothing
else if (m_count < m_capacity)
{
entry.m_prev = null;
entry.m_next = m_head;
m_head.m_prev = entry;
m_head = entry;
++m_count;
entryAdded(entry);
}
else if (m_count < m_maxCapacity)
{
entry.m_prev = null;
entry.m_next = m_head;
m_head.m_prev = entry;
m_head = entry;
++m_count;
int oldCapacity = m_capacity;
++m_capacity;
entryAdded(entry);
capacityChanged(oldCapacity);
}
else {throw new IllegalStateException("Attempt to put a new cache entry on a full cache");}
}
else {} // entry is the head, do nothing
}
else
{
if (entry.m_next == null) // entry is the tail
{
LRUCacheEntry beforeLast = entry.m_prev;
beforeLast.m_next = null;
entry.m_prev = null;
entry.m_next = m_head;
m_head.m_prev = entry;
m_head = entry;
m_tail = beforeLast;
}
else // entry is in the middle of the list
{
LRUCacheEntry previous = entry.m_prev;
previous.m_next = entry.m_next;
entry.m_next.m_prev = previous;
entry.m_prev = null;
entry.m_next = m_head;
m_head.m_prev = entry;
m_head = entry;
}
}
}
/**
* Demotes from the cache the least used entry.
* If the cache is not full, does nothing.
* @see #promote
*/
protected void demote()
{
if (m_capacity < 1) {throw new IllegalStateException("Can't work with capacity < 1");}
if (m_count > m_maxCapacity) {throw new IllegalStateException("Cache list entries number (" + m_count + ") > than the maximum allowed (" + m_maxCapacity + ")");}
if (m_count == m_maxCapacity)
{
LRUCacheEntry entry = m_tail;
// the entry will be removed by ageOut
ageOut(entry);
}
else {} // cache is not full, do nothing
}
/**
* Removes from the cache list the specified entry.
* @param entry
*/
protected void remove(LRUCacheEntry entry)
{
if (entry == null) {throw new IllegalArgumentException("Cannot remove a null entry from the cache");}
if (m_count < 1) {throw new IllegalStateException("Trying to remove an entry from an empty cache");}
entry.m_key = entry.m_object = null;
if (m_count == 1)
{
m_head = m_tail = null;
}
else
{
if (entry.m_prev == null) // the head
{
m_head = entry.m_next;
m_head.m_prev = null;
entry.m_next = null;
}
else if (entry.m_next == null) // the tail
{
m_tail = entry.m_prev;
m_tail.m_next = null;
entry.m_prev = null;
}
else // in the middle
{
entry.m_next.m_prev = entry.m_prev;
entry.m_prev.m_next = entry.m_next;
entry.m_prev = null;
entry.m_next = null;
}
}
--m_count;
entryRemoved(entry);
}
/**
* Callback that signals that the given entry is just about to be added.
* @param entry
*/
protected void entryPromotion(LRUCacheEntry entry) {}
/**
* Callback that signals that the given entry has been added to the cache.
* @param entry
*/
protected void entryAdded(LRUCacheEntry entry) {}
/**
* Callback that signals that the given entry has been removed from the cache.
* @param entry
*/
protected void entryRemoved(LRUCacheEntry entry) {}
/**
* Callback that signals that the capacity of the cache is changed.
* @param oldCapacity the capacity before the change happened
*/
protected void capacityChanged(int oldCapacity) {}
protected void clear()
{
LRUCacheEntry entry = m_head;
m_head = null;
m_tail = null;
m_count = 0;
for (; entry != null; entry = entry.m_next)
entryRemoved(entry);
}
public String toString()
{
String s = Integer.toHexString(super.hashCode());
s += " size: " + m_count;
for (LRUCacheEntry entry = m_head; entry != null; entry = entry.m_next)
{
s += "\n" + entry;
}
return s;
}
}
/**
* Double linked cell used as entry in the cache list.
*/
public class LRUCacheEntry
{
/** Reference to the next cell in the list */
public LRUCacheEntry m_next;
/** Reference to the previous cell in the list */
public LRUCacheEntry m_prev;
/** The key used to retrieve the cached object */
public Object m_key;
/** The cached object */
public Object m_object;
/** The timestamp of the creation */
public long m_time;
/**
* Creates a new double linked cell, storing the object we
* want to cache and the key that is used to retrieve it.
* @param key
* @param object
*/
protected LRUCacheEntry(Object key, Object object)
{
m_key = key;
m_object = object;
m_next = null;
m_prev = null;
m_time = 0; // Set when inserted in the list.
}
public String toString()
{
return "key: " + m_key + ", object: " + ( m_object==null ? "null" : Integer.toHexString(m_object.hashCode())) + ", entry: " + Integer.toHexString(super.hashCode());
}
}
}
libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/SoftObject.java 0000644 0001750 0001750 00000007322 10774222622 032065 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util;
import java.lang.ref.SoftReference;
import java.lang.ref.ReferenceQueue;
/**
* Convenience class to wrap an Object into a SoftReference.
*
* EmptyCollectionException with the specified
* detail message.
*
* @param msg Detail message.
*/
public EmptyCollectionException(String msg) {
super(msg);
}
/**
* Construct a EmptyCollectionException with no detail.
*/
public EmptyCollectionException() {
super();
}
}
././@LongLink 0000000 0000000 0000000 00000000163 00000000000 011565 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/collection/WeakIdentityHashMap.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/collection/WeakIdenti0000644 0001750 0001750 00000072621 10774222622 033266 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.collection;
import java.lang.ref.WeakReference;
import java.lang.ref.ReferenceQueue;
import java.util.*;
/**
* A hashtable-based Map implementation with weak keys and
* using reference-equality in place of object-equality when comparing keys
* (and values). In an WeakIdentityHashMap, two keys k1 and
* k2 are considered equal if and only if (k1==k2).
* An entry in a WeakIdentityHashMap will automatically be removed when
* its key is no longer in ordinary use. More precisely, the presence of a
* mapping for a given key will not prevent the key from being discarded by the
* garbage collector, that is, made finalizable, finalized, and then reclaimed.
* When a key has been discarded its entry is effectively removed from the map.
*
* addLast(Object) and removeFirst().
*
* @param CollectionException with the specified
* detail message.
*
* @param msg Detail message.
*/
public CollectionException(String msg) {
super(msg);
}
/**
* Construct a CollectionException with no detail.
*/
public CollectionException() {
super();
}
}
././@LongLink 0000000 0000000 0000000 00000000157 00000000000 011570 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/collection/SecurityActions.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/collection/SecurityAc0000644 0001750 0001750 00000004273 11015577255 033317 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source.
* Copyright 2006, Red Hat Middleware LLC, and individual contributors
* as indicated by the @author tags. See the copyright.txt file in the
* distribution for a full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.collection;
import java.security.AccessController;
import java.security.PrivilegedAction;
/**
*
* @author Kabir Khan
* @version $Revision: 1.1 $
*/
class SecurityActions
{
interface GetClassLoaderAction
{
ClassLoader getClassLoader(Class clazz);
GetClassLoaderAction NON_PRIVILEGED = new GetClassLoaderAction() {
public ClassLoader getClassLoader(Class clazz)
{
return clazz.getClassLoader();
}};
GetClassLoaderAction PRIVILEGED = new GetClassLoaderAction() {
public ClassLoader getClassLoader(final Class clazz)
{
return AccessController.doPrivileged(new PrivilegedActionCollection which translates added objects
* into {@link SoftObject} references, allowing the VM to garbage collect
* objects in the collection when memory is low.
*
* @version $Revision: 2787 $
* @author Jason Dillon
*/
@SuppressWarnings("unchecked")
public class CachedCollection
extends AbstractCollection
{
/** Reference queue */
protected final ReferenceQueue queue = new ReferenceQueue();
/** Wrapped collection */
protected final Collection collection;
/**
* Construct a CachedCollection.
*
* @param collection Collection to wrap.
*/
public CachedCollection(final Collection collection) {
this.collection = collection;
}
/**
* Returns an iterator over the elements contained in this collection.
*
* @return An iterator over the elements contained in this collection.
*/
public Iterator iterator() {
maintain();
return new MyIterator(collection.iterator());
}
/**
* Returns the size of the collection.
*
* @return The number of elements in the collection.
*/
public int size() {
maintain();
return collection.size();
}
/**
* Add an object to the collection.
*
* @param obj Object (or null to add to the collection.
* @return True if object was added.
*/
public boolean add(final Object obj) {
maintain();
SoftObject soft = SoftObject.create(obj, queue);
return collection.add(soft);
}
/**
* Maintains the collection by removing garbage collected objects.
*/
private void maintain() {
SoftObject obj;
int count = 0;
while ((obj = (SoftObject)queue.poll()) != null) {
count++;
collection.remove(obj);
}
if (count != 0) {
// some temporary debugging fluff
System.err.println("vm reclaimed " + count + " objects");
}
}
/////////////////////////////////////////////////////////////////////////
// De-Referencing Iterator //
/////////////////////////////////////////////////////////////////////////
/**
* A dereferencing iterator.
*/
private final class MyIterator
implements Iterator
{
private final Iterator iter;
public MyIterator(final Iterator iter) {
this.iter = iter;
}
public boolean hasNext() {
maintain();
return iter.hasNext();
}
private Object nextObject() {
Object obj = iter.next();
return Objects.deref(obj);
}
public Object next() {
maintain();
return nextObject();
}
public void remove() {
maintain();
iter.remove();
}
}
}
././@LongLink 0000000 0000000 0000000 00000000147 00000000000 011567 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/collection/SoftSet.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/collection/SoftSet.ja0000644 0001750 0001750 00000014415 10774222622 033217 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.collection;
import java.lang.ref.ReferenceQueue;
import java.lang.ref.SoftReference;
import java.lang.reflect.Array;
import java.util.Collection;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Set;
/**
* An implementation of Set that manages a map of soft references to
* the set values. The map is keyed by the value hashCode and so this
* is only useful for value whose hashCode is a valid identity
* representation (String, primative wrappers, etc).
*
* @author Scott.Stark@jboss.org
* @version $Revision: 2787 $
*/
@SuppressWarnings("unchecked")
public class SoftSet implements Set
{
private HashMap map = new HashMap();
/** The queue of garbage collected soft references */
private ReferenceQueue gcqueue = new ReferenceQueue();
static class ComparableSoftReference extends SoftReference
{
private Integer key;
ComparableSoftReference(Integer key, Object o, ReferenceQueue q)
{
super(o, q);
this.key = key;
}
Integer getKey()
{
return key;
}
}
static class ComparableSoftReferenceIterator implements Iterator
{
Iterator theIter;
ComparableSoftReferenceIterator(Iterator theIter)
{
this.theIter = theIter;
}
public boolean hasNext()
{
return theIter.hasNext();
}
public Object next()
{
ComparableSoftReference csr = (ComparableSoftReference) theIter.next();
return csr.get();
}
public void remove()
{
theIter.remove();
}
}
/**
*
*/
public SoftSet()
{
}
public int size()
{
processQueue();
return map.size();
}
public boolean isEmpty()
{
processQueue();
return map.isEmpty();
}
public boolean contains(Object o)
{
processQueue();
Integer key = new Integer(o.hashCode());
boolean contains = map.containsKey(key);
return contains;
}
public Iterator iterator()
{
processQueue();
Iterator theIter = map.values().iterator();
return new ComparableSoftReferenceIterator(theIter);
}
public Object[] toArray()
{
processQueue();
return toArray(new Object[0]);
}
public Object[] toArray(Object[] a)
{
processQueue();
int size = map.size();
Object[] array = {};
if( a.length >= size )
array = a;
Iterator iter = map.values().iterator();
int index = 0;
while( iter.hasNext() )
{
ComparableSoftReference csr = (ComparableSoftReference) iter.next();
Object value = csr.get();
// Create the correct array type
if( array.length == 0 )
{
if( value == null )
{
index ++;
continue;
}
Array.newInstance(value.getClass(), size);
}
array[index] = value;
index ++;
}
return array;
}
public boolean add(Object o)
{
processQueue();
Integer key = new Integer(o.hashCode());
ComparableSoftReference sr = new ComparableSoftReference(key, o, gcqueue);
return map.put(key, sr) == null;
}
public boolean remove(Object o)
{
processQueue();
Integer key = new Integer(o.hashCode());
return map.remove(key) != null;
}
public boolean containsAll(Collection c)
{
processQueue();
Iterator iter = c.iterator();
boolean contains = true;
while( iter.hasNext() )
{
Object value = iter.next();
Integer key = new Integer(value.hashCode());
contains &= map.containsKey(key);
}
return contains;
}
public boolean addAll(Collection c)
{
processQueue();
Iterator iter = c.iterator();
boolean added = false;
while( iter.hasNext() )
{
Object value = iter.next();
Integer key = new Integer(value.hashCode());
ComparableSoftReference sr = new ComparableSoftReference(key, value, gcqueue);
added |= map.put(key, sr) == null;
}
return added;
}
public boolean retainAll(Collection c)
{
Iterator iter = iterator();
boolean removed = false;
while( iter.hasNext() )
{
Object value = iter.next();
if( c.contains(value) == false )
{
iter.remove();
removed = true;
}
}
return removed;
}
public boolean removeAll(Collection c)
{
processQueue();
Iterator iter = c.iterator();
boolean removed = false;
while( iter.hasNext() )
{
Object value = iter.next();
removed |= remove(value);
}
return removed;
}
public void clear()
{
while( gcqueue.poll() != null )
;
map.clear();
}
public boolean equals(Object o)
{
return map.equals(o);
}
public int hashCode()
{
return map.hashCode();
}
/**
* Iterate through the gcqueue for for any cleared reference, remove
* the associated value from the underlying set.
*/
private void processQueue()
{
ComparableSoftReference cr;
while( (cr = (ComparableSoftReference) gcqueue.poll()) != null )
{
map.remove(cr.getKey());
}
}
}
././@LongLink 0000000 0000000 0000000 00000000147 00000000000 011567 L ustar root root libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/collection/ListSet.java libjboss-common-java-0.0+svn2938.orig/common-core/src/main/java/org/jboss/util/collection/ListSet.ja0000644 0001750 0001750 00000011611 10776226110 033210 0 ustar twerner twerner /*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.util.collection;
import java.util.List;
import java.util.ArrayList;
import java.util.Set;
import java.util.AbstractSet;
import java.util.Iterator;
import java.util.Collection;
import java.io.Serializable;
import org.jboss.util.NullArgumentException;
/**
* A thin wrapper around a List transforming it into a
* modifiable Set.
*
* @version $Revision: 2800 $
* @author Jason Dillon
*/
@SuppressWarnings("unchecked")
public class ListSet
extends AbstractSet
implements Set, Cloneable, Serializable
{
/** The serialVersionUID */
private static final long serialVersionUID = 7333619218072079496L;
/** The List which will be used for element storage. */
protected final List list;
/**
* Construct a ListSet.
*
* @param list The List which will be used for element storage.
*
* @throws IllegalArgumentException List is null or contains
* duplicate entries.
*/
public ListSet(final List list) {
if (list == null)
throw new NullArgumentException("list");
// make sure there are no duplicates
int size = list.size();
for (int i=0; i