com.unboundid.ldap.sdk.unboundidds.monitors.OperationResultCodeInfo Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of unboundid-ldapsdk Show documentation
Show all versions of unboundid-ldapsdk Show documentation
The UnboundID LDAP SDK for Java is a fast, comprehensive, and easy-to-use
Java API for communicating with LDAP directory servers and performing
related tasks like reading and writing LDIF, encoding and decoding data
using base64 and ASN.1 BER, and performing secure communication. This
package contains the Standard Edition of the LDAP SDK, which is a
complete, general-purpose library for communicating with LDAPv3 directory
servers.
/*
* Copyright 2014-2022 Ping Identity Corporation
* All Rights Reserved.
*/
/*
* Copyright 2014-2022 Ping Identity Corporation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* Copyright (C) 2014-2022 Ping Identity Corporation
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License (GPLv2 only)
* or the terms of the GNU Lesser General Public License (LGPLv2.1 only)
* as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, see .
*/
package com.unboundid.ldap.sdk.unboundidds.monitors;
import java.io.Serializable;
import java.util.Collections;
import java.util.Map;
import java.util.TreeMap;
import com.unboundid.ldap.sdk.Attribute;
import com.unboundid.ldap.sdk.Entry;
import com.unboundid.ldap.sdk.OperationType;
import com.unboundid.util.Debug;
import com.unboundid.util.NotMutable;
import com.unboundid.util.NotNull;
import com.unboundid.util.Nullable;
import com.unboundid.util.StaticUtils;
import com.unboundid.util.ThreadSafety;
import com.unboundid.util.ThreadSafetyLevel;
/**
* This class provides a data structure that provides information about the
* result codes associated with a particular type of operation (or across all
* types of operations, if the associated operation type is {@code null}).
*
*
* NOTE: This class, and other classes within the
* {@code com.unboundid.ldap.sdk.unboundidds} package structure, are only
* supported for use against Ping Identity, UnboundID, and
* Nokia/Alcatel-Lucent 8661 server products. These classes provide support
* for proprietary functionality or for external specifications that are not
* considered stable or mature enough to be guaranteed to work in an
* interoperable way with other types of LDAP servers.
*
*/
@NotMutable()
@ThreadSafety(level=ThreadSafetyLevel.COMPLETELY_THREADSAFE)
public final class OperationResultCodeInfo
implements Serializable
{
/**
* The serial version UID for this serializable class.
*/
private static final long serialVersionUID = 4688688688915878084L;
// The percentage of operations of the associated type that failed.
@Nullable private final Double failedPercent;
// The total number of operations of the associated type that failed.
@Nullable private final Long failedCount;
// The total number of operations of the associated type.
@Nullable private final Long totalCount;
// Information about each result code returned for the associated operation
// type, indexed by the result code's integer value.
@NotNull private final Map resultCodeInfoMap;
// The associated operation type. It may be null if this structure provides
// information about all operation types.
@Nullable private final OperationType operationType;
/**
* Creates a new operation result code information object from the provided
* information.
*
* @param entry The monitor entry to use to obtain the result
* code information.
* @param operationType The operation type for this object. It may be
* {@code null} if the information applies to all
* types of operations.
* @param opTypeAttrPrefix The prefix that will be used for information
* about
*/
OperationResultCodeInfo(@NotNull final MonitorEntry entry,
@Nullable final OperationType operationType,
@NotNull final String opTypeAttrPrefix)
{
this.operationType = operationType;
totalCount = entry.getLong(opTypeAttrPrefix + "total-count");
failedCount = entry.getLong(opTypeAttrPrefix + "failed-count");
failedPercent = entry.getDouble(opTypeAttrPrefix + "failed-percent");
final String rcPrefix = opTypeAttrPrefix + "result-";
final TreeMap rcMap = new TreeMap<>();
final Entry e = entry.getEntry();
for (final Attribute a : e.getAttributes())
{
try
{
final String lowerName = StaticUtils.toLowerCase(a.getName());
if (lowerName.startsWith(rcPrefix) && lowerName.endsWith("-name"))
{
final String name = a.getValue();
final int intValue = Integer.parseInt(lowerName.substring(
rcPrefix.length(), (lowerName.length() - 5)));
final long count = entry.getLong(rcPrefix + intValue + "-count");
final double percent = entry.getDouble(
rcPrefix + intValue + "-percent");
final double totalResponseTimeMillis = entry.getDouble(
rcPrefix + intValue + "-total-response-time-millis");
final double averageResponseTimeMillis = entry.getDouble(
rcPrefix + intValue + "-average-response-time-millis");
rcMap.put(intValue,
new ResultCodeInfo(intValue, name, operationType, count, percent,
totalResponseTimeMillis, averageResponseTimeMillis));
}
}
catch (final Exception ex)
{
Debug.debugException(ex);
}
}
resultCodeInfoMap = Collections.unmodifiableMap(rcMap);
}
/**
* Retrieves the type of operation with which this result code information is
* associated, if appropriate.
*
* @return The type of operation with which this result code information is
* associated, or {@code null} if this information applies to all
* types of operations.
*/
@Nullable()
public OperationType getOperationType()
{
return operationType;
}
/**
* Retrieves the total number of operations of the associated type that have
* been processed, if available.
*
* @return The total number of operations of the associated type that have
* been processed, or {@code null} if this information was not in the
* monitor entry.
*/
@Nullable()
public Long getTotalCount()
{
return totalCount;
}
/**
* Retrieves the number of operations of the associated type that resulted in
* failure, if available.
*
* @return The number of operations of the associated type that resulted
* in failure, or {@code null} if this information was not in the
* monitor entry.
*/
@Nullable()
public Long getFailedCount()
{
return failedCount;
}
/**
* Retrieves the percent of operations of the associated type that resulted in
* failure, if available.
*
* @return The percent of operations of the associated type that resulted
* in failure, or {@code null} if this information was not in the
* monitor entry.
*/
@Nullable()
public Double getFailedPercent()
{
return failedPercent;
}
/**
* Retrieves a map with information about the result codes that have been
* returned for operations of the associated type, indexed by the result
* code's integer value.
*
* @return A map with information about the result codes that have been
* returned for operations of the associated type.
*/
@NotNull()
public Map getResultCodeInfoMap()
{
return resultCodeInfoMap;
}
}