fix(javadoc): weekly batch — reduce warnings from 1097 to 1032

Author: ar-agt

jpos/src/main/java/module-info.java

@@ -1,3 +1,4 @@
+/** Java module definition for the jPOS core library. */
 module org.jpos.jpos {
     requires java.se;
     requires jdk.jfr;

jpos/src/main/java/org/jpos/core/SimpleConfiguration.java

@@ -32,6 +32,7 @@
  * @since jPOS 1.1
  */
 public class SimpleConfiguration implements Configuration, Serializable {
+    /** Backing property store used by this configuration instance. */
     private Properties props;
 
     /** Default constructor. */

jpos/src/main/java/org/jpos/emv/EMVConstructedTag.java

@@ -31,9 +31,13 @@
  */
 public class EMVConstructedTag<T> implements Serializable {
 
+    /** EMV tag classification and metadata. */
     private final EMVTagType tagType;
+    /** TLV data format used to encode the value. */
     private final TLVDataFormat dataFormat;
+    /** Numeric EMV tag identifier. */
     private final Integer tagNumber;
+    /** Parsed value carried by this tag. */
     private final T value;
 
 

jpos/src/main/java/org/jpos/emv/EMVTag.java

@@ -34,9 +34,13 @@
 public abstract class EMVTag<T> implements TagValue<T>, Serializable {
 
     private static final long serialVersionUID = 4674858246785118615L;
+    /** EMV tag classification and metadata. */
     private final EMVTagType tagType;
+    /** TLV data format used to encode the value. */
     private final TLVDataFormat dataFormat;
+    /** Numeric EMV tag identifier. */
     private final Integer tagNumber;
+    /** Parsed value carried by this tag. */
     private final T value;
 
 

jpos/src/main/java/org/jpos/iso/ISOException.java

@@ -33,7 +33,9 @@ public class ISOException extends Exception implements Loggeable {
 
     private static final long serialVersionUID = -777216335204861186L;
     /**
-     * @serial
+     * Nested exception wrapped by this ISOException, when present.
+     *
+     * @serial wrapped cause captured for legacy serialization
      */
     Throwable nested = null;
 

jpos/src/main/java/org/jpos/iso/ISOServerAcceptEvent.java

@@ -23,6 +23,7 @@
 
 /** Event fired when a new client connection is accepted by ISOServer. */
 public final class ISOServerAcceptEvent extends EventObject implements ISOServerEvent {
+    /** Weak reference to the accepted channel. */
     private WeakReference<ISOChannel> channelRef;
     /** Constructs the event.
      * @param source  the ISOServer

jpos/src/main/java/org/jpos/iso/ISOServerClientDisconnectEvent.java

@@ -23,6 +23,7 @@
 
 /** Event fired when a client disconnects from ISOServer. */
 public final class ISOServerClientDisconnectEvent extends EventObject implements ISOServerEvent {
+    /** Weak reference to the disconnected channel. */
     private WeakReference<ISOChannel> channelRef;
     /** Constructs the event.
      * @param source  the event source

jpos/src/main/java/org/jpos/iso/filter/XSLTFilter.java

@@ -61,8 +61,10 @@ public XSLTFilter () throws ISOException {
     }
 
     /**
-     * @param xsltfile XSL Transformation file
-     * @param reread true if you want XSLT file re-read from disk
+     * Creates a filter backed by the supplied XSL transformation file.
+     *
+     * @param xsltfile XSL transformation file
+     * @param reread true if you want the XSLT file re-read from disk
      * @throws ISOException on pack/unpack error
      */
     public XSLTFilter (String xsltfile, boolean reread) 
@@ -105,11 +107,13 @@ public void setConfiguration (Configuration cfg)
     }
 
     /**
+     * Applies the configured XSLT transformation to the supplied message.
+     *
      * @param channel current ISOChannel instance
      * @param m ISOMsg to filter
-     * @param evt LogEvent
-     * @return an ISOMsg (possibly parameter m)
-     * @throws VetoException
+     * @param evt LogEvent collecting filter diagnostics
+     * @return an ISOMsg, usually the same instance passed in
+     * @throws VetoException if the transformation fails
      */
     public ISOMsg filter (ISOChannel channel, ISOMsg m, LogEvent evt) 
         throws VetoException

jpos/src/main/java/org/jpos/iso/gui/ISOChannelPanel.java

@@ -38,19 +38,27 @@
 public class ISOChannelPanel extends JPanel implements Observer {
     private static final long serialVersionUID = -8069489863639386589L;
     /**
-     * @serial
+     * Meter widget used to visualize channel activity.
+     *
+     * @serial embedded child component state
      */
     ISOMeter meter;
     /**
-     * @serial
+     * Rolling log model displayed when the meter is opened.
+     *
+     * @serial serialized log contents
      */
     DefaultListModel log;
     /**
-     * @serial
+     * Human-readable channel name shown in the UI.
+     *
+     * @serial display name persisted with the panel
      */
     String symbolicName;
 
+    /** Fields that must be protected before logging. */
     private int[] protectFields = null;
+    /** Fields that must be wiped before logging. */
     private int[] wipeFields    = null;
 
     /** Maximum number of log entries to retain. */

jpos/src/main/java/org/jpos/iso/gui/ISOMeter.java

@@ -116,7 +116,9 @@ public class ISOMeter extends JComponent implements Runnable {
      */
     int refreshPanel = 50;
 
+    /** Off-screen image buffer used during repaint operations. */
     private Image imb;
+    /** Background thread that advances the animated meter display. */
     private Thread repaintThread;
 
     /** Constructs an ISOMeter for the given channel panel.