docker-175

package com.citigroup.get.quantum.config.v2.internal.soap;

import java.util.ArrayList;
import java.util.List;
import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.XmlType;

/**
 * <h2>GetProperties</h2>
 *
 * <p>Concrete JAXB request wrapper class responsible for marshaling the
 * parameter arguments of the {@code getProperties} operation into a
 * validated SOAP 1.1 XML payload body. This entity serves as the network
 * envelope used to query specific, targeted configuration keys for a given
 * application context.</p>
 *
 * <p><b>Architectural Context &amp; Serialization Mechanics:</b><br>
 * Modernized and stabilized for compliance with <b>Java 21</b> and
 * <b>Spring 6.1</b> infrastructures. Fields are bound directly using an
 * explicit strategy managed via {@link XmlAccessorType} set to
 * {@link XmlAccessType#FIELD}. To maintain wire compatibility with strict
 * backend parsing engines, data serialization formatting sequence rules are
 * strictly enforced. The class-level {@code propOrder} configuration
 * array guarantees that {@code applicationName} is serialized immediately
 * before {@code propertyNames} inside the generated XML payload.</p>
 *
 * <p><b>Memory Management &amp; Concurrency Safety:</b><br>
 * Both fields are restricted by an {@link XmlElement} layout mapping
 * defining them as mandatory elements ({@code required = true}) while
 * preserving nullability permissions ({@code nillable = true}). To optimize
 * resource utilization under high-concurrency workloads driven by Java 21
 * Virtual Threads, the collection accessor for {@code propertyNames}
 * utilizes a lazy-initialization pattern. This prevents downstream
 * {@link NullPointerException} failures during payload population without
 * requiring synchronized block locks on the heap.</p>
 *
 * <p>The class exposes the following property accessors and mutators:
 * <ul>
 * <li>{@code getApplicationName()}: Resolves the targeted workspace
 * environment string identifier.</li>
 * <li>{@code setApplicationName(String value)}: Mutator allowing custom
 * client orchestrators to point requests to alternative application
 * contexts dynamically.</li>
 * <li>{@code getPropertyNames()}: Lazy-initialized accessor returning
 * the {@link List} of target configuration keys to be resolved.</li>
 * </ul>
 *
 * @since CPLS Migration 2.0 (Java 21 / Spring 6.1 Baseline)
 * @see ConfigurationRetrievalServicePortType
 * @see XmlRootElement
 */
@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(
    name = "",
    propOrder = {
        "applicationName",
        "propertyNames"
    }
)
@XmlRootElement(name = "getProperties")
public class GetProperties {

    @XmlElement(
        required = true,
        nillable = true
    )
    protected String applicationName;

    @XmlElement(
        required = true,
        nillable = true
    )
    protected List<String> propertyNames;

    public String getApplicationName() {
        return this.applicationName;
    }

    public void setApplicationName(String value) {
        this.applicationName = value;
    }

    public List<String> getPropertyNames() {
        if (this.propertyNames == null) {
            this.propertyNames = new ArrayList<>();
        }
        return this.propertyNames;
    }
}