From 146a0fb8b0e90f9196e569152f649baf60d6cc8f Mon Sep 17 00:00:00 2001
From: Joaquín Reñé <jrene@curisit.net>
Date: Tue, 07 Oct 2025 14:52:57 +0000
Subject: [PATCH] #4410 - Comments on classes

---
 securis/src/main/java/net/curisit/securis/db/PackStatus.java |   61 +++++++++++++++++++++---------
 1 files changed, 42 insertions(+), 19 deletions(-)

diff --git a/securis/src/main/java/net/curisit/securis/db/PackStatus.java b/securis/src/main/java/net/curisit/securis/db/PackStatus.java
index 2588fe2..aa1a841 100644
--- a/securis/src/main/java/net/curisit/securis/db/PackStatus.java
+++ b/securis/src/main/java/net/curisit/securis/db/PackStatus.java
@@ -1,3 +1,6 @@
+/*
+* Copyright @ 2013 CurisTEC, S.A.S. All Rights Reserved.
+*/
 package net.curisit.securis.db;
 
 import net.curisit.securis.db.common.CodedEnum;
@@ -6,38 +9,58 @@
 import com.fasterxml.jackson.annotation.JsonValue;
 
 /**
- * Contains the possible pack statuses. For further details:
- * https://redmine.curistec.com/projects/securis/wiki/LicensesServerManagement
- * 
- * @author rob
- */
+* PackStatus
+* <p>
+* Enumerates possible pack lifecycle statuses. JSON representation is the short code.
+* See: https://redmine.curistec.com/projects/securis/wiki/LicensesServerManagement
+* 
+* @author JRA
+* Last reviewed by JRA on Oct 5, 2025.
+*/
 public enum PackStatus implements CodedEnum {
+	
+	// Available status for the pack
     CREATED("CR"), ACTIVE("AC"), ON_HOLD("OH"), EXPIRED("EX"), CANCELLED("CA");
 
     private final String code;
 
-    PackStatus(String code) {
-        this.code = code;
-    }
+    /**
+     * PackStatus<p>
+     * Constructor
+     * 
+     * @param code
+     */
+    PackStatus(String code) { this.code = code; }
 
-    @Override
-    public String getCode() {
-        return code;
-    }
+    /** 
+     * getCode<p>
+     * Short code stored in DB / used in JSON. 
+     * 
+     * @return packCode
+     */
+    @Override public String getCode() { return code; }
 
+    /** 
+     * valueFromCode<p>
+     * Factory method from short code. 
+     * 
+     * @param packCode
+     * @return packStatus
+     */
     @JsonCreator
     public static PackStatus valueFromCode(String code) {
         for (PackStatus ps : PackStatus.values()) {
-            if (ps.code.equals(code)) {
-                return ps;
-            }
+            if (ps.code.equals(code)) return ps;
         }
         return null;
     }
 
+    /** 
+     * getName<p>
+     * Expose short code as JSON value. 
+     * 
+     * @return name
+     */
     @JsonValue
-    public String getName() {
-        return this.code;
-    }
-
+    public String getName() { return this.code; }
 }

--
Gitblit v1.3.2