nfs4: turn StateDisposeListener into DisposeListener

Motivation:
We might need to have listeners for other object too, thus, reuse the
interface.

Acked-by: Paul Millar
Target: master

Author: kofemann

core/src/main/java/org/dcache/nfs/v4/StateDisposeListener.java renamed to core/src/main/java/org/dcache/nfs/v4/DisposeListener.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009 - 2016 Deutsches Elektronen-Synchroton,
+ * Copyright (c) 2009 - 2025 Deutsches Elektronen-Synchroton,
  * Member of the Helmholtz Association, (DESY), HAMBURG, GERMANY
  *
  * This library is free software; you can redistribute it and/or modify
@@ -22,14 +22,14 @@
 import org.dcache.nfs.ChimeraNFSException;
 
 /**
- * Should be implemented by an object that wants to receive state dispose notifications.
+ * Should be implemented by an object that wants to receive dispose notifications.
  */
-public interface StateDisposeListener {
+public interface DisposeListener<T> {
 
     /**
-     * Called when specified {@link NFS4State} is disposed.
-     * @param state disposed state
+     * Called when attached object is disposed.
+     * @param attachement disposed object
      * @throws ChimeraNFSException on errors.
      */
-    void notifyDisposed(NFS4State state) throws ChimeraNFSException;
+    void notifyDisposed(T attachement) throws ChimeraNFSException;
 }

core/src/main/java/org/dcache/nfs/v4/NFS4State.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009 - 2020 Deutsches Elektronen-Synchroton,
+ * Copyright (c) 2009 - 2025 Deutsches Elektronen-Synchroton,
  * Member of the Helmholtz Association, (DESY), HAMBURG, GERMANY
  *
  * This library is free software; you can redistribute it and/or modify
@@ -61,7 +61,7 @@ public class NFS4State {
      */
     private final NFS4State _openState;
 
-    private final List<StateDisposeListener> _disposeListeners;
+    private final List<DisposeListener<NFS4State>> _disposeListeners;
 
     public NFS4State(StateOwner owner, stateid4 stateid) {
         this(null, owner, stateid);
@@ -95,9 +95,9 @@ public boolean isConfimed() {
      */
     synchronized public final void tryDispose() throws ChimeraNFSException {
         if (!_disposed) {
-            Iterator<StateDisposeListener> i = _disposeListeners.iterator();
+            Iterator<DisposeListener<NFS4State>> i = _disposeListeners.iterator();
             while(i.hasNext()) {
-                StateDisposeListener listener = i.next();
+                DisposeListener listener = i.next();
                 listener.notifyDisposed(this);
                 i.remove();
             }
@@ -112,9 +112,9 @@ synchronized public final void tryDispose() throws ChimeraNFSException {
      */
     synchronized public final void disposeIgnoreFailures() {
         if (!_disposed) {
-            Iterator<StateDisposeListener> i = _disposeListeners.iterator();
+            Iterator<DisposeListener<NFS4State>> i = _disposeListeners.iterator();
             while (i.hasNext()) {
-                StateDisposeListener listener = i.next();
+                DisposeListener<NFS4State> listener = i.next();
                 try {
                     listener.notifyDisposed(this);
                 } catch (ChimeraNFSException e) {
@@ -142,7 +142,7 @@ public StateOwner getStateOwner() {
         return _owner;
     }
 
-    synchronized public void addDisposeListener(StateDisposeListener disposeListener) {
+    synchronized public void addDisposeListener(DisposeListener<NFS4State> disposeListener) {
         _disposeListeners.add(disposeListener);
     }