com.sun.xml.ws.api.FeatureListValidator Maven / Gradle / Ivy
Show all versions of rt Show documentation
/*
* Copyright (c) 1997, 2022 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Distribution License v. 1.0, which is available at
* http://www.eclipse.org/org/documents/edl-v10.php.
*
* SPDX-License-Identifier: BSD-3-Clause
*/
package com.sun.xml.ws.api;
import jakarta.xml.ws.WebServiceFeature;
import jakarta.xml.ws.WebServiceException;
/**
* Validates a list of {@link WebServiceFeature} instances when they are added to
* the client or service binding.
*
* {@link WebServiceFeature} classes may specify validator beans using {@link FeatureListValidatorAnnotation}.
*
* Current behavior will allow runtime components to add features to the binding after initial validation; however,
* this behavior is discouraged and will not be supported in later releases of the reference
* implementation.
*
* @since 2.2.8
* @see FeatureListValidatorAnnotation
*/
public interface FeatureListValidator {
/**
* Validates feature list. Implementations should throw {@link WebServiceException} if the
* list of features is invalid. Implementations may add features to the list or make other
* changes; however, only validators belonging to features on the original list will be
* invoked.
*
* @param list feature list
*/
void validate(WSFeatureList list);
}