* Hinweis: Der Test mit {@code equals()} auf den Leerstring ist
* sehr ineffektiv, deswegen sollte bis Java 6 besser geprüft werden ob
* {@link String#length()} gleich 0 ist. Ab Java 6 kann für den Test auf den
* Leerstring {@link String#isEmpty()} verwendet werden.
*/
public static final String EMPTY_STRING = "";
/** Faktor für Prozentrechnung. */
public static final int PERCENT = 100;
private Constants() {
// Konstruktor verstecken
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/ReleaseInfo.java 0000664 0000000 0000000 00000012422 13154212327 0023650 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl;
import java.util.regex.Pattern;
/**
* Beschreibt die komplette Versionsnummer eines Release nach dem allgemeinen
* Schema {major release}.{minor release}.{patch level}-{build number}. Bis auf
* Major-Release sind die Angaben optional.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public class ReleaseInfo {
/** Der regüläre Ausdruck, der eine Versionsnummer beschreibt. */
private static final String PATTERN = "(\\d)+(\\.(\\d)+(\\.(\\d)+(-(\\d)+)?)?)?";
private final Integer major;
private final Integer minor;
private final Integer patchLevel;
private final Integer buildNumber;
/**
* Erzeugt eine Versionsnummer.
*
* @param major
* das Major-Release.
*/
public ReleaseInfo(final int major) {
this.major = major;
this.minor = null;
this.patchLevel = null;
this.buildNumber = null;
}
/**
* Erzeugt eine Versionsnummer.
*
* @param major
* das Major-Release.
* @param minor
* das Minor-Release.
*/
public ReleaseInfo(final int major, final int minor) {
this.major = major;
this.minor = minor;
this.patchLevel = null;
this.buildNumber = null;
}
/**
* Erzeugt eine Versionsnummer.
*
* @param major
* das Major-Release.
* @param minor
* das Minor-Release.
* @param patchLevel
* der Patch-Level.
*/
public ReleaseInfo(final int major, final int minor, final int patchLevel) {
this.major = major;
this.minor = minor;
this.patchLevel = patchLevel;
this.buildNumber = null;
}
/**
* Erzeugt eine Versionsnummer.
*
* @param major
* das Major-Release.
* @param minor
* das Minor-Release.
* @param patchLevel
* der Patch-Level.
* @param buildNumber
* die Build-Number.
*/
public ReleaseInfo(final int major, final int minor, final int patchLevel,
final int buildNumber) {
this.major = major;
this.minor = minor;
this.patchLevel = patchLevel;
this.buildNumber = buildNumber;
}
/**
* Erzeugt eine Versionsnummer.
*
* @param release
* ein String, der die Versionsnummer enthält.
*/
public ReleaseInfo(final String release) {
if (Pattern.matches(PATTERN, release)) {
int start, end;
start = 0;
end = release.indexOf(".");
if (end < 0) {
major = Integer.valueOf(release.substring(start));
minor = null;
patchLevel = null;
buildNumber = null;
return;
}
major = Integer.valueOf(release.substring(start, end));
start = end + 1;
end = release.indexOf(".", start);
if (end < 0) {
minor = Integer.valueOf(release.substring(start));
patchLevel = null;
buildNumber = null;
return;
}
minor = Integer.valueOf(release.substring(start, end));
start = end + 1;
end = release.indexOf("-", start);
if (end < 0) {
patchLevel = Integer.valueOf(release.substring(start));
buildNumber = null;
return;
}
patchLevel = Integer.valueOf(release.substring(start, end));
start = end + 1;
if (start == release.length()) {
buildNumber = null;
return;
}
buildNumber = Integer.valueOf(release.substring(start));
} else {
throw new IllegalArgumentException(
"Release muss dem Muster 1[.4[.2[-15]]] entsprechen.");
}
}
/**
* Gibt falls vorhanden die Build-Number zurück.
*
* @return die Build-Number.
*/
public Integer getBuildNumber() {
return buildNumber;
}
/**
* Gibt das Major-Release zurück.
*
* @return das Major-Release.
*/
public Integer getMajor() {
return major;
}
/**
* Gibt falls vorhanden das Minor-Release zurück.
*
* @return das Minor-Release.
*/
public Integer getMinor() {
return minor;
}
/**
* Gibt falls vorhanden den Patch-Level zurück.
*
* @return der Patch-Level.
*/
public Integer getPatchLevel() {
return patchLevel;
}
/**
* Gibt das Release für den Menschen lesbar zurück. Teile die nicht
* angegeben sind, werden nicht ausgegeben. Fehlt z. B. die Build
* Number wird diese auch nicht berücksichtigt.
*
* @return ein Text nach dem Muster 1[.4[.2[-15]]].
*/
@Override
public String toString() {
String s;
s = major.toString();
if (minor != null) {
s += "." + minor;
if (patchLevel != null) {
s += "." + patchLevel;
if (buildNumber != null) {
s += "-" + buildNumber;
}
}
}
return s;
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/VersionInfo.java 0000664 0000000 0000000 00000007144 13154212327 0023722 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.jar.Attributes;
import java.util.jar.Manifest;
/**
* Beschreibt eine Applikation oder Bibliothek.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public class VersionInfo {
private final String title;
private final String version;
private final String vendor;
private final String vendorUrl;
/**
* Liest die Beschreibung aus dem Manifest-File.
*
* @param manifest
* ein Manifestfile.
* @see Attributes.Name#IMPLEMENTATION_TITLE
* @see Attributes.Name#IMPLEMENTATION_VERSION
* @see Attributes.Name#IMPLEMENTATION_VENDOR
* @see Attributes.Name#IMPLEMENTATION_URL
*/
public VersionInfo(final Manifest manifest) {
Attributes attributes;
attributes = manifest.getMainAttributes();
title = attributes.getValue(Attributes.Name.IMPLEMENTATION_TITLE);
version = attributes.getValue(Attributes.Name.IMPLEMENTATION_VERSION);
vendor = attributes.getValue(Attributes.Name.IMPLEMENTATION_VENDOR);
vendorUrl = attributes.getValue(Attributes.Name.IMPLEMENTATION_URL);
}
/**
* Erzeugt eine Beschreibung.
*
* @param title
* der Name der Applikation oder der Bibliothek.
* @param version
* die Versionsnummer.
* @param vendor
* das Unternehmen.
* @param vendorUrl
* die Internetseite des Unternehmens.
*/
public VersionInfo(final String title, final String version,
final String vendor, final String vendorUrl) {
this.title = title;
this.version = version;
this.vendor = vendor;
this.vendorUrl = vendorUrl;
}
/**
* Gibt die Versionsnummer als {@code ReleaseInfo} zurück. Dies ist nur
* möglich, wenn die Versionsnummer einer Releasenummer entspricht.
*
* @return das Release.
*/
public ReleaseInfo getReleaseInfo() {
return new ReleaseInfo(getVersion());
}
/**
* Gibt den Namen der Applikation oder der Bibliothek zurück.
*
* @return der Name.
*/
public String getTitle() {
return title;
}
/**
* Gibt die Internetseite des Unternehmens zurück.
*
* @return die Unternehmensseite.
*/
public URL getURL() {
try {
return new URL(getVendorUrl());
} catch (MalformedURLException ex) {
throw new IllegalStateException(ex);
}
}
/**
* Gibt das Unternehmen zurück.
*
* @return das Unternehmen.
*/
public String getVendor() {
return vendor;
}
/**
* Gibt die Internetseite des Unternehmens zurück.
*
* @return die Unternehmensseite.
*/
public String getVendorUrl() {
return vendorUrl;
}
/**
* Gibt die Version zurück.
*
* @return die Version.
*/
public String getVersion() {
return version;
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/beans/ 0000775 0000000 0000000 00000000000 13154212327 0021700 5 ustar 00root root 0000000 0000000 com.bitctrl-2.0.2/src/main/java/com/bitctrl/beans/AbstractBeanInfo.java 0000664 0000000 0000000 00000021426 13154212327 0025715 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.beans;
import java.beans.BeanDescriptor;
import java.beans.IntrospectionException;
import java.beans.PropertyDescriptor;
import java.beans.SimpleBeanInfo;
import java.lang.reflect.Method;
import java.util.Arrays;
import java.util.List;
/**
* Abstracte Implementierung der Beschreibung einer Java Bean. Die Klasse bietet
* eine einheitliche Schnittstelle, um Übersetzungen für Namen und
* Kurzbeschreibung von Java Bean und deren Properties. anzubieten
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public abstract class AbstractBeanInfo extends SimpleBeanInfo {
// Die Descriptoren werden aus Performancegründen nach dem Erzeugen gecacht.
private BeanDescriptor beanDescriptorCache;
/**
* Die Methode legt die zu beschreibende Java Bean fest und setzt deren
* übersetzten Namen und Kurzbeschreibung. Da sich die Bean zur Laufzeit
* i. d. R. nicht ändert wird das Ergebnis der Funktion intern
* statisch gecacht, so dass der Aufruf ab dem zweiten Mal schneller
* vonstatten geht.
*
* {@inheritDoc}
*
* @see AbstractBeanInfo#getBeanClass()
* @see #getDisplayName()
* @see #getShortDescription()
*/
@Override
public BeanDescriptor getBeanDescriptor() {
synchronized (AbstractBeanInfo.class) {
if (beanDescriptorCache == null) {
final Class beanClass = getBeanClass();
beanDescriptorCache = new BeanDescriptor(beanClass);
beanDescriptorCache.setDisplayName(getDisplayName());
beanDescriptorCache.setShortDescription(getShortDescription());
}
}
return beanDescriptorCache;
}
/**
* Die Methode registriert die vorhandenen Properties und setzt deren übersetzte
* Namen und Kurzbeschreibungen. In Umgebungen mit Mehrsprachigkeit können sich
* die Properties zur Laufzeit ändern (z.B. {@link #getDisplayName(PropertyInfo)}.
*
* {@inheritDoc}
*
* @see #getProperties()
* @see #getDisplayName(PropertyInfo)
* @see #getShortDescription(PropertyInfo)
* @see #getHiddenProperties()
* @see #getPreferredProperties()
* @see #getExpertProperties()
*/
@Override
public PropertyDescriptor[] getPropertyDescriptors() {
synchronized (AbstractBeanInfo.class) {
final PropertyInfo[] propInfo = getProperties();
final List hiddenProps = Arrays.asList(getHiddenProperties());
final List preferredProps = Arrays.asList(getPreferredProperties());
final List expertProps = Arrays.asList(getExpertProperties());
PropertyDescriptor[] propertyDescriptors = new PropertyDescriptor[propInfo.length];
try {
for (int i = 0; i < propertyDescriptors.length; ++i) {
final PropertyDescriptor prop;
Class beanClass = getBeanClass();
String propName = propInfo[i].name();
propName = propName.substring(0, 1).toUpperCase() + propName.substring(1);
String readMethodName = getReadMethodName(beanClass, propName);
String writeMethodName = getWriteMethodName(beanClass, propName);
prop = new PropertyDescriptor(propInfo[i].name(), getBeanClass(), readMethodName, writeMethodName);
prop.setDisplayName(getDisplayName(propInfo[i]));
prop.setShortDescription(getShortDescription(propInfo[i]));
if (hiddenProps.contains(propInfo[i])) {
prop.setHidden(true);
}
if (preferredProps.contains(propInfo[i])) {
prop.setPreferred(true);
}
if (expertProps.contains(propInfo[i])) {
prop.setExpert(true);
}
propertyDescriptors[i] = prop;
}
} catch (final IntrospectionException ex) {
propertyDescriptors = null;
throw new IllegalStateException(ex);
}
return propertyDescriptors;
}
}
private String getReadMethodName(Class beanClass, String propName) {
try {
return beanClass.getMethod("get" + propName).getName();
} catch (NoSuchMethodException ignored) {
try {
return beanClass.getMethod("is" + propName).getName();
} catch (NoSuchMethodException ex) {
return null;
}
}
}
private String getWriteMethodName(Class beanClass, String propName) {
String name = "set" + propName;
Method[] declaredMethods = beanClass.getDeclaredMethods();
for ( Method method : declaredMethods) {
if( name.equals(method.getName())) {
return name;
}
}
return null;
}
/**
* Gibt die Liste der Properties zurück der Java Bean zurück.
*
* @return die Popertyliste.
*/
protected abstract PropertyInfo[] getProperties();
/**
* Gibt die Liste der Properties zurück, die standardmäßig ausgeblendet
* werden sollen. Abgeleite Klassen können die Methode überschreiben. Die
* Standardimplementierung gibt eine leere Liste zurück.
*
* Hinweis: Die versteckten Properties müssen auch in der Liste
* aller Properties enthalten sein.
*
* @return die Liste der versteckten Properties oder ein leeres Feld,
* niemals {@code null}.
* @see #getProperties()
*/
protected PropertyInfo[] getHiddenProperties() {
return new PropertyInfo[0];
}
/**
* Gibt die Liste der Properties zurück, die als wichtig hervorgehoben
* werden sollen. Abgeleite Klassen können die Methode überschreiben. Die
* Standardimplementierung gibt eine leere Liste zurück.
*
* Hinweis: Die wichtigen Properties müssen auch in der Liste aller
* Properties enthalten sein.
*
* @return die Liste der wichtigen Properties oder ein leeres Feld, niemals
* {@code null}.
* @see #getProperties()
*/
protected PropertyInfo[] getPreferredProperties() {
return new PropertyInfo[0];
}
/**
* Gibt die Liste der Properties zurück, die nur fortgeschrittenen Nutzern
* angeboten werden sollen. Abgeleite Klassen können die Methode
* überschreiben. Die Standardimplementierung gibt eine leere Liste zurück.
*
* Hinweis: Die Expertenproperties müssen auch in der Liste aller
* Properties enthalten sein.
*
* @return die Liste der Expertenproperties oder ein leeres Feld, niemals
* {@code null}.
* @see #getProperties()
*/
protected PropertyInfo[] getExpertProperties() {
return new PropertyInfo[0];
}
/**
* Gibt den übersetzten Namen der Property zurück. Die Methode sollte in
* abgeleiteten Klassen überschrieben werden. Die Standardimplementierung
* gibt einfach den Propertynamen zurück.
*
* @param info
* eine Propertybeschreibung.
* @return der übersetzte Propertyname.
*/
protected String getDisplayName(final PropertyInfo info) {
return info.name();
}
/**
* Gibt eine kurze Beschreibung der Property zurück. Diese kann z. B.
* von einem Editor als Tooltip angezeigt werden. Die Methode sollte in
* abgeleiteten Klassen überschrieben werden. Die Standardimplementierung
* gibt einfach den übersetzen Propertynamen zurück.
*
* @param info
* eine Propertybeschreibung.
* @return die kurze Beanbeschreibung.
* @see #getDisplayName(PropertyInfo)
*/
protected String getShortDescription(final PropertyInfo info) {
return getDisplayName(info);
}
/**
* Gibt die Klasse der zu beschreibenden Java Bean zurück.
*
* @return die Beanklasse.
*/
protected abstract Class getBeanClass();
/**
* Gibt den übersetzten Namen der Java Bean zurück. Die Methode sollte in
* abgeleiteten Klassen überschrieben werden. Die Standardimplementierung
* gibt einfach den Klassennamen (ohne Package) zurück.
*
* @return der übersetzte Beanname.
*/
protected String getDisplayName() {
return getBeanClass().getSimpleName();
}
/**
* Gibt eine kurze Beschreibung der Java Bean zurück. Diese kann z. B.
* von einem Editor als Tooltip angezeigt werden. Die Methode sollte in
* abgeleiteten Klassen überschrieben werden. Die Standardimplementierung
* gibt einfach den übersetzen Beannamen zurück.
*
* @return die kurze Beanbeschreibung.
* @see #getDisplayName()
*/
protected String getShortDescription() {
return getDisplayName();
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/beans/BeanEvent.java 0000664 0000000 0000000 00000003253 13154212327 0024415 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.beans;
import java.util.EventObject;
/**
* Dieses Event enthält die Informationen über die Änderungen einer Bean.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public class BeanEvent extends EventObject {
private static final long serialVersionUID = 1L;
private final Object beanData;
/**
* Initialisert das Event.
*
* @param source
* die Quelle des Events.
* @param beanData
* die neuen Daten der Bean.
*/
public BeanEvent(final Object source, final Object beanData) {
super(source);
this.beanData = beanData;
}
/**
* Gibt die neuen Daten der Bean zurück.
*
* @return die Beandaten.
*/
public Object getBeanData() {
return beanData;
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/beans/BeanListener.java 0000664 0000000 0000000 00000002571 13154212327 0025123 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.beans;
import java.util.EventListener;
/**
* Der Listener wird informiert, wenn sich eine beliebige Property einer Bean
* geändert hat.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public interface BeanListener extends EventListener {
/**
* Informiert einen Listener über die Propertyänderung an einer Bean.
*
* @param e
* das Event.
*/
void beanChanged(BeanEvent e);
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/beans/BeanUtils.java 0000664 0000000 0000000 00000027361 13154212327 0024442 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.beans;
import java.beans.BeanInfo;
import java.beans.IntrospectionException;
import java.beans.Introspector;
import java.beans.PropertyDescriptor;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.util.Collections;
import java.util.Map;
import java.util.WeakHashMap;
/**
* Enthält Hilfsmethoden für den Umgang mit Java Beans.
*
* @author BitCtrl Systems GmbH, Schumann
*/
public final class BeanUtils {
/**
* Kopiert eine Java-Bean. Es werden alle Properties kopiert, die über einen
* Getter und Setter verfügen. Sind beide vorhanden, müssen sie auch {@code
* public} sein.
*
* @param source
* die zu kopierende Bean.
* @return die Kopie der Bean.
* @throws IllegalArgumentException
* wenn die Bean nicht kopierbar ist.
*/
public static Object copy(final Object source) {
final Class clazz = source.getClass();
final BeanInfo info;
try {
info = Introspector.getBeanInfo(clazz);
} catch (final IntrospectionException ex) {
throw new IllegalArgumentException("Can not introspect bean: "
+ clazz, ex);
}
final Object target;
try {
target = clazz.newInstance();
} catch (final InstantiationException ex) {
throw new IllegalArgumentException(
"Can not copy interface or abstract class: " + clazz, ex);
} catch (final IllegalAccessException ex) {
throw new IllegalArgumentException(
"Bean must have a public default constructor: " + clazz, ex);
}
for (final PropertyDescriptor pd : info.getPropertyDescriptors()) {
final Method getter = pd.getReadMethod();
final Method setter = pd.getWriteMethod();
if (getter != null && setter != null) {
try {
setter.invoke(target, getter.invoke(source));
} catch (final IllegalArgumentException ex) {
throw new IllegalArgumentException(
"Getter and setter have different type: " + clazz
+ ", " + pd, ex);
} catch (final IllegalAccessException ex) {
throw new IllegalArgumentException(
"Getter and setter must be public: " + clazz + ", "
+ pd, ex);
} catch (final InvocationTargetException ex) {
throw new IllegalArgumentException(
"Getter or setter throws an exception: " + clazz
+ ", " + pd, ex);
}
}
}
return target;
}
/**
* Erstellt eine neue Instanz der übergebenen Bean-Klasse.
*
* @param
* der Typ der Bean die angelegt werden soll.
* @param beanClass
* die Klasse der Bean die angelegt werden soll.
* @return die neue Instanz der Bean.
*/
public static T createInstance(final Class beanClass) {
try {
return beanClass.newInstance();
} catch (final InstantiationException ex) {
throw new IllegalArgumentException(
"Cannot create new instance of bean type " + beanClass
+ ".", ex);
} catch (final IllegalAccessException ex) {
throw new IllegalArgumentException(
"Cannot create new instance of bean type " + beanClass
+ ".", ex);
}
}
/**
* Liest den Wert der Property einer Java Bean.
*
* @param target
* eine Java Bean.
* @param propertyName
* der Name der Property.
* @return der Wert.
*/
public static Object getProperty(final Object target,
final String propertyName) {
final BeanInfo beanInfo = getBeanInfo(target.getClass());
for (final PropertyDescriptor pd : beanInfo.getPropertyDescriptors()) {
if (pd.getName().equals(propertyName)) {
try {
return pd.getReadMethod().invoke(target);
} catch (final IllegalAccessException ex) {
throw new IllegalArgumentException(
"Cannot read property data.", ex);
} catch (final InvocationTargetException ex) {
throw new IllegalArgumentException(
"Cannot read property data.", ex);
}
}
}
throw new IllegalArgumentException("Bean "
+ target.getClass().getName() + " has no property "
+ propertyName + ".");
}
/**
* Setzt den Wert der Property einer Java Bean.
*
* @param target
* eine Java Bean.
* @param propertyName
* der Name der Property.
* @param value
* der neue Wert.
*/
public static void setProperty(final Object target,
final String propertyName, final Object value) {
final BeanInfo beanInfo = getBeanInfo(target.getClass());
for (final PropertyDescriptor pd : beanInfo.getPropertyDescriptors()) {
if (pd.getName().equals(propertyName)) {
try {
pd.getWriteMethod().invoke(target, value);
} catch (final IllegalAccessException ex) {
throw new IllegalArgumentException(
"Cannot set property data.", ex);
} catch (final InvocationTargetException ex) {
throw new IllegalArgumentException(
"Cannot set property data.", ex);
}
return;
}
}
throw new IllegalArgumentException("Bean "
+ target.getClass().getName() + " has no property "
+ propertyName + ".");
}
private static Map, BeanInfo> beanInfoCache = Collections
.synchronizedMap(new WeakHashMap, BeanInfo>());
/**
* Bestimmt zu einer Klasse die dazugehörige {@link BeanInfo}. Es wird die
* Bean Info-Klasse direkt geladen, weil
* {@link Introspector#getBeanInfo(Class)} eine Bean Info zurückgibt, deren
* Properties nicht mehr der Originalsortierung entsprechen. Sollte die Bean
* Info-Klasse nicht direkt geladen werden können, wird als Rückfallebene
* der Introspector gefragt.
*
* @param beanClass
* eine Klasse.
* @return die Bean Info zu der Klasse.
*/
public static BeanInfo getBeanInfo(final Class beanClass) {
if (beanInfoCache.containsKey(beanClass)) {
return beanInfoCache.get(beanClass);
}
final ClassLoader loader = beanClass.getClassLoader();
Class beanInfoClass;
BeanInfo info = null;
try {
beanInfoClass = (Class) loader
.loadClass(beanClass.getName() + "BeanInfo");
info = beanInfoClass.newInstance();
} catch (final ClassNotFoundException ex) {
try {
info = Introspector.getBeanInfo(beanClass);
} catch (final IntrospectionException ex1) {
throw new IllegalArgumentException(
"Can not analyze Java Bean type " + beanClass + ".",
ex1);
}
} catch (final InstantiationException ex) {
throw new IllegalArgumentException(
"Can not analyze Java Bean type " + beanClass + ".", ex);
} catch (final IllegalAccessException ex) {
throw new IllegalArgumentException(
"Can not analyze Java Bean type " + beanClass + ".", ex);
}
beanInfoCache.put(beanClass, info);
return info;
}
/**
* Prüft, ob es sich bei einer Property um eine Textproperty handelt.
*
* @param pd
* ein Property Descriptor.
* @return {@code true}, wenn es sich um eine Textproperty handelt.
*/
public static boolean isText(final PropertyDescriptor pd) {
return pd.getPropertyType().isAssignableFrom(String.class);
}
/**
* Prüft, ob es sich bei einer Property um eine ganze Zahl handelt.
*
* @param pd
* ein Property Descriptor.
* @return {@code true}, wenn es sich um eine ganze Zahl handelt.
*/
public static boolean isNumber(final PropertyDescriptor pd) {
return pd.getPropertyType().isAssignableFrom(long.class)
|| pd.getPropertyType().isAssignableFrom(Long.class)
|| pd.getPropertyType().isAssignableFrom(int.class)
|| pd.getPropertyType().isAssignableFrom(Integer.class)
|| pd.getPropertyType().isAssignableFrom(short.class)
|| pd.getPropertyType().isAssignableFrom(Short.class)
|| pd.getPropertyType().isAssignableFrom(byte.class)
|| pd.getPropertyType().isAssignableFrom(Byte.class);
}
/**
* Prüft, ob es sich bei einer Property um eine reele Zahl handelt.
*
* @param pd
* ein Property Descriptor.
* @return {@code true}, wenn es sich um eine reele Zahl handelt.
*/
public static boolean isRealNumber(final PropertyDescriptor pd) {
return pd.getPropertyType().isAssignableFrom(float.class)
|| pd.getPropertyType().isAssignableFrom(Float.class)
|| pd.getPropertyType().isAssignableFrom(double.class)
|| pd.getPropertyType().isAssignableFrom(Double.class);
}
/**
* Prüft, ob es sich bei einer Property um eine Boolean-Property handelt.
*
* @param pd
* ein Property Descriptor.
* @return {@code true}, wenn es sich um eine Boolean-Property handelt.
*/
public static boolean isBoolean(final PropertyDescriptor pd) {
return pd.getPropertyType().isAssignableFrom(boolean.class)
|| pd.getPropertyType().isAssignableFrom(Boolean.class);
}
/**
* Prüft, ob es sich bei einer Property um eine Zeitangabe handelt.
*
* @param pd
* ein Property Descriptor.
* @return {@code true}, wenn es sich um eine Zeitangabe handelt.
*/
public static boolean isTime(final PropertyDescriptor pd) {
return pd.getPropertyType().isAssignableFrom(java.sql.Time.class);
}
/**
* Prüft, ob es sich bei einer Property um eine Datumsangabe handelt.
*
* @param pd
* ein Property Descriptor.
* @return {@code true}, wenn es sich um eine Datumsangabe handelt.
*/
public static boolean isDate(final PropertyDescriptor pd) {
return pd.getPropertyType().isAssignableFrom(java.sql.Date.class);
}
/**
* Prüft, ob es sich bei einer Property um einen Zeitstempel handelt.
*
* @param pd
* ein Property Descriptor.
* @return {@code true}, wenn es sich um einen Zeitstempel handelt.
*/
public static boolean isTimestamp(final PropertyDescriptor pd) {
return pd.getPropertyType().isAssignableFrom(java.util.Date.class)
|| pd.getPropertyType().isAssignableFrom(
java.sql.Timestamp.class);
}
/**
* Gibt den eine Bean als String zurück. Der zurückgegebene String
* entspricht dem üblichen allgemeinen {@code toString()} z. B. {@code
* Punkt[x=10, y=20]}.
*
* @param bean
* eine beliebige Java Bean.
* @return der String zur Bean.
*/
public static String toString(final Object bean) {
if (bean == null) {
return "null";
}
final Class objClass = bean.getClass();
final Method[] methods = objClass.getMethods();
String buffer = bean.getClass().getName() + "[";
for (int i = 0; i < methods.length; ++i) {
final Method method = methods[i];
if (!method.getName().equals("getClass")
&& (method.getName().startsWith("get") || method.getName()
.startsWith("is"))
&& method.getParameterTypes().length == 0) {
final String name = method.getName();
if (name.startsWith("get")) {
buffer += name.substring(3);
} else {
buffer += name.substring(2);
}
buffer += "=";
try {
buffer += method.invoke(bean);
} catch (final Exception ex) {
buffer += "[property unreadable]";
}
buffer += ", ";
}
}
// ", " am Ende wieder entfernen
buffer = buffer.substring(0, buffer.length() - 2);
buffer += "]";
return buffer;
}
private BeanUtils() {
// nix
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/beans/PropertyInfo.java 0000664 0000000 0000000 00000003165 13154212327 0025210 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.beans;
/**
* Diese Schnittstelle beschreibt den Namen und die Aufzählungsposition einer
* Property fest. Die Implementierung erfolgt am besten mit Hilfe einer {@code
* enum}-Klasse, dies sichert die einmalig von Name und Position.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public interface PropertyInfo {
/**
* Gibt den Namen der Property zurück.
*
* @return der Propertyname.
*/
String name();
/**
* Vergleicht zwei Infos anhand des Propertynamens.
*
* @param other
* eine andere {@link PropertyInfo}.
* @return {@code true}, wenn beide identisch sind.
* @see #name()
*/
boolean equals(Object other);
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/commands/ 0000775 0000000 0000000 00000000000 13154212327 0022411 5 ustar 00root root 0000000 0000000 com.bitctrl-2.0.2/src/main/java/com/bitctrl/commands/AbstractCommand.java 0000664 0000000 0000000 00000004433 13154212327 0026322 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.commands;
import javax.swing.event.EventListenerList;
/**
* Implementiert die allgemeinen Methoden eines Befehls.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public abstract class AbstractCommand implements Command {
private final EventListenerList listener = new EventListenerList();
private boolean canceled = false;
public void exec() {
new Thread(this, toString()).start();
}
public void cancel() {
canceled = true;
}
public boolean isCanceled() {
return canceled;
}
public void addCommandFinishedListener(final CommandFinishedListener l) {
listener.add(CommandFinishedListener.class, l);
}
public void removeCommandFinishedListener(final CommandFinishedListener l) {
listener.remove(CommandFinishedListener.class, l);
}
/**
* Informiert die angemeldeten Listener über das Ende des Befehls.
*
* @param successful
* {@code true}, wenn der Befehl erfolgreich beendet wurde.
* @param message
* eine Vollzugsmittuilung oder Fehlernachricht.
*/
protected void fireCommandFinished(final boolean successful,
final String message) {
final CommandFinishedEvent e = new CommandFinishedEvent(this,
successful, message);
for (final CommandFinishedListener l : listener
.getListeners(CommandFinishedListener.class)) {
l.commandFinished(e);
}
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/commands/Command.java 0000664 0000000 0000000 00000004454 13154212327 0024641 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.commands;
/**
* Ein ausführbarer Befehl. Der Befehl wird entweder synchron (blockiernd) mit
* {@link #run()} oder asynchron (nicht blockierend) mit {@link #exec()}
* ausgeführt werden.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public interface Command extends Runnable {
/**
* Führt den Befehl aus. Die Methode blockiert während der Ausführung des
* Befehls. Die Methode muss regelmäßig mit {@link #isCanceled()} prüfen, ob
* der Befehl abgebrochen werden soll.
*
* @see #isCanceled()
*/
void run();
/**
* Führt den Befehl im Hintergrund aus. Die Methode blockiert nicht während
* der Ausführung des Befehls, da die {@link #run()}-Methode dazu in einem
* eigenen Thread gestartet wird.
*
* @see #isCanceled()
*/
void exec();
/**
* Signalisiert dem Befehl, dass er abgebrochen werden soll.
*/
void cancel();
/**
* Fragt, ob der Befehl abgebrochen werden soll.
*
* @return {@code true}, wenn der Befehl abgebrochen werden soll.
* @see #exec()
*/
boolean isCanceled();
/**
* Registriert einen Listener.
*
* @param l
* der Listener.
*/
void addCommandFinishedListener(CommandFinishedListener l);
/**
* Meldet einen Listener wieder ab.
*
* @param l
* der Listener.
*/
void removeCommandFinishedListener(CommandFinishedListener l);
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/commands/CommandFinishedEvent.java 0000664 0000000 0000000 00000004614 13154212327 0027313 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.commands;
import java.util.EventObject;
/**
* Dieses Event wird getriggert, wenn ein Befehl beendet wurde.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public class CommandFinishedEvent extends EventObject {
private static final long serialVersionUID = 1L;
private final boolean successful;
private final String message;
/**
* Initialisiert das Objekt {@code CommandFinishedEvent}.
*
* @param source
* die Quelle des Events.
* @param successful
* {@code true}, wenn der Befehl erfolgreich beendet wurde.
* @param message
* eine Vollzugsmitteilung oder Fehlernachricht.
*/
public CommandFinishedEvent(final Command source, final boolean successful,
final String message) {
super(source);
this.successful = successful;
this.message = message;
}
/**
* Gibt die Quelle des Events als Befehl zurück.
*
* @return der beendete Befehl.
*/
public Command getCommand() {
return (Command) source;
}
/**
* Flag, ob der Befehl ohne Fehler abgeschlossen wurde.
*
* @return {@code true}, wenn der Befehl erfolgreich beendet wurde.
*/
public boolean isSuccessful() {
return successful;
}
/**
* Gibt eine Nachricht zurück, die etwas über das Ende des Befehls aussagt.
* Wurde der Befehl mit einem Fehler beendet, wird die Fehlerbeschreibung
* zurückgegeben.
*
* @return die Nachricht.
*/
public String getMessage() {
return message;
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/commands/CommandFinishedListener.java 0000664 0000000 0000000 00000002574 13154212327 0030022 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.commands;
import java.util.EventListener;
/**
* Muss implementiert werden, wenn über das Ende eines Befehls informiert werden
* soll.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public interface CommandFinishedListener extends EventListener {
/**
* Wird aufgerufen, wenn ein Befehl beendet wurde.
*
* @param e
* das Event.
*/
void commandFinished(CommandFinishedEvent e);
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/commands/Makro.java 0000664 0000000 0000000 00000003134 13154212327 0024326 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.commands;
import java.util.ArrayList;
import java.util.List;
/**
* Fasst mehrere Befehle zu einem zusammen. Die einzelnen Befehle werden streng
* nacheinander ausgeführt. Makros können auch verschachtelt werden.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public class Makro extends AbstractCommand {
private final List script = new ArrayList();
/**
* Fügt dem Makro einen auszuführenden Befehl hinzu.
*
* @param cmd
* ein Befehl,
*/
public void add(final Command cmd) {
script.add(cmd);
}
public void run() {
for (final Command cmd : script) {
cmd.run();
}
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/geo/ 0000775 0000000 0000000 00000000000 13154212327 0021362 5 ustar 00root root 0000000 0000000 com.bitctrl-2.0.2/src/main/java/com/bitctrl/geo/GeoUtil.java 0000664 0000000 0000000 00000004257 13154212327 0023605 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.geo;
import java.awt.Dimension;
/**
* Allgemeine geometrische Hilfsmethoden.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public final class GeoUtil {
/**
* Skaliert unter Berücksichtigung des Seitenverhältnisses die Breite und
* Höhe derart, dass die Ausnahme ein bestimmtes Maximum nicht
* überschreiten.
*
* @param toLarge
* die zu skalierende Dimension.
* @param maximum
* das angestrebte Maximum.
* @return die herunterskalierte Dimension im gleichen Seitenverhältnis.
*/
public static Dimension resizeToFit(final Dimension toLarge,
final Dimension maximum) {
if (toLarge == null) {
throw new IllegalArgumentException("toLarge is null");
}
if (maximum == null) {
throw new IllegalArgumentException("maximum is null");
}
final double factorWidth = maximum.getWidth() / toLarge.getWidth();
final double factorHeight = maximum.getHeight() / toLarge.getHeight();
final double factor = Math.min(factorWidth, factorHeight);
final int width = (int) Math.floor(toLarge.width * factor);
final int height = (int) Math.floor(toLarge.height * factor);
return new Dimension(width, height);
}
private GeoUtil() {
// Konstruktor verstecken
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/geo/graph/ 0000775 0000000 0000000 00000000000 13154212327 0022463 5 ustar 00root root 0000000 0000000 com.bitctrl-2.0.2/src/main/java/com/bitctrl/geo/graph/BaseEdge.java 0000664 0000000 0000000 00000005134 13154212327 0024770 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.geo.graph;
/**
* Basisimplementierung einer Kante.
*
* Die notwendige Logik der Knoten und Kanten ist aus Gründen der Performance
* mit {@code protected}-Membern anstelle von Gettern und Settern ausgelegt.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public class BaseEdge implements Edge {
private String name;
/** Der Startknoten des Bogens. */
protected BaseNode source;
/** Der Endknoten des Bogens. */
protected BaseNode target;
/** Gibt den nächsten Eingangsbogen des Endknoten zurück. */
protected BaseEdge nextIn;
/** Gibt den nächsten Ausgangsbogen des Ausgangsknoten zurück. */
protected BaseEdge nextOut;
/**
* Standardkonstruktor.
*/
public BaseEdge() {
// nix zu tun
}
/**
* Initialisiert die Kante mit ihren Knoten.
*
* @param source
* der Startknoten.
* @param target
* der Endknoten.
*/
public BaseEdge(final BaseNode source, final BaseNode target) {
this.source = source;
this.target = target;
}
public String getName() {
return name;
}
public Node getSource() {
return source;
}
public Node getTarget() {
return target;
}
public void setName(final String name) {
this.name = name;
}
@Override
public boolean equals(final Object obj) {
if (this == obj) {
return true;
}
if (obj instanceof Node) {
final Node other = (Node) obj;
return getName().equals(other.getName());
}
return false;
}
@Override
public int hashCode() {
throw new UnsupportedOperationException();
}
/**
* Gibt den Namen des Knoten zurück.
*
* {@inheritDoc}
*/
@Override
public String toString() {
return getName();
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/geo/graph/BaseGraph.java 0000664 0000000 0000000 00000007027 13154212327 0025170 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.geo.graph;
import java.util.ArrayList;
import java.util.LinkedList;
import java.util.List;
/**
* Basisimplementierung eines Graphen.
*
* Die notwendige Logik der Kanten ist aus Gründen der Performance mit {@code
* protected}-Membern anstelle von Gettern und Settern ausgelegt.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*
* @param
* der Typ der Knoten.
* @param
* der Typ der Kanten.
*/
public class BaseGraph implements Graph {
/** Die Liste der Knoten im Graphen. */
protected final List nodes = new LinkedList();
/** Die Liste der Kanten im Graphen. */
protected final List edges = new LinkedList();
public void addNode(final N node) {
nodes.add(node);
}
public void removeNode(final N node) {
nodes.remove(node);
}
public boolean containsNode(final N node) {
return nodes.contains(node);
}
public Iterable nodes() {
return nodes;
}
public void insertEdge(final E edge) {
edges.add(edge);
}
public void removeEdge(final E edge) {
edges.remove(edge);
}
public Iterable edges() {
return edges;
}
public boolean containsEdge(final E edge) {
return edges.contains(edge);
}
public boolean containsEdge(final N source, final N target) {
for (final Edge e : edges()) {
if (source.equals(e.getSource()) && target.equals(e.getTarget())) {
return true;
}
}
return false;
}
public Iterable inEdges(final N node) {
final List inEdges = new ArrayList();
BaseEdge edge;
// Alle Eingangsbögen
edge = ((BaseNode) node).firstIn;
inEdges.add(edge);
while (edge.nextIn != null) {
inEdges.add(edge.nextIn);
edge = edge.nextIn;
}
return inEdges;
}
public Iterable outEdges(final N node) {
final List outEdges = new ArrayList();
BaseEdge edge;
// Alle Ausgangsbögen
edge = ((BaseNode) node).firstOut;
outEdges.add(edge);
while (edge.nextOut != null) {
outEdges.add(edge.nextOut);
edge = edge.nextOut;
}
return outEdges;
}
public Iterable incidentEdges(final N node) {
final List incidentEdges = new ArrayList();
BaseEdge edge;
// Alle Ausgangsbögen
edge = ((BaseNode) node).firstOut;
incidentEdges.add(edge);
while (edge.nextOut != null) {
incidentEdges.add(edge.nextOut);
edge = edge.nextOut;
}
// Alle Eingangsbögen
edge = ((BaseNode) node).firstIn;
incidentEdges.add(edge);
while (edge.nextIn != null) {
incidentEdges.add(edge.nextIn);
edge = edge.nextIn;
}
return incidentEdges;
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/geo/graph/BaseNode.java 0000664 0000000 0000000 00000004400 13154212327 0025004 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.geo.graph;
/**
* Basisimplementierung eines Knoten.
*
* Die notwendige Logik der Kanten ist aus Gründen der Performance mit {@code
* protected}-Membern anstelle von Gettern und Settern ausgelegt.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public class BaseNode implements Node {
private String name;
/** Der erste Eingangsbogen des Knoten. */
protected BaseEdge firstIn;
/** Der erste Ausgangsbogen des Knoten. */
protected BaseEdge firstOut;
/**
* Initialisiert den Knoten mit seinem Namen.
*
* @param name
* der Knotenname.
*/
public BaseNode(final String name) {
this.name = name;
}
public String getName() {
assert name != null;
return name;
}
public void setName(final String name) {
if (name == null) {
throw new NullPointerException("name must not be null");
}
this.name = name;
}
@Override
public boolean equals(final Object obj) {
if (this == obj) {
return true;
}
if (obj instanceof Node) {
final Node other = (Node) obj;
return getName().equals(other.getName());
}
return false;
}
@Override
public int hashCode() {
throw new UnsupportedOperationException();
}
/**
* Gibt den Namen des Knoten zurück.
*
* {@inheritDoc}
*/
@Override
public String toString() {
return getName();
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/geo/graph/Edge.java 0000664 0000000 0000000 00000003125 13154212327 0024173 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.geo.graph;
/**
* Repräsentiert eine Kante in einem Graphen.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public interface Edge {
/**
* Gibt den Namen der Kante zurück.
*
* @return der Kantenname.
*/
String getName();
/**
* Legt den Namen der Kante fest.
*
* @param name
* der neue Kantenname.
*/
void setName(String name);
/**
* Gibt den Startknoten der Kante zurück.
*
* @return der Startknoten, niemals {@code null}.
*/
Node getSource();
/**
* Gibt den Endknoten der Kante zurück.
*
* @return der Endknoten, niemals {@code null}.
*/
Node getTarget();
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/geo/graph/Graph.java 0000664 0000000 0000000 00000006727 13154212327 0024403 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.geo.graph;
/**
* Repräsentiert einen Graphen.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*
* @param
* der Typ der Knoten.
* @param
* der Typ der Kanten.
*/
public interface Graph {
/**
* Fügt einen neuen Knoten ohne Verbindung in den Graphen ein.
*
* @param node
* der neue Knoten.
*/
void addNode(N node);
/**
* Entfernt den angegebenen Knoten aus dem Graphen.
*
* @param node
* ein Knoten des Graph.
*/
void removeNode(N node);
/**
* Prüft ob ein bestimmter Knoten im Graph enthalten ist.
*
* @param node
* ein Knoten.
* @return {@code true}, wenn der Knoten im Graph enthalten ist.
*/
boolean containsNode(N node);
/**
* Gibt einen Iterator für die Knoten des Graphen zurück.
*
* @return ein Knoteniterator.
*/
Iterable nodes();
/**
* Fügt eine neue Kanten zwischen zwei Knoten in den Graphen ein.
*
* @param edge
* die neue Kante.
*/
void insertEdge(E edge);
/**
* Entfernt die angegebene Kante aus dem Graphen.
*
* @param edge
* eine Kante des Graphen.
*/
void removeEdge(E edge);
/**
* Prüft ob der Graph eine Kante zwischen den beiden angegebenen Knoten
* besitzt.
*
* @param edge
* eine Kante.
* @return {@code true}, wenn der Graph die Kante enthält.
*/
boolean containsEdge(E edge);
/**
* Prüft ob der Graph eine Kante zwischen den beiden angegebenen Knoten
* besitzt.
*
* @param source
* der Startknoten der Kante.
* @param target
* der Endknoten der Kante.
* @return {@code true}, wenn der Graph die Kante enthält.
*/
boolean containsEdge(N source, N target);
/**
* Gibt einen Iterator über die Kanten des Graphen zurück.
*
* @return ein Kanteniterator.
*/
Iterable edges();
/**
* Gibt einen Iterator der Ausgangsbögen eines Knotens zurück.
*
* @param node
* ein Konten im Graph.
* @return der Ausgangsbogeniterator.
*/
Iterable outEdges(N node);
/**
* Gibt einen Iterator der Eingangsbögen eines Knotens zurück.
*
* @param node
* ein Konten im Graph.
* @return der Eingangsbogeniterator.
*/
Iterable inEdges(N node);
/**
* Gibt einen Iterator über inzidenten Kanten eines Knoten zurück.
*
* @param node
* ein Knoten im Graph.
* @return der Iterator der inzidenten Kanten.
*/
Iterable incidentEdges(N node);
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/geo/graph/Node.java 0000664 0000000 0000000 00000003225 13154212327 0024215 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.geo.graph;
/**
* Repräsentiert einen Knoten in einem Graphen.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public interface Node {
/**
* Gibt den Namen des Knotens zurück.
*
* @return der Knotenname, niemals {@code null}.
*/
String getName();
/**
* Legt den Namen des Knotens fest.
*
* @param name
* der neue Knotenname.
*/
void setName(String name);
/**
* Vergleicht diesen Knoten mit einem anderen. Die Standardimplementierung
* vergleicht die Namen der beiden Knoten.
*
* @param other
* ein anderer Knoten.
* @return {@code true}, wenn dieser Knoten und der andere gleich sind.
*/
boolean equals(Object other);
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/geo/graph/package-info.java 0000664 0000000 0000000 00000002616 13154212327 0025657 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
/**
* Modellierung von Graphen.
*
* Ein Graph besteht aus Knoten und Kanten zwischen den Knoten. Jede Kante hat
* genau einen Knoten von dem sie ausgeht und einen Knoten zu dem sie hinführt.
* Ist eine Kante gerichtet, spricht man einem Bogen. Knoten besitzen eine
* beliebig lange Liste von Ausgangsbögen und eine beliebige lange Liste von
* Eingangsbögen. Jede der beiden Bögenlisten kann leer sein.
*/
package com.bitctrl.geo.graph;
com.bitctrl-2.0.2/src/main/java/com/bitctrl/geo/graph/tree/ 0000775 0000000 0000000 00000000000 13154212327 0023422 5 ustar 00root root 0000000 0000000 com.bitctrl-2.0.2/src/main/java/com/bitctrl/geo/graph/tree/TreeUtil.java 0000664 0000000 0000000 00000005160 13154212327 0026024 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.geo.graph.tree;
/**
* Hilfsmethoden für Eigenschaften von Bäumen.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public final class TreeUtil {
/**
* Bestimmt die notwendige Höhe eines B+-Baumes.
*
* @param k
* die maximale Anzahl der Elemente, die pro Blatt gesichert
* werden dürfen.
* @param n
* Anzahl der unterzubringenden Elemente.
* @return die notwendige Baumhöhe.
* @deprecated Funktion muss validiert werden, da scheinbar fehlerhaft.
*/
@Deprecated
public static int necessaryHighOfBPlusTree(final int k, final long n) {
if (n <= 1) {
throw new IllegalArgumentException(
"Number of elements must be greater than 1.");
}
if (k <= 0) {
throw new IllegalArgumentException(
"Number of leaf elements must be greater than 0.");
}
final int b = k;
final double h = Math.ceil((float) (Math.log(n / b) / Math.log(k + 1))) + 1;
return (int) h;
}
/**
* Bestimmt die maximale Anzahl von Elementen, die in einem B+-Baum
* untergebracht werden können.
*
* @param k
* die maximale Anzahl der Elemente, die pro Blatt gesichert
* werden dürfen.
* @param height
* die gewünschte Höhe des Baumes.
* @return die maximale Elementanzahl im Baum.
*/
public static long maxElementsOfBPlusTree(final int k, final int height) {
if (k <= 0) {
throw new IllegalArgumentException(
"Number of leaf elements must be greater than 0.");
}
if (height <= 0) {
throw new IllegalArgumentException("Height must be greater than 0.");
}
return (long) (Math.pow(k + 1, height - 1) * k);
}
private TreeUtil() {
// nix
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/geo/graph/tree/package-info.java 0000664 0000000 0000000 00000002030 13154212327 0026604 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
/**
* Modellierung von Baumstrukturen.
*/
package com.bitctrl.geo.graph.tree;
com.bitctrl-2.0.2/src/main/java/com/bitctrl/geo/package-info.java 0000664 0000000 0000000 00000002064 13154212327 0024553 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
/**
* Allgemeine geometrische Hilfsklassen ohne Bezug zu einer bestimten GUI.
*/
package com.bitctrl.geo;
com.bitctrl-2.0.2/src/main/java/com/bitctrl/graph/ 0000775 0000000 0000000 00000000000 13154212327 0021711 5 ustar 00root root 0000000 0000000 com.bitctrl-2.0.2/src/main/java/com/bitctrl/graph/AbstractGraph.java 0000664 0000000 0000000 00000002221 13154212327 0025276 0 ustar 00root root 0000000 0000000 package com.bitctrl.graph;
/**
* Basisklasse für eine {@link Graph}-Implementierung.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public abstract class AbstractGraph implements Graph {
/**
* {@inheritDoc}
*
* Wirft immer eine {@link UnsupportedOperationException}.
*/
@Override
public boolean addKnoten(final Knoten knoten) {
throw new UnsupportedOperationException();
}
/**
* {@inheritDoc}
*
* Wirft immer eine {@link UnsupportedOperationException}.
*/
@Override
public boolean insertBogen(final Knoten startKnoten, final Knoten endKnoten) {
throw new UnsupportedOperationException();
}
@Override
public void initStuetzBogen(final Knoten wurzel) {
if (!getKnoten().contains(wurzel)) {
throw new IllegalArgumentException(
"Der Knoten ist im Netz nicht vorhanden: " + wurzel);
}
for (final Knoten knoten : getKnoten()) {
if (knoten == wurzel) {
knoten.setStuetzBogen(Knoten.WURZEL_BOGEN);
} else {
knoten.setStuetzBogen(null);
}
}
}
@Override
public void initPotential(final double potential) {
for (final Knoten knoten : getKnoten()) {
knoten.setPotential(potential);
}
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/graph/AbstractKnoten.java 0000664 0000000 0000000 00000001117 13154212327 0025476 0 ustar 00root root 0000000 0000000 package com.bitctrl.graph;
/**
* Basisklasse für {@link Knoten}-Implementierungen.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public abstract class AbstractKnoten implements Knoten {
private Bogen stuetzBogen;
private double distance;
@Override
public Bogen getStuetzBogen() {
return stuetzBogen;
}
@Override
public void setStuetzBogen(final Bogen stuetzBogen) {
this.stuetzBogen = stuetzBogen;
}
@Override
public double getPotential() {
return distance;
}
@Override
public void setPotential(final double distance) {
this.distance = distance;
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/graph/Bogen.java 0000664 0000000 0000000 00000001213 13154212327 0023603 0 ustar 00root root 0000000 0000000 package com.bitctrl.graph;
/**
* Basisschnittstelle für einen Bogen in einem {@link Graph}.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public interface Bogen {
/**
* Gibt den Anfangsknoten des Bogen zurück.
*
* @return der Anfangsknoten des Bogen.
*/
Knoten getAnfangsKnoten();
/**
* Gibt den Endknoten des Bogen zurück.
*
* @return der Endknoten des Bogen.
*/
Knoten getEndKnoten();
/**
* Gibt die Länge des Bogens zurück. Die Länge kann auch als Kosten
* interpretiert, die aufgebracht werden müssen, um den Bogen zu
* durchlaufen.
*
* @return die Bogenlänge.
*/
double getLength();
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/graph/Graph.java 0000664 0000000 0000000 00000003400 13154212327 0023612 0 ustar 00root root 0000000 0000000 package com.bitctrl.graph;
import java.util.Collection;
import java.util.Set;
/**
* Basisschnittstelle für einen Graphen.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public interface Graph {
/**
* Gibt die Knoten des Graphen zurück.
*
* @return die Knotenmenge im Graph.
*/
Set getKnoten();
/**
* Fügt einen neuen Knoten in den Graphen ein. Ist der Knoten bereits im
* Graph enthalten passiert nichts.
*
*
* Die Methode ist optional.
*
* @param knoten
* der neue Knoten.
* @return true wenn der Knoten hinzugefügt wurde, sonst
* false.
*/
boolean addKnoten(Knoten knoten);
/**
* Gibt die Bögen des Graphen zurück.
*
* @return die Bogenmenge im Graph.
*/
Collection getBoegen();
/**
* Fügt einen Bogen in den Graphen ein. Ein Bogen kann abhängig von der
* Implementierung des Graphen auch mehrfach hinzugefügt werden.
*
* @param startKnoten
* der Startknoten des Bogens.
* @param endKnoten
* der Endknoten des Bogens.
* @return true wenn der Bogen hinzugefügt wurde, sonst
* false.
*/
boolean insertBogen(Knoten startKnoten, Knoten endKnoten);
/**
* Legt einen Knoten als Wurzel fest. Dabei wird der Stutzbogen aller Knoten
* auf null gesetzt. Nur der Stützbogen der Wurzel wird auf
* {@link Knoten#WURZEL_BOGEN} gesetzt.
*
* @param wurzel
* die Wurzel für das Stützbogengerüst.
*/
void initStuetzBogen(Knoten wurzel);
/**
* Initialisiert das Potential aller Knoten mit einem bestimmten Wert.
*
* @param potential
* der Initialwert für das Knotenpotential.
*/
void initPotential(double potential);
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/graph/GraphAlgorithm.java 0000664 0000000 0000000 00000010035 13154212327 0025463 0 ustar 00root root 0000000 0000000 package com.bitctrl.graph;
import java.util.ArrayList;
import java.util.HashSet;
import java.util.LinkedList;
import java.util.List;
import java.util.Queue;
import java.util.Set;
/**
* Stellt allgemeine Algorithmen auf Graphen bereit.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public final class GraphAlgorithm {
/**
* Führt eine Breitensuche ausgehend von einem Knoten im Graph durch. Es
* wird ein Stützgerüst erzeugt über das alle erreichbaren Knoten vom
* Startknoten aus enthält.
*
*
* Ein bereits vorhandenes Gerüst im Graph wird überschrieben!
*
* @param graph
* der Graph in dem die Breitensuche durchgeführt werden soll.
* @param startKnoten
* der Startknoten.
*/
public static void breitensuche(final Graph graph, final Knoten startKnoten) {
if (startKnoten == null) {
throw new IllegalArgumentException(
"Der Startknoten muss ungleich null sein.");
}
graph.initStuetzBogen(startKnoten);
final Queue queue = new LinkedList();
queue.add(startKnoten);
Knoten current = queue.poll();
while (current != null) {
for (final Bogen b : current.ausgangsBogenIterator()) {
final Knoten nachfolger = b.getEndKnoten();
if (nachfolger.getStuetzBogen() != null) {
continue;
}
nachfolger.setStuetzBogen(b);
if (nachfolger.getStuetzBogen() != null) {
queue.add(nachfolger);
}
}
current = queue.poll();
}
}
public static void dijkstra(final Graph graph, final Knoten startKnoten) {
if (startKnoten == null) {
throw new IllegalArgumentException(
"Der Startknoten muss ungleich null sein.");
}
graph.initStuetzBogen(startKnoten);
graph.initPotential(0);
Bogen minK;
double tj;
do {
double minT = Double.MAX_VALUE;
minK = null;
for (final Bogen k : graph.getBoegen()) {
final Knoten ak = k.getAnfangsKnoten();
final Knoten ek = k.getEndKnoten();
if (ak.getStuetzBogen() != null && ek.getStuetzBogen() == null) {
tj = ak.getPotential() + k.getLength();
if (tj < minT) {
minT = tj;
minK = k;
}
}
}
if (minK != null) {
minK.getEndKnoten().setPotential(minT);
minK.getEndKnoten().setStuetzBogen(minK);
}
} while (minK != null);
}
/**
* Bestimmt den Pfad von der Wurzel zu einem bestimmten Knoten.
*
*
* Setzt voraus, das z. B. mit der Breitensuche ein entsprechendes
* Gerüst erzeugt wurde.
*
* @param zielKnoten
* der Zielknoten
* @return der Pfad, eine leere ist, wenn der Zielknoten der Wurzelknoten
* ist oder null, wenn es keinen Pfad gibt.
*/
public static List getPfadVonWurzel(final Knoten zielKnoten) {
if (zielKnoten.getStuetzBogen() != null) {
return getPfadVonWurzel(zielKnoten, new ArrayList());
}
return null;
}
private static List getPfadVonWurzel(final Knoten zielKnoten,
final ArrayList pfad) {
final Bogen stuetzBogen = zielKnoten.getStuetzBogen();
if (stuetzBogen == Knoten.WURZEL_BOGEN) {
return pfad;
}
pfad.add(0, stuetzBogen);
return getPfadVonWurzel(stuetzBogen.getAnfangsKnoten(), pfad);
}
/**
* Bestimmt alle Nachfolgerknoten eines Knotens zurück.
*
* @param knoten
* der zu untersuchende Knoten.
* @return alle Nachfolgerknoten zu denen ein Bogen hinführt.
*/
public static Set getNachfolger(final Knoten knoten) {
final Set result = new HashSet();
for (final Bogen b : knoten.ausgangsBogenIterator()) {
result.add(b.getEndKnoten());
}
return result;
}
/**
* Bestimmt alle Vorgängerknoten eines Knotens zurück.
*
* @param knoten
* der zu untersuchende Knoten.
* @return alle Vorgängerknoten von denen ein Bogen herführt.
*/
public static Set getVorgaenger(final Knoten knoten) {
final Set result = new HashSet();
for (final Bogen b : knoten.eingangsBogenIterator()) {
result.add(b.getAnfangsKnoten());
}
return result;
}
private GraphAlgorithm() {
// utility class
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/graph/Knoten.java 0000664 0000000 0000000 00000005042 13154212327 0024013 0 ustar 00root root 0000000 0000000 package com.bitctrl.graph;
/**
* Basisschnittstelle für einen Knoten in einem {@link Graph}.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public interface Knoten {
/** Konstante für den Wurzelbogen als Stützbogen des Wurzelknotens. */
Bogen WURZEL_BOGEN = new Bogen() {
/**
* Als Spezialfall hat der Wurzelbogen weder Anfangs- noch Endknoten.
* Die entsprechenden Methode wirft deswegen eine
* {@link UnsupportedOperationException}.
*/
@Override
public Knoten getAnfangsKnoten() {
throw new UnsupportedOperationException();
}
/**
* Als Spezialfall hat der Wurzelbogen weder Anfangs- noch Endknoten.
* Die entsprechenden Methode wirft deswegen eine
* {@link UnsupportedOperationException}.
*/
@Override
public Knoten getEndKnoten() {
throw new UnsupportedOperationException();
}
/**
* {@inheritDoc}
*
* Die Länge des Wurzelknoten ist 0.
*/
@Override
public double getLength() {
return 0;
}
@Override
public String toString() {
return "Wurzelbogen";
}
};
/**
* Gibt einen Iterator über alle außen inzidenten, also ausgehenden, Bögen
* des Knoten zurück.
*
* @return einen Ausgangsbogeniterator.
*/
Iterable ausgangsBogenIterator();
/**
* Gibt einen Iterator über alle innen inzidenten, also eingehenden, Bögen
* des Knoten zurück.
*
* @return einen Eingangsbogeniterator.
*/
Iterable eingangsBogenIterator();
/**
* Gibt einen Iterator über alle überhaupt inzidenten Bögen des Knoten
* zurück.
*
* @return einen Iterator über die inzidenten Bögen.
*/
Iterable inzidentBogenIterator();
/**
* Gibt den Stützbogen dieses Knotens zurück.
*
* @return der Stüzbogen oder null, wenn es keinen Stützbogen
* gibt.
*/
Bogen getStuetzBogen();
/**
* Legt den Stützbogen des Knotens fest.
*
* @param stuetzBogen
* ein Bogen, der zu diesen Knoten führt, der
* {@link #WURZEL_BOGEN} oder null, um keinen
* Stützbogen festzulegen.
*/
void setStuetzBogen(final Bogen stuetzBogen);
/**
* Gibt das Potential des Knotens zurück. Das Potential kann z. B. als
* Entfernung zum Starknoten interpretriert werden.
*
* @return das Knotenpotential.
*/
double getPotential();
/**
* Legt das Potential des Knotens fest. Das Potential kann z. B. als
* Entfernung zum Starknoten interpretriert werden.
*
* @param potential
* das Knotenpotential.
*/
void setPotential(double potential);
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/i18n/ 0000775 0000000 0000000 00000000000 13154212327 0021367 5 ustar 00root root 0000000 0000000 com.bitctrl-2.0.2/src/main/java/com/bitctrl/i18n/MessageHandler.java 0000664 0000000 0000000 00000004165 13154212327 0025122 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.i18n;
import java.util.Locale;
import java.util.ResourceBundle;
/**
* Schnittstelle für Message-Handler. Die implementierende Klasse sollte eine
* Enum-Klasse sein, jeder Enum-Eintrag entspricht einem Meldungstyp.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public interface MessageHandler {
/**
* Gibt das Resource-Bundle für diesen Message-Handler zurück.
*
* @return Resource-Bundle
*/
ResourceBundle getResourceBundle();
/**
* Gibt das Resource-Bundle für diesen Message-Handler in der entsprechenden
* Sprache zurück.
*
* @param locale
* Die Sprache in der das Resource-Bundle zurückgegeben werden
* soll.
*
* @return Das Resource-Bundle.
*/
default ResourceBundle getResourceBundle(Locale locale) {
return getResourceBundle();
}
/**
* Gibt den Namen des Meldungstyps zurück. Unter diesem Namen wird im
* Resource-Bundle nach der Nachricht gesucht.
*
* @return der Name.
*/
String name();
/**
* Gibt die Nachricht als Text zurück. Eventuell vorhandene Platzhalter
* werden nicht ersetzt und bleiben erhalten.
*
* @return die Nachricht.
*/
String toString();
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/i18n/MessageHandler2.java 0000664 0000000 0000000 00000001350 13154212327 0025175 0 ustar 00root root 0000000 0000000 package com.bitctrl.i18n;
import java.util.Locale;
import java.util.ResourceBundle;
/**
* Schnittstelle für Message-Handler. Die implementierende Klasse sollte eine
* Enum-Klasse sein, jeder Enum-Eintrag entspricht einem Meldungstyp.
*
* @deprecated Mit {@link MessageHandler} zusammenführen.
*
* @author BitCtrl Systems GmbH, Görlitz
*/
@Deprecated
public interface MessageHandler2 extends MessageHandler {
/**
* Gibt das Resource-Bundle für diesen Message-Handler in der entsprechenden
* Sprache zurück.
*
* @param locale
* Die Sprache in der das Resource-Bundle zurückgegeben werden
* soll.
*
* @return Das Resource-Bundle.
*/
ResourceBundle getResourceBundle(Locale locale);
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/i18n/Messages.java 0000664 0000000 0000000 00000005377 13154212327 0024015 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.i18n;
import java.text.MessageFormat;
import java.util.Locale;
/**
* Liefert lokalisierte Meldungen.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public final class Messages {
/**
* Ersetzt in einer Meldung die enthaltenen Variablen und gibt sie
* lokalisiert zurück. Eine Meldung mit Variablen hat die Form text {0} text {1}"
* . {...} wird durch den Inhalt der übergebenen Argumente
* ersetzt.
*
* @param key
* der Typ der Meldung.
* @param arguments
* die Argumente, mit denen die Variaben in der Meldung ersetzt
* werden sollen.
* @return die lokalisierte Meldung.
*/
public static String get(final MessageHandler key,
final Object... arguments) {
final String txt = key.getResourceBundle().getString(key.name());
if (arguments != null) {
return MessageFormat.format(txt, arguments);
}
return txt;
}
/**
* Ersetzt in einer Meldung die enthaltenen Variablen und gibt sie
* lokalisiert zurück. Eine Meldung mit Variablen hat die Form text {0} text {1}"
* . {...} wird durch den Inhalt der übergebenen Argumente
* ersetzt.
*
* @param key
* der Typ der Meldung.
* @param locale
* die Sprache der Meldung.
* @param arguments
* die Argumente, mit denen die Variaben in der Meldung ersetzt
* werden sollen.
* @return die lokalisierte Meldung.
*/
public static String get(final MessageHandler2 key, final Locale locale,
final Object... arguments) {
final String txt = key.getResourceBundle(locale).getString(key.name());
if (arguments != null) {
return MessageFormat.format(txt, arguments);
}
return txt;
}
/**
* Standardkosntruktor verstecken.
*/
private Messages() {
// nix
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/i18n/package-info.java 0000664 0000000 0000000 00000002030 13154212327 0024551 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
/**
* Klassen für Internationalisierung (i18n).
*/
package com.bitctrl.i18n;
com.bitctrl-2.0.2/src/main/java/com/bitctrl/math/ 0000775 0000000 0000000 00000000000 13154212327 0021541 5 ustar 00root root 0000000 0000000 com.bitctrl-2.0.2/src/main/java/com/bitctrl/math/MathTools.java 0000664 0000000 0000000 00000004346 13154212327 0024325 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.math;
/**
* Allgemeine mathematische Hilfsfunktionen.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public final class MathTools {
/**
* Testet ob die zwei Werte ungefähr gleich sind. Die maximal erlaubte
* Abweichung wird als dritter Parameter angegeben.
*
* @param a
* ein Wert.
* @param b
* ein zweiter Wert.
* @param precision
* die maximal erlaubte Abweichung, z. B. 0.001.
* @return {@code true}, wenn die beiden Werte ungefähr gleich sind.
*/
public static boolean ca(final double a, final double b,
final double precision) {
if (Math.abs(a - b) < precision) {
return true;
}
return false;
}
/**
* Testet ob die zwei Werte ungefähr gleich sind. Die maximal erlaubte
* Abweichung wird als dritter Parameter angegeben.
*
* @param a
* ein Wert.
* @param b
* ein zweiter Wert.
* @param precision
* die maximal erlaubte Abweichung, z. B. 0.001.
* @return {@code true}, wenn die beiden Werte ungefähr gleich sind.
*/
public static boolean ca(final float a, final float b, final float precision) {
if (Math.abs(a - b) < precision) {
return true;
}
return false;
}
private MathTools() {
// Konstruktor verstecken
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/math/SkalierungHelper.java 0000664 0000000 0000000 00000006203 13154212327 0025651 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.math;
import java.text.DecimalFormat;
import java.text.DecimalFormatSymbols;
import java.text.NumberFormat;
/**
* Hilfsklasse zum genauen Skalieren von Kommazahlen.
*
* Beispiel: 188 * 0.01 soll als 1.88 rauskommen, Double.toString() liefert aber
* 1.880000000001.
*
* @author BitCtrl Systems GmbH, Albrecht Uhlmann
*/
public class SkalierungHelper {
/**
* Test der notwendigen Anzahl Nachkommastellen.
*/
private final NumberFormat precesionTestFormat;
/**
* Formatierer für skalierte Werte.
*/
private final NumberFormat integerNumberFormat;
/**
* der Helper.
*/
private static final SkalierungHelper instanz = new SkalierungHelper();
/**
* Liefert den Helper.
*
* @return der Helper
*/
public static SkalierungHelper getInstanz() {
return instanz;
}
/**
* Initialisierung der Formatierer.
*/
private SkalierungHelper() {
final DecimalFormatSymbols isymbols = new DecimalFormatSymbols();
isymbols.setDecimalSeparator('.');
integerNumberFormat = new DecimalFormat("0", isymbols);
integerNumberFormat.setMinimumIntegerDigits(1);
integerNumberFormat.setMaximumIntegerDigits(999);
integerNumberFormat.setGroupingUsed(false);
final DecimalFormatSymbols symbols = new DecimalFormatSymbols();
symbols.setDecimalSeparator('.');
precesionTestFormat = new DecimalFormat("0.#", symbols);
precesionTestFormat.setMaximumFractionDigits(999);
}
/**
* Skaliert und formatiert einen Wert.
*
* @param unscaledValue
* Unskalierter Wert
* @param conversionFactor
* Faktor, mit dem der unskalierte Wert multipliziert wird.
* @return der Text
*/
public String format(final double unscaledValue,
final double conversionFactor) {
int precision = 0;
synchronized (integerNumberFormat) {
final String formatted = precesionTestFormat
.format(conversionFactor);
final int kommaPosition = formatted.lastIndexOf('.');
if (kommaPosition >= 0) {
precision = formatted.length() - kommaPosition - 1;
}
integerNumberFormat.setMinimumFractionDigits(precision);
integerNumberFormat.setMaximumFractionDigits(precision);
return integerNumberFormat.format(conversionFactor * unscaledValue);
}
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/math/package-info.java 0000664 0000000 0000000 00000002104 13154212327 0024725 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
/**
* Enthält mathematische Funktionen.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
package com.bitctrl.math;
com.bitctrl-2.0.2/src/main/java/com/bitctrl/messages/ 0000775 0000000 0000000 00000000000 13154212327 0022417 5 ustar 00root root 0000000 0000000 com.bitctrl-2.0.2/src/main/java/com/bitctrl/messages/DynamicMessages.java 0000664 0000000 0000000 00000004751 13154212327 0026345 0 ustar 00root root 0000000 0000000 /**
* Rahmenwerk-Plug-in "Gangliniendarstellung fuer PuA-Protokolle"
* Copyright (C) 2009 BitCtrl Systems GmbH
*
* This program is free software; you can redistribute it and/or modify it under
* the terms of the GNU General Public License as published by the Free Software
* Foundation; either version 2 of the License, or (at your option) any later
* version.
*
* This program 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 General Public License for more
* details.
*
* You should have received a copy of the GNU General Public License along with
* this program; if not, write to the Free Software Foundation, Inc., 51
* Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weissenfelser Strasse 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.messages;
import java.util.MissingResourceException;
import java.util.ResourceBundle;
/**
* Dynamische Schnittstelle zum Auslesen des ResourcenBundles.
*
* @author BitCtrl Systems GmbH, Enrico Schnepel
*/
public class DynamicMessages {
private final ResourceBundle resourceBundle;
private DynamicMessages(final ResourceBundle resourceBundle) {
this.resourceBundle = resourceBundle;
}
public static DynamicMessages getInstance(
final ResourceBundle resourceBundle) {
return new DynamicMessages(resourceBundle);
}
/**
* Liest den Wert zu einem Schluessel aus der Resource.
*
* @param key
* der Schluessel
* @return Wenn der Schluessel nicht gefunden wird, gibt die Funktion den
* String "!Schluessel!" zurueck.
*/
public String getString(final String key) {
try {
return resourceBundle.getString(key);
} catch (final MissingResourceException e) {
return '!' + key + '!';
}
}
/**
* Liest den Wert zu einem Schluessel aus der Resource.
*
* @param key
* der Schluessel
* @return Wenn der Schluessel nicht gefunden wird, gibt die Funktion
* null zurueck.
*/
public String getStringOrNull(final String key) {
try {
return resourceBundle.getString(key);
} catch (final MissingResourceException e) {
return null;
}
}
public String encloseWithCommas(String str) {
if (null == str) {
str = ""; //$NON-NLS-1$
} else {
str = "," + str.replaceAll("[^\\-_A-Za-z]", ",") + ",";
}
return str;
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/model/ 0000775 0000000 0000000 00000000000 13154212327 0021710 5 ustar 00root root 0000000 0000000 com.bitctrl-2.0.2/src/main/java/com/bitctrl/model/ModelElement.java 0000664 0000000 0000000 00000007007 13154212327 0025131 0 ustar 00root root 0000000 0000000 package com.bitctrl.model;
import java.beans.PropertyChangeListener;
import java.beans.PropertyChangeSupport;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.Serializable;
import javax.xml.bind.annotation.XmlTransient;
/**
* Basisklasse für Modellklassen mit Property Change Support. Modellobjekte sind
* serialisierbar, sowohl binär ({@link Serializable}) als auch in XML (Java XML
* Binding).
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public class ModelElement implements Serializable {
private static final long serialVersionUID = 1L;
@XmlTransient
private transient PropertyChangeSupport pcsDelegate = new PropertyChangeSupport(
this);
/**
* Registriert einen Property Listener für alle bound properties.
*
* @param listener
* der zu registrierende Listener.
*/
public void addPropertyChangeListener(final PropertyChangeListener listener) {
pcsDelegate.addPropertyChangeListener(listener);
}
/**
* Registriert einen Property Listener für eine einzelne
* bound property.
*
* @param propertyName
* der Name der Property, die �berwacht werden soll.
* @param listener
* der zu registrierende Listener.
*/
public void addPropertyChangeListener(final String propertyName,
final PropertyChangeListener listener) {
pcsDelegate.addPropertyChangeListener(propertyName, listener);
}
/**
* Entfernt einen registrierten Property Listener für alle
* bound properties.
*
* @param listener
* der zu entfernende Listener.
*/
public void removePropertyChangeListener(
final PropertyChangeListener listener) {
pcsDelegate.removePropertyChangeListener(listener);
}
/**
* Entfernt einen registrierten Property Listener für eine einzelne
* bound property.
*
* @param propertyName
* der Name der Property, die nicht mehr überwacht werden soll.
* @param listener
* der zu entfernende Listener.
*/
public void removePropertyChangeListener(final String propertyName,
final PropertyChangeListener listener) {
pcsDelegate.removePropertyChangeListener(propertyName, listener);
}
/**
* Feuert ein Event für eine bound property.
*
* @param propertyName
* der Name der Property die sich geändert hat.
* @param oldValue
* der alte Wert oder null, wenn der alte Wert nicht
* bekannt ist.
* @param newValue
* der neue Wert.
*/
protected synchronized void firePropertyChanged(final String propertyName,
final Object oldValue, final Object newValue) {
pcsDelegate.firePropertyChange(propertyName, oldValue, newValue);
}
/**
* Feuert ein Event für eine indexed bound property.
*
* @param propertyName
* der Name der Property die sich geändert hat.
* @param index
* der Index des Elements das sich geändert hat.
* @param oldValue
* der alte Wert oder null, wenn der alte Wert nicht
* bekannt ist.
* @param newValue
* der neue Wert.
*/
protected synchronized void fireIndexedPropertyChanged(
final String propertyName, final int index, final Object oldValue,
final Object newValue) {
pcsDelegate.fireIndexedPropertyChange(propertyName, index, oldValue,
newValue);
}
private void readObject(final ObjectInputStream in) throws IOException,
ClassNotFoundException {
in.defaultReadObject();
pcsDelegate = new PropertyChangeSupport(this);
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/model/NamedObject.java 0000664 0000000 0000000 00000001700 13154212327 0024724 0 ustar 00root root 0000000 0000000 package com.bitctrl.model;
/**
* Ein benanntes Modellelement.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public class NamedObject extends ModelElement {
/** Konstante für den Namen der entsprechenden Property. */
public static final String PROP_NAME = "name";
private static final long serialVersionUID = 1L;
private String name;
/**
* Gibt den Namen des Objekts zurück.
*
* @return der Objektname.
*/
public String getName() {
if (name == null) {
return "";
}
return name;
}
/**
* Legt einen Namen für das Objekt fest.
*
*
* bound property.
*
* @param name
* der neue Objektname.
*
*/
public void setName(final String name) {
final String oldValue = this.name;
this.name = name;
firePropertyChanged(PROP_NAME, oldValue, name);
}
@Override
public String toString() {
if (name == null || name.isEmpty()) {
return "Unbenannt";
}
return name;
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/ 0000775 0000000 0000000 00000000000 13154212327 0022064 5 ustar 00root root 0000000 0000000 com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/AbstractDAO.java 0000664 0000000 0000000 00000006673 13154212327 0025032 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell;
import java.lang.reflect.ParameterizedType;
import javax.swing.event.EventListenerList;
import com.bitctrl.modell.criteria.OrderDAOCriterion;
/**
* Implementiert allgemeine Funktionen einer DAO.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*
* @param
* der Typ der Datenobjekte.
* @param
* der Schlüssel für die Datenobjekte.
*/
public abstract class AbstractDAO implements DAO {
private final EventListenerList listenerList = new EventListenerList();
private final Class persistentClass;
private final Class keyClass;
private OrderDAOCriterion[] defaultOrder;
/**
* Initialisiert die DAO mit dem Typ der DAO-Elemente und deren
* Schlüsseltyp.
*/
@SuppressWarnings("unchecked")
protected AbstractDAO() {
persistentClass = (Class) ((ParameterizedType) getClass().getGenericSuperclass())
.getActualTypeArguments()[0];
keyClass = (Class) ((ParameterizedType) getClass().getGenericSuperclass()).getActualTypeArguments()[1];
}
public Class getPersistentClass() {
return persistentClass;
}
public Class getKeyClass() {
return keyClass;
}
public OrderDAOCriterion[] getDefaultOrder() {
return defaultOrder != null ? defaultOrder : new OrderDAOCriterion[0];
}
/**
* Legt die Defaultsortierung der Daten in der DAO fest.
*
* @param defaultOrder
* die Defaultsortierung der DAO-Daten.
*/
protected void setDefaultOrder(final OrderDAOCriterion... defaultOrder) {
this.defaultOrder = defaultOrder;
}
public void addDAOListener(final DAOListener l) {
listenerList.add(DAOListener.class, l);
}
public void removeDAOListener(final DAOListener l) {
listenerList.remove(DAOListener.class, l);
}
/**
* Benachrichtigt alle angemeldeten Listener über Datenänderungen. Muss nach
* einer Änderung der Daten der DAO aufgerufen werden.
*/
protected synchronized void fireDataChanged() {
fireDataChanged(DAOEvent.Type.Unknown, null);
}
/**
* Benachrichtigt alle angemeldeten Listener über Datenänderungen. Muss nach
* einer Änderung der Daten der DAO aufgerufen werden.
*
* @param type
* der Typ der Aktualisierung.
* @param object
* das aktualisierte Objekt.
*/
protected synchronized void fireDataChanged(final DAOEvent.Type type, final Object object) {
DAOEvent e;
e = new DAOEvent(this, type, object);
for (final DAOListener l : listenerList.getListeners(DAOListener.class)) {
l.dataChanged(e);
}
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/AbstractDAOFactory.java 0000664 0000000 0000000 00000004502 13154212327 0026347 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell;
import java.util.HashMap;
import java.util.Map;
/**
* Implementiert ein Caching für die DAOs, die die Factory anlegt.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public abstract class AbstractDAOFactory implements DAOFactory {
private final Map, DAO> daoCache = new HashMap, DAO>();
/**
* {@inheritDoc}
*
* Gibt falls möglich die gesuchte DAO aus dem Cache zurück. Falls die
* gesuchte DAO noch nicht im Cache vorliegt, wird sie mit
* {@link #doFindDAO(Class)} bestimmt.
*
* @see #doFindDAO(Class)
*/
@SuppressWarnings("unchecked")
public DAO findDAO(final Class type) {
if (!daoCache.containsKey(type)) {
daoCache.put(type, doFindDAO(type));
}
return (DAO) daoCache.get(type);
}
/**
* Wird von {@link #findDAO(Class)} aus deligiert.
*
* @param
* der Typ der DAO.
* @param type
* die Typklasse der DAO-Objekte.
* @return die DAO zum Typ oder {@code null}, wenn keine passende DAO
* gefunden werden konnte.
* @see #findDAO(Class)
*/
protected abstract DAO doFindDAO(Class type);
/**
* {@inheritDoc}
*
* Prüft ob {@link #findDAO(Class)} einen Wert ungleich {@code null}
* zurückgibt.
*/
public boolean isDataObject(final Object object) {
return findDAO(object.getClass()) != null;
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/AbstractTicketDAO.java 0000664 0000000 0000000 00000003463 13154212327 0026170 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell;
/**
* Implementiert allgemeine Funktionen einer Ticket-DAO.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*
* @param
* der Typ der Datenobjekte.
* @param
* der Schlüssel für die Datenobjekte.
*/
public abstract class AbstractTicketDAO extends AbstractDAO implements TicketDAO {
private DAOTicket ticket;
public DAOTicket getTicket() {
return ticket;
}
/**
* Legt das Ticket für die DAO fest.
*
* Hinweis: Das Ticket kann nur einmal gesetzt und dann nicht mehr
* verändert werden.
*
* @param ticket
* das Ticket, welches die DAO verwendet soll.
*/
public void setTicket(final DAOTicket ticket) {
if (this.ticket != null) {
throw new IllegalStateException("Ticket was already assigned.");
}
this.ticket = ticket;
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/AbstractTicketDAOFactory.java 0000664 0000000 0000000 00000003454 13154212327 0027520 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell;
/**
* Implementiert die Ticketfähigkeit.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public abstract class AbstractTicketDAOFactory extends AbstractDAOFactory
implements TicketDAOFactory {
private DAOTicket ticket;
public DAOTicket getTicket() {
return ticket;
}
/**
* Legt das Ticket für die DAO-Factory fest.
*
* Hinweis: Das Ticket kann nur einmal gesetzt und dann nicht mehr
* verändert werden.
*
* @param ticket
* das Ticket, welches die Factory verwendet soll.
*/
public void setTicket(final DAOTicket ticket) {
if (this.ticket != null) {
throw new IllegalStateException("Ticket was already assigned.");
}
this.ticket = ticket;
}
@Override
public TicketDAO findDAO(final Class type) {
return (TicketDAO) super.findDAO(type);
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/DAO.java 0000664 0000000 0000000 00000012217 13154212327 0023335 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell;
import java.util.List;
import com.bitctrl.modell.criteria.DAOCriterion;
import com.bitctrl.modell.criteria.OrderDAOCriterion;
/**
* Delegiert den Zugriff auf Objekte in einer Datenquelle. Die Datenquelle kann
* ein Datenbank(tabelle) oder auch etwas anderes sein. Jedes Datum der
* Datenquelle wird als Java-Objekt behandelt.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*
* @param
* der Typ der Datenobjekte.
* @param
* der Schlüssel für die Datenobjekte.
*/
public interface DAO {
/**
* Gibt den Typ der Objekte zurück, die die DAO verwaltet.
*
* @return der Objekttyp der DAO-Elemente.
*/
Class getPersistentClass();
/**
* Gibt den Typ des Schlüssels der DAO-Elemente zurück.
*
* @return der Schlüsseltyp.
*/
Class getKeyClass();
/**
* Registriert einen Listener, der über Änderungen am DAO informiert werden
* möchte.
*
* @param l
* ein DAO-Listener.
*/
void addDAOListener(DAOListener l);
/**
* Deregistiert einen Listener.
*
* @param l
* ein DAO-Listener.
*/
void removeDAOListener(DAOListener l);
/**
* Ruft alle Objekt von der Datenquelle ab.
*
* @return die Liste der vorhandenen Objekte.
* @param criteria
* die DAO Kriterien, darf nicht {@code null} sein.
* @throws DAOException
* bei einem Fehler.
*/
List retrieve(DAOCriterion... criteria) throws DAOException;
/**
* Fügt der Datenquelle ein Objekt hinzu.
*
* Hinweis: Die Datenquelle kann das Objekt beim Hinzufügen ändern,
* z. B. die Id ausfüllen. Deshalb darf nach dem Hinzufügen nicht mit
* dem übergebenen Objekt weitergearbeitet werden, sondern es muss das
* zurückgegebene Objekt weiterverwendet werden.
*
* @param object
* ein Objekt mit Schlüssel.
* @return das hinzugefügte Objekt.
* @throws DAOException
* bei einem Fehler.
*/
T add(T object) throws DAOException;
/**
* Aktualisiert ein vorhandenes Objekt der Datenquelle.
*
* @param object
* ein Objekt mit Schlüssel.
* @throws DAOException
* bei einem Fehler.
*/
void update(T object) throws DAOException;
/**
* Aktualisiert ein vorhandenes Objekt der Datenquelle. Zweite Objectinstanz
* in der Session darf existieren
*
* @param object
* ein Objekt mit Schlüssel.
* @throws DAOException
* bei einem Fehler.
*/
void merge(T object) throws DAOException;
/**
* Löscht das angegebene Objekt aus der Datenquelle. Das betroffene Objekt
* wird anhand seines Schlüssel identifiziert.
*
* @param object
* ein Objekt mit Schlüssel.
* @throws DAOException
* bei einem Fehler.
*/
void delete(T object) throws DAOException;
/**
* Sucht das Objekt, welches zu dem angegebenen Schlüssel passt.
*
* @param key
* ein Schlüssel.
* @return das Objekt auf das der Schlüssel passt.
* @throws DAOException
* bei einem Fehler.
*/
T findById(ID key) throws DAOException;
/**
* Gibt die erwartete Anzahl Datenobjekte zurück. Wird kein Criteria
* angegeben, wird die Gesamtanzahl zurückgegeben.
*
* @param criteria
* beliebige DAO-Kriterien.
* @return die Anzahl gemäß der übergebenen Kriterien.
* @throws DAOException
* bei einem Fehler.
*/
long count(DAOCriterion... criteria) throws DAOException;
/**
* Gibt die Standardsortierung der Datensätze zurück. Kann leer sein, wenn
* es keine sinnvolle Sortierung gibt.
*
* @return die Standardsortierung oder ein leeres Array. Niemals
* null.
*/
OrderDAOCriterion[] getDefaultOrder();
/**
* Konvertiert die uebergebenen {@link DAOCriterion}s in ein Hibernate-
* Criteria Objekt.
*
* @param isCount
* true wenn es sich bei der Abfrage um ein
* {@link #count(DAOCriterion...)} handelt, sonst
* false.
* @param daoCriterias
* Die {@link DAOCriterion}s.
* @return Das Hibernate-Criteria Object.
*/
Object createCriteria(final boolean isCount, final DAOCriterion... daoCriterias);
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/DAOEvent.java 0000664 0000000 0000000 00000006125 13154212327 0024340 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell;
import java.util.EventObject;
/**
* Repräsentiert ein Ereignis eines DAO.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public class DAOEvent extends EventObject {
private static final long serialVersionUID = 1;
/** Die Typen einer Änderung. */
public static enum Type {
/** Hinzufügen. */
Add,
/** Aktualisieren. */
Update,
/** Löschen. */
Delete,
/**
* Unbekannte Änderung. Dieser Typ kann verwendet werden, wenn eine DAO
* die Aktualisierung nicht unterscheiden kann, z. B. wenn sich
* alle Daten der Quelle geändert haben.
*/
Unknown;
}
private final Type type;
private final Object object;
/**
* Erzeugt ein neues Event.
*
* @param source
* die Quelle des Events, in der Regel eine DAO.
* @param type
* der Typ des Events.
* @param object
* das aktualiserte Objekt.
* @deprecated Der Parameter source hat den falschen Typ,
* besser den anderen Konstruktor verwenden!!
*/
@Deprecated
public DAOEvent(final Object source, final Type type, final Object object) {
super(source);
if (type == null) {
throw new IllegalArgumentException("null type");
}
this.type = type;
this.object = object;
}
/**
* Erzeugt ein neues Event.
*
* @param source
* die Quelle des Events, in der Regel eine DAO.
* @param type
* der Typ des Events.
* @param object
* das aktualiserte Objekt.
*/
public DAOEvent(final DAO source, final Type type, final Object object) {
super(source);
if (type == null) {
throw new IllegalArgumentException("null type");
}
this.type = type;
this.object = object;
}
@Override
public DAO getSource() {
return (DAO) super.getSource();
}
/**
* Gibt den Typ der Aktualisierung zurück.
*
* @return der Eventtyp.
*/
public Type getType() {
return type;
}
/**
* Gibt das aktualisierte Objekt zurück. Für den Typ {@link Type#Unknown}
* kann der Rückgabewert {@code null} sein.
*
* @return das aktualisierte Objekt.
*/
public Object getObject() {
return object;
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/DAOException.java 0000664 0000000 0000000 00000003763 13154212327 0025222 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell;
/**
* Dies ist eine allgemeine Exception für Fehler bei der Arbeit mit DAO. In der
* Regel kapselt eine {@link DAOException} eine andere Exception wie z. B.
* {@link java.sql.SQLException}.
*
* @author BitCtrl Systems GmbH, Schumann
*/
public class DAOException extends Exception {
private static final long serialVersionUID = 1L;
/**
* Der Standardkonstruktor tut nichts.
*/
public DAOException() {
// nix
}
/**
* Initialisiert die Exception.
*
* @param message
* ein Meldungstext.
*/
public DAOException(final String message) {
super(message);
}
/**
* Initialisiert die Exception.
*
* @param cause
* der Grund für die Exception.
*/
public DAOException(final Throwable cause) {
super(cause);
}
/**
* Initialisiert die Exception.
*
* @param message
* ein Meldungstext.
* @param cause
* der Grund für die Exception.
*/
public DAOException(final String message, final Throwable cause) {
super(message, cause);
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/DAOFactory.java 0000664 0000000 0000000 00000003247 13154212327 0024670 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell;
/**
* Basisklasse für eine Factory, die DAO-Implementierungen liefert.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public interface DAOFactory {
/**
* Sucht anhand der Klasse die dazugehörige DAO.
*
* @param
* der Typ der DAO.
* @param type
* die Typklasse der DAO-Objekte.
* @return die DAO zum Typ oder {@code null}, wenn keine passende DAO
* gefunden werden konnte.
*/
DAO findDAO(Class type);
/**
* Prüft ob zu einem Objekt eine DAO existiert.
*
* @param object
* ein beliebiges Objekt.
* @return {@code true}, wenn es zu dem Objekt eine DAO gibt.
*/
boolean isDataObject(Object object);
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/DAOListener.java 0000664 0000000 0000000 00000002521 13154212327 0025040 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell;
import java.util.EventListener;
/**
* Ein Listener der Events von DAOs überwacht.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public interface DAOListener extends EventListener {
/**
* Wird aufgerufen, wenn sich die Daten eines DAO geändert haben.
*
* @param e
* das eingetroffene Event.
*/
void dataChanged(DAOEvent e);
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/DAOTicket.java 0000664 0000000 0000000 00000006357 13154212327 0024511 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell;
/**
* Repräsentiert ein DAO-Ticket. Alle DAOs, die über das Ticket bezogen werden
* arbeiten im selben Kontext. Auch ist möglich mit Hilfe des Tickts Operationen
* atomar als Transaktion auszuführen.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public interface DAOTicket {
/**
* Gibt die DAO-Factory zurück, die exklusiv für dieses Ticket verwendet
* werden muss.
*
* @return die DAO-Factory für dieses Ticket.
*/
DAOFactory getDAOFactory();
/**
* Import ein Objekt, welches in einem anderen Ticket angelegt wurde.
*
* @param object
* ein "fremdes" Objekt.
* @throws DAOException
* bei einem Fehler.
*/
void importFromOtherTicket(final Object object) throws DAOException;
/**
* Sucht das übergebene Objekt in der Session des Tickets. Der Zustand des
* übergebenen Objekts wird dann in das der Ticketsession kopiert.
*
* @param
* der Typ des Objekts um Rückgabewert anzupassen. *
* @param object
* ein Objekt.
* @return das Objekt auf das der Schlüssel passt.
* @throws DAOException
* bei einem Fehler.
*/
T merge(final T object) throws DAOException;
/**
* Prüft, ob das Ticket bereits freigegeben wurde.
*
* @return {@code true}, wenn das Ticket schon freigegeben ist.
*/
boolean isDestroyed();
/**
* Gibt das Ticket wieder frei.
*/
void destroy();
/**
* Startet eine neue Transaktion. Alle nachfolgenden Operationen werden in
* dieser Transaktion ausgeführt.
*
* @throws DAOException
* bei einem Fehler beim Anlegend er Transaktion.
* @see #commitTransaction()
* @see #rollbackTransaction()
*/
void beginTransaction() throws DAOException;
/**
* Beendet die aktuelle Transaktion und schreibt alle gepufferten
* Operationen.
*
* @throws DAOException
* bei einem Fehler beim Ausführen der Transaktion.
* @see #beginTransaction()
* @see #rollbackTransaction()
*/
void commitTransaction() throws DAOException;
/**
* Führt ein Rollback auf der aktuellen Transaktion aus.
*
* @throws DAOException
* bei einem Fehler beim Rollback der Transaktion
* @see #beginTransaction()
* @see #commitTransaction()
*/
void rollbackTransaction() throws DAOException;
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/TicketDAO.java 0000664 0000000 0000000 00000003233 13154212327 0024477 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell;
/**
* Erweiterung der DAO um das Konzept des Tickets. Für jede Aktion wird ein
* Ticket benötigt. Damit Datenobjekte zwischen verschiedenen Operationen
* ausgetauscht werden können, müssen diese alle das selbe Ticket verwenden.
*
* @author BitCtrl Systems GmbH, krosse
*
* @param
* der Typ der Datenobjekte.
* @param
* der Schlüssel für die Datenobjekte.
*/
public interface TicketDAO extends DAO {
/**
* Gibt das Ticket zurück, welches diese DAO zur Sessionverwaltung
* verwendet. Das Ticket darf sich nach der Initialisierung nicht mehr
* ändern.
*
* @return das Ticket dieser DAO.
*/
DAOTicket getTicket();
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/TicketDAOFactory.java 0000664 0000000 0000000 00000002733 13154212327 0026033 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell;
/**
* Erweitert eine DAO-Factory um das Ticket, welches sie verwendet.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public interface TicketDAOFactory extends DAOFactory {
/**
* Gibt das Ticket zurück, welches die Factory den von ihr erzeugten DAOs
* mit gibt.
*
* @return das Ticket, welches die Factory verwendet.
*/
DAOTicket getTicket();
/**
* {@inheritDoc}
*
* Ändert den Rückgabewert auf {@link TicketDAO}.
*/
TicketDAO findDAO(Class type);
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/criteria/ 0000775 0000000 0000000 00000000000 13154212327 0023666 5 ustar 00root root 0000000 0000000 com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/criteria/BaseDAOCriteriaContainer.java 0000664 0000000 0000000 00000001210 13154212327 0031247 0 ustar 00root root 0000000 0000000 package com.bitctrl.modell.criteria;
import java.util.Collection;
import java.util.HashSet;
import java.util.Set;
/**
* Abstrakte Implentierung der {@link DAOCriteriaContainer}
*
* @author BitCtrl Systems GmbH, krosse
*/
abstract class BaseDAOCriteriaContainer implements DAOCriteriaContainer {
private final Set criterias = new HashSet();
public void addDAOCriterion(final DAOCriterion criterion) {
criterias.add(criterion);
}
public Collection getDAOCriterias() {
return criterias;
}
public void removeDAOCriterion(final DAOCriterion criterion) {
criterias.remove(criterion);
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/criteria/ComparisonDAOCriterion.java 0000664 0000000 0000000 00000010136 13154212327 0031047 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell.criteria;
/**
* Criteria fuer Vergleichsoperationen.
*
* @author BitCtrl Systems GmbH, Krosse
*/
public class ComparisonDAOCriterion implements DAOCriterion {
/**
* Unterstuetzte Vergleichsoperationen.
*/
public enum RelationalTypes {
/** equals. */
EQUALS,
/** greater than. */
GREATER,
/** greater than or equals. */
GREATER_EQUALS,
/** less than. */
LESS,
/** less than or equals. */
LESS_EQUALS,
/**
* between.
*
* TODO Eventuell als eigenes Kriterium definieren.
*/
BETWEEN,
/**
* in.
*
* TODO Eventuell als eigenes Kriterium definieren.
*/
IN,
/**
* case insensitive like.
*
* TODOo Eventuell als eigenes Kriterium definieren, da nur für String
* sinnvoll.
*/
ILIKE,
}
private final RelationalTypes type;
private final String propertyName;
private final Object[] values;
private final boolean not;
/**
* Konstruktor.
*
* @param propertyName
* Propertyname der Bean
* @param type
* Typ des Vergleichsoperators
* @param values
* Werte fuer Vergleichsoperation
*/
public ComparisonDAOCriterion(final String propertyName,
final RelationalTypes type, final Object... values) {
this(propertyName, type, false, values);
}
/**
* Konstruktor.
*
* @param propertyName
* Propertyname der Bean.
* @param type
* Typ des Vergleichsoperators.
* @param not
* Wenn der Ausdruck verneint werden soll.
* @param values
* Werte fuer Vergleichsoperation.
*
* XXX: Ursprünglich war der Datentyp boolean in dem Konstruktor
* verwendet, aber wegen Bug
* https://bugs.eclipse.org/bugs/show_bug.cgi?id=384562 war der
* Konstruktor für den Eclipse Compiler nicht mehr eindeutig. Als
* Workaround verwenden wir einfach die Klasse Boolean statt
* boolean.
*/
public ComparisonDAOCriterion(final String propertyName,
final RelationalTypes type, final Boolean not,
final Object... values) {
this.propertyName = propertyName;
this.type = type;
this.values = values;
this.not = not;
if (this.values == null || type != RelationalTypes.IN
&& this.values.length == 0) {
throw new IllegalArgumentException(
"Values parameter can not be null or empty");
}
if (this.type == RelationalTypes.BETWEEN && this.values.length != 2) {
throw new IllegalArgumentException(
"Values parameter need two objects for type between");
}
}
/**
* Auslesen des Types der Vergleichsoperation.
*
* @return Typ der Vergleichsoperation.
*/
public RelationalTypes getType() {
return type;
}
/**
* Auslesen der Property.
*
* @return Name der Property
*/
public String getPropertyName() {
return propertyName;
}
/**
* Abfragen der Werte.
*
* @return Menge von Werten.
*/
public Object[] getValues() {
return values;
}
/**
* Gibt an ob dieser Ausdruck verneitn werden soll.
*
* @return true wenn dieser Ausdruck verneint werden soll,
* sonst false.
*/
public boolean isNot() {
return not;
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/criteria/ConjunctionDAOCriteriaContainer.java 0000664 0000000 0000000 00000000614 13154212327 0032675 0 ustar 00root root 0000000 0000000 package com.bitctrl.modell.criteria;
/**
* Konjunktion von {@link DAOCriterion}
*
* @author BitCtrl Systems GmbH, krosse
*/
public class ConjunctionDAOCriteriaContainer extends BaseDAOCriteriaContainer {
public ConjunctionDAOCriteriaContainer(final DAOCriterion... criterion) {
if (criterion != null) {
for (final DAOCriterion e : criterion) {
addDAOCriterion(e);
}
}
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/criteria/DAOCriteriaContainer.java 0000664 0000000 0000000 00000001347 13154212327 0030467 0 ustar 00root root 0000000 0000000 package com.bitctrl.modell.criteria;
import java.util.Collection;
/**
* Container für UND oder ODER Verknüpfung von DAOCriterias
*
* @author BitCtrl Systems GmbH, krosse
*/
public interface DAOCriteriaContainer extends DAOCriterion {
/**
* Collection der verknüpften Elemente
*
* @return verknüpfte Elemente
*/
public Collection getDAOCriterias();
/**
* Hinzufügen eines neuen DAOCriterion
*
* @param criterion
* neues {@link DAOCriterion}
*/
public void addDAOCriterion(DAOCriterion criterion);
/**
* Entfernen des angegebenen {@link DAOCriterion}
*
* @param criterion
* zu entferndes Element
*/
public void removeDAOCriterion(DAOCriterion criterion);
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/criteria/DAOCriterion.java 0000664 0000000 0000000 00000002207 13154212327 0027014 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell.criteria;
/**
* Basisinterface fuer ein DAO Kriterium.
*
* @author BitCtrl Systems GmbH, Goerlitz
*/
public interface DAOCriterion {
// tagging interface
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/criteria/DisjunctionDAOCriteriaContainer.java 0000664 0000000 0000000 00000000614 13154212327 0032675 0 ustar 00root root 0000000 0000000 package com.bitctrl.modell.criteria;
/**
* Disjunktion von {@link DAOCriterion}
*
* @author BitCtrl Systems GmbH, krosse
*/
public class DisjunctionDAOCriteriaContainer extends BaseDAOCriteriaContainer {
public DisjunctionDAOCriteriaContainer(final DAOCriterion... criterion) {
if (criterion != null) {
for (final DAOCriterion e : criterion) {
addDAOCriterion(e);
}
}
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/criteria/ExampleDAOCriterion.java 0000664 0000000 0000000 00000003213 13154212327 0030326 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell.criteria;
/**
* Repräsentiert einen Test gegen ein Beispielobjekt.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public class ExampleDAOCriterion implements DAOCriterion {
private final Object example;
/**
* Initialisiert das Kriterium mit dem Beispielobjekt.
*
* @param example
* ein Beispielobjekt.
*/
public ExampleDAOCriterion(final Object example) {
this.example = example;
}
/**
* Gibt das Beispielobjekt des Kriterums zurück.
*
* @return das Beispielobjekt.
*/
public Object getExample() {
return example;
}
@Override
public String toString() {
return getClass().getName() + "[example=" + example + "]";
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/criteria/LimitDAOCriterion.java 0000664 0000000 0000000 00000005271 13154212327 0030017 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell.criteria;
/**
* Repräsentiert eine Begrenzung der DAO Ergebnisse (analog LIMIT und OFFSET bei
* SQL).
*
* @author BitCtrl Systems GmbH, Görlitz
*/
public class LimitDAOCriterion implements DAOCriterion {
private final long offset;
private final int limit;
/**
* Initialisiert das Criteria mit dem Offset und der Anzahl Datenobjekte.
*
* @param offset
* der Offset (inklusive) ab dem die Ergebnisse geliefert werden
* sollen.
* @param limit
* die maximale Anzahl an Ergebnissen.
*/
public LimitDAOCriterion(final long offset, final int limit) {
this.offset = offset;
this.limit = limit;
}
/**
* Initialisiert das Criteria mit dem Offset und der maximal möglichen
* Anzahl Datenobjekte.
*
* @param offset
* der Offset (inklusive) ab dem die Ergebnisse geliefert werden
* sollen.
*/
public LimitDAOCriterion(final long offset) {
this(offset, Integer.MAX_VALUE);
}
/**
* Initialisiert das Criteria mit dem Offset des ersten Elements und der
* Anzahl Datenobjekte.
*
* @param limit
* die maximale Anzahl an Ergebnissen.
*/
public LimitDAOCriterion(final int limit) {
this(0, limit);
}
/**
* Liefert den Offset, ab dem Datenobjekte geliefert werden sollen. Das
* Element, welches der Offset addressiert, ist im Ergebnis enthalten.
*
* @return der Offset.
*/
public long getOffset() {
return offset;
}
/**
* Liefert das Limit, also die maximale Anzahl von Datenobjekten im
* Ergebnis.
*
* @return das Limit.
*/
public int getLimit() {
return limit;
}
@Override
public String toString() {
return getClass().getName() + "[offset=" + offset + ", limit=" + limit
+ "]";
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/criteria/NullDAOCriterion.java 0000664 0000000 0000000 00000003456 13154212327 0027656 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell.criteria;
/**
* Repräsentiert eine auf {@code null} zu prüfenden Property.
*
* @author BitCtrl Systems GmbH, Görlitz
*/
public class NullDAOCriterion implements DAOCriterion {
private final String propertyName;
/**
* Erstellt ein Kriterium dass einen auf {@code null} zu pruefenden
* Spaltennamen repraesentiert.
*
* @param property
* die auf {@code null} zu prüfende Property.
*/
public NullDAOCriterion(final String property) {
propertyName = property;
}
/**
* Liefert den Spaltennamen welcher auf {@code null} geprueft werden soll.
*
* @return Den Spaltennamen welcher auf {@code null} geprueft werden soll.
*/
public String getPropertyName() {
return propertyName;
}
@Override
public String toString() {
return getClass().getName() + "[propertyName=" + propertyName + "]";
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/criteria/OrderDAOCriterion.java 0000664 0000000 0000000 00000004771 13154212327 0030020 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell.criteria;
/**
* Repräsentiert die Sortierung der Ergebnisse einer DAO nach dem Inhalte einer
* Property.
*
* @author BitCtrl Systems GmbH, Goerlitz
*/
public class OrderDAOCriterion implements DAOCriterion {
private final String propertyName;
private final boolean ascending;
/**
* Erstellt eine aufsteigende Sortierung für Ergebnisse einer DAO.
*
* @param propertyName
* der Spaltenname ueber den sortiert werden soll.
*/
public OrderDAOCriterion(final String propertyName) {
this(propertyName, true);
}
/**
* Erstellt eine Sortierung für Ergebnisse einer DAO.
*
* @param propertyName
* der Spaltenname ueber den sortiert werden soll.
* @param ascending
* true, wenn aufsteigend sortiert werden soll,
* sonst false.
*/
public OrderDAOCriterion(final String propertyName, final boolean ascending) {
this.propertyName = propertyName;
this.ascending = ascending;
}
/**
* Liefert den Propertynamen über welchen sortiert werden soll.
*
* @return der Propertynamen über welchen sortiert werden soll.
*/
public String getPropertyName() {
return propertyName;
}
/**
* Liefert die Sortierrichtiung.
*
* @return true, wenn aufsteigend sortiert werden soll, sonst
* false;
*/
public boolean isAscending() {
return ascending;
}
@Override
public String toString() {
return getClass().getName() + "[propertyName=" + propertyName
+ ", ascending=" + ascending + "]";
}
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/package-info.java 0000664 0000000 0000000 00000002277 13154212327 0025263 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
/**
* Enthält Klassen um den Zugriff auf eine Datenquelle in einer Modellansicht zu
* abstrahieren.
*
*
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
package com.bitctrl.modell;
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/util/ 0000775 0000000 0000000 00000000000 13154212327 0023041 5 ustar 00root root 0000000 0000000 com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/util/DAOElementContainer.java 0000664 0000000 0000000 00000004233 13154212327 0027466 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell.util;
import java.util.List;
import com.bitctrl.modell.DAOException;
import com.bitctrl.modell.criteria.DAOCriterion;
/**
* Interface für einen Container welcher DAO-Elemente oder weitere Container
* hält.
*
* @author BitCtrl Systems GmbH, Görlitz
*/
public interface DAOElementContainer {
/**
* Liefert den Typ der Blätter-Elemente dieses Container bzw. seiner
* Sub-Container.
*
* @return Den Typ der Blätter-Elemente.
*/
Class getLeafElementsType();
/**
* Liefert die Anzahl der Blätterelemente.
*
* @return Die Anzahl der Blätterelemente.
* @throws DAOException
* Bei einem Fehler.
*/
int getLeafElementsCount() throws DAOException;
/**
* Liefert alle Kriterien zur Ermittlung des Kindelements am übergebenen
* Index.
*
* @param index
* Der Index.
*
* @return Die Kriterien.
*/
DAOCriterion[] getLeafElementsCriteriaWithLimit(final int index);
/**
* Liefert die Elemente dieses Containers. Das können DAO-Elemente aber auch
* Sub-Container sein.
*
* @return Die Elemente dieses Containers
* @throws DAOException
* Bei einem Fehler.
*/
List getElements() throws DAOException;
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/util/DAOPage.java 0000664 0000000 0000000 00000017700 13154212327 0025111 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell.util;
import java.beans.BeanInfo;
import java.util.ArrayList;
import java.util.List;
import java.util.Objects;
import com.bitctrl.beans.BeanUtils;
import com.bitctrl.geo.graph.tree.TreeUtil;
import com.bitctrl.modell.DAO;
import com.bitctrl.modell.DAOException;
import com.bitctrl.modell.criteria.DAOCriterion;
import com.bitctrl.modell.criteria.LimitDAOCriterion;
/**
* Kapselt alle Informationen die für das Anzeigen einer Seite beim Paging von
* DAO-Elementen benötigt werden. Eine Datenabfrage erfolgt erst bei Bedarf.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public class DAOPage implements DAOElementContainer, Comparable {
/** Die DAO bei der Daten bei Bedarf abgerufen werden. */
private final DAO dao;
/** Die Gesamtanzahl der Elemente. */
private final long count;
/** Die maximale Anzahl der Elemente pro Seite. */
private final int maxPageSize;
/** Der Index ab dem Daten abgerufen werden sollen (inklusive, ab 0). */
private final long from;
/** Der Index bis zu dem Daten abgerufen werden sollen (exklusive, ab 0). */
private final long to;
/** Enthält die notwendigen Kriterien für den Datenabruf. */
private final DAOCriterion[] criteria;
private final boolean showPageName;
/**
* Initialisiert die Seite mit den notwendigen Informationen zum späteren
* Abruf der Daten.
*
* @param dao
* die DAO bei der Daten bei Bedarf abgerufen werden.
* @param count
* die Gesamtanzahl der Elemente.
* @param pageSize
* die maximale Anzahl der Elemente pro Seite.
* @param showPageName
* Flag, ob {@link #toString()} nur den Bereich oder auch den
* Namen der Page zurückgeben soll. Der Name der Page wird anhand
* des Typs bzw. der BeanInfo bestimmt.
* @param from
* der Index ab dem Daten abgerufen werden sollen (inklusive, ab
* 0).
* @param to
* der Index bis zu dem Daten abgerufen werden sollen (exklusive,
* ab 0).
* @param criteria
* die Kritierien für den Datenabruf.
*/
protected DAOPage(final DAO dao, final long count, final int pageSize, final boolean showPageName,
final long from, final long to, final DAOCriterion... criteria) {
if (count <= 0) {
throw new IllegalArgumentException("Count must be greater than 0.");
}
if (pageSize <= 0) {
throw new IllegalArgumentException("Page size must be greater than 0.");
}
if (from > to) {
throw new IllegalArgumentException("From must be smaller than to.");
}
this.dao = dao;
this.count = count;
maxPageSize = pageSize;
this.showPageName = showPageName;
this.from = from;
this.to = to;
this.criteria = criteria;
}
/**
* Flag, ob diese Page Datenelemente oder weitere Pages als Kinder besitzt.
* Eine Subpage liefert mit {@link #getElements()} weitere {@link DAOPage}
* Objekte zurück. Ein normale Page liefert die Datenelemente.
*
* @return {@code true}, wenn die Page eine Subpage ist.
*/
public boolean isSubpage() {
return to - from > maxPageSize;
}
/**
* {@inheritDoc}
*
* Ruft die Daten zu der Seite von der Datenquelle ab oder gibt die Subpages
* zurück.
*
* @return die Daten oder Subpages.
* @throws DAOException
* bei einem Fehler.
*/
public List getElements() throws DAOException {
if (isSubpage()) {
final List
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
package com.bitctrl.modell;
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/util/ 0000775 0000000 0000000 00000000000 13154212327 0023041 5 ustar 00root root 0000000 0000000 com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/util/DAOElementContainer.java 0000664 0000000 0000000 00000004233 13154212327 0027466 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell.util;
import java.util.List;
import com.bitctrl.modell.DAOException;
import com.bitctrl.modell.criteria.DAOCriterion;
/**
* Interface für einen Container welcher DAO-Elemente oder weitere Container
* hält.
*
* @author BitCtrl Systems GmbH, Görlitz
*/
public interface DAOElementContainer {
/**
* Liefert den Typ der Blätter-Elemente dieses Container bzw. seiner
* Sub-Container.
*
* @return Den Typ der Blätter-Elemente.
*/
Class getLeafElementsType();
/**
* Liefert die Anzahl der Blätterelemente.
*
* @return Die Anzahl der Blätterelemente.
* @throws DAOException
* Bei einem Fehler.
*/
int getLeafElementsCount() throws DAOException;
/**
* Liefert alle Kriterien zur Ermittlung des Kindelements am übergebenen
* Index.
*
* @param index
* Der Index.
*
* @return Die Kriterien.
*/
DAOCriterion[] getLeafElementsCriteriaWithLimit(final int index);
/**
* Liefert die Elemente dieses Containers. Das können DAO-Elemente aber auch
* Sub-Container sein.
*
* @return Die Elemente dieses Containers
* @throws DAOException
* Bei einem Fehler.
*/
List getElements() throws DAOException;
}
com.bitctrl-2.0.2/src/main/java/com/bitctrl/modell/util/DAOPage.java 0000664 0000000 0000000 00000017700 13154212327 0025111 0 ustar 00root root 0000000 0000000 /*
* Java Common Library
* Copyright (c) 2008 BitCtrl Systems GmbH
*
* This library 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 3.0 of the License, or (at your option)
* any later version.
*
* This library 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 library; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Contact Information:
* BitCtrl Systems GmbH
* Weißenfelser Straße 67
* 04229 Leipzig
* Phone: +49 341-490670
* mailto: info@bitctrl.de
*/
package com.bitctrl.modell.util;
import java.beans.BeanInfo;
import java.util.ArrayList;
import java.util.List;
import java.util.Objects;
import com.bitctrl.beans.BeanUtils;
import com.bitctrl.geo.graph.tree.TreeUtil;
import com.bitctrl.modell.DAO;
import com.bitctrl.modell.DAOException;
import com.bitctrl.modell.criteria.DAOCriterion;
import com.bitctrl.modell.criteria.LimitDAOCriterion;
/**
* Kapselt alle Informationen die für das Anzeigen einer Seite beim Paging von
* DAO-Elementen benötigt werden. Eine Datenabfrage erfolgt erst bei Bedarf.
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
public class DAOPage implements DAOElementContainer, Comparable