com.sun.xml.ws.policy.sourcemodel.AssertionData Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jaxws-rt Show documentation
Show all versions of jaxws-rt Show documentation
JAX-WS Runtime with module descriptor
The newest version!
/*
* 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.policy.sourcemodel;
import com.sun.xml.ws.policy.PolicyConstants;
import com.sun.xml.ws.policy.privateutil.LocalizationMessages;
import com.sun.xml.ws.policy.privateutil.PolicyLogger;
import com.sun.xml.ws.policy.privateutil.PolicyUtils;
import java.io.Serializable;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Map;
import java.util.Set;
import javax.xml.namespace.QName;
/**
* Wrapper class for possible data that each "assertion" and "assertion parameter content" policy source model node may
* have attached.
*
* This data, when stored in an 'assertion' model node, is intended to be used as input parameter when creating
* {@link com.sun.xml.ws.policy.PolicyAssertion} objects via {@link com.sun.xml.ws.policy.spi.PolicyAssertionCreator}
* implementations.
*
* @author Marek Potociar ([email protected])
* @author Fabian Ritzmann
*/
public final class AssertionData implements Cloneable, Serializable {
private static final long serialVersionUID = 4416256070795526315L;
private static final PolicyLogger LOGGER = PolicyLogger.getLogger(AssertionData.class);
private final QName name;
private final String value;
private transient final Map attributes;
private ModelNode.Type type;
private boolean optional;
private boolean ignorable;
/**
* Constructs assertion data wrapper instance for an assertion that does not
* contain any value nor any attributes.
*
* @param name the FQN of the assertion
*
* @throws IllegalArgumentException in case the {@code type} parameter is not
* {@link ModelNode.Type#ASSERTION ASSERTION} or
* {@link ModelNode.Type#ASSERTION_PARAMETER_NODE ASSERTION_PARAMETER_NODE}
*/
public static AssertionData createAssertionData(final QName name) throws IllegalArgumentException {
return new AssertionData(name, null, null, ModelNode.Type.ASSERTION, false, false);
}
/**
* Constructs assertion data wrapper instance for an assertion parameter that
* does not contain any value nor any attributes.
*
* @param name the FQN of the assertion parameter
*
* @throws IllegalArgumentException in case the {@code type} parameter is not
* {@link ModelNode.Type#ASSERTION ASSERTION} or
* {@link ModelNode.Type#ASSERTION_PARAMETER_NODE ASSERTION_PARAMETER_NODE}
*/
public static AssertionData createAssertionParameterData(final QName name) throws IllegalArgumentException {
return new AssertionData(name, null, null, ModelNode.Type.ASSERTION_PARAMETER_NODE, false, false);
}
/**
* Constructs assertion data wrapper instance for an assertion that does
* contain a value or attributes.
*
* @param name the FQN of the assertion
* @param value a {@link String} representation of model node value
* @param attributes map of model node's <attribute name, attribute value> pairs
* @param optional flag indicating whether the assertion is optional or not
* @param ignorable flag indicating whether the assertion is ignorable or not
*
* @throws IllegalArgumentException in case the {@code type} parameter is not
* {@link ModelNode.Type#ASSERTION ASSERTION} or
* {@link ModelNode.Type#ASSERTION_PARAMETER_NODE ASSERTION_PARAMETER_NODE}
*/
public static AssertionData createAssertionData(final QName name, final String value, final Map attributes, boolean optional, boolean ignorable) throws IllegalArgumentException {
return new AssertionData(name, value, attributes, ModelNode.Type.ASSERTION, optional, ignorable);
}
/**
* Constructs assertion data wrapper instance for an assertion parameter that
* contains a value or attributes
*
* @param name the FQN of the assertion parameter
* @param value a {@link String} representation of model node value
* @param attributes map of model node's <attribute name, attribute value> pairs
*
* @throws IllegalArgumentException in case the {@code type} parameter is not
* {@link ModelNode.Type#ASSERTION ASSERTION} or
* {@link ModelNode.Type#ASSERTION_PARAMETER_NODE ASSERTION_PARAMETER_NODE}
*/
public static AssertionData createAssertionParameterData(final QName name, final String value, final Map attributes) throws IllegalArgumentException {
return new AssertionData(name, value, attributes, ModelNode.Type.ASSERTION_PARAMETER_NODE, false, false);
}
/**
* Constructs assertion data wrapper instance for an assertion or assertion parameter that contains a value or
* some attributes. Whether the data wrapper is constructed for assertion or assertion parameter node is distinguished by
* the supplied {@code type} parameter.
*
* @param name the FQN of the assertion or assertion parameter
* @param value a {@link String} representation of model node value
* @param attributes map of model node's <attribute name, attribute value> pairs
* @param type specifies whether the data will belong to the assertion or assertion parameter node. This is
* a workaround solution that allows us to transfer this information about the owner node to
* a policy assertion instance factory without actualy having to touch the {@link com.sun.xml.ws.policy.spi.PolicyAssertionCreator}
* interface and protected {@link com.sun.xml.ws.policy.PolicyAssertion} constructors.
*
* @throws IllegalArgumentException in case the {@code type} parameter is not
* {@link ModelNode.Type#ASSERTION ASSERTION} or
* {@link ModelNode.Type#ASSERTION_PARAMETER_NODE ASSERTION_PARAMETER_NODE}
*/
AssertionData(QName name, String value, Map attributes, ModelNode.Type type, boolean optional, boolean ignorable) throws IllegalArgumentException {
this.name = name;
this.value = value;
this.optional = optional;
this.ignorable = ignorable;
this.attributes = new HashMap<>();
if (attributes != null && !attributes.isEmpty()) {
this.attributes.putAll(attributes);
}
setModelNodeType(type);
}
private void setModelNodeType(final ModelNode.Type type) throws IllegalArgumentException {
if (type == ModelNode.Type.ASSERTION || type == ModelNode.Type.ASSERTION_PARAMETER_NODE) {
this.type = type;
} else {
throw LOGGER.logSevereException(new IllegalArgumentException(
LocalizationMessages.WSP_0074_CANNOT_CREATE_ASSERTION_BAD_TYPE(type, ModelNode.Type.ASSERTION, ModelNode.Type.ASSERTION_PARAMETER_NODE)));
}
}
/**
* Copy constructor.
*
* @param data The instance that is to be copied.
*/
AssertionData(final AssertionData data) {
this.name = data.name;
this.value = data.value;
this.attributes = new HashMap<>();
if (!data.attributes.isEmpty()) {
this.attributes.putAll(data.attributes);
}
this.type = data.type;
}
@Override
protected AssertionData clone() throws CloneNotSupportedException {
return (AssertionData) super.clone();
}
/**
* Returns true if the given attribute exists, false otherwise.
*
* @param name The name of the attribute. Must not be null.
* @return True if the given attribute exists, false otherwise.
*/
public boolean containsAttribute(final QName name) {
synchronized (attributes) {
return attributes.containsKey(name);
}
}
@Override
public boolean equals(final Object obj) {
if (this == obj) {
return true;
}
if (!(obj instanceof AssertionData)) {
return false;
}
boolean result = true;
final AssertionData that = (AssertionData) obj;
result = result && this.name.equals(that.name);
result = result && ((this.value == null) ? that.value == null : this.value.equals(that.value));
synchronized (attributes) {
result = result && this.attributes.equals(that.attributes);
}
return result;
}
/**
* Returns the value of the given attribute. Returns null if the attribute
* does not exist.
*
* @param name The name of the attribute. Must not be null.
* @return The value of the given attribute. Returns null if the attribute
* does not exist.
*/
public String getAttributeValue(final QName name) {
synchronized (attributes) {
return attributes.get(name);
}
}
/**
* Returns the disconnected map of attributes attached to the assertion.
*
* 'Disconnected' means, that the result of this method will not be synchronized with any consequent assertion's attribute modification. It is
* also important to notice that a manipulation with returned set of attributes will not have any effect on the actual assertion's
* attributes.
*
* @return disconnected map of attributes attached to the assertion.
*/
public Map getAttributes() {
synchronized (attributes) {
return new HashMap<>(attributes);
}
}
/**
* Returns the disconnected set of attributes attached to the assertion. Each attribute is represented as a single
* {@code Map.Entry} element.
*
* 'Disconnected' means, that the result of this method will not be synchronized with any consequent assertion's attribute modification. It is
* also important to notice that a manipulation with returned set of attributes will not have any effect on the actual assertion's
* attributes.
*
* @return disconnected set of attributes attached to the assertion.
*/
public Set> getAttributesSet() {
synchronized (attributes) {
return new HashSet<>(attributes.entrySet());
}
}
/**
* Returns the name of the assertion.
*
* @return assertion's name
*/
public QName getName() {
return name;
}
/**
* Returns the value of the assertion.
*
* @return assertion's value
*/
public String getValue() {
return value;
}
/**
* An {@code Object.hashCode()} method override.
*/
@Override
public int hashCode() {
int result = 17;
result = 37 * result + this.name.hashCode();
result = 37 * result + ((this.value == null) ? 0 : this.value.hashCode());
synchronized (attributes) {
result = 37 * result + this.attributes.hashCode();
}
return result;
}
/**
* Method specifies whether the assertion data contain proprietary visibility element set to "private" value.
*
* @return {@code 'true'} if the attribute is present and set properly (i.e. the node containing this assertion data instance should
* not be marshaled into generated WSDL documents). Returns {@code false} otherwise.
*/
public boolean isPrivateAttributeSet() {
return PolicyConstants.VISIBILITY_VALUE_PRIVATE.equals(getAttributeValue(PolicyConstants.VISIBILITY_ATTRIBUTE));
}
/**
* Removes the given attribute from the assertion data.
*
* @param name The name of the attribute. Must not be null
* @return The value of the removed attribute.
*/
public String removeAttribute(final QName name) {
synchronized (attributes) {
return attributes.remove(name);
}
}
/**
* Adds or overwrites an attribute.
*
* @param name The name of the attribute.
* @param value The value of the attribute.
*/
public void setAttribute(final QName name, final String value) {
synchronized (attributes) {
attributes.put(name, value);
}
}
/**
* Sets the optional attribute.
*
* @param value The value of the optional attribute.
*/
public void setOptionalAttribute(final boolean value) {
optional = value;
}
/**
* Tests if the optional attribute is set.
*
* @return True if optional is set and is true. False otherwise.
*/
public boolean isOptionalAttributeSet() {
return optional;
}
/**
* Sets the ignorable attribute.
*
* @param value The value of the ignorable attribute.
*/
public void setIgnorableAttribute(final boolean value) {
ignorable = value;
}
/**
* Tests if the ignorable attribute is set.
*
* @return True if ignorable is set and is true. False otherwise.
*/
public boolean isIgnorableAttributeSet() {
return ignorable;
}
@Override
public String toString() {
return toString(0, new StringBuffer()).toString();
}
/**
* A helper method that appends indented string representation of this instance to the input string buffer.
*
* @param indentLevel indentation level to be used.
* @param buffer buffer to be used for appending string representation of this instance
* @return modified buffer containing new string representation of the instance
*/
public StringBuffer toString(final int indentLevel, final StringBuffer buffer) {
final String indent = PolicyUtils.Text.createIndent(indentLevel);
final String innerIndent = PolicyUtils.Text.createIndent(indentLevel + 1);
final String innerDoubleIndent = PolicyUtils.Text.createIndent(indentLevel + 2);
buffer.append(indent);
if (type == ModelNode.Type.ASSERTION) {
buffer.append("assertion data {");
} else {
buffer.append("assertion parameter data {");
}
buffer.append(PolicyUtils.Text.NEW_LINE);
buffer.append(innerIndent).append("namespace = '").append(name.getNamespaceURI()).append('\'').append(PolicyUtils.Text.NEW_LINE);
buffer.append(innerIndent).append("prefix = '").append(name.getPrefix()).append('\'').append(PolicyUtils.Text.NEW_LINE);
buffer.append(innerIndent).append("local name = '").append(name.getLocalPart()).append('\'').append(PolicyUtils.Text.NEW_LINE);
buffer.append(innerIndent).append("value = '").append(value).append('\'').append(PolicyUtils.Text.NEW_LINE);
buffer.append(innerIndent).append("optional = '").append(optional).append('\'').append(PolicyUtils.Text.NEW_LINE);
buffer.append(innerIndent).append("ignorable = '").append(ignorable).append('\'').append(PolicyUtils.Text.NEW_LINE);
synchronized (attributes) {
if (attributes.isEmpty()) {
buffer.append(innerIndent).append("no attributes");
} else {
buffer.append(innerIndent).append("attributes {").append(PolicyUtils.Text.NEW_LINE);
for(Map.Entry entry : attributes.entrySet()) {
final QName aName = entry.getKey();
buffer.append(innerDoubleIndent).append("name = '").append(aName.getNamespaceURI()).append(':').append(aName.getLocalPart());
buffer.append("', value = '").append(entry.getValue()).append('\'').append(PolicyUtils.Text.NEW_LINE);
}
buffer.append(innerIndent).append('}');
}
}
buffer.append(PolicyUtils.Text.NEW_LINE).append(indent).append('}');
return buffer;
}
public ModelNode.Type getNodeType() {
return type;
}
}