- * Hinweis: Der Test mit {@code equals()} auf den Leerstring ist
- * sehr ineffektiv, deswegen sollte bis Java 6 besser geprüft werden ob
+ * 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.
*/
diff --git a/src/main/java/com/bitctrl/ReleaseInfo.java b/src/main/java/com/bitctrl/ReleaseInfo.java
index 7fedb19..4c1c552 100644
--- a/src/main/java/com/bitctrl/ReleaseInfo.java
+++ b/src/main/java/com/bitctrl/ReleaseInfo.java
@@ -47,8 +47,7 @@ public class ReleaseInfo {
/**
* Erzeugt eine Versionsnummer.
*
- * @param major
- * das Major-Release.
+ * @param major das Major-Release.
*/
public ReleaseInfo(final int major) {
this.major = major;
@@ -60,10 +59,8 @@ public ReleaseInfo(final int major) {
/**
* Erzeugt eine Versionsnummer.
*
- * @param major
- * das Major-Release.
- * @param minor
- * das Minor-Release.
+ * @param major das Major-Release.
+ * @param minor das Minor-Release.
*/
public ReleaseInfo(final int major, final int minor) {
this.major = major;
@@ -75,12 +72,9 @@ public ReleaseInfo(final int major, final int minor) {
/**
* Erzeugt eine Versionsnummer.
*
- * @param major
- * das Major-Release.
- * @param minor
- * das Minor-Release.
- * @param patchLevel
- * der Patch-Level.
+ * @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;
@@ -92,17 +86,12 @@ public ReleaseInfo(final int major, final int minor, final int patchLevel) {
/**
* Erzeugt eine Versionsnummer.
*
- * @param major
- * das Major-Release.
- * @param minor
- * das Minor-Release.
- * @param patchLevel
- * der Patch-Level.
- * @param buildNumber
- * die Build-Number.
+ * @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) {
+ public ReleaseInfo(final int major, final int minor, final int patchLevel, final int buildNumber) {
this.major = major;
this.minor = minor;
this.patchLevel = patchLevel;
@@ -112,8 +101,7 @@ public ReleaseInfo(final int major, final int minor, final int patchLevel,
/**
* Erzeugt eine Versionsnummer.
*
- * @param release
- * ein String, der die Versionsnummer enthält.
+ * @param release ein String, der die Versionsnummer enthält.
*/
public ReleaseInfo(final String release) {
if (Pattern.matches(PATTERN, release)) {
@@ -156,8 +144,7 @@ public ReleaseInfo(final String release) {
}
buildNumber = Integer.valueOf(release.substring(start));
} else {
- throw new IllegalArgumentException(
- "Release muss dem Muster 1[.4[.2[-15]]] entsprechen.");
+ throw new IllegalArgumentException("Release muss dem Muster 1[.4[.2[-15]]] entsprechen.");
}
}
@@ -198,9 +185,9 @@ public Integer getPatchLevel() {
}
/**
- * 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.
+ * 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]]].
*/
diff --git a/src/main/java/com/bitctrl/VersionInfo.java b/src/main/java/com/bitctrl/VersionInfo.java
index f17ca77..1b3b50c 100644
--- a/src/main/java/com/bitctrl/VersionInfo.java
+++ b/src/main/java/com/bitctrl/VersionInfo.java
@@ -46,8 +46,7 @@ public class VersionInfo {
/**
* Liest die Beschreibung aus dem Manifest-File.
*
- * @param manifest
- * ein Manifestfile.
+ * @param manifest ein Manifestfile.
* @see Attributes.Name#IMPLEMENTATION_TITLE
* @see Attributes.Name#IMPLEMENTATION_VERSION
* @see Attributes.Name#IMPLEMENTATION_VENDOR
@@ -66,17 +65,12 @@ public VersionInfo(final Manifest manifest) {
/**
* 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.
+ * @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) {
+ public VersionInfo(final String title, final String version, final String vendor, final String vendorUrl) {
this.title = title;
this.version = version;
this.vendor = vendor;
@@ -84,8 +78,8 @@ public VersionInfo(final String title, final String version,
}
/**
- * Gibt die Versionsnummer als {@code ReleaseInfo} zurück. Dies ist nur
- * möglich, wenn die Versionsnummer einer Releasenummer entspricht.
+ * Gibt die Versionsnummer als {@code ReleaseInfo} zurück. Dies ist nur möglich,
+ * wenn die Versionsnummer einer Releasenummer entspricht.
*
* @return das Release.
*/
@@ -110,7 +104,7 @@ public String getTitle() {
public URL getURL() {
try {
return new URL(getVendorUrl());
- } catch (MalformedURLException ex) {
+ } catch (final MalformedURLException ex) {
throw new IllegalStateException(ex);
}
}
diff --git a/src/main/java/com/bitctrl/beans/AbstractBeanInfo.java b/src/main/java/com/bitctrl/beans/AbstractBeanInfo.java
index 0dc7393..ba48742 100644
--- a/src/main/java/com/bitctrl/beans/AbstractBeanInfo.java
+++ b/src/main/java/com/bitctrl/beans/AbstractBeanInfo.java
@@ -50,8 +50,8 @@ public abstract class AbstractBeanInfo extends SimpleBeanInfo {
* 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.
+ * statisch gecacht, so dass der Aufruf ab dem zweiten Mal schneller vonstatten
+ * geht.
*
* {@inheritDoc}
*
@@ -76,7 +76,8 @@ public BeanDescriptor getBeanDescriptor() {
/**
* 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)}.
+ * die Properties zur Laufzeit ändern (z.B.
+ * {@link #getDisplayName(PropertyInfo)}.
*
* {@inheritDoc}
*
@@ -100,12 +101,12 @@ public PropertyDescriptor[] getPropertyDescriptors() {
for (int i = 0; i < propertyDescriptors.length; ++i) {
final PropertyDescriptor prop;
- Class beanClass = getBeanClass();
+ final 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);
+ final String readMethodName = getReadMethodName(beanClass, propName);
+ final String writeMethodName = getWriteMethodName(beanClass, propName);
prop = new PropertyDescriptor(propInfo[i].name(), getBeanClass(), readMethodName, writeMethodName);
prop.setDisplayName(getDisplayName(propInfo[i]));
@@ -130,33 +131,32 @@ public PropertyDescriptor[] getPropertyDescriptors() {
}
private String getReadMethodName(Class beanClass, String propName) {
-
+
try {
return beanClass.getMethod("get" + propName).getName();
- } catch (NoSuchMethodException ignored) {
+ } catch (final NoSuchMethodException ignored) {
try {
return beanClass.getMethod("is" + propName).getName();
- } catch (NoSuchMethodException ex) {
+ } catch (final NoSuchMethodException ex) {
return null;
}
}
}
private String getWriteMethodName(Class beanClass, String propName) {
-
- String name = "set" + propName;
-
- Method[] methods = beanClass.getMethods();
- for ( Method method : methods) {
- if( name.equals(method.getName())) {
+
+ final String name = "set" + propName;
+
+ final Method[] methods = beanClass.getMethods();
+ for (final Method method : methods) {
+ if (name.equals(method.getName())) {
return name;
}
}
-
+
return null;
}
-
/**
* Gibt die Liste der Properties zurück der Java Bean zurück.
*
@@ -165,15 +165,15 @@ private String getWriteMethodName(Class beanClass, String propName) {
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
+ * 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.
+ * 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}.
+ * @return die Liste der versteckten Properties oder ein leeres Feld, niemals
+ * {@code null}.
* @see #getProperties()
*/
protected PropertyInfo[] getHiddenProperties() {
@@ -181,8 +181,8 @@ protected PropertyInfo[] getHiddenProperties() {
}
/**
- * Gibt die Liste der Properties zurück, die als wichtig hervorgehoben
- * werden sollen. Abgeleite Klassen können die Methode überschreiben. Die
+ * 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
@@ -198,8 +198,8 @@ protected PropertyInfo[] getPreferredProperties() {
/**
* 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.
+ * 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.
@@ -214,11 +214,10 @@ protected PropertyInfo[] getExpertProperties() {
/**
* Gibt den übersetzten Namen der Property zurück. Die Methode sollte in
- * abgeleiteten Klassen überschrieben werden. Die Standardimplementierung
- * gibt einfach den Propertynamen zurück.
+ * abgeleiteten Klassen überschrieben werden. Die Standardimplementierung gibt
+ * einfach den Propertynamen zurück.
*
- * @param info
- * eine Propertybeschreibung.
+ * @param info eine Propertybeschreibung.
* @return der übersetzte Propertyname.
*/
protected String getDisplayName(final PropertyInfo info) {
@@ -226,13 +225,12 @@ protected String getDisplayName(final PropertyInfo info) {
}
/**
- * 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.
+ * 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.
+ * @param info eine Propertybeschreibung.
* @return die kurze Beanbeschreibung.
* @see #getDisplayName(PropertyInfo)
*/
@@ -249,8 +247,8 @@ protected String getShortDescription(final PropertyInfo info) {
/**
* 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.
+ * abgeleiteten Klassen überschrieben werden. Die Standardimplementierung gibt
+ * einfach den Klassennamen (ohne Package) zurück.
*
* @return der übersetzte Beanname.
*/
@@ -259,10 +257,10 @@ protected String getDisplayName() {
}
/**
- * 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.
+ * 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()
diff --git a/src/main/java/com/bitctrl/beans/BeanEvent.java b/src/main/java/com/bitctrl/beans/BeanEvent.java
index 6fdb304..901bfcb 100644
--- a/src/main/java/com/bitctrl/beans/BeanEvent.java
+++ b/src/main/java/com/bitctrl/beans/BeanEvent.java
@@ -42,10 +42,8 @@ public class BeanEvent extends EventObject {
/**
* Initialisert das Event.
*
- * @param source
- * die Quelle des Events.
- * @param beanData
- * die neuen Daten der Bean.
+ * @param source die Quelle des Events.
+ * @param beanData die neuen Daten der Bean.
*/
public BeanEvent(final Object source, final Object beanData) {
super(source);
diff --git a/src/main/java/com/bitctrl/beans/BeanListener.java b/src/main/java/com/bitctrl/beans/BeanListener.java
index a47d956..77dadf2 100644
--- a/src/main/java/com/bitctrl/beans/BeanListener.java
+++ b/src/main/java/com/bitctrl/beans/BeanListener.java
@@ -39,8 +39,7 @@ public interface BeanListener extends EventListener {
/**
* Informiert einen Listener über die Propertyänderung an einer Bean.
*
- * @param e
- * das Event.
+ * @param e das Event.
*/
void beanChanged(BeanEvent e);
diff --git a/src/main/java/com/bitctrl/beans/BeanUtils.java b/src/main/java/com/bitctrl/beans/BeanUtils.java
index 509c894..bcfce06 100644
--- a/src/main/java/com/bitctrl/beans/BeanUtils.java
+++ b/src/main/java/com/bitctrl/beans/BeanUtils.java
@@ -48,11 +48,9 @@ public final class BeanUtils {
* Getter und Setter verfügen. Sind beide vorhanden, müssen sie auch {@code
* public} sein.
*
- * @param source
- * die zu kopierende Bean.
+ * @param source die zu kopierende Bean.
* @return die Kopie der Bean.
- * @throws IllegalArgumentException
- * wenn die Bean nicht kopierbar ist.
+ * @throws IllegalArgumentException wenn die Bean nicht kopierbar ist.
*/
public static Object copy(final Object source) {
final Class clazz = source.getClass();
@@ -61,19 +59,16 @@ public static Object copy(final Object source) {
try {
info = Introspector.getBeanInfo(clazz);
} catch (final IntrospectionException ex) {
- throw new IllegalArgumentException("Can not introspect bean: "
- + clazz, 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);
+ 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);
+ throw new IllegalArgumentException("Bean must have a public default constructor: " + clazz, ex);
}
for (final PropertyDescriptor pd : info.getPropertyDescriptors()) {
@@ -83,17 +78,13 @@ public static Object copy(final Object source) {
try {
setter.invoke(target, getter.invoke(source));
} catch (final IllegalArgumentException ex) {
- throw new IllegalArgumentException(
- "Getter and setter have different type: " + clazz
- + ", " + pd, 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);
+ 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);
+ throw new IllegalArgumentException("Getter or setter throws an exception: " + clazz + ", " + pd,
+ ex);
}
}
}
@@ -104,91 +95,66 @@ public static Object copy(final Object source) {
/**
* 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.
+ * @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);
+ } catch (final InstantiationException | 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.
+ * @param target eine Java Bean.
+ * @param propertyName der Name der Property.
* @return der Wert.
*/
- public static Object getProperty(final Object target,
- final String propertyName) {
+ 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);
+ } catch (final IllegalAccessException | InvocationTargetException ex) {
+ throw new IllegalArgumentException("Cannot read property data.", ex);
}
}
}
- throw new IllegalArgumentException("Bean "
- + target.getClass().getName() + " has no property "
- + propertyName + ".");
+ 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.
+ * @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) {
+ 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);
+ } catch (final IllegalAccessException | InvocationTargetException ex) {
+ throw new IllegalArgumentException("Cannot set property data.", ex);
}
return;
}
}
- throw new IllegalArgumentException("Bean "
- + target.getClass().getName() + " has no property "
- + propertyName + ".");
+ throw new IllegalArgumentException(
+ "Bean " + target.getClass().getName() + " has no property " + propertyName + ".");
}
@@ -196,15 +162,13 @@ public static void setProperty(final Object target,
.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.
+ * 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.
+ * @param beanClass eine Klasse.
* @return die Bean Info zu der Klasse.
*/
public static BeanInfo getBeanInfo(final Class beanClass) {
@@ -216,23 +180,16 @@ public static BeanInfo getBeanInfo(final Class beanClass) {
Class beanInfoClass;
BeanInfo info = null;
try {
- beanInfoClass = (Class) loader
- .loadClass(beanClass.getName() + "BeanInfo");
+ 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);
+ 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);
+ } catch (final InstantiationException | IllegalAccessException ex) {
+ throw new IllegalArgumentException("Can not analyze Java Bean type " + beanClass + ".", ex);
}
beanInfoCache.put(beanClass, info);
@@ -242,8 +199,7 @@ public static BeanInfo getBeanInfo(final Class beanClass) {
/**
* Prüft, ob es sich bei einer Property um eine Textproperty handelt.
*
- * @param pd
- * ein Property Descriptor.
+ * @param pd ein Property Descriptor.
* @return {@code true}, wenn es sich um eine Textproperty handelt.
*/
public static boolean isText(final PropertyDescriptor pd) {
@@ -253,13 +209,11 @@ public static boolean isText(final PropertyDescriptor pd) {
/**
* Prüft, ob es sich bei einer Property um eine ganze Zahl handelt.
*
- * @param pd
- * ein Property Descriptor.
+ * @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)
+ 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)
@@ -271,13 +225,11 @@ public static boolean isNumber(final PropertyDescriptor pd) {
/**
* Prüft, ob es sich bei einer Property um eine reele Zahl handelt.
*
- * @param pd
- * ein Property Descriptor.
+ * @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)
+ return pd.getPropertyType().isAssignableFrom(float.class) || pd.getPropertyType().isAssignableFrom(Float.class)
|| pd.getPropertyType().isAssignableFrom(double.class)
|| pd.getPropertyType().isAssignableFrom(Double.class);
}
@@ -285,8 +237,7 @@ public static boolean isRealNumber(final PropertyDescriptor pd) {
/**
* Prüft, ob es sich bei einer Property um eine Boolean-Property handelt.
*
- * @param pd
- * ein Property Descriptor.
+ * @param pd ein Property Descriptor.
* @return {@code true}, wenn es sich um eine Boolean-Property handelt.
*/
public static boolean isBoolean(final PropertyDescriptor pd) {
@@ -297,8 +248,7 @@ public static boolean isBoolean(final PropertyDescriptor pd) {
/**
* Prüft, ob es sich bei einer Property um eine Zeitangabe handelt.
*
- * @param pd
- * ein Property Descriptor.
+ * @param pd ein Property Descriptor.
* @return {@code true}, wenn es sich um eine Zeitangabe handelt.
*/
public static boolean isTime(final PropertyDescriptor pd) {
@@ -308,8 +258,7 @@ public static boolean isTime(final PropertyDescriptor pd) {
/**
* Prüft, ob es sich bei einer Property um eine Datumsangabe handelt.
*
- * @param pd
- * ein Property Descriptor.
+ * @param pd ein Property Descriptor.
* @return {@code true}, wenn es sich um eine Datumsangabe handelt.
*/
public static boolean isDate(final PropertyDescriptor pd) {
@@ -319,23 +268,20 @@ public static boolean isDate(final PropertyDescriptor pd) {
/**
* Prüft, ob es sich bei einer Property um einen Zeitstempel handelt.
*
- * @param pd
- * ein Property Descriptor.
+ * @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);
+ || 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
+ * 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.
+ * @param bean eine beliebige Java Bean.
* @return der String zur Bean.
*/
public static String toString(final Object bean) {
@@ -347,11 +293,9 @@ public static String toString(final Object bean) {
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"))
+ for (final Method method : methods) {
+ if (!"getClass".equals(method.getName())
+ && (method.getName().startsWith("get") || method.getName().startsWith("is"))
&& method.getParameterTypes().length == 0) {
final String name = method.getName();
if (name.startsWith("get")) {
diff --git a/src/main/java/com/bitctrl/beans/PropertyInfo.java b/src/main/java/com/bitctrl/beans/PropertyInfo.java
index d96503b..ee897e7 100644
--- a/src/main/java/com/bitctrl/beans/PropertyInfo.java
+++ b/src/main/java/com/bitctrl/beans/PropertyInfo.java
@@ -45,11 +45,11 @@ public interface PropertyInfo {
/**
* Vergleicht zwei Infos anhand des Propertynamens.
*
- * @param other
- * eine andere {@link PropertyInfo}.
+ * @param other eine andere {@link PropertyInfo}.
* @return {@code true}, wenn beide identisch sind.
* @see #name()
*/
+ @Override
boolean equals(Object other);
}
diff --git a/src/main/java/com/bitctrl/commands/AbstractCommand.java b/src/main/java/com/bitctrl/commands/AbstractCommand.java
index 3ab8d0b..dab556d 100644
--- a/src/main/java/com/bitctrl/commands/AbstractCommand.java
+++ b/src/main/java/com/bitctrl/commands/AbstractCommand.java
@@ -38,22 +38,27 @@ public abstract class AbstractCommand implements Command {
private final EventListenerList listener = new EventListenerList();
private boolean canceled = false;
+ @Override
public void exec() {
new Thread(this, toString()).start();
}
+ @Override
public void cancel() {
canceled = true;
}
+ @Override
public boolean isCanceled() {
return canceled;
}
+ @Override
public void addCommandFinishedListener(final CommandFinishedListener l) {
listener.add(CommandFinishedListener.class, l);
}
+ @Override
public void removeCommandFinishedListener(final CommandFinishedListener l) {
listener.remove(CommandFinishedListener.class, l);
}
@@ -61,18 +66,13 @@ public void removeCommandFinishedListener(final CommandFinishedListener 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.
+ * @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);
+ 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)) {
+ for (final CommandFinishedListener l : listener.getListeners(CommandFinishedListener.class)) {
l.commandFinished(e);
}
}
diff --git a/src/main/java/com/bitctrl/commands/Command.java b/src/main/java/com/bitctrl/commands/Command.java
index d9c07dd..c891b9a 100644
--- a/src/main/java/com/bitctrl/commands/Command.java
+++ b/src/main/java/com/bitctrl/commands/Command.java
@@ -37,17 +37,18 @@ 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.
+ * Befehls. Die Methode muss regelmäßig mit {@link #isCanceled()} prüfen, ob der
+ * Befehl abgebrochen werden soll.
*
* @see #isCanceled()
*/
+ @Override
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.
+ * 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()
*/
@@ -69,16 +70,14 @@ public interface Command extends Runnable {
/**
* Registriert einen Listener.
*
- * @param l
- * der Listener.
+ * @param l der Listener.
*/
void addCommandFinishedListener(CommandFinishedListener l);
/**
* Meldet einen Listener wieder ab.
*
- * @param l
- * der Listener.
+ * @param l der Listener.
*/
void removeCommandFinishedListener(CommandFinishedListener l);
diff --git a/src/main/java/com/bitctrl/commands/CommandFinishedEvent.java b/src/main/java/com/bitctrl/commands/CommandFinishedEvent.java
index c5f6414..c43dada 100644
--- a/src/main/java/com/bitctrl/commands/CommandFinishedEvent.java
+++ b/src/main/java/com/bitctrl/commands/CommandFinishedEvent.java
@@ -42,15 +42,11 @@ public class CommandFinishedEvent extends EventObject {
/**
* 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.
+ * @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) {
+ public CommandFinishedEvent(final Command source, final boolean successful, final String message) {
super(source);
this.successful = successful;
this.message = message;
diff --git a/src/main/java/com/bitctrl/commands/CommandFinishedListener.java b/src/main/java/com/bitctrl/commands/CommandFinishedListener.java
index 554de1c..f446088 100644
--- a/src/main/java/com/bitctrl/commands/CommandFinishedListener.java
+++ b/src/main/java/com/bitctrl/commands/CommandFinishedListener.java
@@ -39,8 +39,7 @@ public interface CommandFinishedListener extends EventListener {
/**
* Wird aufgerufen, wenn ein Befehl beendet wurde.
*
- * @param e
- * das Event.
+ * @param e das Event.
*/
void commandFinished(CommandFinishedEvent e);
diff --git a/src/main/java/com/bitctrl/commands/Makro.java b/src/main/java/com/bitctrl/commands/Makro.java
index 11382c5..a9b7841 100644
--- a/src/main/java/com/bitctrl/commands/Makro.java
+++ b/src/main/java/com/bitctrl/commands/Makro.java
@@ -37,18 +37,18 @@
*/
public class Makro extends AbstractCommand {
- private final List script = new ArrayList();
+ private final List script = new ArrayList<>();
/**
* Fügt dem Makro einen auszuführenden Befehl hinzu.
*
- * @param cmd
- * ein Befehl,
+ * @param cmd ein Befehl,
*/
public void add(final Command cmd) {
script.add(cmd);
}
+ @Override
public void run() {
for (final Command cmd : script) {
cmd.run();
diff --git a/src/main/java/com/bitctrl/geo/GeoUtil.java b/src/main/java/com/bitctrl/geo/GeoUtil.java
index 349a13e..60202c8 100644
--- a/src/main/java/com/bitctrl/geo/GeoUtil.java
+++ b/src/main/java/com/bitctrl/geo/GeoUtil.java
@@ -36,18 +36,14 @@
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.
+ * 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.
+ * @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) {
+ public static Dimension resizeToFit(final Dimension toLarge, final Dimension maximum) {
if (toLarge == null) {
throw new IllegalArgumentException("toLarge is null");
}
diff --git a/src/main/java/com/bitctrl/geo/graph/BaseEdge.java b/src/main/java/com/bitctrl/geo/graph/BaseEdge.java
index 357f8bb..9f99c09 100644
--- a/src/main/java/com/bitctrl/geo/graph/BaseEdge.java
+++ b/src/main/java/com/bitctrl/geo/graph/BaseEdge.java
@@ -60,28 +60,30 @@ public BaseEdge() {
/**
* Initialisiert die Kante mit ihren Knoten.
*
- * @param source
- * der Startknoten.
- * @param target
- * der Endknoten.
+ * @param source der Startknoten.
+ * @param target der Endknoten.
*/
public BaseEdge(final BaseNode source, final BaseNode target) {
this.source = source;
this.target = target;
}
+ @Override
public String getName() {
return name;
}
+ @Override
public Node getSource() {
return source;
}
+ @Override
public Node getTarget() {
return target;
}
+ @Override
public void setName(final String name) {
this.name = name;
}
@@ -91,8 +93,7 @@ public boolean equals(final Object obj) {
if (this == obj) {
return true;
}
- if (obj instanceof Node) {
- final Node other = (Node) obj;
+ if (obj instanceof final Node other) {
return getName().equals(other.getName());
}
return false;
diff --git a/src/main/java/com/bitctrl/geo/graph/BaseGraph.java b/src/main/java/com/bitctrl/geo/graph/BaseGraph.java
index 619d10a..5aa464e 100644
--- a/src/main/java/com/bitctrl/geo/graph/BaseGraph.java
+++ b/src/main/java/com/bitctrl/geo/graph/BaseGraph.java
@@ -38,51 +38,58 @@
*
* @author BitCtrl Systems GmbH, Falko Schumann
*
- * @param
- * der Typ der Knoten.
- * @param
- * der Typ der Kanten.
+ * @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();
+ protected final List nodes = new LinkedList<>();
/** Die Liste der Kanten im Graphen. */
- protected final List edges = new LinkedList();
+ protected final List edges = new LinkedList<>();
+ @Override
public void addNode(final N node) {
nodes.add(node);
}
+ @Override
public void removeNode(final N node) {
nodes.remove(node);
}
+ @Override
public boolean containsNode(final N node) {
return nodes.contains(node);
}
+ @Override
public Iterable nodes() {
return nodes;
}
+ @Override
public void insertEdge(final E edge) {
edges.add(edge);
}
+ @Override
public void removeEdge(final E edge) {
edges.remove(edge);
}
+ @Override
public Iterable edges() {
return edges;
}
+ @Override
public boolean containsEdge(final E edge) {
return edges.contains(edge);
}
+ @Override
public boolean containsEdge(final N source, final N target) {
for (final Edge e : edges()) {
if (source.equals(e.getSource()) && target.equals(e.getTarget())) {
@@ -92,8 +99,9 @@ public boolean containsEdge(final N source, final N target) {
return false;
}
+ @Override
public Iterable inEdges(final N node) {
- final List inEdges = new ArrayList();
+ final List inEdges = new ArrayList<>();
BaseEdge edge;
// Alle Eingangsbögen
@@ -107,8 +115,9 @@ public Iterable inEdges(final N node) {
return inEdges;
}
+ @Override
public Iterable outEdges(final N node) {
- final List outEdges = new ArrayList();
+ final List outEdges = new ArrayList<>();
BaseEdge edge;
// Alle Ausgangsbögen
@@ -122,8 +131,9 @@ public Iterable outEdges(final N node) {
return outEdges;
}
+ @Override
public Iterable incidentEdges(final N node) {
- final List incidentEdges = new ArrayList();
+ final List incidentEdges = new ArrayList<>();
BaseEdge edge;
// Alle Ausgangsbögen
diff --git a/src/main/java/com/bitctrl/geo/graph/BaseNode.java b/src/main/java/com/bitctrl/geo/graph/BaseNode.java
index d9e5a50..b16efc5 100644
--- a/src/main/java/com/bitctrl/geo/graph/BaseNode.java
+++ b/src/main/java/com/bitctrl/geo/graph/BaseNode.java
@@ -47,18 +47,19 @@ public class BaseNode implements Node {
/**
* Initialisiert den Knoten mit seinem Namen.
*
- * @param name
- * der Knotenname.
+ * @param name der Knotenname.
*/
public BaseNode(final String name) {
this.name = name;
}
+ @Override
public String getName() {
assert name != null;
return name;
}
+ @Override
public void setName(final String name) {
if (name == null) {
throw new NullPointerException("name must not be null");
@@ -71,8 +72,7 @@ public boolean equals(final Object obj) {
if (this == obj) {
return true;
}
- if (obj instanceof Node) {
- final Node other = (Node) obj;
+ if (obj instanceof final Node other) {
return getName().equals(other.getName());
}
return false;
@@ -82,7 +82,7 @@ public boolean equals(final Object obj) {
public int hashCode() {
throw new UnsupportedOperationException();
}
-
+
/**
* Gibt den Namen des Knoten zurück.
*
diff --git a/src/main/java/com/bitctrl/geo/graph/Edge.java b/src/main/java/com/bitctrl/geo/graph/Edge.java
index 7e7f322..8ddcd20 100644
--- a/src/main/java/com/bitctrl/geo/graph/Edge.java
+++ b/src/main/java/com/bitctrl/geo/graph/Edge.java
@@ -43,8 +43,7 @@ public interface Edge {
/**
* Legt den Namen der Kante fest.
*
- * @param name
- * der neue Kantenname.
+ * @param name der neue Kantenname.
*/
void setName(String name);
diff --git a/src/main/java/com/bitctrl/geo/graph/Graph.java b/src/main/java/com/bitctrl/geo/graph/Graph.java
index 3cf700f..edbbc41 100644
--- a/src/main/java/com/bitctrl/geo/graph/Graph.java
+++ b/src/main/java/com/bitctrl/geo/graph/Graph.java
@@ -31,34 +31,29 @@
*
* @author BitCtrl Systems GmbH, Falko Schumann
*
- * @param
- * der Typ der Knoten.
- * @param
- * der Typ der Kanten.
+ * @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.
+ * @param node der neue Knoten.
*/
void addNode(N node);
/**
* Entfernt den angegebenen Knoten aus dem Graphen.
*
- * @param node
- * ein Knoten des Graph.
+ * @param node ein Knoten des Graph.
*/
void removeNode(N node);
/**
* Prüft ob ein bestimmter Knoten im Graph enthalten ist.
*
- * @param node
- * ein Knoten.
+ * @param node ein Knoten.
* @return {@code true}, wenn der Knoten im Graph enthalten ist.
*/
boolean containsNode(N node);
@@ -73,37 +68,30 @@ public interface Graph {
/**
* Fügt eine neue Kanten zwischen zwei Knoten in den Graphen ein.
*
- * @param edge
- * die neue Kante.
+ * @param edge die neue Kante.
*/
void insertEdge(E edge);
/**
* Entfernt die angegebene Kante aus dem Graphen.
*
- * @param edge
- * eine Kante des Graphen.
+ * @param edge eine Kante des Graphen.
*/
void removeEdge(E edge);
/**
- * Prüft ob der Graph eine Kante zwischen den beiden angegebenen Knoten
- * besitzt.
+ * Prüft ob der Graph eine Kante zwischen den beiden angegebenen Knoten besitzt.
*
- * @param edge
- * eine Kante.
+ * @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.
+ * 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.
+ * @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);
@@ -118,8 +106,7 @@ public interface Graph {
/**
* Gibt einen Iterator der Ausgangsbögen eines Knotens zurück.
*
- * @param node
- * ein Konten im Graph.
+ * @param node ein Konten im Graph.
* @return der Ausgangsbogeniterator.
*/
Iterable outEdges(N node);
@@ -127,8 +114,7 @@ public interface Graph {
/**
* Gibt einen Iterator der Eingangsbögen eines Knotens zurück.
*
- * @param node
- * ein Konten im Graph.
+ * @param node ein Konten im Graph.
* @return der Eingangsbogeniterator.
*/
Iterable inEdges(N node);
@@ -136,8 +122,7 @@ public interface Graph {
/**
* Gibt einen Iterator über inzidenten Kanten eines Knoten zurück.
*
- * @param node
- * ein Knoten im Graph.
+ * @param node ein Knoten im Graph.
* @return der Iterator der inzidenten Kanten.
*/
Iterable incidentEdges(N node);
diff --git a/src/main/java/com/bitctrl/geo/graph/Node.java b/src/main/java/com/bitctrl/geo/graph/Node.java
index 0cc05d3..848de34 100644
--- a/src/main/java/com/bitctrl/geo/graph/Node.java
+++ b/src/main/java/com/bitctrl/geo/graph/Node.java
@@ -43,8 +43,7 @@ public interface Node {
/**
* Legt den Namen des Knotens fest.
*
- * @param name
- * der neue Knotenname.
+ * @param name der neue Knotenname.
*/
void setName(String name);
@@ -52,10 +51,10 @@ public interface Node {
* Vergleicht diesen Knoten mit einem anderen. Die Standardimplementierung
* vergleicht die Namen der beiden Knoten.
*
- * @param other
- * ein anderer Knoten.
+ * @param other ein anderer Knoten.
* @return {@code true}, wenn dieser Knoten und der andere gleich sind.
*/
+ @Override
boolean equals(Object other);
}
diff --git a/src/main/java/com/bitctrl/geo/graph/package-info.java b/src/main/java/com/bitctrl/geo/graph/package-info.java
index 2941a8d..fbc2297 100644
--- a/src/main/java/com/bitctrl/geo/graph/package-info.java
+++ b/src/main/java/com/bitctrl/geo/graph/package-info.java
@@ -31,7 +31,6 @@
* 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.
+ * Eingangsbögen. Jede der beiden Bögenlisten kann leer sein.
*/
package com.bitctrl.geo.graph;
-
diff --git a/src/main/java/com/bitctrl/geo/graph/tree/TreeUtil.java b/src/main/java/com/bitctrl/geo/graph/tree/TreeUtil.java
index 9bc96af..725f24b 100644
--- a/src/main/java/com/bitctrl/geo/graph/tree/TreeUtil.java
+++ b/src/main/java/com/bitctrl/geo/graph/tree/TreeUtil.java
@@ -36,23 +36,19 @@ 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.
+ * @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.");
+ 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.");
+ throw new IllegalArgumentException("Number of leaf elements must be greater than 0.");
}
final int b = k;
@@ -64,17 +60,14 @@ public static int necessaryHighOfBPlusTree(final int k, final long n) {
* 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.
+ * @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.");
+ throw new IllegalArgumentException("Number of leaf elements must be greater than 0.");
}
if (height <= 0) {
throw new IllegalArgumentException("Height must be greater than 0.");
diff --git a/src/main/java/com/bitctrl/geo/graph/tree/package-info.java b/src/main/java/com/bitctrl/geo/graph/tree/package-info.java
index 9b68ff6..45fae78 100644
--- a/src/main/java/com/bitctrl/geo/graph/tree/package-info.java
+++ b/src/main/java/com/bitctrl/geo/graph/tree/package-info.java
@@ -28,4 +28,3 @@
* Modellierung von Baumstrukturen.
*/
package com.bitctrl.geo.graph.tree;
-
diff --git a/src/main/java/com/bitctrl/geo/package-info.java b/src/main/java/com/bitctrl/geo/package-info.java
index d84e702..122f26e 100644
--- a/src/main/java/com/bitctrl/geo/package-info.java
+++ b/src/main/java/com/bitctrl/geo/package-info.java
@@ -28,4 +28,3 @@
* Allgemeine geometrische Hilfsklassen ohne Bezug zu einer bestimten GUI.
*/
package com.bitctrl.geo;
-
diff --git a/src/main/java/com/bitctrl/graph/AbstractGraph.java b/src/main/java/com/bitctrl/graph/AbstractGraph.java
index 1798f89..5170588 100644
--- a/src/main/java/com/bitctrl/graph/AbstractGraph.java
+++ b/src/main/java/com/bitctrl/graph/AbstractGraph.java
@@ -30,8 +30,7 @@ public boolean insertBogen(final Knoten startKnoten, final Knoten endKnoten) {
@Override
public void initStuetzBogen(final Knoten wurzel) {
if (!getKnoten().contains(wurzel)) {
- throw new IllegalArgumentException(
- "Der Knoten ist im Netz nicht vorhanden: " + wurzel);
+ throw new IllegalArgumentException("Der Knoten ist im Netz nicht vorhanden: " + wurzel);
}
for (final Knoten knoten : getKnoten()) {
if (knoten == wurzel) {
diff --git a/src/main/java/com/bitctrl/graph/Bogen.java b/src/main/java/com/bitctrl/graph/Bogen.java
index abf1e6a..64da112 100644
--- a/src/main/java/com/bitctrl/graph/Bogen.java
+++ b/src/main/java/com/bitctrl/graph/Bogen.java
@@ -23,8 +23,7 @@ public interface Bogen {
/**
* 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.
+ * interpretiert, die aufgebracht werden müssen, um den Bogen zu durchlaufen.
*
* @return die Bogenlänge.
*/
diff --git a/src/main/java/com/bitctrl/graph/Graph.java b/src/main/java/com/bitctrl/graph/Graph.java
index 8611cb5..ccfc004 100644
--- a/src/main/java/com/bitctrl/graph/Graph.java
+++ b/src/main/java/com/bitctrl/graph/Graph.java
@@ -18,14 +18,13 @@ public interface Graph {
Set getKnoten();
/**
- * Fügt einen neuen Knoten in den Graphen ein. Ist der Knoten bereits im
- * Graph enthalten passiert nichts.
+ * 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.
+ * @param knoten der neue Knoten.
* @return true wenn der Knoten hinzugefügt wurde, sonst
* false.
*/
@@ -42,30 +41,26 @@ public interface Graph {
* 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.
+ * @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
+ * 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.
+ * @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.
+ * @param potential der Initialwert für das Knotenpotential.
*/
void initPotential(double potential);
diff --git a/src/main/java/com/bitctrl/graph/GraphAlgorithm.java b/src/main/java/com/bitctrl/graph/GraphAlgorithm.java
index ce5f529..ce46f50 100644
--- a/src/main/java/com/bitctrl/graph/GraphAlgorithm.java
+++ b/src/main/java/com/bitctrl/graph/GraphAlgorithm.java
@@ -15,27 +15,25 @@
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.
+ * 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.
+ * @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.");
+ throw new IllegalArgumentException("Der Startknoten muss ungleich null sein.");
}
graph.initStuetzBogen(startKnoten);
- final Queue queue = new LinkedList();
+ final Queue queue = new LinkedList<>();
queue.add(startKnoten);
Knoten current = queue.poll();
@@ -59,8 +57,7 @@ public static void breitensuche(final Graph graph, final Knoten startKnoten) {
public static void dijkstra(final Graph graph, final Knoten startKnoten) {
if (startKnoten == null) {
- throw new IllegalArgumentException(
- "Der Startknoten muss ungleich null sein.");
+ throw new IllegalArgumentException("Der Startknoten muss ungleich null sein.");
}
graph.initStuetzBogen(startKnoten);
@@ -97,24 +94,22 @@ public static void dijkstra(final Graph graph, final Knoten startKnoten) {
* Bestimmt den Pfad von der Wurzel zu einem bestimmten Knoten.
*
*
- * Setzt voraus, das z. B. mit der Breitensuche ein entsprechendes
- * Gerüst erzeugt wurde.
+ * 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.
+ * @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 getPfadVonWurzel(zielKnoten, new ArrayList<>());
}
return null;
}
- private static List getPfadVonWurzel(final Knoten zielKnoten,
- final ArrayList pfad) {
+ private static List getPfadVonWurzel(final Knoten zielKnoten, final ArrayList pfad) {
final Bogen stuetzBogen = zielKnoten.getStuetzBogen();
if (stuetzBogen == Knoten.WURZEL_BOGEN) {
@@ -128,12 +123,11 @@ private static List getPfadVonWurzel(final Knoten zielKnoten,
/**
* Bestimmt alle Nachfolgerknoten eines Knotens zurück.
*
- * @param knoten
- * der zu untersuchende Knoten.
+ * @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();
+ final Set result = new HashSet<>();
for (final Bogen b : knoten.ausgangsBogenIterator()) {
result.add(b.getEndKnoten());
@@ -145,12 +139,11 @@ public static Set getNachfolger(final Knoten knoten) {
/**
* Bestimmt alle Vorgängerknoten eines Knotens zurück.
*
- * @param knoten
- * der zu untersuchende Knoten.
+ * @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();
+ final Set result = new HashSet<>();
for (final Bogen b : knoten.eingangsBogenIterator()) {
result.add(b.getAnfangsKnoten());
diff --git a/src/main/java/com/bitctrl/graph/Knoten.java b/src/main/java/com/bitctrl/graph/Knoten.java
index 0900f8b..940ded5 100644
--- a/src/main/java/com/bitctrl/graph/Knoten.java
+++ b/src/main/java/com/bitctrl/graph/Knoten.java
@@ -11,8 +11,8 @@ public interface Knoten {
Bogen WURZEL_BOGEN = new Bogen() {
/**
- * Als Spezialfall hat der Wurzelbogen weder Anfangs- noch Endknoten.
- * Die entsprechenden Methode wirft deswegen eine
+ * Als Spezialfall hat der Wurzelbogen weder Anfangs- noch Endknoten. Die
+ * entsprechenden Methode wirft deswegen eine
* {@link UnsupportedOperationException}.
*/
@Override
@@ -21,8 +21,8 @@ public Knoten getAnfangsKnoten() {
}
/**
- * Als Spezialfall hat der Wurzelbogen weder Anfangs- noch Endknoten.
- * Die entsprechenden Methode wirft deswegen eine
+ * Als Spezialfall hat der Wurzelbogen weder Anfangs- noch Endknoten. Die
+ * entsprechenden Methode wirft deswegen eine
* {@link UnsupportedOperationException}.
*/
@Override
@@ -48,24 +48,23 @@ public String toString() {
};
/**
- * Gibt einen Iterator über alle außen inzidenten, also ausgehenden, Bögen
- * des Knoten zurück.
+ * 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.
+ * 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.
+ * Gibt einen Iterator über alle überhaupt inzidenten Bögen des Knoten zurück.
*
* @return einen Iterator über die inzidenten Bögen.
*/
@@ -74,18 +73,16 @@ public String toString() {
/**
* Gibt den Stützbogen dieses Knotens zurück.
*
- * @return der Stüzbogen oder null, wenn es keinen Stützbogen
- * gibt.
+ * @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.
+ * @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);
@@ -101,8 +98,7 @@ public String toString() {
* Legt das Potential des Knotens fest. Das Potential kann z. B. als
* Entfernung zum Starknoten interpretriert werden.
*
- * @param potential
- * das Knotenpotential.
+ * @param potential das Knotenpotential.
*/
void setPotential(double potential);
diff --git a/src/main/java/com/bitctrl/i18n/MessageHandler.java b/src/main/java/com/bitctrl/i18n/MessageHandler.java
index 535ef7f..69388b5 100644
--- a/src/main/java/com/bitctrl/i18n/MessageHandler.java
+++ b/src/main/java/com/bitctrl/i18n/MessageHandler.java
@@ -48,9 +48,8 @@ public interface 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.
+ * @param locale Die Sprache in der das Resource-Bundle zurückgegeben werden
+ * soll.
*
* @return Das Resource-Bundle.
*/
@@ -67,11 +66,12 @@ default ResourceBundle getResourceBundle(Locale locale) {
String name();
/**
- * Gibt die Nachricht als Text zurück. Eventuell vorhandene Platzhalter
- * werden nicht ersetzt und bleiben erhalten.
+ * Gibt die Nachricht als Text zurück. Eventuell vorhandene Platzhalter werden
+ * nicht ersetzt und bleiben erhalten.
*
* @return die Nachricht.
*/
+ @Override
String toString();
}
diff --git a/src/main/java/com/bitctrl/i18n/MessageHandler2.java b/src/main/java/com/bitctrl/i18n/MessageHandler2.java
index f498450..4545a98 100644
--- a/src/main/java/com/bitctrl/i18n/MessageHandler2.java
+++ b/src/main/java/com/bitctrl/i18n/MessageHandler2.java
@@ -18,12 +18,12 @@ 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.
+ * @param locale Die Sprache in der das Resource-Bundle zurückgegeben werden
+ * soll.
*
* @return Das Resource-Bundle.
*/
+ @Override
ResourceBundle getResourceBundle(Locale locale);
}
diff --git a/src/main/java/com/bitctrl/i18n/Messages.java b/src/main/java/com/bitctrl/i18n/Messages.java
index d561371..0aafd15 100644
--- a/src/main/java/com/bitctrl/i18n/Messages.java
+++ b/src/main/java/com/bitctrl/i18n/Messages.java
@@ -37,20 +37,17 @@
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.
+ * 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.
+ * @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) {
+ public static String get(final MessageHandler key, final Object... arguments) {
final String txt = key.getResourceBundle().getString(key.name());
if (arguments != null) {
@@ -61,22 +58,18 @@ public static String get(final MessageHandler key,
}
/**
- * 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.
+ * 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.
+ * @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) {
+ 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) {
diff --git a/src/main/java/com/bitctrl/i18n/package-info.java b/src/main/java/com/bitctrl/i18n/package-info.java
index cf82c72..b1da5d7 100644
--- a/src/main/java/com/bitctrl/i18n/package-info.java
+++ b/src/main/java/com/bitctrl/i18n/package-info.java
@@ -28,4 +28,3 @@
* Klassen für Internationalisierung (i18n).
*/
package com.bitctrl.i18n;
-
diff --git a/src/main/java/com/bitctrl/math/MathTools.java b/src/main/java/com/bitctrl/math/MathTools.java
index 6682cc8..6fd8059 100644
--- a/src/main/java/com/bitctrl/math/MathTools.java
+++ b/src/main/java/com/bitctrl/math/MathTools.java
@@ -37,16 +37,12 @@ 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.
+ * @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) {
+ public static boolean ca(final double a, final double b, final double precision) {
if (Math.abs(a - b) < precision) {
return true;
}
@@ -58,12 +54,9 @@ public static boolean ca(final double a, final double b,
* 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.
+ * @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) {
diff --git a/src/main/java/com/bitctrl/math/SkalierungHelper.java b/src/main/java/com/bitctrl/math/SkalierungHelper.java
index e0b68b6..0eed7f2 100644
--- a/src/main/java/com/bitctrl/math/SkalierungHelper.java
+++ b/src/main/java/com/bitctrl/math/SkalierungHelper.java
@@ -82,18 +82,15 @@ private SkalierungHelper() {
/**
* Skaliert und formatiert einen Wert.
*
- * @param unscaledValue
- * Unskalierter Wert
- * @param conversionFactor
- * Faktor, mit dem der unskalierte Wert multipliziert wird.
+ * @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) {
+ public String format(final double unscaledValue, final double conversionFactor) {
int precision = 0;
synchronized (integerNumberFormat) {
- final String formatted = precesionTestFormat
- .format(conversionFactor);
+ final String formatted = precesionTestFormat.format(conversionFactor);
final int kommaPosition = formatted.lastIndexOf('.');
if (kommaPosition >= 0) {
precision = formatted.length() - kommaPosition - 1;
diff --git a/src/main/java/com/bitctrl/math/package-info.java b/src/main/java/com/bitctrl/math/package-info.java
index ad2b94e..f4cc439 100644
--- a/src/main/java/com/bitctrl/math/package-info.java
+++ b/src/main/java/com/bitctrl/math/package-info.java
@@ -30,4 +30,3 @@
* @author BitCtrl Systems GmbH, Falko Schumann
*/
package com.bitctrl.math;
-
diff --git a/src/main/java/com/bitctrl/messages/DynamicMessages.java b/src/main/java/com/bitctrl/messages/DynamicMessages.java
index 84c7fa4..ad0f251 100644
--- a/src/main/java/com/bitctrl/messages/DynamicMessages.java
+++ b/src/main/java/com/bitctrl/messages/DynamicMessages.java
@@ -41,18 +41,16 @@ private DynamicMessages(final ResourceBundle resourceBundle) {
this.resourceBundle = resourceBundle;
}
- public static DynamicMessages getInstance(
- final 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.
+ * @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 {
@@ -65,8 +63,7 @@ public String getString(final String key) {
/**
* Liest den Wert zu einem Schluessel aus der Resource.
*
- * @param key
- * der Schluessel
+ * @param key der Schluessel
* @return Wenn der Schluessel nicht gefunden wird, gibt die Funktion
* null zurueck.
*/
diff --git a/src/main/java/com/bitctrl/model/ModelElement.java b/src/main/java/com/bitctrl/model/ModelElement.java
index 8267028..522fbfe 100644
--- a/src/main/java/com/bitctrl/model/ModelElement.java
+++ b/src/main/java/com/bitctrl/model/ModelElement.java
@@ -6,7 +6,7 @@
import java.io.ObjectInputStream;
import java.io.Serializable;
-import javax.xml.bind.annotation.XmlTransient;
+import jakarta.xml.bind.annotation.XmlTransient;
/**
* Basisklasse für Modellklassen mit Property Change Support. Modellobjekte sind
@@ -20,97 +20,78 @@ public class ModelElement implements Serializable {
private static final long serialVersionUID = 1L;
@XmlTransient
- private transient PropertyChangeSupport pcsDelegate = new PropertyChangeSupport(
- this);
+ private transient PropertyChangeSupport pcsDelegate = new PropertyChangeSupport(this);
/**
* Registriert einen Property Listener für alle bound properties.
*
- * @param listener
- * der zu registrierende Listener.
+ * @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.
+ * 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.
+ * @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) {
+ public void addPropertyChangeListener(final String propertyName, final PropertyChangeListener listener) {
pcsDelegate.addPropertyChangeListener(propertyName, listener);
}
/**
- * Entfernt einen registrierten Property Listener für alle
- * bound properties.
+ * Entfernt einen registrierten Property Listener für alle bound
+ * properties.
*
- * @param listener
- * der zu entfernende Listener.
+ * @param listener der zu entfernende Listener.
*/
- public void removePropertyChangeListener(
- final PropertyChangeListener listener) {
+ public void removePropertyChangeListener(final PropertyChangeListener listener) {
pcsDelegate.removePropertyChangeListener(listener);
}
/**
- * Entfernt einen registrierten Property Listener für eine einzelne
- * bound property.
+ * 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.
+ * @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) {
+ 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.
+ * @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) {
+ 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.
+ * @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);
+ 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 {
+ private void readObject(final ObjectInputStream in) throws IOException, ClassNotFoundException {
in.defaultReadObject();
pcsDelegate = new PropertyChangeSupport(this);
}
diff --git a/src/main/java/com/bitctrl/model/NamedObject.java b/src/main/java/com/bitctrl/model/NamedObject.java
index c2a8934..f90019e 100644
--- a/src/main/java/com/bitctrl/model/NamedObject.java
+++ b/src/main/java/com/bitctrl/model/NamedObject.java
@@ -32,8 +32,7 @@ public String getName() {
*
* bound property.
*
- * @param name
- * der neue Objektname.
+ * @param name der neue Objektname.
*
*/
public void setName(final String name) {
diff --git a/src/main/java/com/bitctrl/modell/AbstractDAO.java b/src/main/java/com/bitctrl/modell/AbstractDAO.java
index fe2c8ee..ed724d3 100644
--- a/src/main/java/com/bitctrl/modell/AbstractDAO.java
+++ b/src/main/java/com/bitctrl/modell/AbstractDAO.java
@@ -37,11 +37,10 @@
*
* @author BitCtrl Systems GmbH, Falko Schumann
*
- * @param
- * der Typ der Datenobjekte.
- * @param
- * der Schlüssel für die Datenobjekte.
+ * @param der Typ der Datenobjekte.
+ * @param der Schlüssel für die Datenobjekte.
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public abstract class AbstractDAO implements DAO {
private final EventListenerList listenerList = new EventListenerList();
@@ -51,8 +50,7 @@ public abstract class AbstractDAO implements DAO {
private OrderDAOCriterion[] defaultOrder;
/**
- * Initialisiert die DAO mit dem Typ der DAO-Elemente und deren
- * Schlüsseltyp.
+ * Initialisiert die DAO mit dem Typ der DAO-Elemente und deren Schlüsseltyp.
*/
@SuppressWarnings("unchecked")
protected AbstractDAO() {
@@ -61,14 +59,17 @@ protected AbstractDAO() {
keyClass = (Class) ((ParameterizedType) getClass().getGenericSuperclass()).getActualTypeArguments()[1];
}
+ @Override
public Class getPersistentClass() {
return persistentClass;
}
+ @Override
public Class getKeyClass() {
return keyClass;
}
+ @Override
public OrderDAOCriterion[] getDefaultOrder() {
return defaultOrder != null ? defaultOrder : new OrderDAOCriterion[0];
}
@@ -76,17 +77,18 @@ public OrderDAOCriterion[] getDefaultOrder() {
/**
* Legt die Defaultsortierung der Daten in der DAO fest.
*
- * @param defaultOrder
- * die Defaultsortierung der DAO-Daten.
+ * @param defaultOrder die Defaultsortierung der DAO-Daten.
*/
protected void setDefaultOrder(final OrderDAOCriterion... defaultOrder) {
this.defaultOrder = defaultOrder;
}
+ @Override
public void addDAOListener(final DAOListener l) {
listenerList.add(DAOListener.class, l);
}
+ @Override
public void removeDAOListener(final DAOListener l) {
listenerList.remove(DAOListener.class, l);
}
@@ -103,10 +105,8 @@ protected synchronized void fireDataChanged() {
* 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.
+ * @param type der Typ der Aktualisierung.
+ * @param object das aktualisierte Objekt.
*/
protected synchronized void fireDataChanged(final DAOEvent.Type type, final Object object) {
DAOEvent e;
diff --git a/src/main/java/com/bitctrl/modell/AbstractDAOFactory.java b/src/main/java/com/bitctrl/modell/AbstractDAOFactory.java
index be21e75..eaf93d3 100644
--- a/src/main/java/com/bitctrl/modell/AbstractDAOFactory.java
+++ b/src/main/java/com/bitctrl/modell/AbstractDAOFactory.java
@@ -34,19 +34,21 @@
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public abstract class AbstractDAOFactory implements DAOFactory {
- private final Map, DAO> daoCache = new HashMap, DAO>();
+ private final Map, DAO> daoCache = new HashMap<>();
/**
* {@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.
+ * 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)
*/
+ @Override
@SuppressWarnings("unchecked")
public DAO findDAO(final Class type) {
if (!daoCache.containsKey(type)) {
@@ -58,12 +60,10 @@ public abstract class AbstractDAOFactory implements DAOFactory {
/**
* 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.
+ * @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);
@@ -71,9 +71,9 @@ public abstract class AbstractDAOFactory implements DAOFactory {
/**
* {@inheritDoc}
*
- * Prüft ob {@link #findDAO(Class)} einen Wert ungleich {@code null}
- * zurückgibt.
+ * Prüft ob {@link #findDAO(Class)} einen Wert ungleich {@code null} zurückgibt.
*/
+ @Override
public boolean isDataObject(final Object object) {
return findDAO(object.getClass()) != null;
}
diff --git a/src/main/java/com/bitctrl/modell/AbstractTicketDAO.java b/src/main/java/com/bitctrl/modell/AbstractTicketDAO.java
index e0481fb..0b9dba0 100644
--- a/src/main/java/com/bitctrl/modell/AbstractTicketDAO.java
+++ b/src/main/java/com/bitctrl/modell/AbstractTicketDAO.java
@@ -31,15 +31,15 @@
*
* @author BitCtrl Systems GmbH, Falko Schumann
*
- * @param
- * der Typ der Datenobjekte.
- * @param
- * der Schlüssel für die Datenobjekte.
+ * @param der Typ der Datenobjekte.
+ * @param der Schlüssel für die Datenobjekte.
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public abstract class AbstractTicketDAO extends AbstractDAO implements TicketDAO {
private DAOTicket ticket;
+ @Override
public DAOTicket getTicket() {
return ticket;
}
@@ -50,8 +50,7 @@ public DAOTicket getTicket() {
* Hinweis: Das Ticket kann nur einmal gesetzt und dann nicht mehr
* verändert werden.
*
- * @param ticket
- * das Ticket, welches die DAO verwendet soll.
+ * @param ticket das Ticket, welches die DAO verwendet soll.
*/
public void setTicket(final DAOTicket ticket) {
if (this.ticket != null) {
diff --git a/src/main/java/com/bitctrl/modell/AbstractTicketDAOFactory.java b/src/main/java/com/bitctrl/modell/AbstractTicketDAOFactory.java
index e3019a0..bbc780c 100644
--- a/src/main/java/com/bitctrl/modell/AbstractTicketDAOFactory.java
+++ b/src/main/java/com/bitctrl/modell/AbstractTicketDAOFactory.java
@@ -31,11 +31,12 @@
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
-public abstract class AbstractTicketDAOFactory extends AbstractDAOFactory
- implements TicketDAOFactory {
+@Deprecated(since = "3.0.0", forRemoval = true)
+public abstract class AbstractTicketDAOFactory extends AbstractDAOFactory implements TicketDAOFactory {
private DAOTicket ticket;
+ @Override
public DAOTicket getTicket() {
return ticket;
}
@@ -46,8 +47,7 @@ public DAOTicket getTicket() {
* Hinweis: Das Ticket kann nur einmal gesetzt und dann nicht mehr
* verändert werden.
*
- * @param ticket
- * das Ticket, welches die Factory verwendet soll.
+ * @param ticket das Ticket, welches die Factory verwendet soll.
*/
public void setTicket(final DAOTicket ticket) {
if (this.ticket != null) {
diff --git a/src/main/java/com/bitctrl/modell/DAO.java b/src/main/java/com/bitctrl/modell/DAO.java
index c986999..884329a 100644
--- a/src/main/java/com/bitctrl/modell/DAO.java
+++ b/src/main/java/com/bitctrl/modell/DAO.java
@@ -38,11 +38,10 @@
*
* @author BitCtrl Systems GmbH, Falko Schumann
*
- * @param
- * der Typ der Datenobjekte.
- * @param
- * der Schlüssel für die Datenobjekte.
+ * @param der Typ der Datenobjekte.
+ * @param der Schlüssel für die Datenobjekte.
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public interface DAO {
/**
@@ -63,16 +62,14 @@ public interface DAO {
* Registriert einen Listener, der über Änderungen am DAO informiert werden
* möchte.
*
- * @param l
- * ein DAO-Listener.
+ * @param l ein DAO-Listener.
*/
void addDAOListener(DAOListener l);
/**
* Deregistiert einen Listener.
*
- * @param l
- * ein DAO-Listener.
+ * @param l ein DAO-Listener.
*/
void removeDAOListener(DAOListener l);
@@ -80,10 +77,8 @@ public interface DAO {
* 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.
+ * @param criteria die DAO Kriterien, darf nicht {@code null} sein.
+ * @throws DAOException bei einem Fehler.
*/
List retrieve(DAOCriterion... criteria) throws DAOException;
@@ -91,76 +86,64 @@ public interface DAO {
* 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
+ * 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.
+ * @param object ein Objekt mit Schlüssel.
* @return das hinzugefügte Objekt.
- * @throws DAOException
- * bei einem Fehler.
+ * @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.
+ * @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
+ * 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.
+ * @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.
+ * 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.
+ * @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.
+ * @param key ein Schlüssel.
* @return das Objekt auf das der Schlüssel passt.
- * @throws DAOException
- * bei einem Fehler.
+ * @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.
+ * Gibt die erwartete Anzahl Datenobjekte zurück. Wird kein Criteria angegeben,
+ * wird die Gesamtanzahl zurückgegeben.
*
- * @param criteria
- * beliebige DAO-Kriterien.
+ * @param criteria beliebige DAO-Kriterien.
* @return die Anzahl gemäß der übergebenen Kriterien.
- * @throws DAOException
- * bei einem Fehler.
+ * @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.
+ * 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.
@@ -168,15 +151,13 @@ public interface DAO {
OrderDAOCriterion[] getDefaultOrder();
/**
- * Konvertiert die uebergebenen {@link DAOCriterion}s in ein Hibernate-
- * Criteria Objekt.
+ * 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.
+ * @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.
*/
diff --git a/src/main/java/com/bitctrl/modell/DAOEvent.java b/src/main/java/com/bitctrl/modell/DAOEvent.java
index a282e29..de2d1c9 100644
--- a/src/main/java/com/bitctrl/modell/DAOEvent.java
+++ b/src/main/java/com/bitctrl/modell/DAOEvent.java
@@ -33,12 +33,13 @@
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public class DAOEvent extends EventObject {
private static final long serialVersionUID = 1;
/** Die Typen einer Änderung. */
- public static enum Type {
+ public enum Type {
/** Hinzufügen. */
Add,
@@ -50,9 +51,9 @@ public static enum Type {
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.
+ * 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;
@@ -64,14 +65,11 @@ public static enum Type {
/**
* 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!!
+ * @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) {
@@ -87,12 +85,9 @@ public DAOEvent(final Object source, final Type type, 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.
+ * @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);
@@ -119,8 +114,8 @@ public Type getType() {
}
/**
- * Gibt das aktualisierte Objekt zurück. Für den Typ {@link Type#Unknown}
- * kann der Rückgabewert {@code null} sein.
+ * Gibt das aktualisierte Objekt zurück. Für den Typ {@link Type#Unknown} kann
+ * der Rückgabewert {@code null} sein.
*
* @return das aktualisierte Objekt.
*/
diff --git a/src/main/java/com/bitctrl/modell/DAOException.java b/src/main/java/com/bitctrl/modell/DAOException.java
index 491fcea..5e1f932 100644
--- a/src/main/java/com/bitctrl/modell/DAOException.java
+++ b/src/main/java/com/bitctrl/modell/DAOException.java
@@ -33,6 +33,7 @@
*
* @author BitCtrl Systems GmbH, Schumann
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public class DAOException extends Exception {
private static final long serialVersionUID = 1L;
@@ -47,8 +48,7 @@ public DAOException() {
/**
* Initialisiert die Exception.
*
- * @param message
- * ein Meldungstext.
+ * @param message ein Meldungstext.
*/
public DAOException(final String message) {
super(message);
@@ -57,8 +57,7 @@ public DAOException(final String message) {
/**
* Initialisiert die Exception.
*
- * @param cause
- * der Grund für die Exception.
+ * @param cause der Grund für die Exception.
*/
public DAOException(final Throwable cause) {
super(cause);
@@ -67,10 +66,8 @@ public DAOException(final Throwable cause) {
/**
* Initialisiert die Exception.
*
- * @param message
- * ein Meldungstext.
- * @param cause
- * der Grund für 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);
diff --git a/src/main/java/com/bitctrl/modell/DAOFactory.java b/src/main/java/com/bitctrl/modell/DAOFactory.java
index 9af4ebc..b5d5555 100644
--- a/src/main/java/com/bitctrl/modell/DAOFactory.java
+++ b/src/main/java/com/bitctrl/modell/DAOFactory.java
@@ -31,25 +31,23 @@
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
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.
+ * @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.
+ * @param object ein beliebiges Objekt.
* @return {@code true}, wenn es zu dem Objekt eine DAO gibt.
*/
boolean isDataObject(Object object);
diff --git a/src/main/java/com/bitctrl/modell/DAOListener.java b/src/main/java/com/bitctrl/modell/DAOListener.java
index 3f910d0..a95bc38 100644
--- a/src/main/java/com/bitctrl/modell/DAOListener.java
+++ b/src/main/java/com/bitctrl/modell/DAOListener.java
@@ -33,13 +33,13 @@
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public interface DAOListener extends EventListener {
/**
* Wird aufgerufen, wenn sich die Daten eines DAO geändert haben.
*
- * @param e
- * das eingetroffene Event.
+ * @param e das eingetroffene Event.
*/
void dataChanged(DAOEvent e);
diff --git a/src/main/java/com/bitctrl/modell/DAOTicket.java b/src/main/java/com/bitctrl/modell/DAOTicket.java
index 370c073..8ec9036 100644
--- a/src/main/java/com/bitctrl/modell/DAOTicket.java
+++ b/src/main/java/com/bitctrl/modell/DAOTicket.java
@@ -33,11 +33,12 @@
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public interface DAOTicket {
/**
- * Gibt die DAO-Factory zurück, die exklusiv für dieses Ticket verwendet
- * werden muss.
+ * Gibt die DAO-Factory zurück, die exklusiv für dieses Ticket verwendet werden
+ * muss.
*
* @return die DAO-Factory für dieses Ticket.
*/
@@ -46,10 +47,8 @@ public interface DAOTicket {
/**
* Import ein Objekt, welches in einem anderen Ticket angelegt wurde.
*
- * @param object
- * ein "fremdes" Objekt.
- * @throws DAOException
- * bei einem Fehler.
+ * @param object ein "fremdes" Objekt.
+ * @throws DAOException bei einem Fehler.
*/
void importFromOtherTicket(final Object object) throws DAOException;
@@ -57,13 +56,10 @@ public interface DAOTicket {
* 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.
+ * @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.
+ * @throws DAOException bei einem Fehler.
*/
T merge(final T object) throws DAOException;
@@ -83,19 +79,16 @@ public interface DAOTicket {
* Startet eine neue Transaktion. Alle nachfolgenden Operationen werden in
* dieser Transaktion ausgeführt.
*
- * @throws DAOException
- * bei einem Fehler beim Anlegend er Transaktion.
+ * @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.
+ * Beendet die aktuelle Transaktion und schreibt alle gepufferten Operationen.
*
- * @throws DAOException
- * bei einem Fehler beim Ausführen der Transaktion.
+ * @throws DAOException bei einem Fehler beim Ausführen der Transaktion.
* @see #beginTransaction()
* @see #rollbackTransaction()
*/
@@ -104,8 +97,7 @@ public interface DAOTicket {
/**
* Führt ein Rollback auf der aktuellen Transaktion aus.
*
- * @throws DAOException
- * bei einem Fehler beim Rollback der Transaktion
+ * @throws DAOException bei einem Fehler beim Rollback der Transaktion
* @see #beginTransaction()
* @see #commitTransaction()
*/
diff --git a/src/main/java/com/bitctrl/modell/TicketDAO.java b/src/main/java/com/bitctrl/modell/TicketDAO.java
index ceb547e..9a94d28 100644
--- a/src/main/java/com/bitctrl/modell/TicketDAO.java
+++ b/src/main/java/com/bitctrl/modell/TicketDAO.java
@@ -33,17 +33,15 @@
*
* @author BitCtrl Systems GmbH, krosse
*
- * @param
- * der Typ der Datenobjekte.
- * @param
- * der Schlüssel für die Datenobjekte.
+ * @param der Typ der Datenobjekte.
+ * @param der Schlüssel für die Datenobjekte.
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
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.
+ * 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.
*/
diff --git a/src/main/java/com/bitctrl/modell/TicketDAOFactory.java b/src/main/java/com/bitctrl/modell/TicketDAOFactory.java
index 1fdf15e..7991cca 100644
--- a/src/main/java/com/bitctrl/modell/TicketDAOFactory.java
+++ b/src/main/java/com/bitctrl/modell/TicketDAOFactory.java
@@ -31,11 +31,12 @@
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public interface TicketDAOFactory extends DAOFactory {
/**
- * Gibt das Ticket zurück, welches die Factory den von ihr erzeugten DAOs
- * mit gibt.
+ * Gibt das Ticket zurück, welches die Factory den von ihr erzeugten DAOs mit
+ * gibt.
*
* @return das Ticket, welches die Factory verwendet.
*/
@@ -46,6 +47,7 @@ public interface TicketDAOFactory extends DAOFactory {
*
* Ändert den Rückgabewert auf {@link TicketDAO}.
*/
+ @Override
TicketDAO findDAO(Class type);
}
diff --git a/src/main/java/com/bitctrl/modell/criteria/BaseDAOCriteriaContainer.java b/src/main/java/com/bitctrl/modell/criteria/BaseDAOCriteriaContainer.java
index e354992..afd5d02 100644
--- a/src/main/java/com/bitctrl/modell/criteria/BaseDAOCriteriaContainer.java
+++ b/src/main/java/com/bitctrl/modell/criteria/BaseDAOCriteriaContainer.java
@@ -9,18 +9,22 @@
*
* @author BitCtrl Systems GmbH, krosse
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
abstract class BaseDAOCriteriaContainer implements DAOCriteriaContainer {
- private final Set criterias = new HashSet();
+ private final Set criterias = new HashSet<>();
+ @Override
public void addDAOCriterion(final DAOCriterion criterion) {
criterias.add(criterion);
}
+ @Override
public Collection getDAOCriterias() {
return criterias;
}
+ @Override
public void removeDAOCriterion(final DAOCriterion criterion) {
criterias.remove(criterion);
}
diff --git a/src/main/java/com/bitctrl/modell/criteria/ComparisonDAOCriterion.java b/src/main/java/com/bitctrl/modell/criteria/ComparisonDAOCriterion.java
index 955bb05..5ca70c3 100644
--- a/src/main/java/com/bitctrl/modell/criteria/ComparisonDAOCriterion.java
+++ b/src/main/java/com/bitctrl/modell/criteria/ComparisonDAOCriterion.java
@@ -31,6 +31,7 @@
*
* @author BitCtrl Systems GmbH, Krosse
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public class ComparisonDAOCriterion implements DAOCriterion {
/**
@@ -70,8 +71,7 @@ public enum RelationalTypes {
/**
* case insensitive like.
*
- * TODOo Eventuell als eigenes Kriterium definieren, da nur für String
- * sinnvoll.
+ * TODOo Eventuell als eigenes Kriterium definieren, da nur für String sinnvoll.
*/
ILIKE,
@@ -85,54 +85,42 @@ public enum RelationalTypes {
/**
* Konstruktor.
*
- * @param propertyName
- * Propertyname der Bean
- * @param type
- * Typ des Vergleichsoperators
- * @param values
- * Werte fuer Vergleichsoperation
+ * @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) {
+ 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.
+ * @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.
+ * 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,
+ 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.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");
+ throw new IllegalArgumentException("Values parameter need two objects for type between");
}
}
@@ -166,8 +154,8 @@ public Object[] getValues() {
/**
* Gibt an ob dieser Ausdruck verneitn werden soll.
*
- * @return true wenn dieser Ausdruck verneint werden soll,
- * sonst false.
+ * @return true wenn dieser Ausdruck verneint werden soll, sonst
+ * false.
*/
public boolean isNot() {
return not;
diff --git a/src/main/java/com/bitctrl/modell/criteria/ConjunctionDAOCriteriaContainer.java b/src/main/java/com/bitctrl/modell/criteria/ConjunctionDAOCriteriaContainer.java
index 30dc9e2..9f87e7c 100644
--- a/src/main/java/com/bitctrl/modell/criteria/ConjunctionDAOCriteriaContainer.java
+++ b/src/main/java/com/bitctrl/modell/criteria/ConjunctionDAOCriteriaContainer.java
@@ -5,6 +5,7 @@
*
* @author BitCtrl Systems GmbH, krosse
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public class ConjunctionDAOCriteriaContainer extends BaseDAOCriteriaContainer {
public ConjunctionDAOCriteriaContainer(final DAOCriterion... criterion) {
diff --git a/src/main/java/com/bitctrl/modell/criteria/DAOCriteriaContainer.java b/src/main/java/com/bitctrl/modell/criteria/DAOCriteriaContainer.java
index dcb14ce..accad20 100644
--- a/src/main/java/com/bitctrl/modell/criteria/DAOCriteriaContainer.java
+++ b/src/main/java/com/bitctrl/modell/criteria/DAOCriteriaContainer.java
@@ -7,6 +7,7 @@
*
* @author BitCtrl Systems GmbH, krosse
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public interface DAOCriteriaContainer extends DAOCriterion {
/**
@@ -14,21 +15,19 @@ public interface DAOCriteriaContainer extends DAOCriterion {
*
* @return verknüpfte Elemente
*/
- public Collection getDAOCriterias();
+ Collection getDAOCriterias();
/**
* Hinzufügen eines neuen DAOCriterion
*
- * @param criterion
- * neues {@link DAOCriterion}
+ * @param criterion neues {@link DAOCriterion}
*/
- public void addDAOCriterion(DAOCriterion criterion);
+ void addDAOCriterion(DAOCriterion criterion);
/**
* Entfernen des angegebenen {@link DAOCriterion}
*
- * @param criterion
- * zu entferndes Element
+ * @param criterion zu entferndes Element
*/
- public void removeDAOCriterion(DAOCriterion criterion);
+ void removeDAOCriterion(DAOCriterion criterion);
}
diff --git a/src/main/java/com/bitctrl/modell/criteria/DAOCriterion.java b/src/main/java/com/bitctrl/modell/criteria/DAOCriterion.java
index f9e94bd..5cb8734 100644
--- a/src/main/java/com/bitctrl/modell/criteria/DAOCriterion.java
+++ b/src/main/java/com/bitctrl/modell/criteria/DAOCriterion.java
@@ -31,6 +31,7 @@
*
* @author BitCtrl Systems GmbH, Goerlitz
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public interface DAOCriterion {
// tagging interface
diff --git a/src/main/java/com/bitctrl/modell/criteria/DisjunctionDAOCriteriaContainer.java b/src/main/java/com/bitctrl/modell/criteria/DisjunctionDAOCriteriaContainer.java
index 6f7fe52..d6de845 100644
--- a/src/main/java/com/bitctrl/modell/criteria/DisjunctionDAOCriteriaContainer.java
+++ b/src/main/java/com/bitctrl/modell/criteria/DisjunctionDAOCriteriaContainer.java
@@ -5,6 +5,7 @@
*
* @author BitCtrl Systems GmbH, krosse
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public class DisjunctionDAOCriteriaContainer extends BaseDAOCriteriaContainer {
public DisjunctionDAOCriteriaContainer(final DAOCriterion... criterion) {
diff --git a/src/main/java/com/bitctrl/modell/criteria/ExampleDAOCriterion.java b/src/main/java/com/bitctrl/modell/criteria/ExampleDAOCriterion.java
index 3400fb6..3539699 100644
--- a/src/main/java/com/bitctrl/modell/criteria/ExampleDAOCriterion.java
+++ b/src/main/java/com/bitctrl/modell/criteria/ExampleDAOCriterion.java
@@ -31,6 +31,7 @@
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public class ExampleDAOCriterion implements DAOCriterion {
private final Object example;
@@ -38,8 +39,7 @@ public class ExampleDAOCriterion implements DAOCriterion {
/**
* Initialisiert das Kriterium mit dem Beispielobjekt.
*
- * @param example
- * ein Beispielobjekt.
+ * @param example ein Beispielobjekt.
*/
public ExampleDAOCriterion(final Object example) {
this.example = example;
diff --git a/src/main/java/com/bitctrl/modell/criteria/LimitDAOCriterion.java b/src/main/java/com/bitctrl/modell/criteria/LimitDAOCriterion.java
index a314434..bba51d3 100644
--- a/src/main/java/com/bitctrl/modell/criteria/LimitDAOCriterion.java
+++ b/src/main/java/com/bitctrl/modell/criteria/LimitDAOCriterion.java
@@ -31,6 +31,7 @@
*
* @author BitCtrl Systems GmbH, Görlitz
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public class LimitDAOCriterion implements DAOCriterion {
private final long offset;
@@ -39,11 +40,9 @@ public class LimitDAOCriterion implements DAOCriterion {
/**
* 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.
+ * @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;
@@ -51,31 +50,29 @@ public LimitDAOCriterion(final long offset, final int limit) {
}
/**
- * Initialisiert das Criteria mit dem Offset und der maximal möglichen
- * Anzahl Datenobjekte.
+ * 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.
+ * @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.
+ * Initialisiert das Criteria mit dem Offset des ersten Elements und der Anzahl
+ * Datenobjekte.
*
- * @param limit
- * die maximale Anzahl an Ergebnissen.
+ * @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.
+ * Liefert den Offset, ab dem Datenobjekte geliefert werden sollen. Das Element,
+ * welches der Offset addressiert, ist im Ergebnis enthalten.
*
* @return der Offset.
*/
@@ -84,8 +81,7 @@ public long getOffset() {
}
/**
- * Liefert das Limit, also die maximale Anzahl von Datenobjekten im
- * Ergebnis.
+ * Liefert das Limit, also die maximale Anzahl von Datenobjekten im Ergebnis.
*
* @return das Limit.
*/
@@ -95,8 +91,7 @@ public int getLimit() {
@Override
public String toString() {
- return getClass().getName() + "[offset=" + offset + ", limit=" + limit
- + "]";
+ return getClass().getName() + "[offset=" + offset + ", limit=" + limit + "]";
}
}
diff --git a/src/main/java/com/bitctrl/modell/criteria/NullDAOCriterion.java b/src/main/java/com/bitctrl/modell/criteria/NullDAOCriterion.java
index 046e8dc..554972e 100644
--- a/src/main/java/com/bitctrl/modell/criteria/NullDAOCriterion.java
+++ b/src/main/java/com/bitctrl/modell/criteria/NullDAOCriterion.java
@@ -30,16 +30,16 @@
*
* @author BitCtrl Systems GmbH, Görlitz
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public class NullDAOCriterion implements DAOCriterion {
private final String propertyName;
/**
- * Erstellt ein Kriterium dass einen auf {@code null} zu pruefenden
- * Spaltennamen repraesentiert.
+ * Erstellt ein Kriterium dass einen auf {@code null} zu pruefenden Spaltennamen
+ * repraesentiert.
*
- * @param property
- * die auf {@code null} zu prüfende Property.
+ * @param property die auf {@code null} zu prüfende Property.
*/
public NullDAOCriterion(final String property) {
propertyName = property;
diff --git a/src/main/java/com/bitctrl/modell/criteria/OrderDAOCriterion.java b/src/main/java/com/bitctrl/modell/criteria/OrderDAOCriterion.java
index af015c1..4aaff8b 100644
--- a/src/main/java/com/bitctrl/modell/criteria/OrderDAOCriterion.java
+++ b/src/main/java/com/bitctrl/modell/criteria/OrderDAOCriterion.java
@@ -31,6 +31,7 @@
*
* @author BitCtrl Systems GmbH, Goerlitz
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public class OrderDAOCriterion implements DAOCriterion {
private final String propertyName;
@@ -39,8 +40,7 @@ public class OrderDAOCriterion implements DAOCriterion {
/**
* Erstellt eine aufsteigende Sortierung für Ergebnisse einer DAO.
*
- * @param propertyName
- * der Spaltenname ueber den sortiert werden soll.
+ * @param propertyName der Spaltenname ueber den sortiert werden soll.
*/
public OrderDAOCriterion(final String propertyName) {
this(propertyName, true);
@@ -49,11 +49,9 @@ public OrderDAOCriterion(final String propertyName) {
/**
* 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.
+ * @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;
@@ -81,8 +79,7 @@ public boolean isAscending() {
@Override
public String toString() {
- return getClass().getName() + "[propertyName=" + propertyName
- + ", ascending=" + ascending + "]";
+ return getClass().getName() + "[propertyName=" + propertyName + ", ascending=" + ascending + "]";
}
}
diff --git a/src/main/java/com/bitctrl/modell/package-info.java b/src/main/java/com/bitctrl/modell/package-info.java
index 37fd8ae..cf1cbfc 100644
--- a/src/main/java/com/bitctrl/modell/package-info.java
+++ b/src/main/java/com/bitctrl/modell/package-info.java
@@ -32,5 +32,5 @@
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
package com.bitctrl.modell;
-
diff --git a/src/main/java/com/bitctrl/modell/util/DAOElementContainer.java b/src/main/java/com/bitctrl/modell/util/DAOElementContainer.java
index de43b62..cf24c3c 100644
--- a/src/main/java/com/bitctrl/modell/util/DAOElementContainer.java
+++ b/src/main/java/com/bitctrl/modell/util/DAOElementContainer.java
@@ -37,6 +37,7 @@
*
* @author BitCtrl Systems GmbH, Görlitz
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public interface DAOElementContainer {
/**
@@ -51,17 +52,14 @@ public interface DAOElementContainer {
* Liefert die Anzahl der Blätterelemente.
*
* @return Die Anzahl der Blätterelemente.
- * @throws DAOException
- * Bei einem Fehler.
+ * @throws DAOException Bei einem Fehler.
*/
int getLeafElementsCount() throws DAOException;
/**
- * Liefert alle Kriterien zur Ermittlung des Kindelements am übergebenen
- * Index.
+ * Liefert alle Kriterien zur Ermittlung des Kindelements am übergebenen Index.
*
- * @param index
- * Der Index.
+ * @param index Der Index.
*
* @return Die Kriterien.
*/
@@ -72,8 +70,7 @@ public interface DAOElementContainer {
* Sub-Container sein.
*
* @return Die Elemente dieses Containers
- * @throws DAOException
- * Bei einem Fehler.
+ * @throws DAOException Bei einem Fehler.
*/
List getElements() throws DAOException;
}
diff --git a/src/main/java/com/bitctrl/modell/util/DAOPage.java b/src/main/java/com/bitctrl/modell/util/DAOPage.java
index 50422ff..6850f80 100644
--- a/src/main/java/com/bitctrl/modell/util/DAOPage.java
+++ b/src/main/java/com/bitctrl/modell/util/DAOPage.java
@@ -44,6 +44,7 @@
*
* @author BitCtrl Systems GmbH, Falko Schumann
*/
+@Deprecated(since = "3.0.0", forRemoval = true)
public class DAOPage implements DAOElementContainer, Comparable {
/** Die DAO bei der Daten bei Bedarf abgerufen werden. */
@@ -67,27 +68,20 @@ public class DAOPage implements DAOElementContainer, Comparable {
private final boolean showPageName;
/**
- * Initialisiert die Seite mit den notwendigen Informationen zum späteren
- * Abruf der Daten.
+ * 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.
+ * @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) {
@@ -110,9 +104,9 @@ protected DAOPage(final DAO dao, final long count, final int pageSize, fin
}
/**
- * 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.
+ * 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.
*/
@@ -127,12 +121,12 @@ public boolean isSubpage() {
* zurück.
*
* @return die Daten oder Subpages.
- * @throws DAOException
- * bei einem Fehler.
+ * @throws DAOException bei einem Fehler.
*/
+ @Override
public List getElements() throws DAOException {
if (isSubpage()) {
- final List